Color

Generated from project.v1.schema.json at the documented engine version. The schema checks shape only; the engine’s validation also checks ranges, limits, references and keyframe order.

`ColorMatrix`

Coefficients used to decode source components.

"bt601" SD BT.601 YUV coefficients.
"bt709" HD BT.709 YUV coefficients.
"bt2020_ncl" BT.2020 non-constant-luminance YUV coefficients.
"rgb" Source components are already RGB.

`ColorMetadata`

Host-independent video color description.

Field	Type	Description
`dynamic_range`required	DynamicRange	SDR or HDR; HDR exactly when `transfer` is PQ or HLG (`is_consistent`).
`matrix`required	ColorMatrix	YUV-to-RGB coefficient family, or RGB for already converted sources.
`primaries`required	ColorPrimaries	RGB chromaticity standard.
`range`required	ColorRange	Encoded component range.
`transfer`required	TransferFunction	Nonlinear transfer curve.

`ColorPipeline`

How sources' colors come into the working space.

The working space is display-referred linear light with BT.709 primaries, 1.0 being SDR white (100 nits); every export is SDR BT.709. SDR sources decode through the sRGB EOTF and wide-gamut ones are converted to BT.709. An HDR (PQ or HLG) source is either refused or linearized, converted to BT.709, and tone-mapped from hdr_peak_nits to SDR white by the ITU-R BT.2390 EETF on each pixel's largest component, preserving hue.

Field Type Description

Field	Type	Description
`hdr`	HdrSources	What an HDR source does. Default: `"tone_map"`
`hdr_peak_nits`	integer (uint32)	The luminance, in nits, HDR sources are taken to peak at: PQ above it is clipped, HLG is displayed at it, and the tone map brings it to SDR white. Within `HDR_PEAK_NITS_RANGE`. Default: `1000`

hdr

HdrSources

What an HDR source does.

Default: "tone_map"

hdr_peak_nits

integer (uint32)

The luminance, in nits, HDR sources are taken to peak at: PQ above it is clipped, HLG is displayed at it, and the tone map brings it to SDR white. Within HDR_PEAK_NITS_RANGE.

Default: 1000

`ColorPrimaries`

RGB primary chromaticities a source or export declares.

"bt601" SD video primaries.
"bt709" HD video and sRGB primaries.
"bt2020" Wide-gamut BT.2020 primaries, normally indicating HDR input.

`ColorRange`

Nominal encoded component range.

"limited" Studio/video range.
"full" Full component range.

`DynamicRange`

Standard or high dynamic range; must agree with the transfer.

"sdr" Standard dynamic range: a BT.709 or sRGB transfer.
"hdr" High dynamic range: a PQ or HLG transfer, tone-mapped or rejected per the color pipeline.

`LinearPrimaries`

Named RGB primaries linear-light media may be in, each with its own white point.

"bt709" ITU-R BT.709 and sRGB, D65 white.
"bt2020" ITU-R BT.2020, D65 white.
"p3_d65" DCI-P3 primaries with a D65 white, as Display P3.
"aces_ap0" ACES AP0 (SMPTE ST 2065-1), the ACES white.
"aces_ap1" ACES AP1 (ACEScg), the ACES white.

`TransferFunction`

Encoded transfer curve.

"bt709" BT.709 opto-electronic transfer function.
"srgb" IEC sRGB transfer function.
"pq" Perceptual quantizer HDR transfer function.
"hlg" Hybrid log-gamma HDR transfer function.