PostVolume

Grades the look of one region of the scene — exposure, tint, saturation, bloom, vignette, grain — and blends smoothly at its edge, so a flooded room can read blue and a furnace room warm with no hard cut between them.

On this page

Add it
From a script
Fields

Guides

Effects and shaders

Add it

+ Add node → Post Volume creates a node with it already on. Already have a node for it? Add component → PostVolumeComponent.

From a script

A script on the same node writes these fields by name. PostVolumeComponent is the name to pass.

rgs

set_flag("PostVolumeComponent", "enabled", true);
set_point("PostVolumeComponent", "bounds", vec2(1920.0, 1080.0));
set_number("PostVolumeComponent", "blend", 64.0);

Fields

Field Script name Kind Default What it does

Enabled enabled checkbox on Whether this volume is in the running at all.

Area area one of Global, Box Box Whether this covers the world or a rectangle.

Bounds bounds two numbers (x, y), at least 0 (1920, 1080) Room size, centred on this node.

Blend blend number, at least 0 64 u World units inside the edge to reach full strength; zero cuts.

Priority priority number 0 Who wins. Higher folds on top.

Profile profile section — The look itself.

Field	Script name	Kind	Default	What it does
Grade
Exposure	`exposure`	number, at least 0, step 0.01	1.05	Overall exposure multiplier.
Tint	`tint`	colour, no transparency	#fffcff	Colour tint applied at the end.
Saturation	`saturation`	number, at least 0, step 0.01	1.1	One leaves colour untouched, zero is greyscale.
Vignette	`vignette`	number, 0 to 2, step 0.01	0.55	Vignette strength. Zero disables it and it costs nothing either way.
Bloom
Enabled	`bloom`	checkbox	on	Whether bloom runs at all.
Threshold	`bloom_threshold`	number, at least 0, step 0.01	0.6	Brightness above which a pixel contributes to bloom.
Intensity	`bloom_intensity`	number, at least 0, step 0.01	0.8	How strongly bloom is added back.
Blur Pairs	`blur_passes`	number, 0 to 7	2	How many rounds of blur to run.
Spread	`bloom_spread`	number, 1 to 8, step 0.1	1	How wide the glow spreads: one is the plain blur, higher reaches further for no extra cost.
Film
Aberration	`aberration`	number, at least 0, step 0.05	0	How far the colour channels separate at the edge of the screen, in pixels.
Grain	`grain`	number, at least 0, step 0.01	0	Grain intensity, as a fraction of full range.
Grain Rolloff	`grain_response`	number, 0 to 1, step 0.01	0.85	How far the grain backs off as a pixel approaches white.