19 February 2021
almost 4 years ago by Encoding.com Product Team #2
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 |