24 November 2022

Framerate interpolation

Added option to change output frame-rate by interpolating output frames from the source frames

<?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 -->
        <framerate_interpolation>[yes|no]</video_codec>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "framerate_interpolation": "[yes|no]"
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
framerate_interpolation	Change the output frame rate by interpolating new video output frames from the source frames	yes, no	no

ITU-R BT.470 / ITU-R BT.601 625-line for color-space parameters

Added new allowed values for <transfer_characteristics /> and <matrix_coefficients /> parameters.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[OutputFormat]</output> <!-- required-->
        <transfer_characteristics>[TransferCharacteristics]</transfer_characteristics>
        <matrix_coefficients>[MatrixCoefficients]</matrix_coefficients>
        <!-- common format parameters -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<id>>", // required
        "action": "AddMedia",
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[OutputFormat]", // required
            "transfer_characteristics": "[TransferCharacteristics]",
            "matrix_coefficients": "[MatrixCoefficients]"
            // common format parameters
        }
    }
}

Parameter	Description	Allowed Values	Default Value
transfer_characteristics	Transfer Characteristics	2* – auto 1* – ITU-R BT.709 / BT.601 / BT.2020 16* – SMPTE ST 2084 (PQ) 18* – BT.2100 Hybrid Log Gamma 5* – ITU-R BT.470 / ITU-R BT.601 625-line 6– ITU-R BT.601 copy*	2
matrix_coefficients	Matrix Coefficients	2* – auto 1* – ITU-R BT.709, 6 – ITU-R BT.601 9* – ITU-R BT.2020 5* – ITU-R BT.470 / ITU-R BT.601 625-line 6– ITU-R BT.601 525-line copy*	2

Allowed 25 fps framerate for Cablelabs MPEGTS

Added new allowed value (25 fps) for <framerate /> parameter of cablelabs_mpegts output format.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>cablelabs_mpegts</output> <!-- required-->
        <framerate>[FrameRate]</framerate>
        <video_codec>[VideoCodec]</video_codec>
        <!-- common format parameters -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<id>>", // required
        "action": "AddMedia",
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "cablelabs_mpegts", // required
            "framerate": "[FrameRate]"
            // common format parameters
        }
    }
}

Parameter	Description	Allowed Values	Default Value
framerate	Specifies the frame rate.	23.976, 24, 25, 29.97, 30, 59.94	none

MXF OP1a new video codecs

Added new allowed values for <video_codec /> parameter of mxf_op1a output format.

<?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 -->
        <video_codec>[VideoCodec]</video_codec>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "video_codec": "[VideoCodec]"
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
video_codec	Defines the codec used for your output.	mxf_op1a*: mpeg2video, libx264, xdcamhd422, dvcpro, dvcpro50, dvcprohd, imx30, xdcam, copy	mxf_op1a*: mpeg2video

DolbyE audio

Added support of DolbyE audio format.

DolbyE is an audio format containing one or more audio programs packed together in one stream. Muxed DolbyE audio is shown as an AES3 stereo audio stream in the output file. Additionally, it can be muxed in "split form", and represented by pair of AES3 mono streams.

DolbyE output is configured using <dolby_e_program /> block on the format level.

DolbyE output contains one or more audio programs. These programs are represented by existing audio_stream entities. To include audio_stream element as an audio program into DolbyE output you should set <audio_codec /> to dolbye and <dolby_e_program_id /> to the number of the desired output from <dolby_e_program />.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required -->
    <format>
        <output>mxf_op1a</output> <!-- required -->
        <dolby_e_program>
            <program_configuration>[ProgramConfiguration]</program_configuration>
            <bit_depth>[16|20]</bit_depth>
            <key_present>[yes|no]</key_present>
            <mux_mode>[stereo|mono]</mux_mode>
        </dolby_e_program>
        <!-- multiple dolby_e_programs -->
        <dolby_e_program>
            <!-- dolby_e_program params -->
        </dolby_e_program>
        <audio_stream>
            <audio_codec>dolbye</audio_codec>
            <dolby_e_program_id>[ProgramID]</dolby_e_program_id>
            <description>[Description]</description>
            <dc_type>[0|1]</dc_type>
            <bitstream_mode>[BitstreamMode]</bitstream_mode>
            <copyright_protected>[yes|no]</copyright_protected>
            <highpass_filter>[yes|no]</highpass_filter>
            <original_bitstream>[yes|no]</original_bitstream>
            <mixing_level>[yes|no]</mixing_level>
            <room_type>[0|1|2]</room_type>
        </audio_stream>
        <!-- multiple audio_streams -->
        <audio_stream>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "mxf_op1a", // required
            "dolby_e_program": [
                {
                    "program_configuration": "[ProgramConfiguration]",
                    "bit_depth": "[16|20]",
                    "key_present": "[yes|no]",
                    "mux_mode": "[stereo|mono]"
                },
                {
                    // dolby_e_program params
                }
            ],
            "audio_stream": [
                {
                    "audio_codec": "dolbye",
                    "dolby_e_program_id": "[ProgramID]",
                    "description": "[Description]",
                    "dc_type": "[0|1]",
                    "bitstream_mode": "[BitstreamMode]",
                    "copyright_protected": "[yes|no]",
                    "highpass_filter": "[yes|no]",
                    "original_bitstream": "[yes|no]",
                    "mixing_level": "[yes|no]",
                    "room_type": "[0|1|2]"
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
dolby_e_program parameters
program_configuration	Program Configuration	0* – 5.1 + 2 1* – 5.1 + 1 + 1 2* – 4 + 4 3* – 4 + 2 + 2 4* – 4 + 2 + 1 + 1 5* – 4 + 1 + 1 + 1 + 1 6* – 2 + 2 + 2 + 2 7* – 2 + 2 + 2 + 1 + 1 8* – 2 + 2 + 1 + 1 + 1 + 1 9* – 2 + 1 + 1 + 1 + 1 + 1 + 1 10* – 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 11* – 5.1 12* – 4 + 2 13* – 4 + 1 + 1 14* – 2 + 2 + 2 15* – 2 + 2 + 1 + 1 16* – 2 + 1 + 1 + 1 + 1 17* – 1 + 1 + 1 + 1 + 1 + 1 18* – 4 19* – 2 + 2 20* – 2 + 1 + 1 21* – 1 + 1 + 1 + 1 22* – 7.1 23* – 7.1 Screen	0
bit_depth	Output bit depth. Note that for 16 precision, the program configuration is limited to a total of 6 channels	16, 20	none
key_present	Indicates whether bitstream keys are present	yes, no	none
mux_mode	Mux mode	mono* – pair of 2 mono tracks stereo* – stereo track	stereo
audio_stream parameters
dolby_e_program_id	dolby_e_program number	Non-negative integer number	none
description	Program description	String, maximum 32 characters	none
dc_type	Analog to digital ConverterType	0, 1	0
bitstream_mode	Audio bitstream mode	0* – Complete Main 1* – Music and Effects 2* – Visually Impaired 3* – Hearing Impaired 4* – Dialogue 5* – Commentary 6* – Emergency 7* – Voice Over	none
copyright_protected	Copyright protected	yes, no	none
highpass_filter	Enables the DC high pass filter	yes, no	none
original_bitstream	Original bitstream	yes, no	none
mixing_level	Audio production mixing level	Integer number between 80 and 111 inclusive	none
room_type	Room Type	0* – not indicated 1* – large room 2* – small room	none

🚧
Format support
DolbyE audio is currently supported only for mxf_op1a output format.