Class Tonemapping
A volume component that holds settings for the Tonemapping effect.
Inherited Members
Namespace: UnityEngine.Rendering.HighDefinition
Assembly: Unity.RenderPipelines.HighDefinition.Runtime.dll
Syntax
[Serializable]
[VolumeComponentMenu("Post-processing/Tonemapping")]
[SupportedOnRenderPipeline(typeof(HDRenderPipelineAsset))]
public sealed class Tonemapping : VolumeComponent, IApplyRevertPropertyContextMenuItemProvider, IPostProcessComponent
Fields
Name | Description |
---|---|
acesPreset | Specifies the preset to be used for HDR displays. |
detectBrightnessLimits | Whether to use the minimum and maximum brightness values detected from the output device. It might be worth considering calibrating this values manually if the results are not the desired ones. |
detectPaperWhite | Whether to use values detected from the output device as paperwhite. This value will often not lead to equivalent images between SDR and HDR. It is suggested to manually set this value. |
fallbackMode | Specifies the fallback tonemapping algorithm to use when outputting to an HDR device, when the main mode is not supported. |
gamma | Sets a gamma correction value that HDRP applies to the whole curve. This parameter is only used when Custom is set. |
hueShiftAmount | How much hue we want to preserve. Values closer to 0 try to preserve hue, while as values get closer to 1 hue shifts are reintroduced. |
lutContribution | How much of the lookup texture will contribute to the color grading effect. This parameter is only used when External is set. |
lutTexture | A custom 3D texture lookup table to apply. This parameter is only used when External is set. |
maxNits | The maximum brightness (in nits) of the screen. Note that this is assumed to be defined by the preset when ACES Tonemap is used. |
minNits | The minimum brightness (in nits) of the screen. Note that this is assumed to be 0.005f with ACES Tonemap. |
mode | Specifies the tonemapping algorithm to use for the color grading process. |
neutralHDRRangeReductionMode | Specifies the range reduction mode used when HDR output is enabled and Neutral tonemapping is enabled. |
paperWhite | The paper white value. It controls how bright a paper white surface should be, it also determines the maximum brightness of UI. The scene is also scaled relative to this value. Value in nits. |
shoulderAngle | Controls how much overshoot to add to the shoulder. This parameter is only used when Custom is set. |
shoulderLength | Sets how many F-stops (EV) to add to the dynamic range of the curve. This parameter is only used when Custom is set. |
shoulderStrength | Controls the transition between the midsection and the shoulder of the curve. A value of 0 results in no transition and a value of 1 results in a very hard transition. This parameter is only used when Custom is set. |
toeLength | Controls how much of the dynamic range is in the toe. Higher values result in longer toes and therefore contain more of the dynamic range. This parameter is only used when Custom is set. |
toeStrength | Controls the transition between the toe and the mid section of the curve. A value of 0 results in no transition and a value of 1 results in a very hard transition. This parameter is only used when Custom is set. |
useFullACES | Whether to use full ACES tonemap instead of an approximation. |
Methods
Name | Description |
---|---|
IsActive() | Tells if the effect needs to be rendered or not. |
ValidateLUT() | Validates the format and size of the LUT texture set in lutTexture. |