kiteplayer-core/io.github.yuroyami.kiteplayer.spi/ColorSpaceInfo

ColorSpaceInfo

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

The colour metadata a renderer must honour to produce a correct picture.

Every field here changes what the viewer sees. Ignoring matrix shifts hues, most visibly on saturated reds. Ignoring fullRange turns blacks grey and clips whites. Ignoring chromaLocation bleeds colour half a pixel at sharp edges. None of this is subtle once it is wrong, and all of it is already known at decode time.

Constructors

ColorSpaceInfo

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