Component · render

Environment

Procedural sky radiance and camera exposure. The first in stable-ID order wins.

Fields

sky

color

Zenith sky color (linear).

default [0.22,0.32,0.6,1]

horizon

color

Horizon sky color (linear).

default [0.95,0.62,0.4,1]

ground

color

Ground color seen below the horizon (linear).

default [0.18,0.16,0.14,1]

intensity

f32

Sky radiance scale in candela per square metre.

default 900cd≥ 0

exposure

f32

Linear camera exposure multiplier, applied before tone mapping.

default 0.0015≥ 1e-7

Usage

Every edit is an undoable command: from the CLI as below, or the same JSON from an agent over MCP. See component.add and property.set.

Add it

ara do component.add -p entity=name:Crate -p component=Environment --why "Add Environment"

Set a field

ara do property.set -p entity=name:Crate -p path=Environment.sky -p value=[0.22,0.32,0.6,1] --why "Tune Environment"

In a scene document

{
  "Environment": {
    "sky": [
      0.22,
      0.32,
      0.6,
      1
    ]
  }
}

From C#

/// <summary>Brighten a scene during a daylight transition.</summary>
public static void UseEnvironment(Entity entity, in Tick tick)
{
    ref var component = ref World.Get<Ara.Environment>(entity);
    component.Exposure = 0.0025f;
}

From C#

Scripts read and write it with Get<Environment>(); see the Environment struct.