# RenderLook

> Talos next · Since 0.7; changed in next

The scene's colour grade: a look preset and overrides on top of it.

Every field is optional.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `preset` | `RenderLookPreset` | no |  | `natural`, `natural-plus`, `cinematic`, `bright-day`, `warm-afternoon`, `overcast`, `night`, `stylised` | Starting point for the fields below. natural (default): no grade. natural-plus: a faint blue-shadow and warm-highlight split, mild contrast, a little more colour, a light vignette. cinematic: more contrast, teal shadows and warm highlights, a stronger vignette. bright-day: warmer, a touch more colour. overcast: cooler, softer and less saturated. night: cool and desaturated, blue shadows. stylised: bold colour and contrast, warm midtones. |
| `contrast` | `number` | no |  |  | Contrast around 18% grey (a power in scene-linear light, before the tonemapper), 0.5..2. 1 is unchanged. Default: the preset's. |
| `saturation` | `number` | no |  |  | Colour saturation, 0..2: 0 is greyscale, 1 unchanged, 2 double. Default: the preset's. |
| `temperatureK` | `number` | no |  |  | White balance: the colour temperature, in kelvin, the camera treats as white, 2000..15000. 6500 is neutral; lower cools the image (bluer), higher warms it. Default: the preset's. |
| `tint` | `number` | no |  |  | White-balance tint across the daylight curve, -1..1: above 0 more magenta, below 0 more green. 0 is neutral. Default: the preset's. |
| `shadowsLift` | `number` | no |  |  | Black point: the brightness of the darkest tones, after the tonemapper, -1..1. Below 0 deepens the shadows toward a true black; above 0 lifts them (a faded, matte look). 0 is unchanged. Default: the preset's (0). |
| `vignette` | `number` | no |  |  | Corner darkening, 0..0.9: the corners keep 1 - vignette of their light. Default: the preset's (HD's 0.25 for most). The standard renderer draws it only when the scene sets it (a preset's own vignette is HD's alone). |
| `toe` | `number` | no |  |  | A softer AgX toe, 0..1: lifts dark tones before the AgX curve by 1 + toe x 0.01 / (c + 0.01) (up to a stop at 1) while mid grey moves about 0.07 EV and highlights not at all, so shade reads less crushed. 0 or absent is today's punchy look, byte for byte. HD only, and only with an AgX tonemapper (the standard renderer draws no toe). |
| `shoulder` | `number` | no |  |  | A highlight roll-off, 0..1: after the tonemapper the display luminance above 0.45 is compressed with a soft knee, colour kept, so a bright sky or sun-lit wall stops clipping (a full white ends at 1 - 0.275 x shoulder). 0 or absent is today's frame, byte for byte. HD only. |
| `vibrance` | `number` | no |  |  | Saturation that favours muted colours, -1..1: a pixel's colour is scaled by 1 + vibrance x (1 - its saturation), so skin and already-vivid colours move least. 0 or absent is off. HD only. |
| `ranges` | `RenderLookRanges` | no |  |  | Contrast and saturation per tonal range (shadows, midtones, highlights). HD only. |
| `hueSaturation` | `RenderLookHueSaturation` | no |  |  | Saturation by hue. HD only. |
| `lift` | `RenderLookWheel` | no |  |  | The shadows' colour wheel (lift), after the tonemapper. Its luminance is shadowsLift's, and wins when both are written. HD only (the standard renderer reads shadowsLift). |
| `gamma` | `RenderLookWheel` | no |  |  | The midtones' colour wheel (gamma), after the tonemapper. HD only. |
| `gain` | `RenderLookWheel` | no |  |  | The highlights' colour wheel (gain), after the tonemapper. HD only. |
| `preserveLuminance` | `boolean` | no |  |  | The colour wheels change hue only: each pixel keeps the luminance the wheels' own luminance gives it. Default: the preset's (true). HD only. |
| `lut` | `RenderLookLut` | no |  |  | A 3D colour LUT (.cube) over the grade, after the tonemapper by default. HD only; a gradeVolume's look does not draw one yet (render-field-ignored). |

## See also

- `RenderLookPreset`
- `RenderLookRanges`
- `RenderLookHueSaturation`
- `RenderLookWheel`
- `RenderLookLut`