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
        }
    }
}
ParameterDescriptionAvailable ValuesDefault Value
#### Format Parameters
hdrEnable HDRhdr10none
color_rangeColor rangefull, limitednone
#### Master Display Parameters
red_xRed X display primaryFloat number between 0 and 1 included.0.68
red_yRed Y display primaryFloat number between 0 and 1 included.0.32
green_xGreen X display primaryFloat number between 0 and 1 included.0.265
green_yGreen Y display primaryFloat number between 0 and 1 included.0.69
blue_xBlue X display primaryFloat number between 0 and 1 included.0.15
blue_yBlue Y display primaryFloat number between 0 and 1 included.0.06
white_xWhite point XFloat number between 0 and 1 included.0.3127
white_yWhite point YFloat number between 0 and 1 included.0.329
luminance_minMinimum luminanceFloat number between 0 and 65535 included.0.0001
luminance_maxMaximum luminanceFloat number between 0 and 65535 included.1000
max_cllMaximum Content Light Level.Float number between 0 and 65535 included.
0 - no maximum is indicated.
0
max_fallMaximum 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
        }
    }
}
ParameterDescriptionAvailable ValuesDefault Value
segment_templateSelect which SegmentTemplate placeholder will be usedSelect which SegmentTemplate placeholder will be usednumber

🚧

For segment_template parameter

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