Logarithmic_Exposure_Control : ToneOperator

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.

Note: The Logarithmic Exposure Control is the best type of exposure control for animations, since it doesn't use histograms.

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