HDR設定

このトピックでは、HDR ビデオ出力に関連するエンコーディング設定の詳細について説明します。

概要

Zencoder がサポートする HDR 形式と HDR フォーマットのパラメーターに関する推奨事項の詳細については、『 HDR ビデオガイド』を参照してください。

keep_hdr_metadata

master_display:Boolean

API バージョン:V2

親:出力

デフォルト:偽

互換性のあるジョブの種類: vod

説明:

true に設定すると、このパラメータは入力ファイルから HDR 関連のメタデータ (ほとんどまたはすべて) をインポートし、出力に渡すよう Zencoder に指示します。

たとえば、HDR10、PQ10、または HLG10 形式の HEVC エンコードビデオストリームのトランスコーディングは、次のジョブ要求を使用して実行できます。

{
  "input": "s3://mybucket/hdr_master.mp4",
  "outputs": [
    {
     "video_codec": "hevc",
     "video_codec_profile": "main10",
     "video_bit_depth": 10,
     "preserve_hdr_metadata": true
    }
  ]
}

このパラメーターは、HDR 関連のメタデータを直接指定して、他のパラメーターと組み合わせて使用することもできます。たとえば、以下のJSONジョブリクエストは、preserve_hdr_metadataパラメータが引き継いでどのように使用されるかを示しています。master displayとHEVC エンコードされた DolbyVision 8.1 content light levelストリームからのメタデータ。一方、DolbyVision動的メタデータ ( RPUファイル) は、dolby_vision_rpu_url パラメータを使用して別々に通信されます。

{
  "input": "s3://mybucket/dv81_master.mp4",
  "outputs": [
    {
     "video_codec": "hevc",
     "video_codec_profile": "main10",
     "video_bit_depth": 10,
     "hdr_format": "dv8.1",
     "preserve_hdr_metadata": true,
     "dolby_vision_rpu_url": "s3://mubucket/dv81_master_rpu.rpu"
    }
  ]
}

参照:

hdr_format

hdr_format:String

API バージョン:V2

親:outputs , dynamic_profile_options

有効な値:hdr10、pq、hlg , dv5 , dv8.1

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

出力を生成するために使用されている HDR 形式のタイプを指定します。

このパラメーターは、入力ファイルが HDR 形式関連のメタデータを保持していないため、フォーマットタイプと関連するすべてのメタデータの両方を直接指定する必要がある場合に使用します。

たとえば、J2K エンコードされた MFX として提供される PQ カラーグレーディングコンテンツは、次のジョブ要求によって PQ10 出力ストリームに変換できます。

{
  "input": "s3://mybucket/j2k_master.mfx",
  "outputs": [
    {
     "video_codec": "hevc",
     "video_codec_profile": "main10",
     "video_bit_depth": 10,
     "hdr_format": "pq"
    }
   ]
}

または、同じ J2K MXF マスターがHDR10コンテンツを表し、マスターディスプレイとコンテンツライトレベルのメタデータパラメータを説明する追加ファイルが付属している場合は、HDR10 HEVC でエンコードします。ストリームは、次のジョブ要求を使用して実現できます。

{
  "input": "s3://mybucket/j2k_master.mfx",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_codec_profile": "main10",
      "video_bit_depth": 10,
      "hdr_format": "hdr10",
      "master_display": {
        "red": {"x": 0.708, "y": 0.292},
        "green": {"x": 0.17, "y": 0.797},
        "blue": {"x": 0.131, "y": 0.046},
        "white_point": {"x": 0.31273,"y": 0.329},
        "luminance": {"max": 1000,"min": 0.0001}
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

参照:

display

master_display:Object

API バージョン:V2

親:outputs , dynamic_profile_options

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

ビデオコンテンツのマスタリングで使用されたディスプレイのカラーボリューム（カラー、ホワイトポイント、輝度範囲）を記述する構造。この構造で使用される特定の値は、 SMPTE ST 2086規格で定義されています。

マスター表示メタデータは必須であり、HDR-10およびDolbyVision 8.1形式でビデオをエンコードするときに出力に対して実行する必要があります。

次の例は、マスター表示メタデータの指定方法を示しています。

{
  "input": "s3://mybucket/j2k_master.mfx",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_codec_profile": "main10",
      "video_bit_depth": 10,
      "hdr_format": "hdr10",
      "master_display": {
        "red": {"x": 0.708, "y": 0.292},
        "green": {"x": 0.17, "y": 0.797},
        "blue": {"x": 0.131, "y": 0.046},
        "white_point": {"x": 0.31273,"y": 0.329},
        "luminance": {"max": 1000,"min": 0.0001}
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

参照:

content_light_level

max_content_light_level:Number

API バージョン:V2

親:outputs , dynamic_profile_options

デフォルト:なし

有効な値:0-10000

互換性のあるジョブの種類: vod

例:1000

説明:

ビデオシーケンス全体の最大ピクセル（および赤、緑、青のチャンネル）-ワイズの光レベルを示します。平方メートルあたりのカンデラで表します。この値は 0 に設定できます。これは、そのような境界が不明であるか強制されないことを意味します。このパラメータは、別名MaxCLLによって定義されますCAE 861.3標準。

以下の例は、 max_content_light_levelおよび max_frame_average_light_levelメタデータを指定する方法を示しています。

{
  "input": "s3://mybucket/j2k_master.mfx",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_codec_profile": "main10",
      "video_bit_depth": 10,
      "hdr_format": "hdr10",
      "master_display": {
        "red": {"x": 0.708, "y": 0.292},
        "green": {"x": 0.17, "y": 0.797},
        "blue": {"x": 0.131, "y": 0.046},
        "white_point": {"x": 0.31273,"y": 0.329},
        "luminance": {"max": 1000,"min": 0.0001}
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

参照:

max_frame_average_light_level

max_frame_average_light_level:Number

API バージョン:V2

親:outputs , dynamic_profile_options

デフォルト:なし

有効な値:5.0-10000.0

互換性のあるジョブの種類: vod

例:180

説明:

ビデオシーケンス全体の最大フレーム平均（および赤、緑、青チャネルごとの最大レベル）のライトレベルを示します。平方メートルあたりのカンデラで表します。この値は 0 に設定できます。これは、そのような境界が不明であるか強制されないことを意味します。このパラメータは、別名MaxFALLによって定義されますCAE 861.3標準。

max_content_light_levelパラメータと max_frame_average_light_levelパラメータはどちらも必須であり、HDR-10 形式でビデオをエンコードする場合は、出力に含める必要があります。

以下の例は、 max_content_light_levelおよび max_frame_average_light_levelメタデータを指定する方法を示しています。

{
  "input": "s3://mybucket/j2k_master.mfx",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_codec_profile": "main10",
      "video_bit_depth": 10,
      "hdr_format": "hdr10",
      "master_display": {
        "red": {"x": 0.708, "y": 0.292},
        "green": {"x": 0.17, "y": 0.797},
        "blue": {"x": 0.131, "y": 0.046},
        "white_point": {"x": 0.31273,"y": 0.329},
        "luminance": {"max": 1000,"min": 0.0001}
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

参照:

dolby_vision_rpu_url

dolby_vision_rpu_url:String

API バージョン:V2

親:outputs , dynamic_profile_options

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

このパラメーターは、現在、DolbyVision 5 および DolbyVision 8.1 形式でビデオをトランスコードするときに必要です。

使用例:

{
  "input": "s3://mybucket/dv5_master.mp4",
  "outputs": [
   {
    "video_codec": "hevc",
    "video_codec_profile": "main10",
    "video_bit_depth": 10,
    "hdr_format": "dv5",
    "video_color_range": "full",
    "dolby_vision_rpu_url": "s3://mubucket/dv5_master_rpu.rpu"
   }
  ]
}

参照:

color_range

video_color_range:String

API バージョン:V2

親:outputs , dynamic_profile_options

有効な値:limited , full

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

ピクセル値のダイナミックレンジを示します。たとえば、8 ビットピクセルの場合、limited Y (ルミス) ピクセル値は 16 ～ 235 の範囲にとどまり、Y (ルミス) fullピクセルを意味します。値の範囲は 0 ～ 255 です。

コンテンツの大部分は現在、limitedピクセルを使用して作成およびエンコードされています。ただし、full -range ピクセルも使用されることがあります。たとえば、DolbyVision 5 フォーマットでは、10 ビット幅のフルレンジピクセルが使用されます。

使用例:

{
  "input": "s3://mybucket/dv5_master.mp4",
  "outputs": [
   {
    "video_codec": "hevc",
    "video_codec_profile": "main10",
    "video_bit_depth": 10,
    "hdr_format": "dv5",
    "video_color_range": "full",
    "dolby_vision_rpu_url": "s3://mubucket/dv5_master_rpu.rpu"
   }
  ]
}

参照:

赤

red:Object

API バージョン:V2

親:master_display

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

赤の色ボリューム設定を含むハッシュ。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

x

x:Number

API バージョン:V2

親:master_display: 赤

デフォルト:なし

有効な値:0.0001-0.7400

互換性のあるジョブの種類: vod

例:0.708

説明:

赤の色量 x の設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

y

y:Number

API バージョン:V2

親:master_display: 赤

デフォルト:なし

有効な値:0.0001-0.8400

互換性のあるジョブの種類: vod

例:0.292

説明:

赤の色ボリュームy設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

緑

green:Object

API バージョン:V2

親:master_display

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

緑のカラーボリューム設定を含むハッシュ。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

x

x:Number

API バージョン:V2

親:master_display: 緑

デフォルト:なし

有効な値:0.0001-0.7400

互換性のあるジョブの種類: vod

例:0.17

説明:

緑の色量 x の設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

y

y:Number

API バージョン:V2

親:master_display: 緑

デフォルト:なし

有効な値:0.0001-0.8400

互換性のあるジョブの種類: vod

例:0.797

説明:

緑の色ボリュームy設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

青

blue:Object

API バージョン:V2

親:master_display

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

青の色ボリューム設定を含むハッシュ。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

x

x:Number

API バージョン:V2

親:master_display: 青

デフォルト:なし

有効な値:0.0001-0.7400

互換性のあるジョブの種類: vod

例:0.131

説明:

青の色量 x の設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

y

y:Number

API バージョン:V2

親:master_display: 青

デフォルト:なし

有効な値:0.0001-0.8400

互換性のあるジョブの種類: vod

例:0.046

説明:

青の色ボリュームy設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

wite_point

white_point:Object

API バージョン:V2

親:master_display

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

ホワイトポイントのカラーボリューム設定を含むハッシュ。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

x

x:Number

API バージョン:V2

親:master_display: white_point

デフォルト:なし

有効な値:0.0001-0.7400

互換性のあるジョブの種類: vod

例:0.31273

説明:

ホワイトポイントのカラーボリュームx設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

y

y:Number

API バージョン:V2

親:master_display: white_point

デフォルト:なし

有効な値:0.0001-0.8400

互換性のあるジョブの種類: vod

例:0.329

説明:

ホワイトポイントのカラーボリュームy設定。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

輝度

luminance:Object

API バージョン:V2

親:master_display

デフォルト:なし

互換性のあるジョブの種類: vod

説明:

輝度設定を含むハッシュ。

{
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

最小

min:Number

API バージョン:V2

親:master_display: 輝度

デフォルト:なし

有効な値:0.0001-5.0

互換性のあるジョブの種類: vod

例:0.0001

説明:

単位またはカンデラ/平方メートル (cd/m2) の最小輝度。

        {
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

最大

max:Number

API バージョン:V2

親:master_display: 輝度

デフォルト:なし

有効な値:5.0-10000.0

互換性のあるジョブの種類: vod

例:1000

説明:

単位またはカンデラ/平方メートル (cd/m2) での最大輝度。

        {
  "input": "s3://mybucket/hdr_master.mov",
  "outputs": [
    {
      "video_codec": "hevc",
      "video_bit_depth": 10,
      "master_display": {
        "red": {
          "x": 0.708,
          "y": 0.292
        },
        "green": {
          "x": 0.17,
          "y": 0.797
        },
        "blue": {
          "x": 0.131,
          "y": 0.046
        },
        "white_point": {
          "x": 0.31273,
          "y": 0.329
        },
        "luminance": {
          "max": 1000,
          "min": 0.0001
        }
      },
      "max_content_light_level": 1000,
      "max_frame_average_light_level": 180
    }
  ]
}

ページコンテンツ

HDR設定

概要

keep_hdr_metadata

hdr_format

display

content_light_level

max_frame_average_light_level

dolby_vision_rpu_url

color_range

赤

x

y

緑

x

y

青

x

y

wite_point

x

y

輝度

最小

最大