08 September 2022
over 2 years ago by Encoding.com Product Team #2
Unknown and Unspecified options for color settings
Added "unknown" and "unspecified" allowed values for <color_primaries />, <color_trc />, <colorspace />, and <color_range /> video settings parameters.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>AddMedia</action>
<source>[SourceFile]</source> <!-- required-->
<format> <!-- required -->
<output>[output]</output> <!-- required -->
<color_range>[ColorRange]</color_range>
<colorspace>[ColorSpace]</colorspace>
<color_primaries>[ColorPrimaries]</color_primaries>
<color_trc>[ColorTRC]</color_trc>
<!-- format params -->
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "AddMedia", // required
"source": "[SourceFile]", // required
"format": { // required
"output": "[output]", // required
"color_range": "[ColorRange]",
"colorspace": "[ColorSpace]",
"color_primaries": "[ColorPrimaries]",
"color_trc": "[ColorTRC]"
// format params
}
}
}
| Parameter | Description | Allowed Values | DEfault Value |
|---|---|---|---|
| color_range | Color range | For cablelabs_mpegts, apple_prores, mxf, and mov output formats: • 0 – unknown • 1 – tv • 2 – pc • 3 – unspecified • 4 – mpeg • 5 – jpeg Other output formats: • tv • mpeg • pc • jpeg • unknown • unspecified | cablelabs_mpegts, apple_prores, mxf, and mov: 0 other formats: none |
| colorspace | Colorspace | • rgb • bt709 • fcc • bt470bg • smpte170m • smpte240m • ycocg • bt2020nc • bt2020c • smpte2085 • chroma-derived-nc • chroma-derived-c • ictcp • unknown • unspecified | none |
| color_primaries | Color Primaries | For cablelabs_mpegts, apple_prores, mxf, and mov output formats: • 2 – auto • 1 – ITU-R BT.709 • 5 – ITU-R BT.601 625-line • 6 – ITU-R BT.601 525-line • 9 – ITU-R BT.2020 • copy Other output formats: • bt709 • bt470m • bt470bg • smpte170m • smpte240m • film • bt2020 • smpte428 • smpte431 • smpte432 • jedec-p22 • unknown • unspecified | cablelabs_mpegts, apple_prores, mxf, and mov: 2 other formats: none |
| color_trc | Color transformation characteristics | • bt709 • gamma22 • gamma28 • smpte170m • smpte240m • linear • log • log_sqrt • log316 • iec61966_2_4 • bt1361 • iec61966_2_1 • bt2020_10 • bt2020_12 • smpte2084 • arib-std-b67 • unknown • unspecified | none |
Add all captions channels to main HLS manifest
Added option to add all closed captions channels to main HLS manifets.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required-->
<format>
<output>[advanced_hls|fmp4_hls|advanced_fmp4]</output> <!-- required-->
<destination>[DestinationURL]</destination> <!-- required-->
<manifest>
<basename>[BaseName]</basename> <!-- required-->
<add_all_cea_cc_channels>[yes|no]</add_all_cea_cc_channels>
<!-- manifest params -->
</manifest>
<!-- Multiple manifests may be included -->
<manifest>
<!-- manifest params -->
</manifest>
<!-- format params -->
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "[Action]", // required
"source": "[SourceFile]", // required
"format": {
"output": "[advanced_hls|fmp4_hls]", // required
"destination": "[DestinationURL]", // required
"manifest": [
{
"basename": "[BaseName]", // required
"add_all_cea_cc_channels": "[yes|no]"
// manifest params
},
{
// manifest params
}
]
// format params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| add_all_cea_cc_channels | Add all CEA CC/SERVICE to the HLS master manifest. By default or if this parameter set to "no", only CC1 will be added for captions with mux_type set to 608 and SERVICE1 for captions with mux_type set to 708 | yes, no | no |
For add_all_cea_cc_channels parameter
The <add_all_cea_cc_channels /> parameter available only for advanced_hls, fmp4_hls, and HLS manifests of advanced_fmp4 output format.