kiteffmpeg/io.github.yuroyami.kiteffmpeg/ColorInfo

ColorInfo

data class ColorInfo(val matrix: ColorMatrix = ColorMatrix.Unspecified, val primaries: ColorPrimaries = ColorPrimaries.Unspecified, val transfer: ColorTransfer = ColorTransfer.Unspecified, val fullRange: Boolean = false, val chromaLocation: ChromaLocation = ChromaLocation.Unspecified, val rangeSpecified: Boolean = false, val matrixSpecified: Boolean = false, val primariesSpecified: Boolean = false, val transferSpecified: Boolean = false)

The colour metadata a renderer must honour to draw a frame correctly.

None of this is subtle once it is wrong, and all of it is already known at decode time:

Field	What a wrong value looks like
matrix	Hues shift. Faces go green or magenta, worst on saturated reds.
fullRange	Blacks turn grey and whites clip, or contrast is crushed.
chromaLocation	Colour bleeds half a pixel at sharp coloured edges.
transfer	High dynamic range content looks washed out or far too dark.

The values map one to one onto FFmpeg's own enumerations, so nothing is lost or guessed at the boundary. Unspecified is a real and common answer: many containers declare nothing, and guessFor gives the conventional interpretation.

Constructors

ColorInfo

constructor(matrix: ColorMatrix = ColorMatrix.Unspecified, primaries: ColorPrimaries = ColorPrimaries.Unspecified, transfer: ColorTransfer = ColorTransfer.Unspecified, fullRange: Boolean = false, chromaLocation: ChromaLocation = ChromaLocation.Unspecified, rangeSpecified: Boolean = false, matrixSpecified: Boolean = false, primariesSpecified: Boolean = false, transferSpecified: Boolean = false)