Logarithmic_Exposure_Control - superclass: ToneOperator; super-superclass:MAXWrapper - classID: #(1488218187, 1350530793)
TheLogarithmic Exposure Control uses brightness, contrast, and whether the scene is outdoors in daylight to map physical values to RGB values. Logarithmic Exposure Control is better for scenes with a very high dynamic range.
Constructors
Logarithmic_Exposure_Control ... LightscapeExposureControl ...
Properties
<Logarithmic_Exposure_Control>.active Boolean default: true -- boolean
Enable/Disable the Tone Operator. Changes the state of the Active checkbox in the Environment/Exposure Control rollout
<Logarithmic_Exposure_Control>.brightness Float default: 65.0 -- animatable; float
Get/Set the Brightness value of the Tone Operator.
<Logarithmic_Exposure_Control>.chromaticAdaptation Boolean default: false -- boolean; Chromatic_Adaptation
Get/Set the Chromatic Adaptation value of the Tone Operator. Corresponds to the Color Correction checkbox in the Tone Operator’s rollout.
<Logarithmic_Exposure_Control>.colorDifferentiation Boolean default: false -- boolean; Color_Differentiation
Get/Set the Color Differentiation value of the Tone Operator. Corresponds to the Desaturate Low Levels checkbox in the Tone Operator’s rollout.
<Logarithmic_Exposure_Control>.contrast Float default: 50.0 -- animatable; float
Get/Set the Contrast value of the Tone Operator.
<Logarithmic_Exposure_Control>.daylight Boolean default: true -- boolean
Get/Set the Daylight switch of the Tone Operator.
<Logarithmic_Exposure_Control>.exterior Boolean default: false -- boolean
Get/Set the Exterior switch of the Tone Operator.
<Logarithmic_Exposure_Control>.indirectOnly Boolean default: false -- boolean; Indirect_Only
Get/Set the IndirectOnly switch of the Tone Operator. Corresponds to the"Affect Indirect Only"checkbox in the UI.
<Logarithmic_Exposure_Control>.midTones Float default: 1.0 -- animatable; float; Mid_Tones
Get/Set the Exterior value of the Tone Operator.
<Logarithmic_Exposure_Control>.physicalScale Float default: 1500.0 -- animatable; float; Physical_Scale
Get/Set the physicalScale value of the Tone Operator.
<Logarithmic_Exposure_Control>.processBG Boolean default: false -- boolean; Process_Background
Get/Set the state of the processBG value corresponding to the"Process Background and Environment Maps"checkbox in the Tone Operator’s rollout. When set to true
, the Tone Operator will affect the background.
<Logarithmic_Exposure_Control>.whiteColor Color default: (color 255 255 255) -- animatable; RGB color; White_Color
Get/Set the whiteColor
value of the Tone Operator. When the chromaticAdaptation
is set to true
, the Tone Operator will shift all colors so that the color set in whiteColor
appears as white.
<Logarithmic_Exposure_Control>.exteriorDaylight Boolean default: false -- boolean; Exterior_Daylight
Set this property to true when working with exterior Daylight scenes.
<Logarithmic_Exposure_Control>.useLegacyAlgorithm (Use_Legacy_Algorithm) : boolean
When set to true, the exposure control will use the old algorithm (pre- 3ds Max 9). When set to false (default), the new algorithm will be used.
Thetone mapping algorithm used in the logaricthimic exposure control has been changed in 3ds Max 9.
The old algorithm would scale all three color components (R, G, B) in an identical manner, based on the perceptible luminance of the color. The algorithm produces results which were usually over-saturated, and yellowish.
The new algorithm maps the three color components independently, and the perceptible luminance is not taken into account. This results in images which are much less saturated (more grey) and much more realistic.
EXAMPLE
--Create a new Logarithmic Exposure Control Tone Operator instance log_exposure =Logarithmic_Exposure_Control () --> ReferenceTarget:Logarithmic_Exposure_Control --Assign the new tone operator as the current exposure control SceneExposureControl.exposureControl = log_exposure --> ReferenceTarget:Logarithmic_Exposure_Control --Set the Brightness to 50.0 log_exposure.brightness = 50.0 --> 50.0 --Enable the Color Correction of the current exposure control SceneExposureControl.exposureControl.chromaticAdaptation = true --> true