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>[UserID]</userid> <!-- required-->
<userkey>[UserKey]</userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required -->
<format>
<output>[mxf_op1a|mov]</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": "[UserID]", // required
"userkey": "[UserKey]", // required
"action": "AddMedia", // required
"source": "[SourceFile]", // required
"format": { // required
"output": "[mxf_op1a|mov]", // 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 | - | - | - |
audio_stream 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 |
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 and mov output formats.