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_rangerequired	DynamicRange	SDR or HDR signal classification: HDR exactly when transfer is PQ or HLG (is_consistent).
matrixrequired	ColorMatrix	YUV-to-RGB coefficient family, or RGB for already converted sources.
primariesrequired	ColorPrimaries	RGB chromaticity standard.
rangerequired	ColorRange	Encoded component range.
transferrequired	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, where 1.0 is SDR white (100 nits), and every export is SDR BT.709. SDR sources decode through the sRGB EOTF; wide-gamut ones are converted into BT.709 primaries. An HDR (PQ or HLG) source is either refused or brought in: linearized to display light, converted into BT.709 primaries, and tone-mapped from hdr_peak_nits to SDR white by the ITU-R BT.2390 EETF on each pixel's largest component, which keeps its hue.

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 to it, 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

Whether a signal is standard or high dynamic range. It follows the transfer: hdr exactly when the transfer is PQ or HLG, and a color whose two fields disagree is refused.

• "sdr" Standard dynamic range: a BT.709 or sRGB transfer.
• "hdr" High dynamic range: a PQ or HLG transfer, which a project tone-maps into the SDR working space or refuses, as its color pipeline says.

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.