29 April 2020

DolbyVision HDR Support

Added support of DolbyVision HDR

Advanced Multibitrate Formats

<?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>[dv5|dv81]</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": "[dv5|dv81]",
                    "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
hdrEnable HDRhdr10 – HDR 10
dv5 – DolbyVision 5
dv81 – DolbyVision 8.1
none

Mpegts and MP4 containers

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mp4_hdr|mpegts_hdr]</output> <!-- required-->
        <video_codec>[dv5|dv81]</video_codec>
        <audio_codec>eac3</audio_codec>
        <profile>main</profile>
        <two_pass>[yes|no]</two_pass>
        <dolby_vision_md>[MetaDataFile]</dolby_vision_md>
        <audio_source_file>[AudioSourceFile]</audio_source_file>
        <!-- Format params -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mp4_hdr|mpegts_hdr]", // required
            "video_codec": "[dv5|dv81]",
            "audio_codec": "eac3",
            "profile": "main",
            "two_pass": "[yes|no]",
            "dolby_vision_md": "[MetaDataFile]",
            "audio_source_file": "[AudioSourceFile]"
            // Format params
        }
    }
}
ParameterDescriptionAvailable ValuesDefault Value
video_codecVideo Codecdv5 – DolbyVision 5
dv81 – DolbyVision 8.1
none
audio_codecAudio Codeceac3eac3
profileProfilemainmain
two_passTwo Pass encodingyes, noyes
dolby_vision_mdDolby Vision metadata fileValid URLnone
audio_source_fileAudio source fileValid URLnone

Blank Frames Insertion

Add Blank-Frames source blocks to insert blank sequences between source parts.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>AddMedia</action> <!-- required -->
    <source>[SourceFile1]</source> <!-- required -->
    <source>
        <color>[Color]</color> <!-- required -->
        <duration>[InsertionDuration]</duration> <!-- required -->
    </source>
    <source>[SourceFile2]</source>
    <source>
        <color>[Color]</color> <!-- required -->
        <duration>[InsertionDuration]</duration> <!-- required -->
    </source>
    <source>[SourceFile3]</source>
    <format> <!-- required -->
        <!-- Format params --> 
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": [ // required
            "[SourceFile1]", 
            {
                "color": "[Color]", // required
                "duration": "[Duration]" // required
            },
            "[SourceFile2]", 
            {
                "color": "[Color]", // required
                "duration": "[Duration]" // required
            },
            "[SourceFile3]", 
        ],
        "format": { // required
            // Format params
        }
    }
}
colorVideo Insertion solid colorColor in hex formatnone
durationSequence durationValid Timecode in format:
HH:mm:ss:SS - non-dropframe timecode
HH:mm:ss;SS - dropframe timecode
none

🚧

Note

Blank-Frames insertion for now supported only by single-bitrate output formats (e.g. mp4, mpegts, etc.)

❗️

Note

Blank-Frames insertion not working with Split-Screen