Hue Shift
Hue Shift operator properties for Script Engine. Selects a band of colours around a centre hue and shifts that band's hue, saturation or luminance independently of the rest of the image. Useful for changing the colour of a specific object (e.g. recolouring a red car to blue), boosting just the greens in foliage, taming an overly saturated logo, or pulling brightness out of a noisy colour. Pick a centre hue plus a tolerance/softness range, then dial in the desired transformation.
| Property | Type | Access | Description |
|---|---|---|---|
Hue |
int |
get/set |
Centre hue of the band to affect, in degrees around the colour wheel. [min=-180, max=180, default=0]. 0 ≈ red, ±60 ≈ yellow/magenta, ±120 ≈ green/blue, ±180 ≈ cyan. Pick the dominant colour of the object you want to target. Combine with HueTolerance and HueSoftness to control how wide a band gets affected. |
HueTolerance |
int |
get/set |
Width of the fully-affected band around the centre hue, in degrees. [min=0, max=100, default=0]. 0 affects an extremely narrow slice of colours. Larger values widen the band — try 20–40 for typical "select a colour family" work. Combined with HueSoftness to give a hard inner band plus a softer falloff. |
HueSoftness |
int |
get/set |
Falloff width outside the tolerance band, in degrees. [min=0, max=100, default=0]. 0 produces a hard edge — colours are either fully affected or not at all. Larger values fade the effect smoothly into adjacent hues, which avoids sharp colour boundaries on objects whose colour varies (e.g. shaded skin, mixed-colour fabric). |
HueTransform |
int |
get/set |
How far to rotate the selected hues around the colour wheel, in degrees. [min=-180, max=180, default=0]. 0 leaves hues alone. ±60 shifts to a neighbouring colour family; ±180 sends them to the complementary colour. The classic "change the colour of an object" control — e.g. centre on red and set to +120 to turn red things green. |
SaturationTransform |
int |
get/set |
Saturation change applied only to the selected hue band. [min=-100, max=100, default=0]. 0 leaves saturation untouched. -100 fully desaturates the selected colour family (useful for "isolate one colour, drain the rest" looks when combined with an inverted selection workflow). Positive values intensify just the targeted colour. |
LuminanceTransform |
int |
get/set |
Brightness change applied only to the selected hue band. [min=-100, max=100, default=0]. 0 leaves brightness untouched. Positive values lift the selected colour (e.g. brighten blue skies); negative values darken it (e.g. deepen blues for a moodier look). |
ResetCmd |
Command |
get |
Reset all settings to their defaults (Hue, Tolerance, Softness, all transforms set to 0). |
Inherits from: AbstractOperator, AbstractAudioMetering.
See also: Hue Shift in Operators — user-facing introduction, screenshots, and section summaries.