unreal.CameraExposureSettings

class unreal.CameraExposureSettings(method=AutoExposureMethod.AEM_HISTOGRAM, low_percent=80.0, high_percent=98.300003, min_brightness=-10.0, max_brightness=20.0, speed_up=3.0, speed_down=1.0, bias=0.0, bias_curve=None, histogram_log_min=-10.0, histogram_log_max=20.0, calibration_constant=16.0)

Bases: unreal.StructBase

Camera Exposure Settings

C++ Source:

  • Module: Engine
  • File: Scene.h

Editor Properties: (see get_editor_property/set_editor_property)

  • bias (float): [Read-Write] Logarithmic adjustment for the exposure. Only used if a tonemapper is specified. 0: no adjustment, -1:2x darker, -2:4x darker, 1:2x brighter, 2:4x brighter, …
  • bias_curve (CurveFloat): [Read-Write] Exposure compensation based on the scene EV100. Used to calibrate the final exposure differently depending on the average scene luminance. 0: no adjustment, -1:2x darker, -2:4x darker, 1:2x brighter, 2:4x brighter, …
  • calibration_constant (float): [Read-Write] Calibration constant for 18% albedo.
  • high_percent (float): [Read-Write] The eye adaptation will adapt to a value extracted from the luminance histogram of the scene color. The value is defined as having x percent below this brightness. Higher values give bright spots on the screen more priority but can lead to less stable results. Lower values give the medium and darker values more priority but might cause burn out of bright spots. >0, <100, good values are in the range 80 .. 95
  • histogram_log_max (float): [Read-Write] temporary exposed until we found good values 4: 16, 8: 256
  • histogram_log_min (float): [Read-Write] temporary exposed until we found good values, -8: 1/256, -10: 1/1024
  • low_percent (float): [Read-Write] The eye adaptation will adapt to a value extracted from the luminance histogram of the scene color. The value is defined as having x percent below this brightness. Higher values give bright spots on the screen more priority but can lead to less stable results. Lower values give the medium and darker values more priority but might cause burn out of bright spots. >0, <100, good values are in the range 70 .. 80
  • max_brightness (float): [Read-Write] A good value should be positive (2 is a good value). This is the maximum brightness the auto exposure can adapt to. It should be tweaked in a bright lighting situation (too small: image appears too bright, too large: image appears too dark). Note: Tweaking emissive materials and lights or tweaking auto exposure can look the same. Tweaking auto exposure has global effect and defined the HDR range - you don’t want to change that late in the project development. Eye Adaptation is disabled if MinBrightness = MaxBrightness
  • method (AutoExposureMethod): [Read-Write] Luminance computation method
  • min_brightness (float): [Read-Write] A good value should be positive near 0. This is the minimum brightness the auto exposure can adapt to. It should be tweaked in a dark lighting situation (too small: image appears too bright, too large: image appears too dark). Note: Tweaking emissive materials and lights or tweaking auto exposure can look the same. Tweaking auto exposure has global effect and defined the HDR range - you don’t want to change that late in the project development. Eye Adaptation is disabled if MinBrightness = MaxBrightness
  • speed_down (float): [Read-Write] >0
  • speed_up (float): [Read-Write] >0
bias

(float) – [Read-Write] Logarithmic adjustment for the exposure. Only used if a tonemapper is specified. 0: no adjustment, -1:2x darker, -2:4x darker, 1:2x brighter, 2:4x brighter, …

bias_curve

(CurveFloat) – [Read-Write] Exposure compensation based on the scene EV100. Used to calibrate the final exposure differently depending on the average scene luminance. 0: no adjustment, -1:2x darker, -2:4x darker, 1:2x brighter, 2:4x brighter, …

calibration_constant

(float) – [Read-Write] Calibration constant for 18% albedo.

high_percent

(float) – [Read-Write] The eye adaptation will adapt to a value extracted from the luminance histogram of the scene color. The value is defined as having x percent below this brightness. Higher values give bright spots on the screen more priority but can lead to less stable results. Lower values give the medium and darker values more priority but might cause burn out of bright spots. >0, <100, good values are in the range 80 .. 95

histogram_log_max

**(float)* – [Read-Write] temporary exposed until we found good values 4* – 16, 8: 256

histogram_log_min

**(float)* – [Read-Write] temporary exposed until we found good values, -8* – 1/256, -10: 1/1024

low_percent

(float) – [Read-Write] The eye adaptation will adapt to a value extracted from the luminance histogram of the scene color. The value is defined as having x percent below this brightness. Higher values give bright spots on the screen more priority but can lead to less stable results. Lower values give the medium and darker values more priority but might cause burn out of bright spots. >0, <100, good values are in the range 70 .. 80

max_brightness

(float) – [Read-Write] A good value should be positive (2 is a good value). This is the maximum brightness the auto exposure can adapt to. It should be tweaked in a bright lighting situation (too small: image appears too bright, too large: image appears too dark). Note: Tweaking emissive materials and lights or tweaking auto exposure can look the same. Tweaking auto exposure has global effect and defined the HDR range - you don’t want to change that late in the project development. Eye Adaptation is disabled if MinBrightness = MaxBrightness

method

(AutoExposureMethod) – [Read-Write] Luminance computation method

min_brightness

(float) – [Read-Write] A good value should be positive near 0. This is the minimum brightness the auto exposure can adapt to. It should be tweaked in a dark lighting situation (too small: image appears too bright, too large: image appears too dark). Note: Tweaking emissive materials and lights or tweaking auto exposure can look the same. Tweaking auto exposure has global effect and defined the HDR range - you don’t want to change that late in the project development. Eye Adaptation is disabled if MinBrightness = MaxBrightness

speed_down

(float) – [Read-Write] >0

speed_up

(float) – [Read-Write] >0