04 February 2021

Apple ProRes Audio Stream Layout Description

Added option that allows selecting the audio stream layout description in the apple_prores output format.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <format> 
        <output>apple_prores</output> <!-- required -->
        <audio_stream>
            <layout_in_audio_channel_description>[yes|no]</layout_in_audio_channel_description>
            <!-- 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": "apple_prores", //required
            "audio_stream": [
                {
                    "layout_in_audio_channel_description": "[yes|no]"
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}
ParameterDescriptionAllowed ValueDefault Value
Audio Stream Parameters
layout_in_audio_channel_descriptionUse audio channel description instead of channel bitmap to tag channel layout in Audio Channel Layout Atomyes –  use audio channel description to tag layout
no – use channel bitmap
no

Consistent Audio Stream Channels Number

Added option that performs audio stream channels downmix or upmix to match specified audio channels number. Added LFE control options.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required -->
    <format>
        <output>[OutputFormat]</output> <!-- required -->
        <audio_stream>
            <audio_channels_number>[ChannelsNumber]</audio_channels_number>
            <automix_channels>[yes|no]</automix_channels>
            <lfe_low>[LfeLow]</lfe_low>
            <lfe_high>[LfeHigh]</lfe_high>
            <lfe_gain>[LfeGain]</lfe_gain>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- multiple audio_streams -->
        <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": "[OutputFormat]", // required
            "audio_stream": [
                {
                    "audio_channels_number": "[ChannelsNumber]",
                    "automix_channels": "[yes|no]",
                    "lfe_low": "[LfeLow]",
                    "lfe_high": "[LfeHigh]",
                    "lfe_gain": "[LfeGain]"
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Values
automix_channelsAutomatically upmix or downmix audio stream to the specified number of channels in <audio_channels_number />yes, nono
lfe_lowLFE low cut off frequencyInteger number between 3 and 25520
lfe_highLFE high cut off frequencyInteger number between 3 and 512120
lfe_gainLFE gainFloat number between 0 and 1none

🚧

Note for lfe_low, lfe_hight, and lfe_gain

<lfe_low />, <lfe_hight />, and <lfe_gain /> parameters will be allied only in case of channel upmixing.