Color Shift

Color Shift operator properties for Script Engine. Shifts colour balance separately in three tonal ranges — shadows, midtones and highlights — along the classic colour-grading axes (Cyan/Red, Magenta/Green, Yellow/Blue). Useful for removing colour casts (warming up shadows, cooling down highlights), creating cinematic teal-and-orange looks, matching the colour signature of one camera to another, or fixing mixed-lighting scenes where shadows and highlights take on different tints. Use ColorAdjustOperator for global tonal changes or CurvesOperator for finer shaping.

Property Type Access Description
CyanRedShadowsBalance float get/set Cyan/Red balance in shadows. [min=-100, max=100, default=0]. 0 leaves shadows untouched. Negative values push shadows towards cyan (cooler); positive values push shadows towards red (warmer). Small values (±10–20) are typical for cinematic looks; large values quickly look unnatural.
MagentaGreenShadowsBalance float get/set Magenta/Green balance in shadows. [min=-100, max=100, default=0]. 0 leaves shadows untouched. Negative values push shadows towards magenta; positive values push shadows towards green. Useful for correcting fluorescent-lit shadows that pick up a greenish tint.
YellowBlueShadowsBalance float get/set Yellow/Blue balance in shadows. [min=-100, max=100, default=0]. 0 leaves shadows untouched. Negative values push shadows towards yellow (warmer); positive values push shadows towards blue (cooler). Cool shadows + warm highlights is the foundation of the classic teal-and-orange look.
CyanRedMidtonesBalance float get/set Cyan/Red balance in midtones. [min=-100, max=100, default=0]. 0 leaves midtones untouched. Strongly affects skin tones — small positive values add healthy warmth; negative values can give a sickly or cold appearance.
MagentaGreenMidtonesBalance float get/set Magenta/Green balance in midtones. [min=-100, max=100, default=0]. 0 leaves midtones untouched. The most common axis for fixing fluorescent-lighting green casts on faces — try small negative values (push towards magenta).
YellowBlueMidtonesBalance float get/set Yellow/Blue balance in midtones. [min=-100, max=100, default=0]. 0 leaves midtones untouched. The classic warm/cool midtone control — equivalent to shifting overall colour temperature on midtones only.
CyanRedHighlightsBalance float get/set Cyan/Red balance in highlights. [min=-100, max=100, default=0]. 0 leaves highlights untouched. Negative values push highlights towards cyan; positive values push them towards red. Watch for visible discolouration in white objects when using strong values.
MagentaGreenHighlightsBalance float get/set Magenta/Green balance in highlights. [min=-100, max=100, default=0]. 0 leaves highlights untouched. Negative values push highlights towards magenta; positive values towards green. Useful for fine-tuning sky tones or removing tint from bright clouds.
YellowBlueHighlightsBalance float get/set Yellow/Blue balance in highlights. [min=-100, max=100, default=0]. 0 leaves highlights untouched. Negative values warm highlights (towards yellow); positive values cool them (towards blue). Combine with warm shadows for a balanced cinematic look or with cool shadows for the "teal & orange" style.
PreserveLuminance bool get/set When on, brightness is held constant while colours are shifted. On preserves the original brightness/exposure of the image, so only colour balance changes — usually the safer default. Off lets colour shifts also push brightness up or down, which can produce stronger but less predictable looks.
ResetCmd Command get Reset all settings to their defaults (all nine balance sliders to 0).

Inherits from: AbstractOperator, AbstractAudioMetering.

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