Env tonemap controller

It controls the HDR tonemapping for the player. Think of it as a method of controlling the exposure of the player's eyes. Tonemapping affect all players in multiplayer. HDR settings should normally be changed through triggers, whenever transitioning between environments of different light levels.

Class hierarchy
CEnvTonemapController ↳CPointEntity ↳CBaseEntity
env_tonemap_controller.cpp

Flags

Master (Has priority if multiple env_tonemap_controllers exist) Template:L4D add : [1]

Keyvalues

Name (targetname) <string>[ Edit ]

The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.

See also:  Generic Keyvalues, Inputs and Outputs available to all entities

bUseNextGenBloom (bUseNextGenBloom) <choices> (only in )

• 0: NO
• 1: YES

bUseCusBloomNG_Threshold (bUseCusBloomNG_Threshold) <choices> (only in )

• 0: NO
• 1: YES

Important:Most new Black Mesa keyvalues and I/O doesn't work if this keyvalue use choice NO.

Examples

NO (Bloom old) YES (Bloom new)

fCusBloomNG_Threshold (fCusBloomNG_Threshold) <float> (only in )

threshold for bright pass filter

bUseCusBloomNG_tintExponent (bUseCusBloomNG_tintExponent) <choices> (only in )

• 0: NO
• 1: YES

m_fCustomBloomNextGen_r (m_fCustomBloomNextGen_r) <float> (only in )

m_fCustomBloomNextGen_r

m_fCustomBloomNextGen_g (m_fCustomBloomNextGen_g) <float> (only in )

m_fCustomBloomNextGen_g

m_fCusBloomNG_exponent (m_fCusBloomNG_exponent) <float> (only in )

m_fCusBloomNG_exponent

Inputs

SetTonemapScale <floatRedirectInput/float> (not in )

Sets the player's tonemap scale. It should be a value between 0 and 2, where 0 is the eyes fully closed, 1 is use the unchanged autoexposure (default), and 2 is the eye fully wide open.

BlendTonemapScale <stringRedirectInput/string> (not in )

Blends from the player's current tonemap scale to a new one. The parameter syntax is as follows: <target tonemap scale> <blend duration>. For example: 0.5 10 would blend from the current tonemap scale to 0.5 over a period of 10 seconds.

UseDefaultAutoExposure

Reverts to using the default tonemap auto exposure.

UseDefaultBloomScale  !FGD

Reverts to using the default bloom scale.

SetAutoExposureMin <floatRedirectInput/float>

Sets a custom tonemap auto exposure minimum.

SetAutoExposureMax <floatRedirectInput/float>

Sets a custom tonemap auto exposure maximum.

SetBloomScale <floatRedirectInput/float>

Sets a custom bloom scale.

SetBloomScaleRange <vectorRedirectInput/Vector> !FGD

Sets a range for the bloom scale. First number is the maximum, second number is the minimum.

Bug:Broken. The code that processes this input has its formatting and source reversed.  [todo tested in ?]

SetTonemapRate <floatRedirectInput/float>

Sets the rate for autoexposure adjustment (mat_hdr_manual_tonemap_rate).

SetBloomExponent <floatRedirectInput/float> (in all games since )

Sets a custom bloom exponent.

SetBloomSaturation <floatRedirectInput/float> (in all games since )

Sets a custom bloom saturation.

SetTonemapPercentBrightPixels <floatRedirectInput/float> (only in )

Sets a target percentage of pixels to maintain above a certain brightness. (default: 1)

SetTonemapPercentTarget <floatRedirectInput/float> (only in )

Sets the brightness that the percentage of pixels defined by SetTonemapPercentBrightPixels should be kept above. (default: 45)

SetTonemapMinAvgLum <floatRedirectInput/float> (only in )

Sets custom tonemapping param (default: 3).^[Clarify]

InputSetBloomNxtGen_Threshold <floatRedirectInput/float> (only in )

InputSetBloomNxtGen_Threshold

Determines the influence of tonemapping; with high values, only brightest parts of frame will be bloomed.

An example of what it does.

0 (Very high values are used here for RGB) 20

InputSetBloomNxtGen_TintR <floatRedirectInput/float> (only in )

InputSetBloomNxtGen_TintR

An example of what it does.

Default. 20

InputSetBloomNxtGen_TintG <floatRedirectInput/float> (only in )

InputSetBloomNxtGen_TintG

An example of what it does.

Default. 20

InputSetBloomNxtGen_TintB <floatRedirectInput/float> (only in )

InputSetBloomNxtGen_TintB

An example of what it does.

Default. 20

InputSetBloomNxtGen_Exponent <floatRedirectInput/float> (only in )

InputSetBloomNxtGen_Exponent

See also

• HDR Lighting Settings
• BlackMesa XenEngine: Part2 – How a Frame is Rendered (page from Black Mesa developer about how a frame rendered, here also telled about the improvements for tonemapping.)