# Color

> Grade in nolanlabs: wheels, curves and LUTs, nodes, masks, versions, shot match and ASC CDL, with scopes that read the original files, ACES and HDR delivery.

Page: https://nolanlabs.io/docs/color

You grade a clip in the Inspector’s **Color** section, by hand or by asking the agent. This page covers the grade, nodes, scopes, and working in ACES or HDR.

## Grade a clip

**Color** has exposure, contrast, saturation, temperature and tint. **Grade** adds hue, the wheels, curves and a LUT. The viewer shows the grade as you drag, and a render applies it at full quality. A focused wheel moves with the arrow keys (Shift for bigger steps, Home to center it), and a run of key presses is one undo step.

[Clip: Dragging Temperature warms the picture as it moves, then Saturation. The wheels and curves are below.](https://nolanlabs.io/media/docs/pro-color.mp4)

| Control | Range and meaning |
| --- | --- |
| Exposure | Stops, −4 to 4 |
| Contrast | −1 to 1, about mid gray |
| Saturation | −1 (none) to 1 (twice) |
| Temperature, tint | −1 to 1: cooler to warmer, green to magenta |
| Hue | Degrees round the color circle |
| Lift, gamma, gain | A wheel each, 0 leaves it |
| Curves | Master first, then red, green and blue |
| LUT | A `.cube` (1D or 3D) or `.3dl`, and how much of it is mixed in |

## Masks

**Masks** cut a clip to rectangles, ellipses and shapes you draw, each with feather, invert and how it joins the others. Drag a mask’s handles on the picture. **Follow** moves a mask with what it tracks.

## Nodes

**Nodes** grade after the sliders above, which are node 1. Each one works over the whole picture, or a color range, at a mix, on or off.

| Mode | What it grades | What comes out |
| --- | --- | --- |
| Serial | What the node before gave | Its grade, where its range and masks say |
| Parallel | The same picture as the node before | The average of its result and the nodes beside it |
| Layer | The same picture as the node before | Its grade laid over the result so far |

A color range is set by hue, saturation and luma, with a softness for how gently its edges fall off.

## Keep and reuse a grade

- **Versions** keep grades by name, so you can show another and come back.
- **Gallery** keeps a grade with a picture of the frame, to lay on other clips.
- **Match to** grades a clip to another. It measures the shadows, middle and highlights of each channel and adds a node that brings them to the reference’s. Matching again replaces that node. No model is involved.
- **ASC CDL:** a grade’s node 1 can be written as slope, offset, power and saturation, as a `.ccc`, a `.cdl`, or a folder of `.cc` files, one for each shot. What a CDL can’t carry (hue, curves, a LUT, the nodes after node 1) comes back as a warning. It’s the `grade.cdl` op, from a script. See [Scripting](https://nolanlabs.io/docs/scripting).

## Keys

Green-screen keying works by how far the screen’s main channel stands above the others, and holds it down on what stays. A yellow or teal screen is keyed by how near its chroma is. A luma key keeps a range of levels. Both let you grow or shrink the matte, soften it, and show it.

## Scopes

The **Scopes** panel (**Panels** menu) shows the waveform, parade, vectorscope and histogram at the playhead. They read the frame from the original files in 16 bits, as a render makes it. The viewer shows Rec.709 from proxies, so judge fine gradients and HDR by the scopes, not by eye.

## Pick a working space

A project composites and grades in one of two spaces, set in **Project settings**:

- **Rec.709**, the default. Inputs are read with their tags, an untagged source is taken as Rec.709, and delivery converts on the way out.
- **ACES** (ACEScct). Each source comes in through its input transform, everything composites and grades there, and the frame goes out through an ACES output transform for its delivery. Titles and graphics come in so that a white title comes out white.

### ACES inputs

Say what a source was recorded in with **Shot in**, in its info on the **Media** page, or with the `media.colour` op from a script. A source with no input set is Rec.709, or the HDR its file is tagged with.

| Maker | Inputs |
| --- | --- |
| ARRI | LogC3 (EI 800, AWG3), LogC4 (AWG4) |
| Sony | S-Log3, S-Log3 Cine, S-Log3 Venice, S-Log3 Venice Cine |
| RED | Log3G10 (REDWideGamutRGB) |
| Panasonic | V-Log |
| Canon | Canon Log 2, Canon Log 3 (Cinema Gamut) |
| Blackmagic | Film Gen 5, DaVinci Intermediate |
| Apple | Apple Log |
| Display | Rec.709, Rec.709 as shown, sRGB, Rec.2100 PQ, Rec.2100 HLG |
| Linear | Linear Rec.709, Linear Rec.2020, Linear P3-D65, ACEScg, ACES2065, ACEScct |

Camera RAW isn’t read. Bring in the camera’s log as ProRes or a DPX or EXR sequence, and set its input.

### ACES outputs

| Delivery | Output transform |
| --- | --- |
| SDR video (the default) | ACES 1.0 SDR Video, Rec.1886 Rec.709 |
| For sRGB or Display P3 | ACES 1.0 SDR Video on that display, tagged so |
| HDR, PQ or HLG | ACES 1.1 HDR Video, 1000 nits, Rec.2020 limited, in PQ. HLG is made from it as the frame is written |
| EXR sequence | Linear ACES: ACES2065 (the default) or ACEScg |

Judge ACES color from a render or the scopes.

## HDR

Sources are tagged SDR, PQ or HLG at import.

- **SDR delivery:** HDR sources are tone-mapped on the way in.
- **HDR delivery:** the layers aren’t tone-mapped. Everything composites in PQ BT.2020, SDR layers and titles come up to it, and the file is tagged. It needs 10 bits or more.
- **Grading in HDR:** grades run on PQ values, so their numbers differ from what they do to the same clip in SDR.

There’s an HDR viewer only in the Mac app, on an EDR display. Elsewhere the viewer shows Rec.709, so grade HDR by the scopes. See [Deliver](https://nolanlabs.io/docs/deliver) for the formats and [Known limits](https://nolanlabs.io/docs/known-limits) for the rest.
