Logarithmic_Exposure_Control : ToneOperator

Logarithmic_Exposure_Control - superclass: ToneOperator; super-superclass:MAXWrapper - classID: #(1488218187, 1350530793)

 

Logarithmic 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:

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

new.gif NEW in 3ds Max 9: 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.

The tone 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

See also

Interface: SceneExposureControl

Automatic_Exposure_Control : MAXObject

Linear_Exposure_Control : ToneOperator

Pseudo_Color_Exposure_Control : ToneOperator