Add a Grade
- Open the Effects tab and find Grade. Search filters the list (Ctrl+F).
- Drag it onto a layer, or select the layer and double-click Grade or press Enter. With nothing selected, it goes on the composition and grades everything in it.
- Its section appears in the layer's Effects in the Inspector, with Primary, Curves and LUT.
Every value can be keyed, and Limit to confines the Grade to a mask, such as a face cut out with roto. See Confine an effect.
Primary
- Lift, Gamma, Gain
- Three colour wheels side by side, for the shadows, the mid-tones and the highlights, each with a master slider underneath for its brightness.
- Offset
- Moves every level of red, green and blue by the same amount.
- Temperature, Tint
- The white the picture is balanced to, in kelvin, starting at 6504 K, and the tint between green and magenta.
- Exposure
- Brightness in stops: +1 is twice the light.
- Contrast, Pivot
- Contrast around a pivot level, starting at 0.18, a mid grey in linear light.
- Saturation
- Colour strength in percent; 100 leaves it as it is.
Curves
Choose the curve to show: Master, Red, Green or Blue, or Hue vs Saturation and Hue vs Luminance to change one colour's strength or brightness without touching the rest.
- Drag a point to move it, and double-click to add one. Delete removes the selected point.
- Select a point to type its exact position in X and Y.
- Alt with the wheel zooms, the middle button pans, and F frames the curve.
A point that's keyed is changed at its keys on the Timeline.
LUT
The LUT step applies a look or a transform after Primary and Curves:
- None
- Leaves the colour as it is.
- File
- A LUT file imported into the project:
.cube,.3dl, or another format OpenColorIO reads. Once it's in the project, choose it as the LUT file. - Colour space
- A transform from one colour space to another.
Input space and Output space say which spaces the LUT reads and writes, and Strength mixes its result with the colour before it, in percent.
How footage colour is read
Select a piece of footage. Its Footage section has Colour space: how its colours are read, before any effect. Auto reads the footage's own colour metadata. Choose a colour space instead when the metadata is missing or wrong, such as a camera log recording; every clip of that footage follows.
The working colour space
Grapple manages colour with OpenColorIO and its built-in ACES configuration. Footage comes into a linear working space, layers mix there at floating-point precision, and the export converts to the output colour you choose: SDR in BT.709, or HDR with PQ or HLG. Light above white is kept until the export, so a bright highlight survives a Grade that brings it down.
Check with Scopes
Open Scopes from the Window menu. It measures the composition's output frame, without fully transparent pixels, and refreshes as you work.
- Histogram
- How many pixels sit at each brightness. A pile against either edge means clipped shadows or highlights.
- Waveform
- Brightness across the width of the frame, so you can see which part is too bright or too dark.
- RGB parade
- Red, green and blue side by side. Even levels on a white or grey area mean a neutral balance.
- Vectorscope
- Hue and saturation. Skin tones gather along one line, and a cast pulls everything one way.
The Histogram, Waveform and parade measure SDR output in sRGB from 0 to 255. Judge HDR on an HDR display.