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

HdrStaticMetadata

data class HdrStaticMetadata(val masteringPrimaries: DisplayPrimaries? = null, val masteringMinNits: Float? = null, val masteringMaxNits: Float? = null, val maxContentLightNits: Int? = null, val maxFrameAverageNits: Int? = null)

The static HDR metadata of a stream or a frame: the display it was graded on, as SMPTE ST 2086 describes it, and how bright the content gets, as CTA-861.3 describes it. A tone mapper reads the content's real peak from it instead of assuming one. Every field is null when the source did not say.

Constructors

HdrStaticMetadata

constructor(masteringPrimaries: DisplayPrimaries? = null, masteringMinNits: Float? = null, masteringMaxNits: Float? = null, maxContentLightNits: Int? = null, maxFrameAverageNits: Int? = null)

Properties

masteringMaxNits

val masteringMaxNits: Float?

The mastering display's peak white, in nits.

masteringMinNits

val masteringMinNits: Float?

The mastering display's darkest black, in nits.

masteringPrimaries

val masteringPrimaries: DisplayPrimaries?

The mastering display's primaries and white point.

maxContentLightNits

val maxContentLightNits: Int?

The brightest pixel of the content, in nits: MaxCLL.

maxFrameAverageNits

val maxFrameAverageNits: Int?

The brightest frame average of the content, in nits: MaxFALL.

peakNits

val peakNits: Float?

The content's peak for a tone map, in nits: the brightest pixel when it is between 100 and 10000 nits, else the mastering display's peak in that range, else null. The brightest pixel comes first because it measures the content, where the mastering peak describes a display, as mpv's renderer also takes it.