19 March 2020

HDR

Added support of High Dynamic Range video.

🚧
Note
HDR parameters available only for hevc <video_codec />.

🚧
Note
HDR parameters available only for mp4, mpegts, fmp4_hls, advanced_dash, and advanced_fmp4 output formats.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mp4|mpegts]</output> <!-- required-->
        <hdr>[hdr10]</hdr>
        <color_range>[full|limited]</color_range>
        <master_display>
            <red_x>[RedX]</red_x>
            <red_y>[RedY]</red_y>
            <green_x>[GreenX]</green_x>
            <green_y>[GreenY]</green_y>
            <blue_x>[BlueX]</blue_x>
            <blue_y>[BlueY]</blue_y>
            <white_x>[WhiteX]</white_x>
            <white_y>[WhiteY]</white_y>
            <luminance_min>[MinLuminance]</luminance_min>
            <luminance_max>[MaxLuminance]</luminance_max>
            <max_cll>[MaxCLL]</max_cll>
            <max_fall>[MaxFALL]</max_fall>
        </master_display>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mp4|mpegts]", // required
            "hdr": "[hdr10]",
            "color_range": "[full|limited]",
            "master_display": {
                "red_x": "[RedX]",
                "red_y": "[RedY]",
                "green_x": "[GreenX]",
                "green_y": "[GreenY]",
                "blue_x": "[BlueX]",
                "blue_y": "[BlueY]",
                "white_x": "[WhiteX]",
                "white_y": "[WhiteY]",
                "luminance_min": "[MinLuminance]",
                "luminance_max": "[MaxLuminance]",
                "max_cll": "[MaxCLL]",
                "max_fall": "[MaxFALL]"
            }
            // Format params
        }
    }
}

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[fmp4_hls|advanced_dash|advanced_fmp4]</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <stream>
            <hdr>[hdr10]</hdr>
            <color_range>[full|limited]</color_range>
            <master_display>
                <red_x>[RedX]</red_x>
                <red_y>[RedY]</red_y>
                <green_x>[GreenX]</green_x>
                <green_y>[GreenY]</green_y>
                <blue_x>[BlueX]</blue_x>
                <blue_y>[BlueY]</blue_y>
                <white_x>[WhiteX]</white_x>
                <white_y>[WhiteY]</white_y>
                <luminance_min>[MinLuminance]</luminance_min>
                <luminance_max>[MaxLuminance]</luminance_max>
                <max_cll>[MaxCLL]</max_cll>
                <max_fall>[MaxFALL]</max_fall>
            </master_display>
        </stream>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[fmp4_hls|advanced_dash|advanced_fmp4]", // required
            "destination": "[DestinationURL]", // required
            "stream": [
                {
                    "hdr": "[hdr10]",
                    "color_range": "[full|limited]",
                    "master_display": {
                        "red_x": "[RedX]",
                        "red_y": "[RedY]",
                        "green_x": "[GreenX]",
                        "green_y": "[GreenY]",
                        "blue_x": "[BlueX]",
                        "blue_y": "[BlueY]",
                        "white_x": "[WhiteX]",
                        "white_y": "[WhiteY]",
                        "luminance_min": "[MinLuminance]",
                        "luminance_max": "[MaxLuminance]",
                        "max_cll": "[MaxCLL]",
                        "max_fall": "[MaxFALL]"
                    }
                }
            ],
            "segment_template": "[number|time]"
            // Format params
        }
    }
}

Parameter	Description	Available Values	Default Value
Format Parameters
hdr	Enable HDR	hdr10	none
color_range	Color range	full, limited	none
Master Display Parameters
red_x	Red X display primary	Float number between 0 and 1 included.	0.68
red_y	Red Y display primary	Float number between 0 and 1 included.	0.32
green_x	Green X display primary	Float number between 0 and 1 included.	0.265
green_y	Green Y display primary	Float number between 0 and 1 included.	0.69
blue_x	Blue X display primary	Float number between 0 and 1 included.	0.15
blue_y	Blue Y display primary	Float number between 0 and 1 included.	0.06
white_x	White point X	Float number between 0 and 1 included.	0.3127
white_y	White point Y	Float number between 0 and 1 included.	0.329
luminance_min	Minimum luminance	Float number between 0 and 65535 included.	0.0001
luminance_max	Maximum luminance	Float number between 0 and 65535 included.	1000
max_cll	Maximum Content Light Level.	Float number between 0 and 65535 included. 0 - no maximum is indicated.	0
max_fall	Maximum Frame-Average Light Level.	Float number between 0 and 65535 included. 0 - no maximum is indicated.	0

MP4 Ludicrous Mode

Added support for mp4 output format for media with Ludicrous Mode.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>AddMedia</action> <!-- required -->
    <source>[SourceURL]</source> <!-- required -->
    <ludicrous_mode>[yes|no]</ludicrous_mode>
    <format>
        <output>mp4</output> 
      	<destination>[DestinationURL]</destination> <!-- required -->
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[SourceURL]", // required
        "ludicrous_mode": "[yes|no]",
        "format": {
            "output": "mp4",
            "destination": "[DestinationURL]" // required
            // Format params
        }
    }
}

SegmentTemplate type for advanced_dash and advanced_fmp4 output formats

Added option <segment_template /> to select which SegmentTemplate will be used for dash manifest for advanced_dash and advanced_fmp4 output formats.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[advanced_dash|advanced_fmp4]</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <segment_template>[number|time]</segment_template>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[advanced_dash|advanced_fmp4]", // required
            "destination": "[DestinationURL]", // required
            "segment_template": "[number|time]"
            // Format params
        }
    }
}

Parameter	Description	Available Values	Default Value
segment_template	Select which SegmentTemplate placeholder will be used	Select which SegmentTemplate placeholder will be used	number

🚧
For segment_template parameter
<segment_template /> parameter available only for advanced_dash and advanced_fmp4 output formats.

HDR

Note

Note

Format Parameters

Master Display Parameters

MP4 Ludicrous Mode

SegmentTemplate type for advanced_dash and advanced_fmp4 output formats

For segment_template parameter