Color Curves
Color Curves operator properties for Script Engine. Applies tonal and per-channel curve adjustments — drag points on a master, red, green, blue or alpha curve to remap brightness levels precisely. Useful for fine-grained contrast shaping, removing colour casts in specific tonal ranges, building S-curves for cinematic punch, matching cameras to a known reference, or recovering crushed shadows and blown highlights. The included automatic camera-calibration tool can build a correction curve from a grey-scale reference chart in the source image.
| Property | Type | Access | Description |
|---|---|---|---|
ShowAdvancedOptions |
bool |
get/set |
Reveals the automatic camera calibration controls when on. Off by default to keep the UI uncluttered for everyday curve work. Turn on when using a grey-scale reference chart to build a correction curve automatically. |
LinearInterpolation |
bool |
get/set |
When on, draws straight lines between curve points; when off, draws smooth (Lagrange) curves. Off (smooth) is the typical default for natural-looking grades. Turn on when you want hard transitions at specific tonal levels — e.g. a strict posterised look, or precise matching of a measured calibration sample. |
SquareSize |
int |
get/set |
Edge length, in pixels, of each square sampled from the reference chart. [min=2, max=32, default=22]. Larger values average over more pixels, giving more stable readings — best when the chart fills a large portion of the frame. Smaller values are needed when the chart is small or the sample regions are tight; expect noisier results. |
GrayScaleCalibrate |
Command |
get |
Sample the configured grey-scale chart squares and build a correction curve automatically. Run this once a reference chart is visible in the source frame and the sample positions are aligned. Generates a master curve plus per-channel red/green/blue curves that flatten the camera response towards a neutral reference. |
Inherits from: AbstractOperator, AbstractAudioMetering.
See also: Color Curves in Operators — user-facing introduction, screenshots, and section summaries.