Dolby Vision UI User Manual - cpm-code/xbmc GitHub Wiki

Kodi -> Settings Cog -> System -> CoreELEC

Dolby Vision Section

Mode

  • On

    Kodi menu presented in DV (or HDR if Type is set to Player Led (HDR)) from startup. If not playing DV content, HDR10+ converted to DV, and not using VS10 scaling - then content will be played as per content type.

    Available if system supports DV

  • On Demand

    Kodi menu presented in SDR from startup. If playing DV content, HDR10+ converted to DV or using VS10 scaling - then DV Engine is used for playback.

    Available if system supports DV

  • Off

    DV Engine completely off - usage falls back to normal CoreELEC without DV.

- GUI max luminance in menus

Set the preferred maximum luminance (brightness) of the Kodi menus.

Available if using Mode: On

Below settings are available if using Mode: On or On Demand

Type

  • Display Led (DV-Std)

    Display Led DV - generally considered the best quality, where processing is split between the box and the display.

    Available if display supports DV-Std (specifically DV RGB 8bit Tunnel)

  • Player Led (DV-LL)

    Player Led DV - DV processing all done on box

    Available if display supports DV-LL (specifically DV YCbCr 422 12bit)

  • Player Led (HDR)

    Player Led DV - DV processing all done on box, sent to display as HDR (Metadata change only, actual pixel data is the same as DV-LL). Note: HDR InfoFrame Static Metadata is all sent as PQ0 in this case, unless overriding using the HDR InfoFrame setting (see below).

    Available if display supports HDR PQ

  • VS10 Only

    Use with SDR displays, allows usage of VS10 to downscale to SDR.

- Dolby VSVDB

In normal cases you will not need to use this.

Inject a VSVDVB for the display or change the existing VSVDB of the display, the VSVDB value can be built with the following three parameters (also taking into consideration the Type chosen above), or you can directly specify a custom payload. Note: If specifying a custom payload then changing any of the parameters will overwrite it. When using Type: Player Led (HDR) where the display does not provide its own VSVDB this is required.

Available in Mode:On or On Demand, and not Type:VS10 Only

-- Colour space

Colour space of the display.

  • BT.709
  • BT.2020
  • DCI-P3

-- Minimum luminance

PQ 12-bit value for minimum luminance of the display.

  • PQ 0 through PQ 620

-- Maximum luminance

PQ 12-bit value for maximum luminance of the display.

  • PQ 2055 through PQ 4070

-- Payload

Specify your own 14 Byte v1 or v2 Dolby VSVDB payload.

- HDR InfoFrame

In normal cases you will not need to use this.

Override the HDR InfoFrame static metadata, for specialist use case.

Available for Player Led (HDR)

-- Payload

Specify your 48 byte (12 double-word) HDR InfoFrame static metadata to use.

- Colorimetry

The original AMLogic code when playing DV content set the colorimetry to BT.2020nc. For older displays like the LG E8 setting to BT.2020nc makes a visible difference, most notably in the deeper end of the red spectrum. For newer displays it has been noted there is no visible difference across all values.

Available for Display Led (DV-Std)

  • as per AMLogic > As set by AMLogic code (BT.709)
  • BT.2020nc > Set to BT.2020nc
  • disable/remove > Remove the colorimetry value completely.

- Preferred HDR for dual Dolby Vision and HDR10+ content

Where the content has both Dolby Vision and HDR10+ metadata, choose the preferred metadata to use.

  • Dolby Vision
  • HDR10+

- Dynamic HDR10+ to Dolby Vision profile 8.1 conversion

Available when preferred HDR is set to Dolby Vision

-- Prefer conversion over original Dolby Vision

Where the content has dual Dolby Vision and HDR10+ metadata, convert the HDR10+ metadata rather than use the Dolby Vision metadata.

-- Peak Brightness Source

Algorithm used to calculate the peak brightness from the HDR10+ metadata, from quietvoid's dovi_tool.

  • max-scl

    The max value in maxscl.

  • max-scl-luminance

    The luminance calculated from the maxscl components, assumed BT.2020 primaries is use.

  • histogram

    The max value from the histogram measurements.

  • histogram99

    The last percentile in the histogram, usually 99.98% brightness percentile.

  • histogram-plus

    Modified histogram algorithm from doppingkoala: "Change is in the calculation of the avg_pq. Essentially convert the different values of the CDF from nits to PQ, and then approximate average pq from those converted points. Improves over the original method as, due to the nonlinearity of the nits to pq calculation, the average nits converted to pq does not equal the average pq."

- For SDR8

Dolby Vision VS10 Engine scaling for SDR 8bit content

  • off

    off (engine off - no scaling)

  • SDR

    may upscale to SDR 10bit. Needs scientific (at least controlled empirical) testing.

  • HDR10

    upscale to HDR10

  • Dolby Vision

    upscale to Dolby Vision

- For SDR10

Dolby Vision VS10 Engine scaling for SDR 10bit content

  • off

    off (engine off - no scaling)

  • SDR

    probably no change. Needs scientific (at least controlled empirical) testing.

  • HDR10

    upscale to HDR10

  • Dolby Vision

    upscale to Dolby Vision

- For HDR10

Dolby Vision VS10 Engine scaling for HDR10 content

  • off

    off (engine off - no scaling)

  • SDR

    downscale to SDR

  • Dolby Vision

    upscale to Dolby Vision

- For HDR10+

Dolby Vision VS10 Engine scaling for HDR10+ content. In this case the HDR10+ metadata is discarded and only the base HDR10 is used.

Set to off when using a native HDR10+ display.

Available only when not enabling Dynamic HDR10+ to Dolby Vision profile 8.1 conversion (that is the better approach to convert to Dolby Vision utilizing the HDR10+ metadata)

  • off

    off (engine off - no scaling)

  • SDR

    downscale to SDR

  • Dolby Vision

    upscale to Dolby Vision

- For HLG HDR

Dolby Vision VS10 Engine scaling for HLG HDR content.

Current evidence suggests this mode does not work correctly and the VS10 Engine interprets the content as SDR, it is advised to leave this setting off if your display supports HLG HDR natively.

  • off

    off (engine off - no scaling)

  • SDR

    downscale to SDR

  • HDR10

    upscale to HDR10

  • Dolby Vision

    upscale to Dolby Vision

- For Dolby Vision

Dolby Vision VS10 Engine scaling for Dolby Vision content. Note: There is no HDR10 option as was found to not work correctly (the RPU metadata is ignored), use Player Led (HDR) for this use case instead.

  • off

    off (no scaling - DV content plays as native DV)

  • SDR

    downscale to SDR

- Convert profile 7

For Dolby Vision profile 7 content, optionally covert to profile 7 MEL or profile 8.1

  • off

    no conversion play as original content (aka lossless)

  • to MEL

    convert to profile 7 MEL

  • to 8.1

    convert to profile 8.1