RenderSettings

Description

The Render Settings contain values for a range of visual elements in your Scene, like fog and ambient light.

The properties of the Render Settings class can be adjusted both in the Unity Editor through the Lighting Window and using scripts at runtime.

The Render Settings values are stored inside a scene, so changing the properties of this class will change the scene asset as well.

When multiple scenes are loaded at a time, Unity uses the Render Settings from the active scene.

The example below describes a component creating an axis-aligned zone that changes the color of the fog as the camera moves toward the zone. Additional resources: The Lighting window.

using UnityEngine;

public class FogZone : MonoBehaviour
{
    public Camera mainCamera;
    public Vector3 zoneCenter = Vector3.zero;
    public Vector3 zoneSize = new Vector3(10, 10, 10);
    public Color fogColorInside = Color.red;
    public Color fogColorOutside = Color.white;
    public float transitionRadius = 5.0f;

    Bounds zoneBounds;

    void Start()
    {
        // Create a bounds object based on the center and size of the zone
        zoneBounds = new Bounds(zoneCenter, zoneSize);
    }

    void Update()
    {
        if (mainCamera == null) return;

        // Calculate the closest point on the box to the camera
        Vector3 closestPoint = zoneBounds.ClosestPoint(mainCamera.transform.position);
        float distanceToZone = Vector3.Distance(mainCamera.transform.position, closestPoint);

        // Determine the interpolation factor based on the transition radius
        float t = Mathf.Clamp01(distanceToZone / transitionRadius);

        // Interpolate between the inside and outside fog colors
        RenderSettings.fogColor = Color.Lerp(fogColorInside, fogColorOutside, t);
    }
}

Static Properties

Inherited Members