개요
Zencoder가 지원하는 HDR 형식 및 HDR 형식 매개 변수에 대한 권장 사항에 대한 자세한 내용은 HDR 비디오 가이드 .
preserve_hdr_metadata
master_display:Boolean
API 버전: V2
부모의:출력
기본:그릇된
호환 작업 유형: VOD
설명:
true로 설정하면이 매개 변수는 Zencoder가 입력 파일에서 HDR 관련 메타 데이터 (대부분 또는 전체)를 가져 와서 출력으로 전달하도록 지시합니다.
예를 들어 다음 작업 요청을 사용하여 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과content light level HEVC 인코딩 DolbyVision 8.1의 메타 데이터는 스트리밍되는 반면 DolbyVision 동적 메타 데이터 ( RPU file)은 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
}
]
}
또한보십시오:
master_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
}
]
}
또한보십시오:
맥스_컨텐츠_라이트_레벨
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: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"
}
]
}또한보십시오:
video_color_range
video_color_range:String
API 버전: V2
부모님: outputs , dynamic_profile_options
유효한 값 : limited , full
기본:없음
호환 작업 유형: VOD
설명:
픽셀 값의 동적 범위를 나타냅니다. 예를 들어 8 비트 픽셀의 경우limited Y (루마) 픽셀 값이 16에서 235 사이의 범위에 머무르는 반면full Y (루마) 픽셀 값이 0에서 255 사이에 있음을 의미합니다.
현재 대부분의 콘텐츠는limited픽셀. 하나full범위 픽셀도 때때로 사용될 수 있습니다. 예를 들어, 10 비트 폭의 전체 범위 픽셀은 DolbyVision 5 형식으로 사용됩니다.
사용 예 :
{
"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 : red
기본:없음
유효한 값 : 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 : red
기본:없음
유효한 값 : 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
기본:없음
유효한 값 : 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
기본:없음
유효한 값 : 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
기본:없음
유효한 값 : 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
기본:없음
유효한 값 : 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
}
]
}
white_point
white_point:Object
API 버전: V2
부모의: master_display
기본:없음
호환 작업 유형: VOD
설명:
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 버전: V2
부모의: master_display : white_point
기본:없음
유효한 값 : 0.0001-0.7400
호환 작업 유형: VOD
예: 0.31273
설명:
white_point에 대한 색상 볼륨 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
설명:
white_point에 대한 색상 볼륨 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
설명:
최소 휘도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:Number
API 버전: V2
부모의: master_display : 휘도
기본:없음
유효한 값 : 5.0-10000.0
호환 작업 유형: VOD
예: 1000
설명:
최대 휘도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
}
]
}