10 February 2022

Upmix Channel Gain

Added support of customizing of audio stream upmix channel gain.
The <lfe_gain /> parameter support removed.

<?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>
            <upmix_channel_gain>
                <fl>[FLGain]</fl>
                <fr>[FRGain]</fr>
                <fc>[FCGain]</fc>
                <lfe>[LFGain]</lfe>
                <sl>[SLGain]</sl>
                <sr>[SRGain]</sr>
                <bl>[BLGain]</bl>
                <br>[BRGain]</br>
                <bc>[BCGain]</bc>
            </upmix_channel_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": [
                {
                    "upmix_channel_gain": {
                        "fl": "[FLGain]",
                        "fr": "[FRGain]',
                        "fc": "[FCGain]",
                        "lfe": "[LFGain]",
                        "sl": "[SLGain]",
                        "sr": "[SRGain]",
                        "bl": "[BLGain]",
                        "br": "[BRGain]",
                        "bc": "[BCGain]"
                    }
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}

Parameter

Description

Allowed Values

Default Value

Upmix Channel Gain Parameters

fl

Left channel gain

Float number between 0 and 1 inclusive

none

fr

Right channel gain

Float number between 0 and 1 inclusive

none

fc

Center channel gain

Float number between 0 and 1 inclusive

none

lfe

LFE channel gain

Float number between 0 and 1 inclusive

none

sl

Side left channel gain

Float number between 0 and 1 inclusive

none

sr

Side right channel gain

Float number between 0 and 1 inclusive

none

bl

Back left channel gain

Float number between 0 and 1 inclusive

none

br

Back right channel gain

Float number between 0 and 1 inclusive

none

bc

Back center channel gain

Float number between 0 and 1 inclusive

none

Alpha Masking Filter

Added ability to apply alpha masking filter

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <alpha_mask>[yes|no]</alpha_mask>
        <!-- format parameters -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "alpha_mask": "[yes|no]"
            // format parameters
        }
    }
}

Parameter

Description

Allowed Values

Default Value

alpha_mask

Apply alpha masking filter

yes, no

no