This documentation is for a prerelease version of O3DE. Click here to switch to the latest release, or select a version from the dropdown.

Version:

Exposure Control Component

The Exposure Control component adjusts the amount of light from the scene that the camera receives, which controls how bright the scene appears. You can set the exposure manually, or use Eye Adaptation mode to automatically adjust camera exposure based on the scene’s brightness. Eye Adaptation mode adjusts the scene to a neutral middle gray lightness. You can make further adjustments to the automatic exposure by increasing or decreasing the Manual Compensation property.

Provider

Atom Gem

Dependencies

PostFX Layer

Properties

Exposure Control interface

Base properties

PropertyDescriptionValueDefault
EnableEnables the exposure control properties.BooleanEnabled
Overrides - Enabled OverrideIf enabled, you can override Exposure Control settings to have more control over how the PostFX behaves and looks.BooleanEnabled
Control TypeSpecifies how to control the exposure value.

When Control Type is Manual Only, only the Manual Compensation value adjusts the exposure value of the scene by a constant amount.

When Control Type is Eye Adaptation, the scene’s exposure automatically adjusts to a neutral middle gray lightness. Then, the exposure is further adjusted based on the Manual Compensation.
Manual Only, Eye AdaptationManual Only
Manual CompensationSets the exposure compensation value measured in exposure value stops. A lower value results in less exposure, rendering the scene darker. A higher value renders the scene brighter.Float: -16.0 - 16.00.0
Eye AdaptationSee Eye Adaptation properties.

Eye Adaptation properties

The following set of properties are active when Control Type is set to Eye Adaptation.

PropertyDescriptionValueDefault
Minimum ExposureThe minimum value that the exposure automatically adjusts to.Float: -16.0 - 16.0-16.0
Maximum ExposureThe maximum value that the exposure automatically adjusts to.Float: -16.0 - 16.016.0
Speed UpThe speed at which automatic exposure adapts to brighter scenes. A higher value increases the speed.Float: 0.01 - 10.03.0
Speed DownThe speed at which automatic exposure adapts to darker scenes. A higher value increases the speed.Float: 0.01 - 10.01.0
Enable HeatmapDisplays a histogram of the exposure values that the camera captures in the scene. It appears on top of the Viewport. You can move the camera to see the heatmap of other areas. Areas below the Minimum Exposure value are highlighted in blue, and areas above the Maximum Exposure value in red. The numbers on the heatmap represent exposure value stops.NoneDisabled