HSV Grade
Grade colour selectively by hue, saturation, or value range. Wire Curve nodes into the adjustment parameters for per-hue control.
What it does
HSV Grade isolates a range of colour and adjusts it independently of the rest, the secondary correction of a traditional grading suite. Target picks how the range is selected: Hue takes a band of colours, Saturation takes pixels by how vivid they are, Value takes them by brightness. Everything inside the band is pushed by the Range Hue, Saturation and Lightness controls, with a Falloff that blends the edit in rather than cutting a hard line. Master Hue, Saturation and Lightness grade the whole image, and Mix blends between the original and graded result.
A Curve wired into any of the range adjustment inputs varies that adjustment continuously across the hue wheel instead of applying one flat value to the whole selection.
When to use it
Shifting one colour while the rest stays put: bluer sky, warmer skin tones.
Desaturating or boosting only the most vivid colours, or only the shadows or highlights.
A broad, whole-image grade, through the Master controls or a low Mix for a subtle push.
Per-hue control beyond what a single slider expresses: wire a Curve into a range adjustment input.
| Parameter | Type | Default | What it does |
|---|---|---|---|
content_in | Color Field or Volume or Primitives or Collection or GPU Geometry or Geometries or Color or Color[] | — | Input image to grade |
target | String | "Hue" | Target dimension: Hue = select by color, Saturation = select by vividness, Value = select by brightness. One of: Hue, Saturation, Value. |
master_hue_shift | Number | 0 | Global hue rotation in degrees |
master_saturation | Number | 0 | Global saturation offset. -1 = fully desaturated, +1 = double saturation |
master_lightness | Number | 0 | Global lightness offset |
mix | Number | 1 | Blend between original (0) and graded (1) image |
target_hue | Number | 0 | Center hue (degrees). 0=Red, 60=Yellow, 120=Green, 180=Cyan, 240=Blue, 300=Magenta |
hue_width | Number | 30 | Width of the hue selection range (degrees) |
hue_falloff | Number | 15 | Soft falloff at the edges of the hue selection (degrees) |
target_sat | Number | 0.500 | Center saturation of the selected range (0=gray, 1=vivid) |
sat_width | Number | 0.300 | Width of the saturation selection range |
sat_falloff | Number | 0.150 | Soft falloff at the edges of the saturation selection |
target_val | Number | 0.500 | Center luminance of the selected range (0=shadows, 1=highlights) |
val_width | Number | 0.300 | Width of the value selection range |
val_falloff | Number | 0.150 | Soft falloff at the edges of the value selection |
range_hue_shift | Number | 0 | Shift hue of selected range (degrees) |
range_saturation | Number | 0 | Adjust saturation in selected range |
range_lightness | Number | 0 | Adjust lightness in selected range |
spatial_strength | Field | — | Spatial field controlling where the effect applies (0=bypass, 1=full) |
strength | Number | 1 | Effect strength / wet-dry (0 = no effect, 1 = full). Editable, wirable, keyframable. |
Gotchas
Hue is measured in degrees around the colour wheel: 0 Red, 60 Yellow, 120 Green, 180 Cyan, 240 Blue, 300 Magenta. It wraps, so a selection centred near 0/360 still reaches smoothly across the red seam.
The Target Hue, Saturation and Value groups affect only the Target currently selected. Switching Target from Hue to Saturation does not discard the hue settings, it stops using them, so a grade that appears to have vanished may be sitting behind an unselected target group.
Falloff softens the edge of the selection, not the selection itself. Raise it when a graded region shows a visible boundary. Raise Width instead when the selection is not catching enough of the target colour.
Worked example
Add an HSV Grade after an image and leave Target on Hue.
Set Target Hue to the colour to isolate, 240 for blue, then raise Hue Width until the selection covers the range you need.
Raise Hue Falloff a little so the edit blends instead of cutting a hard edge.
Push Range Saturation up, or Range Hue Shift sideways, to grade only the selected colour, and use Mix to dial back overall strength.