White Balance

White Balance operator properties for Script Engine. Corrects the colour temperature and green/magenta tint of an image to match a chosen reference. Useful for neutralising a warm tungsten cast on indoor footage, cooling down shaded outdoor scenes, removing the green tinge of fluorescent lighting, matching cameras that white-balanced differently, or applying a creative warm/cool stylisation. Includes presets for common lighting conditions (Daylight, Tungsten, Fluorescent, Shade).

Property	Type	Access	Description
`Temperature`	`int`	`get/set`	Shifts the image along the blue/orange (cool/warm) axis. [min=-100, max=100, default=0]. 0 leaves the image untouched. Negative values cool the image (more blue) — use when footage looks too warm/orange. Positive values warm it (more orange) — use when footage looks too cool/blue, e.g. shaded outdoor scenes. The presets give starting points for common lighting types.
`Tint`	`int`	`get/set`	Shifts the image along the green/magenta axis. [min=-100, max=100, default=0]. 0 leaves the image untouched. Negative values add green; positive values add magenta. The most common use is countering the slight green tint of fluorescent lighting with a small positive value (around +20 to +30).
`Strength`	`int`	`get/set`	Blend amount between the original image and the corrected image, in percent. [min=0, max=100, default=100]. 0 is the original image, 100 is the fully corrected image. Use intermediate values to dial back an aggressive correction or to gradually animate the white balance change over time.
`PreserveLuminance`	`bool`	`get/set`	When on, brightness is held constant while colours are shifted. On preserves the original exposure/brightness — only the colour balance changes, usually the safer default. Off lets the temperature and tint adjustments also push brightness slightly, which can produce stronger but less predictable looks.
`OutputMode`	`WhiteBalanceOutput`	`get/set`	Selects what the operator outputs. Default is the final corrected image. Use Final for normal operation. The other modes show only the temperature contribution, only the tint contribution, or a luminance mask — handy for understanding why a correction looks the way it does. Keyboard F1–F4 switch between modes when the panel has focus, F5 resets all values.
`ApplyDaylightPresetCmd`	`Command`	`get`	Apply the Daylight preset (~5500K) — neutral reference, sets Temperature and Tint to 0. Use as a baseline for footage shot in normal daylight conditions.
`ApplyTungstenPresetCmd`	`Command`	`get`	Apply the Tungsten preset (~3200K) — cools warm indoor incandescent lighting (Temperature=-35, Tint=+5). Use for footage shot under traditional household bulbs or stage tungsten lamps that look too orange.
`ApplyFluorescentPresetCmd`	`Command`	`get`	Apply the Fluorescent preset (~4000K) — counters the green cast of fluorescent tubes (Temperature=-15, Tint=+25). Use for office, retail and institutional lighting that gives faces a pale or sickly look.
`ApplyShadePresetCmd`	`Command`	`get`	Apply the Shade preset (~7500K) — warms cool open-shade or overcast outdoor footage (Temperature=+30, Tint=+5). Use when subjects are shot in shadow on a sunny day or under heavy clouds and look too blue.
`ResetCmd`	`Command`	`get`	Reset all settings to their defaults (Temperature=0, Tint=0, Strength=100).
`Minilog`	`FormattedMessage`	`get/set`	Latest status message from the operator (read-only). Reports which preset was applied or that values were reset.

Inherits from: AbstractOperator, AbstractAudioMetering.

See also: White Balance in Operators — user-facing introduction, screenshots, and section summaries.