Überblick
Einzelheiten zu den von Zencoder unterstützten HDR-Formaten und Empfehlungen zu den HDR-Formatparametern finden Sie im HDR Video Guide.
bewahren_hdr_metadata
master_display:Boolean
API-Versionen: V2
Elternteil: Ausgänge
Standard: falsch
Kompatible Auftragstypen: vod
Beschreibung:
Wenn dieser Wert auf true gesetzt ist, weist dieser Parameter Zencoder an, (die meisten oder alle) HDR-bezogenen Metadaten aus der Eingabedatei zu importieren und an die Ausgabe zu übergeben.
Beispielsweise kann die Transcodierung von HEVC-codierten Videostreams in den Formaten HDR10, PQ10 oder HLG10 mithilfe der folgenden Jobanforderung durchgeführt werden:
{
"input": "s3://mybucket/hdr_master.mp4",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"preserve_hdr_metadata": true
}
]
}Dieser Parameter kann auch in Kombination mit anderen Parametern verwendet werden, wobei HDR-bezogene Metadaten direkt angegeben werden. Die folgende JSON-Auftragsanfrage zeigt beispielsweise, wie preserve_hdr_metadata Parameter auch für die Übergabe verwendet werden können master display und content light level Metadaten aus HEVC-kodierten DolbyVision 8.1-Streams, während DolbyVision dynamische Metadaten (RPU Datei) werden getrennt unter Verwendung des Parameters dolby_vision_rpu_url kommuniziert:
{
"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"
}
]
}Siehe auch:
hdr_format
hdr_format:String
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Gültige Werte: hdr10, pq, hlg, dv5, dv8.1
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Gibt den Typ eines HDR-Formats an, das zur Erzeugung von Ausgaben verwendet wird.
Dieser Parameter sollte in Fällen verwendet werden, in denen Eingabedateien keine Metadaten im HDR-Format enthalten und daher sowohl der Formattyp als auch alle zugehörigen Metadaten direkt angegeben werden müssen.
Beispielsweise kann ein PQ-Farbinhalt, der als J2K-codierter MFX bereitgestellt wird, durch folgende Jobanforderung in einen PQ10-Ausgabestream konvertiert werden:
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "pq"
}
]
}Oder. Wenn derselbe J2K-MXF-Master HDR10-Inhalte darstellt und zusätzliche Dateien enthält, in denen seine Inhalte beschrieben werden Hauptanzeige und Inhalt Lichtstärke Metadatenparameter und deren Codierung im HDR10-HEVC-Stream können mithilfe der folgenden Jobanforderung ausgeführt werden:
{
"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
}
]
}
Siehe auch:
master_display
master_display:Object
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Struktur, die das Farbvolumen (die Farbprimären, den Weißpunkt und den Luminanzbereich) der Anzeige beschreibt, die beim Mastering von Videoinhalten verwendet wurde. Spezifische Werte, die in dieser Struktur verwendet werden, werden durch definiert SMPTE ST 2086 Standard.
Master-Anzeige-Metadaten sind obligatorisch und müssen bei der Kodierung von Videos in den Formaten HDR-10 und DolbyVision 8.1 an die Ausgaben ausgeführt werden.
Das folgende Beispiel zeigt, wie die Metadaten der Masteranzeige angegeben werden können:
{
"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
}
]
}
Siehe auch:
max_content_light_level
max_content_light_level:Number
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Standard: keiner
Gültige Werte: 0-10000
Kompatible Auftragstypen: vod
Beispiel: 1000
Beschreibung:
Beschreibt die maximale Pixelstärke (und den roten, grünen und blauen Kanal) in Bezug auf die Videosequenz. Ausgedrückt in Candellen pro Quadratmeter. Dieser Wert kann auf 0 gesetzt werden, was bedeutet, dass eine solche Grenze unbekannt ist oder nicht auferlegt wird. Dieser Parameter, auch bekannt als MaxCLL ist durch den CAE 861.3-Standard definiert.
Das folgende Beispiel zeigt, wie max_content_light_level , und max_frame_average_light_level Metadaten können angegeben werden:
{
"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
}
]
}Siehe auch:
max_frame_average_light_level
max_frame_average_light_level:Number
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Standard: keiner
Gültige Werte: 5.0-10000.0
Kompatible Auftragstypen: vod
Beispiel: 180
Beschreibung:
Beschreibt den maximalen Bildmittelwert (und den maximalen Rot-, Grün- und Blaukanal-Lichtpegel) für die gesamte Videosequenz. Ausgedrückt in Candellen pro Quadratmeter. Dieser Wert kann auf 0 gesetzt werden, was bedeutet, dass eine solche Grenze unbekannt ist oder nicht auferlegt wird. Dieser Parameter, auch bekannt als MaxFALL ist durch den CAE 861.3-Standard definiert.
Beide max_content_light_level und max_frame_average_light_level Parameter sind obligatorisch und müssen in den Ausgängen enthalten sein, wenn Videos im HDR-10-Format codiert werden.
Das folgende Beispiel zeigt, wie max_content_light_level , und max_frame_average_light_level Metadaten können angegeben werden:
{
"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
}
]
}Siehe auch:
dolby_vision_rpu_url
dolby_vision_rpu_url:String
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Dieser Parameter ist derzeit erforderlich, wenn Videos in den Formaten DolbyVision 5 und DolbyVision 8.1 transcodiert werden.
Anwendungsbeispiel:
{
"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"
}
]
}Siehe auch:
video_color_range
video_color_range:String
API-Versionen: V2
Eltern: outputs, dynamic_profile_options
Gültige Werte: limited, full
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Zeigt den Dynamikbereich der Pixelwerte an. Zum Beispiel für 8-Bit-Pixel: limited impliziert, dass Y (Luma) -Pixelwerte im Bereich von 16 bis 235 bleiben, während full impliziert, dass die Y (Luma) -Pixelwerte im Bereich von 0 bis 255 liegen.
Die überwiegende Mehrheit der Inhalte wird derzeit mit erstellt und codiert limited Pixel. Manchmal können jedoch auch full-Bereichspixel verwendet werden. Beispielsweise werden im DolbyVision 5-Format 10 Bit breite Vollbereichspixel verwendet.
Anwendungsbeispiel:
{
"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"
}
]
}Siehe auch:
rot
red:Object
API-Versionen: V2
Elternteil: master_display
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Hash mit Farbvolumeneinstellung für Rot.
{
"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-Versionen: V2
Elternteil: master_display: rot
Standard: keiner
Gültige Werte: 0.0001-0.7400
Kompatible Auftragstypen: vod
Beispiel: 0.708
Beschreibung:
Farbvolumen x Einstellung für Rot.
{
"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
}
]
}
ja
y:Number
API-Versionen: V2
Elternteil: master_display: rot
Standard: keiner
Gültige Werte: 0.0001-0.8400
Kompatible Auftragstypen: vod
Beispiel: 0.292
Beschreibung:
Farbvolumen y Einstellung für Rot.
{
"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
}
]
}
grün
green:Object
API-Versionen: V2
Elternteil: master_display
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Hash mit Farbvolumeneinstellung für Grün.
{
"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-Versionen: V2
Elternteil: master_display: grün
Standard: keiner
Gültige Werte: 0.0001-0.7400
Kompatible Auftragstypen: vod
Beispiel: 0.17
Beschreibung:
Farbvolumen x Einstellung für Grün.
{
"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
}
]
}
ja
y:Number
API-Versionen: V2
Elternteil: master_display: grün
Standard: keiner
Gültige Werte: 0.0001-0.8400
Kompatible Auftragstypen: vod
Beispiel: 0.797
Beschreibung:
Farbvolumen y Einstellung für Grün.
{
"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
}
]
}
blau
blue:Object
API-Versionen: V2
Elternteil: master_display
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Hash mit Farbvolumeneinstellung für Blau.
{
"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-Versionen: V2
Elternteil: master_display: blau
Standard: keiner
Gültige Werte: 0.0001-0.7400
Kompatible Auftragstypen: vod
Beispiel: 0.131
Beschreibung:
Farbvolumen x Einstellung für Blau.
{
"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
}
]
}
ja
y:Number
API-Versionen: V2
Elternteil: master_display: blau
Standard: keiner
Gültige Werte: 0.0001-0.8400
Kompatible Auftragstypen: vod
Beispiel: 0.046
Beschreibung:
Farbvolumen y Einstellung für Blau.
{
"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
}
]
}
white_point
white_point:Object
API-Versionen: V2
Elternteil: master_display
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Hash mit Farbvolumeneinstellung für white_point.
{
"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-Versionen: V2
Elternteil: master_display: white_point
Standard: keiner
Gültige Werte: 0.0001-0.7400
Kompatible Auftragstypen: vod
Beispiel: 0.31273
Beschreibung:
Farbvolumen x Einstellung für Weißpunkt.
{
"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
}
]
}
ja
y:Number
API-Versionen: V2
Elternteil: master_display: white_point
Standard: keiner
Gültige Werte: 0.0001-0.8400
Kompatible Auftragstypen: vod
Beispiel: 0.329
Beschreibung:
Farbvolumen y Einstellung für white_point.
{
"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
}
]
}
Luminanz
luminance:Object
API-Versionen: V2
Elternteil: master_display
Standard: keiner
Kompatible Auftragstypen: vod
Beschreibung:
Hash mit Luminanzeinstellungen.
{
"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
}
]
}
Mindest
min:Number
API-Versionen: V2
Elternteil: master_display: Luminanz
Standard: keiner
Gültige Werte: 0.0001-5.0
Kompatible Auftragstypen: vod
Beispiel: 0.0001
Beschreibung:
Minimale Leuchtdichte in nits or candelas per square meter (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
max:Number
API-Versionen: V2
Elternteil: master_display: Luminanz
Standard: keiner
Gültige Werte: 5.0-10000.0
Kompatible Auftragstypen: vod
Beispiel: 1000
Beschreibung:
Maximale Leuchtdichte in nits or candelas per square meter (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
}
]
}