Spatial_Audio_Framework/ambi__enc__internal_8c_source.html

/*

 * Copyright 2016-2018 Leo McCormack

 *

 * Permission to use, copy, modify, and/or distribute this software for any

 * purpose with or without fee is hereby granted, provided that the above

 * copyright notice and this permission notice appear in all copies.

 *

 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH

 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

 * AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,

 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR

 * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

 * PERFORMANCE OF THIS SOFTWARE.

 */


#include "ambi_enc.h"

#include "ambi_enc_internal.h"


void loadSourceConfigPreset

(

    SOURCE_CONFIG_PRESETS preset,

    float dirs_deg[MAX_NUM_INPUTS][2],

    int* newNCH

)

{

    int ch, i, nCH;


    nCH = ch = 0;

    switch(preset){

        default:

            /* fall through */

        case SOURCE_CONFIG_PRESET_DEFAULT:

            /* fall through */

        case SOURCE_CONFIG_PRESET_MONO:

            nCH = 1;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __mono_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_STEREO:

            nCH = 2;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __stereo_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_5PX:

            nCH = 5;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __5pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_7PX:

            nCH = 7;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __7pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_8PX:

            nCH = 8;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __8pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_9PX:

            nCH = 9;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __9pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_10PX:

            nCH = 10;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __10pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_11PX:

            nCH = 11;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __11pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_11PX_7_4:

            nCH = 11;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __11pX_7_4_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_13PX:

            nCH = 13;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __13pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_22PX:

            nCH = 22;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __22pX_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_22P2_9_10_3:

            saf_print_error("Not suitable, since it contains LFE channels");

            break;

        case SOURCE_CONFIG_PRESET_AALTO_MCC:

            nCH = 45;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Aalto_MCC_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_AALTO_MCC_SUBSET:

            nCH = 37;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Aalto_MCCsubset_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_AALTO_APAJA:

            nCH = 29;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Aalto_Apaja_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_AALTO_LR:

            nCH = 13;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Aalto_LR_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_DTU_AVIL:

            nCH = 64;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __DTU_AVIL_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_ZYLIA_LAB:

            nCH = 22;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Zylia_Lab_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_4:

            nCH = 4;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_2_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_12:

            nCH = 12;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_4_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_24:

            nCH = 24;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_6_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_36:

            nCH = 36;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_8_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_48:

            nCH = 48;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_9_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_T_DESIGN_60:

            nCH = 60;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __Tdesign_degree_10_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_SPH_COV_9:

            nCH = 9;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __SphCovering_9_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_SPH_COV_16:

            nCH = 16;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __SphCovering_16_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_SPH_COV_25:

            nCH = 25;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __SphCovering_25_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_SPH_COV_49:

            nCH = 49;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __SphCovering_49_dirs_deg[ch][i];

            break;

        case SOURCE_CONFIG_PRESET_SPH_COV_64:

            nCH = 64;

            for(ch=0; ch<nCH; ch++)

                for(i=0; i<2; i++)

                    dirs_deg[ch][i] = __SphCovering_64_dirs_deg[ch][i];

            break;

    }

    saf_assert(nCH>0, "Number of channels must be more than 0");


    /* Fill remaining slots with default coords */

    for(; ch<MAX_NUM_INPUTS; ch++)

        for(i=0; i<2; i++)

            dirs_deg[ch][i] = __default_LScoords128_deg[ch][i];


    /* specify new number of channels (for dynamically changing the number of TFT channels) */

    (*newNCH) = nCH;

}


MAX_NUM_INPUTS
#define MAX_NUM_INPUTS
Maximum number of input channels supported.
Definition _common.h:233

SOURCE_CONFIG_PRESETS
SOURCE_CONFIG_PRESETS
Available source configurations presets to use for encoding/panning.
Definition _common.h:133

ambi_enc.h
A basic Ambisonic encoder.

loadSourceConfigPreset
void loadSourceConfigPreset(SOURCE_CONFIG_PRESETS preset, float dirs_deg[MAX_NUM_INPUTS][2], int *newNCH)
Returns the source directions for a specified source config preset.
Definition ambi_enc_internal.c:30

ambi_enc_internal.h
A basic Ambisonic encoder.

saf_print_error
#define saf_print_error(message)
Macro to print a error message along with the filename and line number.
Definition saf_utilities.h:127

__Zylia_Lab_dirs_deg
const float __Zylia_Lab_dirs_deg[22][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the 22.x setup, at Zylia Labs.
Definition saf_utility_loudspeaker_presets.c:392

saf_assert
#define saf_assert(x, message)
Macro to make an assertion, along with a string explaining its purpose.
Definition saf_utilities.h:133

__9pX_dirs_deg
const float __9pX_dirs_deg[9][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 9.x setup.
Definition saf_utility_loudspeaker_presets.c:69

__SphCovering_16_dirs_deg
const float __SphCovering_16_dirs_deg[16][2]
Directions [azimuth, Elevation] in degrees, for sphere covering: 16 dirs.
Definition saf_utility_loudspeaker_presets.c:30084

__Aalto_MCC_dirs_deg
const float __Aalto_MCC_dirs_deg[45][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the multi-channel anechoic chamber (MCC),...
Definition saf_utility_loudspeaker_presets.c:190

__SphCovering_49_dirs_deg
const float __SphCovering_49_dirs_deg[49][2]
Directions [azimuth, Elevation] in degrees, for sphere covering: 49 dirs.
Definition saf_utility_loudspeaker_presets.c:31239

__mono_dirs_deg
const float __mono_dirs_deg[1][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a mono setup.
Definition saf_utility_loudspeaker_presets.c:31

__5pX_dirs_deg
const float __5pX_dirs_deg[5][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 5.x setup.
Definition saf_utility_loudspeaker_presets.c:40

__11pX_dirs_deg
const float __11pX_dirs_deg[11][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 11.x setup.
Definition saf_utility_loudspeaker_presets.c:94

__Tdesign_degree_9_dirs_deg
const float __Tdesign_degree_9_dirs_deg[48][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 9.
Definition saf_utility_loudspeaker_presets.c:767

__Tdesign_degree_2_dirs_deg
const float __Tdesign_degree_2_dirs_deg[4][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 2.
Definition saf_utility_loudspeaker_presets.c:621

__11pX_7_4_dirs_deg
const float __11pX_7_4_dirs_deg[11][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 7.4.x setup.
Definition saf_utility_loudspeaker_presets.c:108

__Tdesign_degree_8_dirs_deg
const float __Tdesign_degree_8_dirs_deg[36][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 8.
Definition saf_utility_loudspeaker_presets.c:727

__default_LScoords128_deg
const float __default_LScoords128_deg[128][2]
Default Loudspeaker directions [azimuth, Elevation] - to replace above!
Definition saf_utility_loudspeaker_presets.c:483

__Aalto_MCCsubset_dirs_deg
const float __Aalto_MCCsubset_dirs_deg[37][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the multi-channel anechoic chamber (MCC) ...
Definition saf_utility_loudspeaker_presets.c:237

__Aalto_Apaja_dirs_deg
const float __Aalto_Apaja_dirs_deg[29][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the audio-visual listening room (Apaja),...
Definition saf_utility_loudspeaker_presets.c:277

__SphCovering_9_dirs_deg
const float __SphCovering_9_dirs_deg[9][2]
Directions [azimuth, Elevation] in degrees, for sphere covering: 9 dirs.
Definition saf_utility_loudspeaker_presets.c:29979

__stereo_dirs_deg
const float __stereo_dirs_deg[2][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a stereo setup.
Definition saf_utility_loudspeaker_presets.c:35

__SphCovering_64_dirs_deg
const float __SphCovering_64_dirs_deg[64][2]
Directions [azimuth, Elevation] in degrees, for sphere covering: 64 dirs.
Definition saf_utility_loudspeaker_presets.c:32124

__Tdesign_degree_4_dirs_deg
const float __Tdesign_degree_4_dirs_deg[12][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 4.
Definition saf_utility_loudspeaker_presets.c:639

__Aalto_LR_dirs_deg
const float __Aalto_LR_dirs_deg[13][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the ITU standard listening room (LR),...
Definition saf_utility_loudspeaker_presets.c:309

__DTU_AVIL_dirs_deg
const float __DTU_AVIL_dirs_deg[64][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for the Audio Visual Immersion Lab (AVIL),...
Definition saf_utility_loudspeaker_presets.c:325

__8pX_dirs_deg
const float __8pX_dirs_deg[8][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 8.x setup.
Definition saf_utility_loudspeaker_presets.c:58

__Tdesign_degree_6_dirs_deg
const float __Tdesign_degree_6_dirs_deg[24][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 6.
Definition saf_utility_loudspeaker_presets.c:671

__13pX_dirs_deg
const float __13pX_dirs_deg[13][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 13.x setup.
Definition saf_utility_loudspeaker_presets.c:122

__7pX_dirs_deg
const float __7pX_dirs_deg[7][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 7.x setup.
Definition saf_utility_loudspeaker_presets.c:48

__22pX_dirs_deg
const float __22pX_dirs_deg[22][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 22.x setup.
Definition saf_utility_loudspeaker_presets.c:138

__SphCovering_25_dirs_deg
const float __SphCovering_25_dirs_deg[25][2]
Directions [azimuth, Elevation] in degrees, for sphere covering: 25 dirs.
Definition saf_utility_loudspeaker_presets.c:30291

__Tdesign_degree_10_dirs_deg
const float __Tdesign_degree_10_dirs_deg[60][2]
Directions [azimuth, Elevation] in degrees, for minimum Tdesign degree: 10.
Definition saf_utility_loudspeaker_presets.c:819

__10pX_dirs_deg
const float __10pX_dirs_deg[10][2]
Loudspeaker directions [azimuth, Elevation] in degrees, for a 10.x setup.
Definition saf_utility_loudspeaker_presets.c:81