Class Tonemapping

A volume component that holds settings for the tonemapping effect.

Inheritance
object
Object
ScriptableObject
VolumeComponent
Tonemapping
Implements
IPostProcessComponent
Inherited Members
VolumeComponent.active
VolumeComponent.displayName
VolumeComponent.parameters
VolumeComponent.GetHashCode()
VolumeComponent.AnyPropertiesIsOverridden()
VolumeComponent.Release()
VolumeComponent.GetSourceTerm()
ScriptableObject.CreateInstance<T>()
Object.Instantiate<T>(T)
Object.Instantiate<T>(T, Vector3, Quaternion)
Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
Object.Instantiate<T>(T, Transform)
Object.FindObjectsByType<T>(FindObjectsSortMode)
Object.FindObjectsByType<T>(FindObjectsInactive, FindObjectsSortMode)
Object.FindFirstObjectByType<T>()
Object.FindAnyObjectByType<T>()
Object.FindFirstObjectByType<T>(FindObjectsInactive)
Object.FindAnyObjectByType<T>(FindObjectsInactive)
Namespace: UnityEngine.Rendering.Universal
Assembly: Unity.RenderPipelines.Universal.Runtime.dll
Syntax
[Serializable]
[VolumeComponentMenu("Post-processing/Tonemapping")]
[SupportedOnRenderPipeline(typeof(UniversalRenderPipelineAsset))]
public sealed class Tonemapping : VolumeComponent, IApplyRevertPropertyContextMenuItemProvider, IPostProcessComponent

Fields

acesPreset

Specifies the preset for HDR displays.

Declaration
[Tooltip("Use the ACES preset for HDR displays.")]
public HDRACESPresetParameter acesPreset
Field Value
Type Description
HDRACESPresetParameter

detectBrightnessLimits

Enable to use the minimum and maximum brightness values detected from the output device. For best accuracy, considering calibrating these values manually.

Declaration
[Tooltip("Enable to use the minimum and maximum brightness values detected from the output device. For best accuracy, considering calibrating these values manually.")]
public BoolParameter detectBrightnessLimits
Field Value
Type Description
BoolParameter

detectPaperWhite

Enable to use values detected from the output device as paper white. When enabled, output images might differ between SDR and HDR. For best accuracy, set this value manually.

Declaration
[Tooltip("Enable to use values detected from the output device as paper white. When enabled, output images might differ between SDR and HDR. For best accuracy, set this value manually.")]
public BoolParameter detectPaperWhite
Field Value
Type Description
BoolParameter

hueShiftAmount

Specify how much hue to preserve. Values closer to 0 are likely to preserve hue. As values get closer to 1, Unity doesn't correct hue shifts.

Declaration
[Tooltip("Specify how much hue to preserve. Values closer to 0 are likely to preserve hue. As values get closer to 1, Unity doesn't correct hue shifts.")]
public ClampedFloatParameter hueShiftAmount
Field Value
Type Description
ClampedFloatParameter

maxNits

The maximum brightness of the screen (in nits). This value is defined by the preset when using ACES Tonemap.

Declaration
[Tooltip("The maximum brightness of the screen (in nits). This value is defined by the preset when using ACES Tonemap.")]
public ClampedFloatParameter maxNits
Field Value
Type Description
ClampedFloatParameter

minNits

The minimum brightness of the screen (in nits). This value is assumed to be 0.005f with ACES Tonemap.

Declaration
[Tooltip("The minimum brightness of the screen (in nits). This value is assumed to be 0.005f with ACES Tonemap.")]
public ClampedFloatParameter minNits
Field Value
Type Description
ClampedFloatParameter

mode

Use this to select a tonemapping algorithm to use for color grading.

Declaration
[Tooltip("Select a tonemapping algorithm to use for the color grading process.")]
public TonemappingModeParameter mode
Field Value
Type Description
TonemappingModeParameter

neutralHDRRangeReductionMode

Specifies the range reduction mode used when HDR output is enabled and Neutral tonemapping is enabled.

Declaration
[Tooltip("Specifies the range reduction mode used when HDR output is enabled and Neutral tonemapping is enabled.")]
public NeutralRangeReductionModeParameter neutralHDRRangeReductionMode
Field Value
Type Description
NeutralRangeReductionModeParameter

paperWhite

The reference brightness of a paper white surface. This property determines the maximum brightness of UI. The brightness of the scene is scaled relative to this value. The value is in nits.

Declaration
[Tooltip("The reference brightness of a paper white surface. This property determines the maximum brightness of UI. The brightness of the scene is scaled relative to this value. The value is in nits.")]
public ClampedFloatParameter paperWhite
Field Value
Type Description
ClampedFloatParameter

Methods

IsActive()

Tells if the post process needs to be rendered or not.

Declaration
public bool IsActive()
Returns
Type Description
bool

true if the effect should be rendered, false otherwise.

Implements

UnityEngine.Rendering.IPostProcessComponent