HDR10 Metadata

Transform supports HDR10 metadata in the variety of containers (MXF, IMF, MOV, MKV) and video formats (h265, h265).

HDR10 compatible outputs requires two types of static metadata:

Mastering Display Color Volume (ST2086)

Indicates the color primaries and luminance (brightness) range of the display used to master the content during production. A receiver uses this metadata to determine whether the content could contain colors or light levels that cannot be reproduced by the display.

Content Light Level (CTA-861.3)

Indicates the average and maximum light levels measured over the duration of the content. A receiver uses this information to adjust the content light levels to match the capability of the display.

Metadata Passthrough

HDR10 metadata read from an input container will be automatically written to an output container. This is useful in two scenarios:

  1. Transcoding an HDR10 contribution master (e.g IMF) to an HDR10 distribution format (MP4, HLS, etc.).
  2. Converting an HDR10 master (e.g. MOV) to a different file format (e.g. IMF).

Transform supports HDR10 metadata in the variety of containers (MXF, IMF, MOV, MKV) and video formats (h264, h265).

Metadata Override

HDR10 metadata that is missing or incorrect can be supplied or overridden on a video stream. For example the following composition will override the content light levels on an input:

---
input:
  container:
  - name: master
    video:
    - name: v1
      properties:
        MaxCLL: 1234
        MaxFALL: 102
{
  "input": {
    "container": [
      {
        "name": "master",
        "video": [
          {
            "name": "v1",
            "properties": {
              "MaxCLL": 1234,
              "MaxFALL": 102
            }
          }
        ]
      }
    ]
  }
}

The following HDR10 metadata properties are supported:

PropertyValueDescription
MaxCLLnumberMaximum content light level in candellas per square meter.
MaxFALLnumberMaximum frame average light level in candellas per square meter.
MasteringDisplayColorPrimariesenumDisplay primaries and white point: BT2020, P3D65 or P3DCI.
MasteringDisplayMaxLuminancenumberMaximum display luminance in candellas per square meter.
MasteringDisplayMinLuminancenumberMinimum display luminance in candellas per square meter.

Light Level Measurement

The CTA.861.3 metadata can be automatically measured using the ContentLightLevels property. For example the following composition will measure the light levels on an output stream,

---
input:
  container:
  - name: mov
    video:
    - name: v1
output:
  container:
  - name: imf
    type: 'imf '
    video:
    - route:
        name: v1
      properties:
        ContentLightLevels:
          Override: true
          Aperture:
            top: 56
            bottom: 56
{
  "input": {
    "container": [
      {
        "name": "imf",
        "video": [
          {
            "name": "v1",
            "properties": {
              "ContentLightLevels": {
                "Override": true,
                "Aperture": {
                  "top": 56,
                  "bottom": 56
                }
              }
            }
          }
        ]
      }
    ]
  }
}

The following properties are supported:

PropertyValueDescription
OverridebooleanIndicates whether to override any existing CTA.861.3 metadata, default is false.
Modeenum
AperturerectangleThe top, bottom, left and right offsets of the active image area.