ColorGrading

ColorGrading is used to transform (modify or correct) the colors of the HDR buffer.

Color grading transforms are applied after lighting and lens effects (like bloom), and include tone mapping. ColorGrading allows adjusting image properties like exposure, contrast, saturation, temperature, tint, shadows, midtones, and highlights. These adjustments are applied through a lookup table (LUT) for efficient processing.

Creation and usage: A ColorGrading object is created using the Builder and destroyed with Engine.destroy. A ColorGrading object is meant to be set on a View.

Order of operations: The various transforms are applied in the following order:

1. Exposure

2. Night adaptation

3. White balance

4. Channel mixer

5. Shadows/mid-tones/highlights

6. Slope/offset/power (CDL)

7. Contrast

8. Vibrance

9. Saturation

10. Curves

11. Tone mapping

12. Luminance scaling

13. Gamut mapping

Performance note: Creating a ColorGrading object may be more expensive than other Filament objects as a LUT may need to be generated, which may happen on the CPU.

See also