DolbyE

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
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
dolby_e_program parameters
program_configurationProgram Configuration0 – 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_depthOutput bit depth.
Note that for 16 precision, the program configuration is limited to a total of 6 channels
16, 20none
key_presentIndicates whether bitstream keys are presentyes, nonone
mux_modeMux modemono – pair of 2 mono tracks
stereo – stereo track
stereo
audio_stream parameters
dolby_e_program_iddolby_e_program numberNon-negative integer numbernone
descriptionProgram descriptionString, maximum 32 charactersnone
dc_typeAnalog to digital ConverterType0, 10
bitstream_modeAudio bitstream mode0 – Complete Main
1 – Music and Effects
2 – Visually Impaired
3 – Hearing Impaired
4 – Dialogue
5 – Commentary
6 – Emergency
7 – Voice Over
none
copyright_protectedCopyright protectedyes, nonone
highpass_filterEnables the DC high pass filteryes, nonone
original_bitstreamOriginal bitstreamyes, nonone
mixing_levelAudio production mixing levelInteger number between 80 and 111 inclusivenone
room_typeRoom Type0 – not indicated
1 – large room
2 – small room
none

🚧

Format support

DolbyE audio is currently supported only for mxf_op1a output format.