Post-processing and volumes

Tonemapping, exposure, bloom, depth of field and grading, and how post-process volumes blend them by priority as the camera moves.

Last updated Oct 31, 2026Edit this pageVersion 1.0.0

The post-processing chain turns the lit HDR image into the final frame: depth of field, motion blur, auto-exposure, bloom, tonemapping, color grading, lens flare and sharpening. Each scene has a baseline set of post-process values. Volumes override those values in regions of the world, or everywhere, and blend between each other as the camera moves.

The post chain

  1. DoF
  2. Motion blur
  3. Auto-exposure
  4. Bloom
  5. Temporal upscale
  6. Tonemap + grading
  7. Post-process material
  8. TAA
  9. Lens flare
  10. FXAA / CAS
Post-processing order. See Frame pipeline for where it sits in the frame.
EffectNotesMain controls
Depth of fieldCircle of confusion from depth; a separable gaussian below Epic, a circular bokeh disk at Epic and Cinematicr.DoF.Bokeh (-1 tier, 0 gaussian, 1 disk)
Motion blurTile-based; uses per-object velocity when available. Off at Low. Skipped on a view's first frame, on a camera cut (a jump of more than 25 m or a turn past 90 degrees) and on the frame after a stall of more than 0.25 s, so a teleport or a load hitch never smears the picture.r.MotionBlurObject (default 1)
Auto-exposureRuns before bloom, so the bloom threshold works on exposed luminancer.AutoExposure.*
Local exposureLifts shadows and holds highlights locally after lightingr.LocalExposure (-1 scene, 0 off, 1 on)
BloomA mip chain of 4 to 6 levels depending on tier. Off at Low.r.Bloom.Mips
TonemapSee belowr.Tonemap
Color gradingContrast, saturation, white balance, lift-gamma-gain, a 3D LUT, chromatic aberration, film grainr.ColorGradingLUT (a .cube path; 1D and 3D files both load, a 1D curve is expanded to a 33-cube)
VignetteDarkens the frame edges before the tonemap, like a lens. Intensity scales the darkening and is bounded, so the corners never fall below half brightness; the default is subtle.Volume and scene settings
Post-process materialA PostProcess-domain material evaluated as a fullscreen pass after tonemappingr.PostProcessMaterial
Lens flareScreen-space ghosts and haloVolume and scene settings
SharpeningContrast-adaptive sharpening in the final passr.Sharpness (percent)

The project-wide defaults are on Project Settings > Engine > Post Process.

Tonemapping

r.Tonemap overrides the scene's operator:

ValueOperator
-1The scene's setting
0ACES (fitted curve)
1AgX
2Reinhard
3Clamp
4ACES reference transform with an output transform for the display ()
5A display LUT from r.DisplayLUT or the scene, a .cube file indexed in log2 stops around mid-grey; falls back to 4 without one

For HDR displays, see Display, frame rate and HDR.

Exposure

Manual exposure is a multiplier, default 1.8. Turn on the physical camera in the scene's post-process settings to expose from f-stop, shutter time and ISO instead; the multiplier is then ignored.

Auto-exposure is on at every tier. Metering is average, spot, center-weighted or a histogram percentile window (r.AutoExposure.Metering). The variables below override the scene's values for testing:

VariableMeaning
r.AutoExposure.EVCompensation in stops added on top of the scene's
r.AutoExposure.MinEV, r.AutoExposure.MaxEVLimits of the adapted exposure in stops. Lower the maximum to stop a dark scene being lifted to grey.
r.AutoExposure.SpeedUp, r.AutoExposure.SpeedDownAdaptation rates toward brighter and darker scenes
r.AutoExposure.LowPercent, r.AutoExposure.HighPercentThe percentile window for histogram metering

The exposure limits belong on volumes in a real scene: a dark room can lower the ceiling and release it outdoors.

Accessibility

After the tonemap, r.ColorBlind.Mode applies color-vision correction (1 protanopia, 2 deuteranopia, 3 tritanopia) at r.ColorBlind.Strength. r.ColorBlind.Simulate previews the frame as a viewer with that deficiency sees it. r.DisplayGamma (1.8 to 2.6, default 2.2) re-encodes the SDR image for the player's panel.

Volumes

A volume is a zone that overrides post-process settings. Each setting in a volume profile is a slot with an override flag, and only the flagged slots change anything (VolumeProfile).

Place a volume

In the editor's Place Actors palette, the Volumes category has Post Process Volume (APostProcessVolume) and the generic Volume (AVolumeActor). They are the same actor: a post-process volume is a volume under the name Unreal users look for.

The volume component

FieldRangeMeaning
Globalon/offA global volume always contributes. A local volume contributes when the camera is inside its box or within its Blend Distance. On by default.
Half Extents0.1 to 1000Half-size of the box around the entity's position. Used only when not global.
Priority-100 to 100Lower priorities blend first; higher ones override them. With equal priorities the later one wins.
Blend Distance0 to 50Distance outside the box over which the influence fades to zero, in world units.
Weight0 to 1A multiplier on the volume's influence. Animate it to crossfade two volumes.
Profile Asset.mvolumeA shared profile. When set, it wins over the inline profile.

How volumes blend

Every frame, for each camera, VolumeManager::Evaluate runs this sequence (VolumeManager):

  1. Seed from the scene's baseline
  2. Weigh each enabled volume at the camera
  3. Sort by priority, low to high
  4. Blend each volume's overridden slots
  5. Write the result to ScenePostProcess
Volume evaluation. With no volumes the result is the baseline, unchanged.
  • Numeric values (floats and colors) lerp toward the volume's value by its weight.
  • Discrete values (switches, integers, the AA mode) snap to the volume's value when its weight is at least 0.5.
  • The LUT path is discrete and the LUT strength lerps, so crossing between two LUT volumes crossfades the grade.

The renderer reads the blended ScenePostProcess at BeginScene, so it needs no knowledge of volumes.

What a profile can override

GroupSlots
Tonemap and exposureTonemap on/off, exposure; auto-exposure metering, compensation, minimum and maximum EV, adaptation speeds, low and high percentiles
BloomOn/off, intensity, threshold, clamp
SSAOOn/off, radius, intensity, bias
SSROn/off, intensity, max distance, max steps, thickness, roughness cutoff
Anti-aliasingScene AA mode
Color gradingContrast, saturation, temperature, lift, gamma, gain, LUT path and strength, post-process material path
Vignette, chromatic aberration, film grainOn/off and their parameters
Depth of fieldOn/off, focus distance, focus range, max blur
Motion blurOn/off, intensity, max velocity
Lens flareOn/off, intensity, threshold, ghost count, ghost spacing, halo radius

Set up a post-process volume

  1. Place a volume

    Drag a Post Process Volume from the Volumes category of the Place Actors palette into the scene.

  2. Choose global or local

    Leave Global on for a scene-wide look. Turn it off, then set Half Extents to cover a room or area and Blend Distance for a soft transition as the camera approaches.

  3. Override the settings you want

    In the component's profile, switch on the override for each setting you want to change, for example Bloom intensity or Saturation, and set its value. Everything you leave off falls through to the scene or lower-priority volumes.

  4. Set the priority

    Give the local volume a higher Priority than your global volume so it wins inside its box.

  5. Share the profile (optional)

    Save the profile as a .mvolume asset and assign it to Profile Asset on several volumes. Opening a .mvolume in the Volume Profile editor previews it in the viewport at full weight, above every placed volume.

Mowo Editor with a Post Process Volume selected inside a cave entrance, the box drawn in the viewport, and the Details panel showing the Volume component with Global unchecked, Half Extents 10 x 6 x 20, Priority 10, Blend Distance 3, Weight 1, and the profile section with the Bloom and Color Grading overrides switched on
A local volume with two groups of overrides.

Blend profiles in code

VolumeManager::Blend applies the same rules the renderer uses, so you can compute what a weight resolves to:

BlendProfiles.cpp
#include "Volumes/VolumeManager.h"
#include "Volumes/VolumeProfile.h"

Mowo::VolumeProfile result;

Mowo::VolumeProfile cave;
cave.bloomIntensity = Mowo::VolumeOverride<float>(true, 0.4f);
cave.saturation = Mowo::VolumeOverride<float>(true, 0.6f);
cave.vignetteEnabled = Mowo::VolumeOverride<bool>(true, true);

Mowo::VolumeManager::Blend(result, cave, 0.75f);

const float bloom = result.bloomIntensity.value;
const bool vignette = result.vignetteEnabled.value;

(void)bloom;
(void)vignette;

On disk, a profile stores only its overridden slots, so an empty profile is an empty node (FVolumeProfileSerialize).

API reference

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit df96684dd.

  • Engine/Source/Runtime/Volumes/Public/Volumes/VolumeManager.h
  • Engine/Source/Runtime/Volumes/Public/Volumes/VolumeProfile.h
  • Engine/Source/Runtime/Volumes/Public/Volumes/VolumeProfileSerialize.h
  • Engine/Source/Runtime/Volumes/Public/Volumes/Components/VolumeComponent.h
  • Engine/Source/Runtime/Game/Public/Game/APostProcessVolume.h
  • Engine/Source/Runtime/Renderer/Public/Renderer/RenderFrameData.h
  • Engine/Source/Runtime/SceneRenderer/Public/Renderer/AcesOutputTransform.h

Page feedback

Was this page helpful?