AutoExposureSettings class Rendering

Automatic exposure (eye adaptation) settings for a Scene.

Reachable through Scene.autoExposure. When enabled, the engine meters the average luminance of the rendered HDR image each frame and eases a correction factor toward it, so the image brightens in dark surroundings and darkens in bright ones, like eyes adjusting. The factor multiplies on top of Scene.exposure, which stays the artistic base (a value derived from Scene.physicalCameraExposure keeps working unchanged); the final multiplier applied to the HDR color is exposure * factor.

Metering runs entirely on the GPU (a luminance downsample chain feeding a one-pixel adaptation state), so enabling it adds no readback and works on every backend.

Disabled by default; a fresh scene meters nothing and renders with Scene.exposure alone.

Constructors

AutoExposureSettings()

Properties

compensation ↔ double

Exposure compensation in EV stops, applied to the metering target. 0 is neutral; +1 doubles the target brightness, -1 halves it.

getter/setter pair

enabled ↔ bool

Whether auto exposure runs. Off by default. When false the scene adds no metering passes and the image is unaffected.

getter/setter pair

hashCode → int

The hash code for this object.

no setter, inherited

maxEv ↔ double

The highest the correction may go, in EV stops relative to the base exposure. 1.3 (the default) lets dark scenes be brightened to about 2.5x.

getter/setter pair

minEv ↔ double

The lowest the correction may go, in EV stops relative to the base exposure. -1 (the default) lets bright scenes be darkened to half.

getter/setter pair

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

speedDown ↔ double

Adaptation rate while the scene gets darker (the correction rises), in blends per second.

getter/setter pair

speedUp ↔ double

Adaptation rate while the scene gets brighter (the correction falls), in blends per second. Adapting to brightness is faster than adapting to darkness by default, matching how eyes behave.

getter/setter pair

strength ↔ double

How strongly the metered error is corrected, from 0 (no correction) to 1 (full correction to the metering target). Partial correction preserves some of the scene's natural brightness variation, which usually reads better than a fully flattened image.

getter/setter pair

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

reset() → void

Snaps the adaptation to the metered target on the next frame, skipping the eased transition. Call on camera cuts and teleports so the new shot does not visibly ramp from the previous shot's adaptation.

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited