Unreal Engine 5 Documentation has been moved to the Epic Developer Community

Unreal Engine 4.26

Unreal Engine 4.27

Unreal Engine 5.0

Unreal Engine 5.1

Unreal Engine 5.2

Unreal Engine 5.3

> Designing Visuals, Rendering, and Graphics > Post Process Effects > Color Grading and Filmic Tonemapper

Light Theme

Dark Theme

Color Grading and Filmic Tonemapper

Tonemapping and color correction effects for adjusting scene colors.

Beginner

Choose your operating system:

Windows

macOS

Linux

Tone Mapping

The purpose of the Tone Mapping function is to map the wide range of high dynamic range (HDR) colors into low dynamic range (LDR) that a display can output. This is the last stage of post processing that is done after the normal rendering during post processing. The process of tone mapping can be thought of as a way to simulate the response that film has to light.

Academy Color Encoding System (ACES) Filmic Tonemapper

The Filmic tonemapper that is used in UE4 matches the industry standard set by the Academy Color Encoding System (ACES) for television and film. This ensures that consistent color is preserved across multiple formats and displays while also as a way to future proof the source material since it will not have to be adjusted for each medium that comes along. The filmic tonemapper also uses the same global tonemapper that was previously used in UE4, with the exception that there is now a filmic response meaning that the S-curve shape now better simulates film stock for a better overall look.

Two places you'll immediately notice a difference is with Bloom and Exposure Levels.

Physically Correct Emissive and Bloom

Emissive values are now physically correct so that as the emissive power increases the color will become lighter, similarly to how colored lights work in the real world. As color gets tone mapped, if the final color is bright enough to start saturating the film / sensor, it will become white.

In this example, the legacy tonemapper is compared to the new filmic tonemapper. With a high enough emissive power, the color will start to become white, unlike the legacy tonemapper where values would just become overly saturated causing areas of the material to lose its detail. With the filmic tonemapper, you can even see that the Bloom in this scene retains its physical correctness as well as it is never overly saturated, thus retaining it's reflective primary color value.

Exposure Levels

Exposure levels are physically correct so that colors will continue to have shape to them rather than lose detail.

In this example, there are a variety of colors and material types with varying roughness and metalness. The Exposure Bias is also set to 0.

In this comparison, the Exposure Bias has been increased to a value of 3 so really show the response of the Filmic tonemapper compared to the legacy tonemapper implementation. Also, a value of three means that the processed image will be eight times brighter than the default value of 0 shown in the previous example above.

As the exposure level is increased, the difference between the filmic and the legacy tonemapper will become more apparent. The spheres in the filmic example will continue to have shape to their color and shading, even as they appear to look brighter. The sphere using the legacy tonemapper will start to have their colors blend with the shading. The spheres become really bright as a solid color, but you can't necessarily tell that they have a high exposure value, whereas the filmic tonemapper takes this into account. The filmic response looks like a natural camera effect if you were to increase its exposure.

Legacy Tonemapper

With Unreal Engine 4.15, the Filmic tonemapper using the ACES standard is enabled by default. Because of this change, there may be differences in appearance to your existing content. While there is no timeframe in which we plan to remove the legacy tonemapper, it will be deprecated and removed at some point in a future Unreal Engine release.

For comparison, this is the difference in an average scene taken from the Sun Temple example project available on the Epic Games Launcher under the Learn tab.

If you want to maintain the look of the legacy tonemapper for your project, we recommend using a Post Process Volume and setting the following values under the Film section:

Slope: 0.98
Toe: 0.3
Shoulder: 0.22
Black Clip: 0
White Clip: 0.025

Film Settings

In the Film section of the Post Process Volume enables you to tonemap your scene using properties that match the ACES standardized film stock. You can adjust these controls to emulate other types of film stock for your project.

It is recommended that changes to these properties be used project-wide for a specific look and not changed dynamically or on a shot-by-shot basis. Instead, you should use the Color Grading properties for any artistic adjustments.

Slope: This will adjust the steepness of the S-curve used for the tonemapper, where larger values will make the slope steeper (darker) and lower values will make the slope less steep (lighter). Value is in the range of [0.0, 1.0]. [0.0, 1.0].*
Toe: This will adjust the dark color in the tonemapper. Value is in the range of [0.0, 1.0]. [0.0, 1.0].
Shoulder: This will adjust the bright color in the tonemapper. Value is in the range of [0.0, 1.0]
Black Clip: This will set where the crossover happens where black's start to cut off their value. In general, this value should not be adjusted. Value is in the range of [0.0, 1.0]
White Clip: This will set where the crossover happens where white's start to cut off their values. This will appear as a subtle change in most cases. Value is in the range of [0.0, 1.0]

If you'd like to test different tonemapper values in a real-time grpah like the ones above, you can use the set up default UE4 Tonemapper example here.

Color Correction

Color correction, or color grading, is used to alter or enhance the overall color of light in your scene. With the advent of HDR displays, the need to preserve color before it's processed is very important. It ensures that the color will be properly displayed.

In the past, the color correction would have been implemented through Lookup Tables (LUTs) , which happens in LDR and on the final color that was output to the monitor in sRGB color space. This presents a problem when working with HDR displays because the LUT is just a snapshot in time of the currently supported display it is being adjusted for and cannot be used to the same effect on an HDR display. To solve these types of issues, the color correction controls do their work in Scene Referred Linear Space, which means all colors are captured before they are tone mapped. This makes it possible to only adjust your colors on one HDR display for any color correction to look correct on all displays the image is being outputted to, whether they are HDR or LDR.

You can learn more about the HDR pipeline and how this works for the benefit of your content in the High Dynamic Range Display Output page.

Color Correction Properties

In the Color Grading section of the Post Process Volume, you'll find the properties that enable you to have the most artistic control over the scene.

Settings



RGB	HSV

Under each section, you can use the color wheel to select and drag the color values around. You also can choose between the following modes:

RGB - This will adjust the Red, Green, Blue values.
HSV - This will adjust the Hue and Saturation values.

For more precise control over the slider values, you can hold the Shift key while dragging them.

Property

Description

White Balance

The properties in this section are used to adjust the colors in the scene so that whites appear truly white. This allows for other colors in the scene to be correctly lit under the given lighting in the scene.

Temp

This will adjust the white balance in relation to the temperature of the light in the scene. When the light temperature and this one match the light will appear white. When a value is used that is higher than the light in the scene it will yield a "warm" or yellow color, and, conversely, if the value is lower, it would yield a "cool" or blue color.

Tint

This will adjust the white balance temperature tint for the scene by adjusting the cyan and magenta color ranges. Ideally, this setting should be used once you've adjusted the white balance Temp property to get accurate colors. Under some light temperatures, the colors may appear to be more yellow or blue. This can be used to balance the resulting color to look more natural.

Global

The properties in this section are a global set of color corrections you can use for your scene.

Saturation

This will adjust the intensity (purity) of the colors (hue) that are being represented. A higher saturation intensity will result in colors appearing more like their purest forms (red, green, blue) and when saturation is lowered colors will appear more gray or washed-out.

Contrast

This will adjust the tonal range of light and dark color values in your scene. Lowering the intensity will remove highlights and lighten the image resulting in a washed-out appearance, whereas a higher intensity will tighten the highlights and darken the overall image.

Gamma

This will adjust the luminance intensity of the image's mid-tones to accurately reproduce colors. Lowering or raising this value will result in the image being washed-out or too dark.

Gain

This will adjust the luminance intensity of the image's whites (highlights) to accurately reproduce colors. Raising or lowering this value will result in the image highlights being washed-out or too dark.

Offset

This will adjust the luminance intensity of the image's blacks (shadows) to accurately reproduce colors. Raising or lowering this value will result in the image shadows being washed-out or too dark.

Scene Color Tint

This is a multiplier for color that is a filter color applied to the HDR scene color.

Color Grading LUT Intensity

A scaling factor that controls the effect of the color correction.

Color Grading LUT

The LUT texture to use as a lookup table for color correction.


Click image for full size view.	Click image for full size view.	Click image for full size view.

Shadows

The properties in this section are used to adjust the color correction values for shadows in the scene.

Saturation

Contrast

Gamma

This will adjust the luminance intensity of the image to accurately reproduce colors. Raising or lowering this value will result in the image mid-tones being washed-out or too dark.

Gain

Offset

This will adjust the luminance intensity of the image's blacks (shadows) to accurately reproduce colors. Raising or lowering this value will result in the image shadows being washed-out or too dark.

Shadows Max

This is a multiplier of the properties that affect the color correction properties that have been adjusted in the Shadows section.

Mid-tones

The properties in this section are used to adjust the color correction values for mid-tones in the scene.

Saturation

Contrast

Gamma

This will adjust the luminance intensity of the image to accurately reproduce colors. Raising or lowering this value will result in the image mid-tones being washed-out or too dark.

Gain

Offset

This will adjust the luminance intensity of the image's blacks (shadows) to accurately reproduce colors. Raising or lowering this value will result in the image shadows being washed-out or too dark.

Highlights

The properties in this section are used to adjust the color correction values for Highlights in the scene.

Saturation

Contrast

Gamma

This will adjust the luminance intensity of the image to accurately reproduce colors. Raising or lowering this value will result in the image mid-tones being washed-out or too dark.

Gain

Offset

This will adjust the luminance intensity of the image's blacks (shadows) to accurately reproduce colors. Raising or lowering this value will result in the image shadows being washed-out or too dark.

HighLights Min

This is a multiplier of the properties that affect the color correction properties that have been adjusted in the Highlights section.

Misc

Blue Correction

Correction for artefacts with "electric" blues due to the ACES color space. Bright blue desaturates instead of going violet.

Expand Gamut

Expand bright saturated colors outside the sRGB gamut to fake wide gamut rendering.

Tone Curve Amount

Allows effects of Tone Curve to be reduced. Set Tone Curve Amount and Expand Gamut to 0 to full disable tone curve.

Scene Color Tint

Use the color picker to set the color tint for the scene.

Color Grading LUT Intensity

Set the intensity of the applied color look up table (LUT). 0 is equal to no intensity and 1 applies the full intensity.

Color Grading LUT

Assign a look up table texture to use.

Workflow for Good Color Correction

These are some good habits that should be used when working with the color grading tools in your Post Process Volume.

The Film controls should be set for a project-wide look. Ideally, these properties should not be adjusted and certainly should not be adjusted dynamically or on a shot-by-shot basis. Use the Color Grading properties for this.
Start by using the Global color correction properties and doing an initial pass on your scene before touching any of the other properties. The majority of your color grading changes should be done with these properties.
You should not try to use the Gain property to adjust exposure for your scene. This should be used for fine tweaks for different colors. Instead use the Exposure Bias in the Lens > Auto-Exposure section.
Use Offset in minor amounts to make your shadowed or darkened areas a little lighter. If you want things to look a little hazy or have more bloom, then you can set a higher value, conversely if your scene is overly hazy or has too much bloom you can lower the value to subtract color from the scene.
Instead of using a Lookup Table (LUT) for coloring the scene, since that happens after tone mapping, you should use the Color Grading properties to get the look you want so that it's consistent on all displays you output to (LDR and HDR). However, it can be a good practice to quickly get a look to set the tone with a LUT and then adjust the color correction to get a similar look.

Color Grading and Filmic Tonemapper

Tonemapping and color correction effects for adjusting scene colors.

Tone Mapping

Academy Color Encoding System (ACES) Filmic Tonemapper

Physically Correct Emissive and Bloom

Exposure Levels

Legacy Tonemapper

Film Settings

Color Correction

Color Correction Properties

Settings

Workflow for Good Color Correction

Training Streams