CICP-style colour encoding: the primaries + transfer + matrix the image is
authored in, plus the sample range. Drives both the HEIF colr (nclx) box and
the HEVC VUI signalling.
HDR content light level (CTA-861.3 / ISOBMFF clli): the maximum content light
level (MaxCLL) and maximum frame-average light level (MaxFALL), both in cd/m²
(nits). Written as the ContentLightLevelBox.
Encode a packed 8-bit grayscale + alpha image to HEIC with a separate
alpha auxiliary image. ya must hold exactly width * height * 2 bytes
in Y, A order.
Encode a native-depth u16 grayscale + alpha image to HEIC at an
explicit bit depth. ya must hold exactly width * height * 2 samples
in Y, A order at bit_depth’s native range.