Library/PackageCache/com.unity.postprocessing@2.1.6/Documentation~/Color-Grading.md

   1 # Color Grading
   2
   3 Color grading is the process of altering or correcting the color and luminance of the final image. You can think of it like applying filters in software like Instagram.
   4
   5
   6 ![](images/screenshot-grading.png)
   7
   8
   9 The **Color Grading** effect comes with three modes:
  10
  11 - **Low Definition Range:** this mode is aimed at lower-end platforms but it can be used on any platform. Grading is applied to the final rendered frame clamped in a [0,1] range and stored in a standard LUT.
  12 - **High Definition Range:** this mode is aimed at platforms that support HDR rendering. All the color operations will be applied in HDR and stored into a 3D log-encoded LUT to ensure a sufficient range coverage and precision (Alexa LogC El1000).
  13 - **External:** this mode allows you to provide a custom 3D LUT authored in an external software.
  14
  15 ### Requirements
  16
  17 - Shader Model 3
  18
  19 See the [Graphics Hardware Capabilities and Emulation](https://docs.unity3d.com/Manual/GraphicsEmulation.html) page for further details and a list of compliant hardware.
  20
  21 ## Global Settings
  22
  23
  24 ![](images/grading-1.png)
  25
  26
  27 > **Note:** these are only available for the **Low Definition Range** and **External** modes.
  28
  29 ### Properties
  30
  31 | Property       | Function                                                     |
  32 | :-------------- | :------------------------------------------------------------ |
  33 | Lookup Texture | **LDR:** A custom lookup texture (strip format, e.g. 256x16) to apply before the rest of the color grading operators. If none is provided, a neutral one will be generated internally.<br />**External**: A custom 3D log-encoded texture. **TODO:** tutorial |
  34 | Contribution   | **LDR:** How much of the lookup texture will contribute to the color grading. |
  35
  36 > **Note:** volume blending between multiple LDR lookup textures is supported but only works correctly if they're the same size. For this reason it is recommended to stick to a single LUT size for the whole project (256x16 or 1024x32).
  37
  38 ## Tonemapping
  39
  40 Tonemapping is the process of remapping HDR values of an image into a range suitable to be displayed on screen. Tonemapping should always be applied when using an HDR camera, otherwise values color intensities above 1 will be clamped at 1, altering the scenes luminance balance.
  41
  42 The **High Definition Range** mode comes with 4 tonemapping operators:
  43
  44 - **None:** no tonemapping will be applied.
  45 - **Neutral:** only does range-remapping with minimal impact on color hue & saturation and is generally a great starting point for extensive color grading.
  46 - **ACES**: uses a close approximation of the reference [ACES](http://www.oscars.org/science-technology/sci-tech-projects/aces) tonemapper for a more filmic look. Because of that, it is more contrasted than **Neutral** and has an effect on actual color hue & saturation. Note that if you enable this tonemapper all the grading operations will be done in the ACES color spaces for optimal precision and results.
  47 - **Custom:** a fully parametric tonemapper.
  48
  49
  50 ![](images/grading-2.png)
  51
  52
  53 > **Note**: these are only available for the **High Definition Range** mode.
  54
  55 ### Properties
  56
  57 > **Note**: **Custom** is the only tonemapper with settings.
  58
  59 | Property          | Function                                                     |
  60 | :----------------- | :------------------------------------------------------------ |
  61 | Toe Strength      | Affects the transition between the toe and the mid section of the curve. A value of 0 means no toe, a value of 1 means a very hard transition. |
  62 | Toe Length        | Affects how much of the dynamic range is in the toe. With a small value, the toe will be very short and quickly transition into the linear section, and with a longer value having a longer toe. |
  63 | Shoulder Strength | Affects the transition between the mid section and the shoulder of the curve. A value of 0 means no shoulder, value of 1 means a very hard transition. |
  64 | Shoulder Length   | Affects how many F-stops (EV) to add to the dynamic range of the curve. |
  65 | Shoulder Angle    | Affects how much overshot to add to the shoulder.            |
  66 | Gamma             | Applies a gamma function to the curve.                       |
  67
  68 ## White Balance
  69
  70
  71 ![](images/grading-3.png)
  72
  73
  74 ### Properties
  75
  76 | Property    | Function                                                     |
  77 | :----------- | :------------------------------------------------------------ |
  78 | Temperature | Sets the white balance to a custom color temperature.        |
  79 | Tint        | Sets the white balance to compensate for a green or magenta tint. |
  80
  81 ## Tone
  82
  83
  84 ![](images/grading-4.png)
  85
  86
  87 ### Properties
  88
  89 | Property      | Function                                                     |
  90 | :------------- | :------------------------------------------------------------ |
  91 | Post-exposure | Adjusts the overall exposure of the scene in EV units. This is applied after HDR effect and right before tonemapping so it won’t affect previous effects in the chain.<br />**Note:** Only available with the **High Definition Range** mode. |
  92 | Color Filter  | Tints the render by multiplying a color.                     |
  93 | Hue Shift     | Shifts the hue of all colors.                                |
  94 | Saturation    | Pushes the intensity of all colors.                          |
  95 | Brightness    | Makes the image brighter or darker.<br />**Note:** Only available with the **Low Definition Range** mode. |
  96 | Contrast      | Expands or shrinks the overall range of tonal values.        |
  97
  98 ## Channel Mixer
  99
 100 This is used to modify the influence of each input color channel on the overall mix of the output channel. For example, increasing the influence of the green channel on the overall mix of the red channel will adjust all areas of the image containing green (including neutral/monochrome) to become more reddish in hue.
 101
 102
 103 ![](images/grading-5.png)
 104
 105
 106 ### Properties
 107
 108 | Property | Function                                                     |
 109 | :-------- | :------------------------------------------------------------ |
 110 | Channel  | Selects the output channel to modify.                        |
 111 | Red      | Modifies the influence of the red channel within the overall mix. |
 112 | Green    | Modifies the influence of the green channel within the overall mix. |
 113 | Blue     | Modifies the influence of the blue channel within the overall mix. |
 114
 115 ## Trackballs
 116
 117 The trackballs are used to perform three-way color grading. Adjusting the position of the point on the trackball will have the effect of shifting the hue of the image towards that color in the given tonal range. Different trackballs are used to affect different ranges within the image. Adjusting the slider under the trackball offsets the color lightness of that range.
 118
 119 > **Note:** you can right-click a trackball to reset it to its default value. You can also change the trackballs sensitivity by going to `Edit -> Preferences -> PostProcessing`.
 120
 121
 122 ![](images/grading-6.png)
 123
 124
 125 ### Properties
 126
 127 | Property | Function                             |
 128 | :-------- | :------------------------------------ |
 129 | Lift     | Adjusts the dark tones (or shadows). |
 130 | Gamma    | Adjusts the mid-tones.               |
 131 | Gain     | Adjusts the highlights.              |
 132
 133 ## Grading Curves
 134
 135 Grading curves are an advanced way to adjust specific ranges in hue, saturation or luminosity in your image. By adjusting the curves on the eight available graphs you can achieve the effects of specific hue replacement, desaturating certain luminosities and much more.
 136
 137 ### YRGB Curves
 138
 139 These curves, also called `Master`, `Red`, `Green` and `Blue` affect the selected input channels intensity across the whole image. The X axis of the graph represents input intensity and the Y axis represents output intensity for the selected channel. This can be used to further adjust the appearance of basic attributes such as contrast and brightness.
 140
 141
 142 ![](images/grading-11.png)
 143
 144
 145 >  **Note:** these curves are only available with the **Low Definition Range** mode.
 146
 147 ### Hue vs Hue
 148
 149 Used to shift hues within specific ranges. This curve shifts the input hue (X axis) according to the output hue (Y axis). This can be used to fine tune hues of specific ranges or perform color replacement.
 150
 151
 152 ![](images/grading-7.png)
 153
 154
 155 ### Hue vs Sat
 156
 157 Used to adjust saturation of hues within specific ranges. This curve adjusts saturation (Y axis) according to the input hue (X axis). This can be used to tone down particularly bright areas or create artistic effects such as monochromatic except a single dominant color.
 158
 159
 160 ![](images/grading-8.png)
 161
 162
 163 ### Sat vs Sat
 164
 165 Used to adjust saturation of areas of certain saturation. This curve adjusts saturation (Y axis) according to the input saturation (X axis). This can be used to fine tune saturation adjustments made with settings from the **Tone** section.
 166
 167
 168 ![](images/grading-9.png)
 169
 170
 171 ### Lum vs Sat
 172
 173 Used to adjust saturation of areas of certain luminance. This curve adjusts saturation (Y axis) according to the input luminance (X axis). This can be used to desaturate areas of darkness to provide an interesting visual contrast.
 174
 175
 176 ![](images/grading-10.png)