RenderLook
Since 0.7Changed 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). |