imager_white_balance

Synopsis

Use the white balance imager to correct the image's white balance with reference illuminants, custom colors, or a blackbody temperature.

input

Input points to the previous imager operation in the chain (so that you can stack them and apply multiple operations serially).

enable

Enables this imager.

Selects layers processed by this imager with a glob or operator expression. An imager can use a selection to determine what nodes will be selected to be processed by the imager at render time. The selection is an expression that can consist of multiple selections concatenated by:

or (union)
and (intersection)
not (negation)
and not (exclusion)
() for nested scoping

Each selection uses glob patterns and regular expressions and a node will be processed by the imager if the expression matches the node name. By default, glob matching is used unless the selection is in a regex quote, i.e. r'<my_regex>'. For example:

specular or diffuse
 
not r'sss_(direct|indirect)'
 
r'color_(mask1|mask2)' or r'mask[34]'

mode

White balance mode.

illuminant

Standard illuminant name for illuminante mode.


daylight (default)	sun	shade	overcast	fluorescent

cie a	cie 50	cie 55	cie 65	cie 75

cie f1	cie f2	cie f3	cie f4	cie f5

	cie f7	cie f8	cie f9	cie f10

cie f11	cie f12	halogen warm	halogen basic	halogen cool

ceramic halide warm	ceramic halide cool	quartz halide warm	quartz halide	quartz halide cool

mercury	phosphor mercury	xenon	high press sodium	low press sodium

cie a

temperature

Temperature for black body mode.

Light Type	Color Temperature in Kelvin	Hue
Overcast daylight	6000 K	130
Noontime sunlight	5000 K	58
White fluorescent	4000 K	27
Tungsten/halogen lamp	3300 K	20
Incandescent lamp (100 to 200 W)	2900 K	16
Incandescent lamp (25 W)	2500 K	12
Sunlight at sunset or sunrise	2000 K	7
Candle flame	1750 K	5