08 September 2022

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.