HDR10 Metadata

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:

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: