19 February 2021

Additional MXF parameters with the MPEG2 video codec

Added several new features for the MXF output format with the mpeg2video video codec.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>mxf</output> <!-- required-->
        <video_codec>mpeg2video</video_codec> <!-- required-->
        <framerate>[FrameRate|copy]</framerate>
        <scale_in_color_matrix>[ColorMatrix]</scale_in_color_matrix>
        <scale_out_color_matrix>[ColorMatrix]</scale_out_color_matrix>
        <video_tag>[Tag]</video_tag>
        <deinterlacing>[yes|filter|no|auto]</deinterlacing>
        <video_codec_parameters>
            <colorprim>[ColorPrimaries]</colorprim>
            <transfer>[ColorTransfer]</transfer>
            <colorspace>[ColorSpace]</colorspace>
            <vprofile>[0]</vprofile>
            <level>[VideoLevel]</level>
             <!-- video codec parameters -->
        </video_codec_parameters>
        <!-- format parameters -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "mxf", // required
            "video_codec": "mpeg2video",
            "framerate": "[FrameRate|copy]",
            "scale_in_color_matrix": "[ColorMatrix]",
            "scale_out_color_matrix": "[ColorMatrix]",
            "video_tag": "[Tag]",
            "deinterlacing": "[yes|filter|no|auto]",
            "video_codec_parameters": {
                "colorprim": "[ColorPrimaries]",
                "transfer": "[ColorTransfer]",
                "colorspace": "[ColorSpace]",
                "vprofile": "[0]",
                "level": "[VideoLevel]"
                // video codec parameters
            }
            // format parameters
        }
    }
}

Parameter	Description	Allowed Values	Default Value
framerate	Specifies the frame rate.	Any non-zero float or N/M where N and M are non-zero integers ‘copy’ – take source’s framerate mxf*: 60, 59.94, 60000/1001, 50, 29.97, 30000/1001, 25, 23.98, 24000/1001	All: none psp**: 30000/1001
scale_in_color_matrix	Scaler Input Color Matrix	auto, bt601, bt740, smpte170m, bt709, fcc, smpte240m, bt2020	none
scale_out_color_matrix	Scaler Output Color Matrix	auto, bt601, bt740, smpte170m, bt709, fcc, smpte240m, bt2020	none
video_tag	Video Tag	String	none
deinterlacing	Enable de-interlacing.	yes* – force apply de-interlacing filter* – use ffmpeg de-interlacing filter no* – don't apply de-interlacing auto* – use de-interlacing if source's scan type is interlaced	auto
Video Codec Parameters
colorprim	Color Primaries	bt709, bt470m, bt470bg, smpte170m, smpte240m, film, bt2020, undef, unspecified	none
transfer	Color Transfer	bt709, bt470m, bt470bg, smpte170m, smpte240m, linear, log100, log316, iec61966-2-4, bt1361e, iec61966-2-1, bt2020-10, bt2020-12, undef	none
colorspace	Color Space	rgb, bt709, fcc, bt470bg, smpte170m, smpte240m, ycocg, bt2020_ncl, bt2020_cl, smpte2085, chroma-derived-nc, chroma-derived-c, ictcp, unspecified	none
vprofile	Video Profile	0* - 4:2:2	none
level	Video Level	Positive Integer Number	none

🚧
For video_tag parameter
<video_tag > parameter available only for mxf outptu format.

Availability of the Dolby Encoding Engine (DEE) for audio processing

Added an option that allows to select the audio encoder for eac3 audio codec.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source>
    <format> <!-- required -->
        <output>[output]</output> <!-- REQUIRED -->
        <audio_encoder>[auto|dee]</audio_encoder>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "audio_encoder": "[auto|dee]"
            // format params
        }
    }
}

Parameter	Description	Allowed Value	Default Value
audio_encoder	Select what audio encoder will be used for eac3 audio codec	auto, dee	none

Advanced EAC3 audio processing with the Dolby Encoding Engine

Extended processing parameters with the EAC3 audio_codec with Dolby Encoding Engine.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source>
    <format> <!-- required -->
        <output>[output]</output> <!-- REQUIRED -->
        <audio_codec>eac3</audio_codec>
        <audio_encoder>dee</audio_encoder>
        <downmix_mode>[pl2|loro|ltrt]</downmix_mode>
        <loudness_mode>[LoudnessMode]</loudness_mode>
        <speech_threshold>[Threshold]</speech_threshold>
        <loudnorm_preset>[Preset]</loudnorm_preset>
        <peak_reference>[true_peak|sample_peak]</peak_reference>
        <correction_mode>[pcm_scale|md_update]</correction_mode>
        <peak_limit_db>[PeakLimit]</peak_limit_db>
        <dynrange_line>[DynarangeProfile]</dynrange_line>
        <dynrange_rf>[DynarangeProfile]</dynrange_rf>
        <ddp_bitstream_mode>[BitStreamMode]</ddp_bitstream_mode>
        <lfe_surround>[yes|no]</lfe_surround>
        <lowpass_filter>[yes|no]</lowpass_filter>
        <hybrid_downmix>[yes|no]</hybrid_downmix>
        <surround_mode>[not_indicated|yes|no]</surround_mode>
        <surround_mode_ex>[not_indicated|yes|no]</surround_mode_ex>
        <surr_shift>[yes|no]</surr_shift>
        <surr_attenuation>[yes|no]</surr_attenuation>
        <audio_stream>
            <audio_codec>eac3</audio_codec>
            <audio_encoder>dee</audio_encoder>
            <audio_encoder>dee</audio_encoder>
            <downmix_mode>[pl2|loro|ltrt]</downmix_mode>
            <loudness_mode>[LoudnessMode]</loudness_mode>
            <speech_threshold>[Threshold]</speech_threshold>
            <loudnorm_preset>[Preset]</loudnorm_preset>
            <peak_reference>[true_peak|sample_peak]</peak_reference>
            <correction_mode>[pcm_scale|md_update]</correction_mode>
            <peak_limit_db>[PeakLimit]</peak_limit_db>
            <dynrange_line>[DynarangeProfile]</dynrange_line>
            <dynrange_rf>[DynarangeProfile]</dynrange_rf>
            <ddp_bitstream_mode>[BitStreamMode]</ddp_bitstream_mode>
            <lfe_surround>[yes|no]</lfe_surround>
            <lowpass_filter>[yes|no]</lowpass_filter>
            <hybrid_downmix>[yes|no]</hybrid_downmix>
            <surround_mode>[not_indicated|yes|no]</surround_mode>
            <surround_mode_ex>[not_indicated|yes|no]</surround_mode_ex>
            <surr_shift>[yes|no]</surr_shift>
            <surr_attenuation>[yes|no]</surr_attenuation>
            <!-- audio stream params -->
        <audio_stream>
        <audio_stream>
            <!-- audio stream params -->
        <audio_stream>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "audio_codec": "eac3",
            "audio_encoder": "dee",
            "downmix_mode": "[pl2|loro|ltrt]",
            "loudness_mode": "[LoudnessMode]",
            "speech_threshold": "[Threshold]",
            "loudnorm_preset": "[Preset]",
            "peak_reference": "[true_peak|sample_peak]",
            "correction_mode": "[pcm_scale|md_update]",
            "peak_limit_db": "[PeakLimit]",
            "dynrange_line": "[DynarangeProfile]",
            "dynrange_rf": "[DynarangeProfile]",
            "ddp_bitstream_mode": "[BitStreamMode]",
            "lfe_surround": "[yes|no]",
            "lowpass_filter": "[yes|no]",
            "hybrid_downmix": "[yes|no]",
            "surround_mode": "[not_indicated|yes|no]",
            "surround_mode_ex": "[not_indicated|yes|no]",
            "surr_shift": "[yes|no]",
            "surr_attenuation": "[yes|no]",
            "audio_stream": [
                {
                    "audio_codec": "eac3",
                    "audio_encoder": "dee",
                    "downmix_mode": "[pl2|loro|ltrt]",
                    "loudness_mode": "[LoudnessMode]",
                    "speech_threshold": "[Threshold]",
                    "loudnorm_preset": "[Preset]",
                    "peak_reference": "[true_peak|sample_peak]",
                    "correction_mode": "[pcm_scale|md_update]",
                    "peak_limit_db": "[PeakLimit]",
                    "dynrange_line": "[DynarangeProfile]",
                    "dynrange_rf": "[DynarangeProfile]",
                    "ddp_bitstream_mode": "[BitStreamMode]",
                    "lfe_surround": "[yes|no]",
                    "lowpass_filter": "[yes|no]",
                    "hybrid_downmix": "[yes|no]",
                    "surround_mode": "[not_indicated|yes|no]",
                    "surround_mode_ex": "[not_indicated|yes|no]",
                    "surr_shift": "[yes|no]",
                    "surr_attenuation": "[yes|no]",
                    // audio stream params
                },
                {
                    // audio stream params
                }
            ]
            // format params
        }
    }
}

Parameter	Description	Allowed Value	Default Value
downmix_mode	Dolby Encoding Engine downmix mode	pl2, loro, ltrt	pl2
loudness_mode	Dolby Encoding Engine loudness mode	1770-3, 1770-2-di, 1770-1-di, 1770-2, 1770-3, leqA	none
speech_threshold	Speech threshold percentage	Integer number between 0 and 100	none
loudnorm_preset	Loudness measurement and correction according to one of the preset standards	manual, atsc_a85, atsc_a85_agile, ebu_r128, freetv_op59, arib_b32	none
peak_reference	Peak reference mode	true_peak, sample_peak/	none
correction_mode	Loudness correction mode	pcm_scale, md_update	none
peak_limit_db	Maximum Audio Output Level	Float number with one digit between -12 and -0.1	-0.1
dynrange_line	Line dynamic range control profile	film_standard, film_light, music_standard, music_light, speech	none
dynrange_rf	RF dynamic range control profile	film_standard, film_light, music_standard, music_light, speech	none
ddp_bitstream_mode	Audio bitstream mode	music_and_effects, visually_impaired, hearing_impaired, dialogue, commentary, emergency, voice_over	none
lfe_surround	Low-Frequency Effects	yes, no	none
lowpass_filter	Lowpass filter for the LFE channel	yes, no	none
hybrid_downmix	Hybrid downmix	yes, no	none
surround_mode	Dolby Surround mode	not_indicated, yes, no	none
surround_mode_ex	Dolby Surround EX mode	not_indicated, yes, no	none
surr_shift	Surround 90 degree phase shift	yes, no	none
surr_attenuation	Surround -3dB attenuation	yes, no	none