Create color grade
create_color_gradeAdjust lift, gamma, gain, black point, saturation, hue, and apply a LUT to grade a video source. Builds a node chain with exposed controls for live adjustments.
Instructions
Build a colour-grading / LUT finishing stage over a source — the 'make the final output look graded' tool for VJ sets. A Level TOP applies lift/gamma/gain (brightness1 / gamma1 / contrast + black level), then an HSV Adjust TOP applies saturation + hue rotation; an optional LUT image file is loaded via a Movie File In TOP and fed into a Lookup TOP's second input to remap every colour. Creates a new baseCOMP under parent_path holding the chain. With an input_path the source is pulled in via a Select TOP (so it can live in another container); without one, a Ramp TOP test gradient is graded so it builds and previews standalone. Live Brightness / Gamma / Contrast / Saturation / Hue knobs are exposed. Output is a Null TOP. Returns a summary plus a JSON block with the container path, created node paths, the Level/HSV/output paths, exposed controls, any node errors, warnings, and an inline preview image. Use apply_post_processing instead to chain several distinct effects in series.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brightness | No | Overall brightness / gain multiplier (1 = unchanged). Drives the Level TOP's `brightness1` (this is the gain control — the param is `brightness1`, NOT `gain`). | |
| gamma | No | Gamma / mid-tone curve (1 = linear, <1 brightens mids, >1 darkens mids). Drives the Level TOP's `gamma1`. | |
| contrast | No | Contrast around mid-grey (1 = unchanged). Drives the Level TOP's `contrast`. | |
| black_level | No | Lift the black point (0 = unchanged); raises the darkest pixels for a faded / filmic 'lift'. Drives the Level TOP's `blacklevel`. | |
| saturation | No | Colour saturation multiplier (0 = greyscale, 1 = unchanged, >1 = punchier). Drives the HSV Adjust TOP's `saturationmult`. | |
| hue | No | Hue rotation in degrees (0 = unchanged, 0..360 wraps the colour wheel). Drives the HSV Adjust TOP's `hueoffset`. | |
| lut_path | No | Optional absolute path to a LUT image file (e.g. a 256x1 / 512x512 colour ramp). When given, a Movie File In TOP loads it and feeds the SECOND input of a Lookup TOP; the graded image is the first input, so each pixel is remapped through the LUT. Omit to skip LUT remapping. | |
| input_path | No | Optional absolute path of the source TOP to grade. Pulled in via a Select TOP (TD wires don't cross containers). If omitted, a Ramp TOP test gradient is graded so the chain still builds and previews without any device or external source. | |
| expose_controls | No | When true (default), expose live Brightness / Gamma / Contrast / Saturation / Hue knobs bound to the right node parameters. | |
| parent_path | No | Parent network where the color-grade container is created (default '/project1'). | /project1 |