Unravel Engine C++ Reference
Loading...
Searching...
No Matches
unravel::auto_exposure_pass::settings Struct Reference

#include <auto_exposure_pass.h>

Public Attributes

float min_ev = -4.0f
 
float max_ev = 0.0f
 
float compensation = 0.0f
 Exposure bias in EV stops applied on top of the metered result (+1 = 2x brighter).
 
float adaptation_speed_up = 3.0f
 
float adaptation_speed_down = 1.0f
 Time constant in seconds for the exposure to DECREASE (scene getting brighter).
 
float low_percentile = 0.50f
 Fraction of the darkest (weighted) pixels excluded from the average.
 
float high_percentile = 0.95f
 Upper fraction kept before excluding the brightest (weighted) pixels.
 
exposure_metering_mode metering_mode = exposure_metering_mode::center_weighted
 How pixels are spatially weighted when metering scene luminance.
 
float metering_area = 0.7f
 

Detailed Description

Definition at line 30 of file auto_exposure_pass.h.

Member Data Documentation

◆ adaptation_speed_down

float unravel::auto_exposure_pass::settings::adaptation_speed_down = 1.0f

Time constant in seconds for the exposure to DECREASE (scene getting brighter).

Definition at line 49 of file auto_exposure_pass.h.

◆ adaptation_speed_up

float unravel::auto_exposure_pass::settings::adaptation_speed_up = 3.0f

Time constant in seconds for the exposure to INCREASE (scene getting darker). Larger = slower adaptation. Adaptation is performed in log2/EV space.

Definition at line 47 of file auto_exposure_pass.h.

◆ compensation

float unravel::auto_exposure_pass::settings::compensation = 0.0f

Exposure bias in EV stops applied on top of the metered result (+1 = 2x brighter).

Definition at line 44 of file auto_exposure_pass.h.

◆ high_percentile

float unravel::auto_exposure_pass::settings::high_percentile = 0.95f

Upper fraction kept before excluding the brightest (weighted) pixels.

Definition at line 53 of file auto_exposure_pass.h.

◆ low_percentile

float unravel::auto_exposure_pass::settings::low_percentile = 0.50f

Fraction of the darkest (weighted) pixels excluded from the average.

Definition at line 51 of file auto_exposure_pass.h.

◆ max_ev

float unravel::auto_exposure_pass::settings::max_ev = 0.0f

Upper clamp for metered scene brightness in EV100. A HIGHER value lets the system DARKEN bright scenes more. This engine's lighting is authored at a fixed reference exposure rather than calibrated to physical cd/m2, so the default pins the bright end at the authored peak (exposure ~= 1/1.2) to keep daylight looking like daylight. Raise it only if you want bright scenes (e.g. staring at the sky) to tone down below the authored level.

Definition at line 42 of file auto_exposure_pass.h.

◆ metering_area

float unravel::auto_exposure_pass::settings::metering_area = 0.7f

Relative radius (in normalized device coords) of the metering region. For center_weighted this is the Gaussian sigma; for spot it is the hard cutoff radius.

Definition at line 58 of file auto_exposure_pass.h.

◆ metering_mode

exposure_metering_mode unravel::auto_exposure_pass::settings::metering_mode = exposure_metering_mode::center_weighted

How pixels are spatially weighted when metering scene luminance.

Definition at line 55 of file auto_exposure_pass.h.

◆ min_ev

float unravel::auto_exposure_pass::settings::min_ev = -4.0f

Lower clamp for metered scene brightness in EV100. A LOWER value lets the system BRIGHTEN dark scenes more (eye adaptation walking into shadow). -1 keeps brightening subtle (~1 stop), which matches this engine's authored look.

Definition at line 35 of file auto_exposure_pass.h.


The documentation for this struct was generated from the following file: