_ak_speaker_config_8h

Other Documentation

Wwise SDK 2022.1.7

 /*******************************************************************************

 The content of this file includes portions of the AUDIOKINETIC Wwise Technology

 released in source code form as part of the SDK installer package.

 Commercial License Usage

 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology

 may use this file in accordance with the end user license agreement provided 

 with the software or, alternatively, in accordance with the terms contained in a

 written agreement between you and Audiokinetic Inc.

 Apache License Usage

 Alternatively, this file may be used under the Apache License, Version 2.0 (the 

 "Apache License"); you may not use this file except in compliance with the 

 Apache License. You may obtain a copy of the Apache License at 

 http://www.apache.org/licenses/LICENSE-2.0.

 Unless required by applicable law or agreed to in writing, software distributed

 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES

 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for

 the specific language governing permissions and limitations under the License.

   Copyright (c) 2023 Audiokinetic Inc.

 *******************************************************************************/

 #ifndef _AK_SPEAKERCONFIG_H_

 #define _AK_SPEAKERCONFIG_H_

 #include <AK/SoundEngine/Common/AkTypes.h>

 /// Standard speakers (channel mask):

 #define AK_SPEAKER_FRONT_LEFT               0x1     ///< Front left speaker bit mask

 #define AK_SPEAKER_FRONT_RIGHT              0x2     ///< Front right speaker bit mask

 #define AK_SPEAKER_FRONT_CENTER             0x4     ///< Front center speaker bit mask

 #define AK_SPEAKER_LOW_FREQUENCY            0x8     ///< Low-frequency speaker bit mask

 #define AK_SPEAKER_BACK_LEFT                0x10    ///< Rear left speaker bit mask

 #define AK_SPEAKER_BACK_RIGHT               0x20    ///< Rear right speaker bit mask

 #define AK_SPEAKER_BACK_CENTER              0x100   ///< Rear center speaker ("surround speaker") bit mask

 #define AK_SPEAKER_SIDE_LEFT                0x200   ///< Side left speaker bit mask

 #define AK_SPEAKER_SIDE_RIGHT               0x400   ///< Side right speaker bit mask

 /// "Height" speakers.

 #define AK_SPEAKER_TOP                      0x800   ///< Top speaker bit mask

 #define AK_SPEAKER_HEIGHT_FRONT_LEFT        0x1000  ///< Front left speaker bit mask

 #define AK_SPEAKER_HEIGHT_FRONT_CENTER      0x2000  ///< Front center speaker bit mask

 #define AK_SPEAKER_HEIGHT_FRONT_RIGHT       0x4000  ///< Front right speaker bit mask

 #define AK_SPEAKER_HEIGHT_BACK_LEFT         0x8000  ///< Rear left speaker bit mask

 #define AK_SPEAKER_HEIGHT_BACK_CENTER       0x10000 ///< Rear center speaker bit mask

 #define AK_SPEAKER_HEIGHT_BACK_RIGHT        0x20000 ///< Rear right speaker bit mask

 //

 // Supported speaker setups. Those are the ones that can be used in the Wwise Sound Engine audio pipeline.

 //

 #define AK_SPEAKER_SETUP_MONO           AK_SPEAKER_FRONT_CENTER     ///< 1.0 setup channel mask

 #define AK_SPEAKER_SETUP_0POINT1        AK_SPEAKER_LOW_FREQUENCY    ///< 0.1 setup channel mask

 #define AK_SPEAKER_SETUP_1POINT1        (AK_SPEAKER_FRONT_CENTER    | AK_SPEAKER_LOW_FREQUENCY) ///< 1.1 setup channel mask

 #define AK_SPEAKER_SETUP_STEREO         (AK_SPEAKER_FRONT_LEFT      | AK_SPEAKER_FRONT_RIGHT)   ///< 2.0 setup channel mask

 #define AK_SPEAKER_SETUP_2POINT1        (AK_SPEAKER_SETUP_STEREO    | AK_SPEAKER_LOW_FREQUENCY) ///< 2.1 setup channel mask

 #define AK_SPEAKER_SETUP_3STEREO        (AK_SPEAKER_SETUP_STEREO    | AK_SPEAKER_FRONT_CENTER)  ///< 3.0 setup channel mask

 #define AK_SPEAKER_SETUP_3POINT1        (AK_SPEAKER_SETUP_3STEREO   | AK_SPEAKER_LOW_FREQUENCY) ///< 3.1 setup channel mask

 #define AK_SPEAKER_SETUP_4              (AK_SPEAKER_SETUP_STEREO    | AK_SPEAKER_SIDE_LEFT | AK_SPEAKER_SIDE_RIGHT) ///< 4.0 setup channel mask

 #define AK_SPEAKER_SETUP_4POINT1        (AK_SPEAKER_SETUP_4         | AK_SPEAKER_LOW_FREQUENCY) ///< 4.1 setup channel mask

 #define AK_SPEAKER_SETUP_5              (AK_SPEAKER_SETUP_4         | AK_SPEAKER_FRONT_CENTER)  ///< 5.0 setup channel mask

 #define AK_SPEAKER_SETUP_5POINT1        (AK_SPEAKER_SETUP_5         | AK_SPEAKER_LOW_FREQUENCY) ///< 5.1 setup channel mask

 #define AK_SPEAKER_SETUP_6              (AK_SPEAKER_SETUP_4         | AK_SPEAKER_BACK_LEFT | AK_SPEAKER_BACK_RIGHT) ///< 6.0 setup channel mask

 #define AK_SPEAKER_SETUP_6POINT1        (AK_SPEAKER_SETUP_6         | AK_SPEAKER_LOW_FREQUENCY) ///< 6.1 setup channel mask

 #define AK_SPEAKER_SETUP_7              (AK_SPEAKER_SETUP_6         | AK_SPEAKER_FRONT_CENTER)  ///< 7.0 setup channel mask

 #define AK_SPEAKER_SETUP_7POINT1        (AK_SPEAKER_SETUP_7         | AK_SPEAKER_LOW_FREQUENCY) ///< 7.1 setup channel mask

 #define AK_SPEAKER_SETUP_SURROUND       (AK_SPEAKER_SETUP_STEREO    | AK_SPEAKER_BACK_CENTER)   ///< Legacy surround setup channel mask

 // Note. DPL2 does not really have 4 channels, but it is used by plugins to differentiate from stereo setup.

 #define AK_SPEAKER_SETUP_DPL2           (AK_SPEAKER_SETUP_4)        ///< Legacy DPL2 setup channel mask

 #define AK_SPEAKER_SETUP_HEIGHT_2       (AK_SPEAKER_HEIGHT_FRONT_LEFT | AK_SPEAKER_HEIGHT_FRONT_RIGHT)                              ///< 2 speaker height layer.

 #define AK_SPEAKER_SETUP_HEIGHT_4       (AK_SPEAKER_SETUP_HEIGHT_2  | AK_SPEAKER_HEIGHT_BACK_LEFT | AK_SPEAKER_HEIGHT_BACK_RIGHT)   ///< 4 speaker height layer.

 #define AK_SPEAKER_SETUP_HEIGHT_5       (AK_SPEAKER_SETUP_HEIGHT_4 | AK_SPEAKER_HEIGHT_FRONT_CENTER)                                ///< 5 speaker height layer.

 #define AK_SPEAKER_SETUP_HEIGHT_ALL     (AK_SPEAKER_SETUP_HEIGHT_5 | AK_SPEAKER_HEIGHT_BACK_CENTER)                                 ///< All height speaker layer.

 #define AK_SPEAKER_SETUP_HEIGHT_4_TOP   (AK_SPEAKER_SETUP_HEIGHT_4 | AK_SPEAKER_TOP)                                                ///< 4 speaker height layer + top.

 #define AK_SPEAKER_SETUP_HEIGHT_5_TOP   (AK_SPEAKER_SETUP_HEIGHT_5 | AK_SPEAKER_TOP)                                                ///< 5 speaker height layer + top.

 // Auro speaker setups

 #define AK_SPEAKER_SETUP_AURO_222           (AK_SPEAKER_SETUP_4         | AK_SPEAKER_HEIGHT_FRONT_LEFT  | AK_SPEAKER_HEIGHT_FRONT_RIGHT)    ///< Auro-222 setup channel mask (4.0.2)

 #define AK_SPEAKER_SETUP_AURO_8             (AK_SPEAKER_SETUP_AURO_222  | AK_SPEAKER_HEIGHT_BACK_LEFT   | AK_SPEAKER_HEIGHT_BACK_RIGHT)     ///< Auro-8 setup channel mask (4.0.4)

 #define AK_SPEAKER_SETUP_AURO_9             (AK_SPEAKER_SETUP_AURO_8    | AK_SPEAKER_FRONT_CENTER)                                          ///< Auro-9.0 setup channel mask (5.0.4)

 #define AK_SPEAKER_SETUP_AURO_9POINT1       (AK_SPEAKER_SETUP_AURO_9    | AK_SPEAKER_LOW_FREQUENCY)                                         ///< Auro-9.1 setup channel mask (5.1.4)

 #define AK_SPEAKER_SETUP_AURO_10            (AK_SPEAKER_SETUP_AURO_9    | AK_SPEAKER_TOP)                                                   ///< Auro-10.0 setup channel mask (5.0.4+top)

 #define AK_SPEAKER_SETUP_AURO_10POINT1      (AK_SPEAKER_SETUP_AURO_10   | AK_SPEAKER_LOW_FREQUENCY)                                         ///< Auro-10.1 setup channel mask (5.1.4+top)

 #define AK_SPEAKER_SETUP_AURO_11            (AK_SPEAKER_SETUP_AURO_10   | AK_SPEAKER_HEIGHT_FRONT_CENTER)                                   ///< Auro-11.0 setup channel mask (5.0.5+top)

 #define AK_SPEAKER_SETUP_AURO_11POINT1      (AK_SPEAKER_SETUP_AURO_11   | AK_SPEAKER_LOW_FREQUENCY)                                         ///< Auro-11.1 setup channel mask (5.1.5+top)

 #define AK_SPEAKER_SETUP_AURO_11_740        (AK_SPEAKER_SETUP_7         | AK_SPEAKER_SETUP_HEIGHT_4)                                        ///< Auro-11.0 (7+4) setup channel mask (7.0.4)

 #define AK_SPEAKER_SETUP_AURO_11POINT1_740  (AK_SPEAKER_SETUP_AURO_11_740   | AK_SPEAKER_LOW_FREQUENCY)                                     ///< Auro-11.1 (7+4) setup channel mask (7.1.4)

 #define AK_SPEAKER_SETUP_AURO_13_751        (AK_SPEAKER_SETUP_7         | AK_SPEAKER_SETUP_HEIGHT_5 | AK_SPEAKER_TOP)                       ///< Auro-13.0 setup channel mask (7.0.5+top)

 #define AK_SPEAKER_SETUP_AURO_13POINT1_751  (AK_SPEAKER_SETUP_AURO_13_751   | AK_SPEAKER_LOW_FREQUENCY)                                     ///< Auro-13.1 setup channel mask (7.1.5+top)

 // Dolby speaker setups: in Dolby nomenclature, [#plane].[lfe].[#height]

 #define AK_SPEAKER_SETUP_DOLBY_5_0_2        (AK_SPEAKER_SETUP_5         | AK_SPEAKER_HEIGHT_FRONT_LEFT  | AK_SPEAKER_HEIGHT_FRONT_RIGHT )   ///< Dolby 5.0.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_5_1_2        (AK_SPEAKER_SETUP_DOLBY_5_0_2   | AK_SPEAKER_LOW_FREQUENCY )                                    ///< Dolby 5.1.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_6_0_2        (AK_SPEAKER_SETUP_6         | AK_SPEAKER_HEIGHT_FRONT_LEFT  | AK_SPEAKER_HEIGHT_FRONT_RIGHT )   ///< Dolby 6.0.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_6_1_2        (AK_SPEAKER_SETUP_DOLBY_6_0_2   | AK_SPEAKER_LOW_FREQUENCY )                                    ///< Dolby 6.1.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_6_0_4        (AK_SPEAKER_SETUP_DOLBY_6_0_2   | AK_SPEAKER_HEIGHT_BACK_LEFT | AK_SPEAKER_HEIGHT_BACK_RIGHT )  ///< Dolby 6.0.4 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_6_1_4        (AK_SPEAKER_SETUP_DOLBY_6_0_4   | AK_SPEAKER_LOW_FREQUENCY )                                    ///< Dolby 6.1.4 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_7_0_2        (AK_SPEAKER_SETUP_7         | AK_SPEAKER_HEIGHT_FRONT_LEFT  | AK_SPEAKER_HEIGHT_FRONT_RIGHT )   ///< Dolby 7.0.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_7_1_2        (AK_SPEAKER_SETUP_DOLBY_7_0_2   | AK_SPEAKER_LOW_FREQUENCY )                                    ///< Dolby 7.1.2 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_7_0_4        (AK_SPEAKER_SETUP_DOLBY_7_0_2   | AK_SPEAKER_HEIGHT_BACK_LEFT | AK_SPEAKER_HEIGHT_BACK_RIGHT )  ///< Dolby 7.0.4 setup channel mask

 #define AK_SPEAKER_SETUP_DOLBY_7_1_4        (AK_SPEAKER_SETUP_DOLBY_7_0_4   | AK_SPEAKER_LOW_FREQUENCY )                                    ///< Dolby 7.1.4 setup channel mask

 #define AK_SPEAKER_SETUP_ALL_SPEAKERS       (AK_SPEAKER_SETUP_7POINT1 | AK_SPEAKER_BACK_CENTER | AK_SPEAKER_SETUP_HEIGHT_ALL | AK_SPEAKER_TOP)  ///< All speakers.

 // Channel indices.

 // ------------------------------------------------

 // Channel indices for standard setups on the plane.

 #define AK_IDX_SETUP_FRONT_LEFT             (0) ///< Index of front-left channel in all configurations.

 #define AK_IDX_SETUP_FRONT_RIGHT            (1) ///< Index of front-right channel in all configurations.

 #define AK_IDX_SETUP_CENTER                 (2) ///< Index of front-center channel in all configurations.

 #define AK_IDX_SETUP_NOCENTER_BACK_LEFT     (2) ///< Index of back-left channel in configurations with no front-center channel.

 #define AK_IDX_SETUP_NOCENTER_BACK_RIGHT    (3) ///< Index of back-right channel in configurations with no front-center channel.

 #define AK_IDX_SETUP_NOCENTER_SIDE_LEFT     (4) ///< Index of side-left channel in configurations with no front-center channel.

 #define AK_IDX_SETUP_NOCENTER_SIDE_RIGHT    (5) ///< Index of side-right channel in configurations with no front-center channel.

 #define AK_IDX_SETUP_WITHCENTER_BACK_LEFT   (3) ///< Index of back-left channel in configurations with a front-center channel.

 #define AK_IDX_SETUP_WITHCENTER_BACK_RIGHT  (4) ///< Index of back-right channel in configurations with a front-center channel.

 #define AK_IDX_SETUP_WITHCENTER_SIDE_LEFT   (5) ///< Index of side-left channel in configurations with a front-center channel.

 #define AK_IDX_SETUP_WITHCENTER_SIDE_RIGHT  (6) ///< Index of side-right channel in configurations with a front-center channel.

 // Channel indices for specific setups.

 #define AK_IDX_SETUP_0_LFE          (0) ///< Index of low-frequency channel in 0.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_1_CENTER       (0) ///< Index of center channel in 1.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_1_LFE          (1) ///< Index of low-frequency channel in 1.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_2_LEFT         (0) ///< Index of left channel in 2.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_2_RIGHT        (1) ///< Index of right channel in 2.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_2_LFE          (2) ///< Index of low-frequency channel in 2.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_3_LEFT         (0) ///< Index of left channel in 3.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_3_RIGHT        (1) ///< Index of right channel in 3.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_3_CENTER       (2) ///< Index of center channel in 3.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_3_LFE          (3) ///< Index of low-frequency channel in 3.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_4_FRONTLEFT    (0) ///< Index of front left channel in 4.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_4_FRONTRIGHT   (1) ///< Index of front right channel in 4.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_4_REARLEFT     (2) ///< Index of rear left channel in 4.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_4_REARRIGHT    (3) ///< Index of rear right channel in 4.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_4_LFE          (4) ///< Index of low-frequency channel in 4.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_FRONTLEFT    (0) ///< Index of front left channel in 5.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_FRONTRIGHT   (1) ///< Index of front right channel in 5.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_CENTER       (2) ///< Index of center channel in 5.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_REARLEFT     (3) ///< Index of rear left channel in 5.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_REARRIGHT    (4) ///< Index of rear right channel in 5.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_5_LFE          (5) ///< Index of low-frequency channel in 5.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_FRONTLEFT    (0) ///< Index of front left channel in 6.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_FRONTRIGHT   (1) ///< Index of front right channel in 6x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_REARLEFT     (2) ///< Index of rear left channel in 6.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_REARRIGHT    (3) ///< Index of rear right channel in 6.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_SIDELEFT     (4) ///< Index of side left channel in 6.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_SIDERIGHT    (5) ///< Index of side right channel in 6.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_6_LFE          (6) ///< Index of low-frequency channel in 6.1 setup (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_FRONTLEFT    (0) ///< Index of front left channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_FRONTRIGHT   (1) ///< Index of front right channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_CENTER       (2) ///< Index of center channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_REARLEFT     (3) ///< Index of rear left channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_REARRIGHT    (4) ///< Index of rear right channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_SIDELEFT     (5) ///< Index of side left channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_SIDERIGHT    (6) ///< Index of side right channel in 7.x setups (use with AkAudioBuffer::GetChannel())

 #define AK_IDX_SETUP_7_LFE          (7) ///< Index of low-frequency channel in 7.1 setup (use with AkAudioBuffer::GetChannel())

 //

 // Extra speaker setups. This is a more exhaustive list of speaker setups, which might not all be supported

 // by the Wwise Sound Engine audio pipeline.

 //

 #define AK_SPEAKER_SETUP_0_1        ( AK_SPEAKER_LOW_FREQUENCY )                            //0.1

 #define AK_SPEAKER_SETUP_1_0_CENTER ( AK_SPEAKER_FRONT_CENTER )                         //1.0 (C)

 #define AK_SPEAKER_SETUP_1_1_CENTER ( AK_SPEAKER_FRONT_CENTER   | AK_SPEAKER_LOW_FREQUENCY )    //1.1 (C)

 #define AK_SPEAKER_SETUP_2_0        ( AK_SPEAKER_FRONT_LEFT | AK_SPEAKER_FRONT_RIGHT )                          //2.0

 #define AK_SPEAKER_SETUP_2_1        ( AK_SPEAKER_FRONT_LEFT | AK_SPEAKER_FRONT_RIGHT | AK_SPEAKER_LOW_FREQUENCY )   //2.1

 #define AK_SPEAKER_SETUP_3_0        ( AK_SPEAKER_FRONT_LEFT | AK_SPEAKER_FRONT_RIGHT | AK_SPEAKER_FRONT_CENTER )    //3.0

 #define AK_SPEAKER_SETUP_3_1        ( AK_SPEAKER_SETUP_3_0  | AK_SPEAKER_LOW_FREQUENCY )    //3.1

 #define AK_SPEAKER_SETUP_FRONT      ( AK_SPEAKER_SETUP_3_0 )

 #define AK_SPEAKER_SETUP_4_0        ( AK_SPEAKER_SETUP_4 )

 #define AK_SPEAKER_SETUP_4_1        ( AK_SPEAKER_SETUP_4POINT1 )

 #define AK_SPEAKER_SETUP_5_0        ( AK_SPEAKER_SETUP_5 )

 #define AK_SPEAKER_SETUP_5_1        ( AK_SPEAKER_SETUP_5POINT1 )

 #define AK_SPEAKER_SETUP_6_0        ( AK_SPEAKER_SETUP_6 )

 #define AK_SPEAKER_SETUP_6_1        ( AK_SPEAKER_SETUP_6POINT1 )

 #define AK_SPEAKER_SETUP_7_0        ( AK_SPEAKER_SETUP_7 )

 #define AK_SPEAKER_SETUP_7_1        ( AK_SPEAKER_SETUP_7POINT1 )

 // Standard/largest setup definitions.

 #define AK_SPEAKER_SETUP_DEFAULT_PLANE          (AK_SPEAKER_SETUP_7POINT1)  ///< All speakers on the plane, supported on this platform.

 #define AK_SUPPORTED_STANDARD_CHANNEL_MASK      (AK_SPEAKER_SETUP_ALL_SPEAKERS) ///< Platform supports all standard channels.

 #define AK_STANDARD_MAX_NUM_CHANNELS            (8)                         ///< Legacy: Platform supports at least 7.1

 #define AK_MAX_AMBISONICS_ORDER (5)

 // Helpers.

 inline void AK_SPEAKER_SETUP_FIX_LEFT_TO_CENTER( AkUInt32 &io_uChannelMask )

 {

     if( !(io_uChannelMask & AK_SPEAKER_FRONT_CENTER) 

         && !(io_uChannelMask & AK_SPEAKER_FRONT_RIGHT)

         && (io_uChannelMask & AK_SPEAKER_FRONT_LEFT) )

     {

         io_uChannelMask &= ~AK_SPEAKER_FRONT_LEFT;      // remove left

         io_uChannelMask |= AK_SPEAKER_FRONT_CENTER; // add center

     }

 }

 inline void AK_SPEAKER_SETUP_FIX_REAR_TO_SIDE( AkUInt32 &io_uChannelMask )

 {

     if( io_uChannelMask & ( AK_SPEAKER_BACK_LEFT ) && !( io_uChannelMask & AK_SPEAKER_SIDE_LEFT ) )

     {

         io_uChannelMask &= ~( AK_SPEAKER_BACK_LEFT | AK_SPEAKER_BACK_RIGHT );   // remove rears

         io_uChannelMask |= ( AK_SPEAKER_SIDE_LEFT | AK_SPEAKER_SIDE_RIGHT );    // add sides

     }

 }

 inline void AK_SPEAKER_SETUP_CONVERT_TO_SUPPORTED( AkUInt32 &io_uChannelMask )

 {

     AK_SPEAKER_SETUP_FIX_LEFT_TO_CENTER( io_uChannelMask );

     AK_SPEAKER_SETUP_FIX_REAR_TO_SIDE( io_uChannelMask );

 }

 /// Ambisonics configurations (corresponding to AkChannelConfig::eConfigType == AK_ChannelConfigType_Ambisonic).

 /// Convention: X points towards the front, and XYZ follow a right-hand rule, so Y is the side vector (pointing to the left).

 /// Channel presence and ordering are predefined according to the number of channels. The ordering convention is ACN,

 /// with the mapping of components to number of channels detailed below (source: https://en.wikipedia.org/wiki/Ambisonic_data_exchange_formats).

 /// Normalization natively used in Wwise is SN3D.

 ///

 /// <table cellspacing="0" cellpadding="1" border="1" width="800px">

 /// <tr><td rowspan="2" align="center"><b>Number of channels</b></td> <td colspan="2" align="center"><b>Order</b></td><td rowspan="2" align="center"><b>Description</b></td><td rowspan="2" align="center"><b>Layout of components</b></td></tr>

 /// <tr><td align="center">Horizontal</td><td align="center">Vertical</td></tr>

 /// <tr><td align="right">1 &nbsp;&nbsp;&nbsp;</td> <td align="right">0 &nbsp;&nbsp;&nbsp;</td><td align="right">0 &nbsp;&nbsp;&nbsp;</td> <td>&nbsp;&nbsp;mono</td><td>&nbsp;</td></tr>

 /// <tr><td align="right">4 &nbsp;&nbsp;&nbsp;</td> <td align="right">1 &nbsp;&nbsp;&nbsp;</td><td align="right">1 &nbsp;&nbsp;&nbsp;</td> <td>&nbsp;&nbsp;first-order full sphere</td><td>&nbsp;&nbsp;WYZX</td></tr>

 /// <tr><td align="right">9 &nbsp;&nbsp;&nbsp;</td> <td align="right">2 &nbsp;&nbsp;&nbsp;</td><td align="right">2 &nbsp;&nbsp;&nbsp;</td> <td>&nbsp;&nbsp;second-order full sphere</td><td>&nbsp;&nbsp;WYZXVTRSU</td></tr>

 /// <tr><td align="right">16 &nbsp;&nbsp;&nbsp;</td> <td align="right">3 &nbsp;&nbsp;&nbsp;</td><td align="right">3 &nbsp;&nbsp;&nbsp;</td> <td>&nbsp;&nbsp;third-order full sphere</td><td>&nbsp;&nbsp;WYZXVTRSUQOMKLNP</td></tr>

 /// </table>

 namespace AK

 {

 /// Returns the number of channels of a given channel configuration.

 static inline AkUInt8 ChannelMaskToNumChannels( AkChannelMask in_uChannelMask )

 {

     AkUInt8 num = 0;

     while( in_uChannelMask ){ ++num; in_uChannelMask &= in_uChannelMask-1; } // iterate max once per channel.

     return num;

 }

 /// Returns a 'best guess' channel configuration from a given number of channels.

 /// Will return 0 if no guess can be made.

 static inline AkChannelMask ChannelMaskFromNumChannels( unsigned int in_uNumChannels )

 {

     AkChannelMask uChannelMask = 0;

     switch ( in_uNumChannels )

     {

     case 1:

         uChannelMask = AK_SPEAKER_SETUP_1_0_CENTER;

         break;

     case 2:

         uChannelMask = AK_SPEAKER_SETUP_2_0;

         break;

     case 3:

         uChannelMask = AK_SPEAKER_SETUP_2_1;

         break;

     case 4:

         uChannelMask = AK_SPEAKER_SETUP_4_0;

         break;

     case 5:

         uChannelMask = AK_SPEAKER_SETUP_5_0;

         break;

     case 6:

         uChannelMask = AK_SPEAKER_SETUP_5_1;

         break;

     case 7:

         uChannelMask = AK_SPEAKER_SETUP_7;

         break;

     case 8:

         uChannelMask = AK_SPEAKER_SETUP_7POINT1;

         break;

     }

     return uChannelMask;

 }

 /// Converts a channel bit to a channel index (in Wwise pipeline ordering - LFE at the end), given a channel mask in_uChannelMask.

 /// \return Channel index.

 static inline AkUInt8 ChannelBitToIndex(AkChannelMask in_uChannelBit, AkChannelMask in_uChannelMask)

 {

 #ifdef AKASSERT

     AKASSERT(ChannelMaskToNumChannels(in_uChannelBit) == 1);

 #endif

     if (in_uChannelBit == AK_SPEAKER_LOW_FREQUENCY)

         return ChannelMaskToNumChannels(in_uChannelMask) - 1;

     return ChannelMaskToNumChannels(in_uChannelMask & ~AK_SPEAKER_LOW_FREQUENCY & (in_uChannelBit - 1)); // Count all channels prior this one except the LFE

 }

 /// Returns true when the LFE channel is present in a given channel configuration.

 /// \return True if the LFE channel is present.

 AkForceInline bool HasLFE(AkChannelMask in_uChannelMask)

 {

     return (in_uChannelMask & AK_SPEAKER_LOW_FREQUENCY) > 0;

 }

 /// Returns true when the center channel is present in a given channel configuration.

 /// Note that mono configurations have one channel which is arbitrary set to AK_SPEAKER_FRONT_CENTER,

 /// so HasCenter() returns true for mono signals.

 /// \return True if the center channel is present.

 AkForceInline bool HasCenter(AkChannelMask in_uChannelMask)

 {

     // All supported non-mono configurations have an AK_SPEAKER_FRONT_LEFT.

     return (in_uChannelMask & AK_SPEAKER_FRONT_CENTER) > 0;

 }

 /// Returns the number of angle values required to represent the given channel configuration.

 /// Use this function with supported 2D standard channel configurations only.

 /// \sa AK::SoundEngine::SetSpeakerAngles().

 AkForceInline AkUInt32 GetNumberOfAnglesForConfig(AkChannelMask in_uChannelMask)

 {

 #ifdef AKASSERT

     AKASSERT((in_uChannelMask & ~AK_SPEAKER_SETUP_DEFAULT_PLANE) == 0);

 #endif

     // LFE is irrelevant.

     in_uChannelMask &= ~AK_SPEAKER_LOW_FREQUENCY;

     // Center speaker is always in the center and thus does not require an angle.

     in_uChannelMask &= ~AK_SPEAKER_FRONT_CENTER;

     // We should have complete pairs at this point, unless there is a speaker at 180 degrees, 

     // in which case we need one more angle to specify it.

 #ifdef AKASSERT

     AKASSERT((in_uChannelMask & AK_SPEAKER_BACK_CENTER) || ((ChannelMaskToNumChannels(in_uChannelMask) % 2) == 0));

 #endif

     return ChannelMaskToNumChannels(in_uChannelMask) >> 1;

 }

 /// Channel ordering type. 

 enum AkChannelOrdering

 {

     ChannelOrdering_Standard,   // L-R-C-LFE-RL-RR-RC-SL-SR-HL-HR-HC-HRL-HRR-HRC-T

     ChannelOrdering_RunTime     // L-R-C-RL-RR-RC-SL-SR-HL-HR-HC-HRL-HRR-HRC-T-LFE

 };

 /// Returns true if standard configuration represented by channel mask has surround

 /// channels, either defined as side or back channels.

 AkForceInline bool HasSurroundChannels( AkChannelMask in_uChannelMask )

 {

     return ( in_uChannelMask & AK_SPEAKER_BACK_LEFT || in_uChannelMask & AK_SPEAKER_SIDE_LEFT );

 }

 /// Returns true if standard configuration represented by channel mask has strictly one

 /// pair of surround channels, either defined as side or back channels. 7.1 has two pairs

 /// of surround channels and would thus return false.

 AkForceInline bool HasStrictlyOnePairOfSurroundChannels( AkChannelMask in_uChannelMask )

 {

     return ( ( ( in_uChannelMask & AK_SPEAKER_BACK_LEFT ) != 0 ) ^ ( ( in_uChannelMask & AK_SPEAKER_SIDE_LEFT ) != 0 ) );

 }

 /// Returns true if standard configuration represented by channel mask has two

 /// pair of surround channels, that is, side and back channels. 7.1 has two pairs

 /// of surround channels and would thus return true, whereas 5.1 would return false.

 AkForceInline bool HasSideAndRearChannels( AkChannelMask in_uChannelMask )

 {

     return ( in_uChannelMask & AK_SPEAKER_BACK_LEFT && in_uChannelMask & AK_SPEAKER_SIDE_LEFT );

 }

 /// Returns true if standard configuration represented by channel mask has at least one "height" channel (above the plane).

 AkForceInline bool HasHeightChannels(AkChannelMask in_uChannelMask)

 {

     return (in_uChannelMask & ~AK_SPEAKER_SETUP_DEFAULT_PLANE) > 0;

 }

 /// Takes a channel mask and swap back channels with side channels if there is just

 /// one pair of surround channels.

 AkForceInline AkChannelMask BackToSideChannels( AkChannelMask in_uChannelMask )

 {

     if ( HasStrictlyOnePairOfSurroundChannels( in_uChannelMask ) )

     {

         in_uChannelMask &= ~( AK_SPEAKER_BACK_LEFT | AK_SPEAKER_BACK_RIGHT );   // remove rears

         in_uChannelMask |= ( AK_SPEAKER_SIDE_LEFT | AK_SPEAKER_SIDE_RIGHT );    // add sides

     }

     return in_uChannelMask;

 }

 /// Convert channel indices as they are ordered in standard (WAV) or Wwise sound engine (WEM) wave files 

 /// (which follow channel mask bit values, except that the LFE is at the end in the case of WEMs) 

 /// into display indices. Desired display order is L-R-C-SL-SR-RL-RR-HL-HR-HC-HRL-HRR-HRC-T-LFE. Note that 4-5.x configurations 

 /// may define back or side channels. Either way they are "Surround" channels and are assigned to "SL, SR" names.

 static inline unsigned int StdChannelIndexToDisplayIndex( AkChannelOrdering in_eOrdering, unsigned int in_uChannelMask, unsigned int in_uChannelIdx )

 {

     if ( in_eOrdering == ChannelOrdering_Standard )

     {

         unsigned int uNumChannelsFront = ChannelMaskToNumChannels( in_uChannelMask & AK_SPEAKER_SETUP_FRONT );

         if ( ( in_uChannelMask & AK_SPEAKER_LOW_FREQUENCY )

             && ( in_uChannelIdx == uNumChannelsFront ) )

         {

             // Lfe. Return penultimate channel.

             in_uChannelIdx = ChannelMaskToNumChannels( in_uChannelMask ) - 1;

         }

         else if ( in_uChannelIdx >= uNumChannelsFront ) // strictly greater than uNumChannelsFront (lfe index) if lfe is present, greater or equal otherwise.

         {

             // Back channel. Return index or index-1 if there is an LFE (uLfeOffset==1).

             unsigned int uLfeOffset = ( in_uChannelMask & AK_SPEAKER_LOW_FREQUENCY ) ? 1 : 0;

             // 6-7.x: Need to swap back and sides.

             if ( HasSideAndRearChannels( in_uChannelMask ) )

             {

                 unsigned int uRearIdx = uNumChannelsFront + uLfeOffset;

                 unsigned int uSideIdx = uRearIdx + 2;

                 unsigned int uAfterSideIdx = uSideIdx + 2;

                 if ( in_uChannelIdx < uAfterSideIdx )

                 {               

                     if ( in_uChannelIdx >= uSideIdx )

                         in_uChannelIdx -= 2;    // input is side, swap it with back.

                     else

                         in_uChannelIdx += 2;    // input is back, swap it with side.

                 }

             }

             in_uChannelIdx -= uLfeOffset;   // compensate for LFE if it was skipped above.

         }

     }

     else

     {

         // 6-7.x: Need to swap back and sides.

         if ( HasSideAndRearChannels( in_uChannelMask ) )

         {

             unsigned int uRearIdx = ChannelMaskToNumChannels( in_uChannelMask & AK_SPEAKER_SETUP_FRONT );

             unsigned int uMaxIdx = uRearIdx + 4;    // Side and rear channels.

             if ( in_uChannelIdx >= uRearIdx  

                 && in_uChannelIdx < uMaxIdx )

             {

                 // Surround channel (not LFE).

                 unsigned int uSideIdx = uRearIdx + 2;

                 if ( in_uChannelIdx >= uSideIdx )

                     in_uChannelIdx -= 2;    // input is side, swap it with back.

                 else

                     in_uChannelIdx += 2;    // input is back, swap it with side.

             }

         }

     }

     return in_uChannelIdx;

 }

 } // namespace AK

 /// Channel configuration type. 

 enum AkChannelConfigType

 {

     AK_ChannelConfigType_Anonymous = 0x0,   ///< Channel mask == 0 and channels are anonymous.

     AK_ChannelConfigType_Standard = 0x1,    ///< Channels must be identified with standard defines in AkSpeakerConfigs. 

     AK_ChannelConfigType_Ambisonic = 0x2,   ///< Ambisonics. Channel mask == 0 and channels follow standard ambisonic order.

     AK_ChannelConfigType_Objects = 0x3,     ///< Object-based configurations.

     AK_ChannelConfigType_UseDeviceMain = 0xE,           ///< Special setting for bus objects to use the audio device main configuration.

     AK_ChannelConfigType_UseDevicePassthrough = 0xF     ///< Special setting for bus objects to use the audio device passthrough configuration.

 };

 /// Defines a channel configuration.

 /// Examples:

 /// \code

 /// AkChannelConfig cfg;

 /// 

 /// // Create a stereo configuration.

 /// cfg.SetStandard(AK_SPEAKER_SETUP_STEREO);

 ///

 /// // Create a 7.1.4 configuration (7.1 plus 4 height channels).

 /// cfg.SetStandard(AK_SPEAKER_SETUP_AURO_11POINT1_740);

 /// // or

 /// cfg.SetStandard(AK_SPEAKER_SETUP_DOLBY_7_1_4);

 ///

 /// // Create a 3rd order ambisonic configuration.

 /// cfg.SetAmbisonic(16);   // pass in the number of spherical harmonics, (N+1)^2, where N is the ambisonics order.

 ///

 /// // Invalidate (usually means "As Parent")

 /// cfg.Clear();

 /// \endcode

 struct AkChannelConfig

 {

     // Channel config: 

     // - uChannelMask is a bit field, whose channel identifiers depend on AkChannelConfigType (up to 20). Channel bits are defined in AkSpeakerConfig.h.

     // - eConfigType is a code that completes the identification of channels by uChannelMask.

     // - uNumChannels is the number of channels, identified (deduced from channel mask) or anonymous (set directly). 

     AkUInt32    uNumChannels : 8;   ///< Number of channels.

     AkUInt32    eConfigType : 4;    ///< Channel config type (AkChannelConfigType).

     AkUInt32    uChannelMask : 20;///< Channel mask (configuration). 

     /// Construct standard channel config from channel mask

     static AkForceInline AkChannelConfig Standard(AkUInt32 in_uChannelMask)

     {

         return AkChannelConfig(AK::ChannelMaskToNumChannels(in_uChannelMask), in_uChannelMask);

     }

     // Construct anonymous channel config from number of channels

     static AkForceInline AkChannelConfig Anonymous(AkUInt32 in_uNumChannels)

     {

         return AkChannelConfig(in_uNumChannels, 0);

     }

     /// Construct ambisonic channel config from number of channels (NOT order)

     static AkForceInline AkChannelConfig Ambisonic(AkUInt32 in_uNumChannels)

     {

         AkChannelConfig cfg;

         cfg.SetAmbisonic(in_uNumChannels);

         return cfg;

     }

     // Construct object-based channel config

     static AkForceInline AkChannelConfig Object()

     {

         AkChannelConfig cfg;

         cfg.SetObject();

         return cfg;

     }

     /// Constructor. Clears / sets the channel config in "invalid" state (IsValid() returns false).

     AkForceInline AkChannelConfig()

         : uNumChannels(0)

         , eConfigType(0)

         , uChannelMask(0)

     {

     }

     /// Constructor. Sets number of channels, and config type according to whether channel mask is defined or not. If defined, it must be consistent with the number of channels.

     AkForceInline AkChannelConfig(AkUInt32 in_uNumChannels, AkUInt32 in_uChannelMask)

     {

         // Input arguments should be consistent.

         SetStandardOrAnonymous(in_uNumChannels, in_uChannelMask);

     }

     /// Operator != with a 32-bit word.

     AkForceInline bool operator!=(AkUInt32 in_uBitField)

     {

         return (*((AkUInt32*)this) != in_uBitField);

     }

     /// Clear the channel config. Becomes "invalid" (IsValid() returns false).

     AkForceInline void Clear()

     {

         uNumChannels = 0;

         eConfigType = 0;

         uChannelMask = 0;

     }

     /// Set channel config as a standard configuration specified with given channel mask.

     AkForceInline void SetStandard(AkUInt32 in_uChannelMask)

     {

         uNumChannels = AK::ChannelMaskToNumChannels(in_uChannelMask);

         eConfigType = AK_ChannelConfigType_Standard;

         uChannelMask = in_uChannelMask;

     }

     /// Set channel config as either a standard or an anonymous configuration, specified with both a given channel mask (0 if anonymous) and a number of channels (which must match the channel mask if standard).

     AkForceInline void SetStandardOrAnonymous(AkUInt32 in_uNumChannels, AkUInt32 in_uChannelMask)

     {

 #ifdef AKASSERT

         AKASSERT(in_uChannelMask == 0 || in_uNumChannels == AK::ChannelMaskToNumChannels(in_uChannelMask));

 #endif

         uNumChannels = in_uNumChannels;

         eConfigType = (in_uChannelMask) ? AK_ChannelConfigType_Standard : AK_ChannelConfigType_Anonymous;

         uChannelMask = in_uChannelMask;

     }

     /// Set channel config as an anonymous configuration specified with given number of channels.

     AkForceInline void SetAnonymous(AkUInt32 in_uNumChannels)

     {

         uNumChannels = in_uNumChannels;

         eConfigType = AK_ChannelConfigType_Anonymous;

         uChannelMask = 0;

     }

     /// Set channel config as an ambisonic configuration specified with given number of channels.

     AkForceInline void SetAmbisonic(AkUInt32 in_uNumChannels)

     {

         uNumChannels = in_uNumChannels;

         eConfigType = AK_ChannelConfigType_Ambisonic;

         uChannelMask = 0;

     }

     /// Set channel config as an object-based configuration (implies dynamic number of objects).

     AkForceInline void SetObject()

     {

         uNumChannels = 0;

         eConfigType = AK_ChannelConfigType_Objects;

         uChannelMask = 0;

     }

     /// Set channel config as the main mix channel configuration

     AkForceInline void SetSameAsMainMix()

     {

         uNumChannels = 0;

         eConfigType = AK_ChannelConfigType_UseDeviceMain;

         uChannelMask = 0;

     }

     /// Set channel config as the passthrough mix channel configuration

     AkForceInline void SetSameAsPassthrough()

     {

         uNumChannels = 0;

         eConfigType = AK_ChannelConfigType_UseDevicePassthrough;

         uChannelMask = 0;

     }

     /// Returns true if valid, false otherwise (as when it is constructed, or invalidated using Clear()).

     AkForceInline bool IsValid() const

     {

         return eConfigType <= AK_ChannelConfigType_Objects && (uNumChannels != 0 || eConfigType == AK_ChannelConfigType_Objects);

     }

     /// Serialize channel config into a 32-bit word.

     AkForceInline AkUInt32 Serialize() const

     {

         return uNumChannels | (eConfigType << 8) | (uChannelMask << 12);

     }

     /// Deserialize channel config from a 32-bit word.

     AkForceInline void Deserialize(AkUInt32 in_uChannelConfig)

     {

         uNumChannels = in_uChannelConfig & 0x000000ff;

         eConfigType = (in_uChannelConfig >> 8) & 0x0000000f;

         uChannelMask = (in_uChannelConfig >> 12) & 0x000fffff;

     }

     /// Returns a new config based on 'this' with no LFE.

     AkForceInline AkChannelConfig RemoveLFE() const

     {

         AkChannelConfig newConfig = *this;

         AkUInt32 uNewChannelMask = newConfig.uChannelMask & ~AK_SPEAKER_LOW_FREQUENCY;

         AkUInt32 uNumLFEChannel = (newConfig.uChannelMask - uNewChannelMask) >> 3; // 0 or 1

 #ifdef AKASSERT

         AKASSERT(uNumLFEChannel == 0 || uNumLFEChannel == 1);

 #endif

         newConfig.uNumChannels -= uNumLFEChannel;

         newConfig.uChannelMask = uNewChannelMask;

         return newConfig;

     }

     /// Returns a new config based on 'this' with no Front Center channel.

     AkForceInline AkChannelConfig RemoveCenter() const

     {

         AkChannelConfig newConfig = *this;

         AkUInt32 uNewChannelMask = newConfig.uChannelMask & ~AK_SPEAKER_FRONT_CENTER;

         AkUInt32 uNumCenterChannel = (newConfig.uChannelMask - uNewChannelMask) >> 2;   // 0 or 1.

 #ifdef AKASSERT

         AKASSERT(uNumCenterChannel == 0 || uNumCenterChannel == 1);

 #endif

         newConfig.uNumChannels -= uNumCenterChannel;

         newConfig.uChannelMask = uNewChannelMask;

         return newConfig;

     }

     /// Operator ==

     AkForceInline bool operator==(const AkChannelConfig & in_other) const

     {

         return uNumChannels == in_other.uNumChannels

             && eConfigType == in_other.eConfigType

             && uChannelMask == in_other.uChannelMask;

     }

     /// Operator !=

     AkForceInline bool operator!=(const AkChannelConfig & in_other) const

     {

         return uNumChannels != in_other.uNumChannels

             || eConfigType != in_other.eConfigType

             || uChannelMask != in_other.uChannelMask;

     }

     /// Query if LFE channel is present.

     /// \return True when LFE channel is present

     AkForceInline bool HasLFE() const

     {

         return AK::HasLFE(uChannelMask);

     }

     /// Query if center channel is present.

     /// Note that mono configurations have one channel which is arbitrary set to AK_SPEAKER_FRONT_CENTER,

     /// so HasCenter() returns true for mono signals.

     /// \return True when center channel is present and configuration has more than 2 channels.

     AkForceInline bool HasCenter() const

     {

         return AK::HasCenter(uChannelMask);

     }

 };

 #endif //_AK_SPEAKERCONFIG_H_

AkChannelConfig::operator!=

AkForceInline bool operator!=(AkUInt32 in_uBitField)

Operator != with a 32-bit word.

Definition: AkSpeakerConfig.h:545

AK::HasLFE

AkForceInline bool HasLFE(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:313

AkChannelConfig::SetStandardOrAnonymous

AkForceInline void SetStandardOrAnonymous(AkUInt32 in_uNumChannels, AkUInt32 in_uChannelMask)

Set channel config as either a standard or an anonymous configuration, specified with both a given ch...

Definition: AkSpeakerConfig.h:567

AkChannelConfig::Ambisonic

static AkForceInline AkChannelConfig Ambisonic(AkUInt32 in_uNumChannels)

Construct ambisonic channel config from number of channels (NOT order)

Definition: AkSpeakerConfig.h:514

AK_SPEAKER_SETUP_5_0

#define AK_SPEAKER_SETUP_5_0

Definition: AkSpeakerConfig.h:194

Audiokinetic namespace.

Definition: AkWwiseSDKVersion.cs:31

AkChannelConfig::HasCenter

AkForceInline bool HasCenter() const

Definition: AkSpeakerConfig.h:692

AK::BackToSideChannels

AkForceInline AkChannelMask BackToSideChannels(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:387

AkChannelConfig::uNumChannels

AkUInt32 uNumChannels

Number of channels.

Definition: AkSpeakerConfig.h:497

AkChannelConfig

Definition: AkSpeakerConfig.h:492

AK_SPEAKER_SETUP_FIX_REAR_TO_SIDE

void AK_SPEAKER_SETUP_FIX_REAR_TO_SIDE(AkUInt32 &io_uChannelMask)

Definition: AkSpeakerConfig.h:221

AK_SPEAKER_SETUP_1_0_CENTER

#define AK_SPEAKER_SETUP_1_0_CENTER

Definition: AkSpeakerConfig.h:181

AkChannelConfig::uChannelMask

AkUInt32 uChannelMask

Channel mask (configuration).

Definition: AkSpeakerConfig.h:499

AK::ChannelOrdering_Standard

@ ChannelOrdering_Standard

Definition: AkSpeakerConfig.h:352

AK_ChannelConfigType_Standard

@ AK_ChannelConfigType_Standard

Channels must be identified with standard defines in AkSpeakerConfigs.

Definition: AkSpeakerConfig.h:464

AK::HasCenter

AkForceInline bool HasCenter(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:322

AK_SPEAKER_SETUP_7POINT1

#define AK_SPEAKER_SETUP_7POINT1

7.1 setup channel mask

Definition: AkSpeakerConfig.h:70

AK_SPEAKER_BACK_LEFT

#define AK_SPEAKER_BACK_LEFT

Rear left speaker bit mask.

Definition: AkSpeakerConfig.h:37

AkChannelMask

AkUInt32 AkChannelMask

Channel mask (similar to WAVE_FORMAT_EXTENSIBLE). Bit values are defined in AkSpeakerConfig....

Definition: AkTypes.h:149

AkUInt8

uint8_t AkUInt8

Unsigned 8-bit integer.

Definition: AkNumeralTypes.h:36

AkChannelConfig::AkChannelConfig

AkForceInline AkChannelConfig()

Constructor. Clears / sets the channel config in "invalid" state (IsValid() returns false).

Definition: AkSpeakerConfig.h:530

AkChannelConfig::SetAmbisonic

AkForceInline void SetAmbisonic(AkUInt32 in_uNumChannels)

Set channel config as an ambisonic configuration specified with given number of channels.

Definition: AkSpeakerConfig.h:586

AK_ChannelConfigType_Objects

@ AK_ChannelConfigType_Objects

Object-based configurations.

Definition: AkSpeakerConfig.h:466

AK_SPEAKER_FRONT_RIGHT

#define AK_SPEAKER_FRONT_RIGHT

Front right speaker bit mask.

Definition: AkSpeakerConfig.h:34

AkChannelConfig::Serialize

AkForceInline AkUInt32 Serialize() const

Serialize channel config into a 32-bit word.

Definition: AkSpeakerConfig.h:624

AK_ChannelConfigType_Ambisonic

@ AK_ChannelConfigType_Ambisonic

Ambisonics. Channel mask == 0 and channels follow standard ambisonic order.

Definition: AkSpeakerConfig.h:465

AK::StdChannelIndexToDisplayIndex

static unsigned int StdChannelIndexToDisplayIndex(AkChannelOrdering in_eOrdering, unsigned int in_uChannelMask, unsigned int in_uChannelIdx)

Definition: AkSpeakerConfig.h:401

AkChannelConfig::SetSameAsPassthrough

AkForceInline void SetSameAsPassthrough()

Set channel config as the passthrough mix channel configuration.

Definition: AkSpeakerConfig.h:610

AkChannelConfig::SetAnonymous

AkForceInline void SetAnonymous(AkUInt32 in_uNumChannels)

Set channel config as an anonymous configuration specified with given number of channels.

Definition: AkSpeakerConfig.h:578

AkChannelConfig::RemoveCenter

AkForceInline AkChannelConfig RemoveCenter() const

Returns a new config based on 'this' with no Front Center channel.

Definition: AkSpeakerConfig.h:652

AK::ChannelBitToIndex

static AkUInt8 ChannelBitToIndex(AkChannelMask in_uChannelBit, AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:301

AK_SPEAKER_SETUP_DEFAULT_PLANE

#define AK_SPEAKER_SETUP_DEFAULT_PLANE

All speakers on the plane, supported on this platform.

Definition: AkSpeakerConfig.h:203

AkChannelConfig::operator!=

AkForceInline bool operator!=(const AkChannelConfig &in_other) const

Operator !=.

Definition: AkSpeakerConfig.h:674

AK_ChannelConfigType_UseDevicePassthrough

@ AK_ChannelConfigType_UseDevicePassthrough

Special setting for bus objects to use the audio device passthrough configuration.

Definition: AkSpeakerConfig.h:469

AK::GetNumberOfAnglesForConfig

AkForceInline AkUInt32 GetNumberOfAnglesForConfig(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:331

AkChannelConfig::Anonymous

static AkForceInline AkChannelConfig Anonymous(AkUInt32 in_uNumChannels)

Definition: AkSpeakerConfig.h:508

AK_SPEAKER_SIDE_LEFT

#define AK_SPEAKER_SIDE_LEFT

Side left speaker bit mask.

Definition: AkSpeakerConfig.h:40

AKASSERT

#define AKASSERT(Condition)

Definition: AkAssert.h:67

AK_SPEAKER_BACK_CENTER

#define AK_SPEAKER_BACK_CENTER

Rear center speaker ("surround speaker") bit mask.

Definition: AkSpeakerConfig.h:39

AK::ChannelMaskFromNumChannels

static AkChannelMask ChannelMaskFromNumChannels(unsigned int in_uNumChannels)

Definition: AkSpeakerConfig.h:264

AkChannelConfig::Clear

AkForceInline void Clear()

Clear the channel config. Becomes "invalid" (IsValid() returns false).

Definition: AkSpeakerConfig.h:551

AkChannelConfig::SetSameAsMainMix

AkForceInline void SetSameAsMainMix()

Set channel config as the main mix channel configuration.

Definition: AkSpeakerConfig.h:602

AK_SPEAKER_SETUP_5_1

#define AK_SPEAKER_SETUP_5_1

Definition: AkSpeakerConfig.h:195

AkChannelConfigType

Channel configuration type.

Definition: AkSpeakerConfig.h:462

AK::HasHeightChannels

AkForceInline bool HasHeightChannels(AkChannelMask in_uChannelMask)

Returns true if standard configuration represented by channel mask has at least one "height" channel ...

Definition: AkSpeakerConfig.h:380

AK_SPEAKER_SETUP_FRONT

#define AK_SPEAKER_SETUP_FRONT

Definition: AkSpeakerConfig.h:190

AkChannelConfig::Object

static AkForceInline AkChannelConfig Object()

Definition: AkSpeakerConfig.h:522

AK_SPEAKER_SETUP_7

#define AK_SPEAKER_SETUP_7

7.0 setup channel mask

Definition: AkSpeakerConfig.h:69

AkChannelConfig::SetObject

AkForceInline void SetObject()

Set channel config as an object-based configuration (implies dynamic number of objects).

Definition: AkSpeakerConfig.h:594

AK_SPEAKER_SETUP_2_1

#define AK_SPEAKER_SETUP_2_1

Definition: AkSpeakerConfig.h:185

AK_ChannelConfigType_Anonymous

@ AK_ChannelConfigType_Anonymous

Channel mask == 0 and channels are anonymous.

Definition: AkSpeakerConfig.h:463

AK::HasSurroundChannels

AkForceInline bool HasSurroundChannels(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:358

AK_SPEAKER_SETUP_2_0

#define AK_SPEAKER_SETUP_2_0

Definition: AkSpeakerConfig.h:184

AkChannelConfig::operator==

AkForceInline bool operator==(const AkChannelConfig &in_other) const

Operator ==.

Definition: AkSpeakerConfig.h:666

AkChannelConfig::RemoveLFE

AkForceInline AkChannelConfig RemoveLFE() const

Returns a new config based on 'this' with no LFE.

Definition: AkSpeakerConfig.h:638

AkChannelConfig::SetStandard

AkForceInline void SetStandard(AkUInt32 in_uChannelMask)

Set channel config as a standard configuration specified with given channel mask.

Definition: AkSpeakerConfig.h:559

AK_SPEAKER_FRONT_LEFT

#define AK_SPEAKER_FRONT_LEFT

Standard speakers (channel mask):

Definition: AkSpeakerConfig.h:33

AkTypes.h

AkChannelConfig::AkChannelConfig

AkForceInline AkChannelConfig(AkUInt32 in_uNumChannels, AkUInt32 in_uChannelMask)

Constructor. Sets number of channels, and config type according to whether channel mask is defined or...

Definition: AkSpeakerConfig.h:538

AkUInt32

uint32_t AkUInt32

Unsigned 32-bit integer.

Definition: AkNumeralTypes.h:38

AkChannelConfig::eConfigType

AkUInt32 eConfigType

Channel config type (AkChannelConfigType).

Definition: AkSpeakerConfig.h:498

AK_ChannelConfigType_UseDeviceMain

@ AK_ChannelConfigType_UseDeviceMain

Special setting for bus objects to use the audio device main configuration.

Definition: AkSpeakerConfig.h:468

AK::HasSideAndRearChannels

AkForceInline bool HasSideAndRearChannels(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:374

AkChannelConfig::HasLFE

AkForceInline bool HasLFE() const

Definition: AkSpeakerConfig.h:683

AK::ChannelMaskToNumChannels

static AkUInt8 ChannelMaskToNumChannels(AkChannelMask in_uChannelMask)

Returns the number of channels of a given channel configuration.

Definition: AkSpeakerConfig.h:255

AK_SPEAKER_SETUP_CONVERT_TO_SUPPORTED

void AK_SPEAKER_SETUP_CONVERT_TO_SUPPORTED(AkUInt32 &io_uChannelMask)

Definition: AkSpeakerConfig.h:230

AK::AkChannelOrdering

AkChannelOrdering

Channel ordering type.

Definition: AkSpeakerConfig.h:351

AK_SPEAKER_LOW_FREQUENCY

#define AK_SPEAKER_LOW_FREQUENCY

Low-frequency speaker bit mask.

Definition: AkSpeakerConfig.h:36

AkChannelConfig::Deserialize

AkForceInline void Deserialize(AkUInt32 in_uChannelConfig)

Deserialize channel config from a 32-bit word.

Definition: AkSpeakerConfig.h:630

AK_SPEAKER_FRONT_CENTER

#define AK_SPEAKER_FRONT_CENTER

Front center speaker bit mask.

Definition: AkSpeakerConfig.h:35

AkForceInline

#define AkForceInline

Definition: AkTypes.h:61

AK_SPEAKER_SETUP_FIX_LEFT_TO_CENTER

void AK_SPEAKER_SETUP_FIX_LEFT_TO_CENTER(AkUInt32 &io_uChannelMask)

Definition: AkSpeakerConfig.h:210

AK::ChannelOrdering_RunTime

@ ChannelOrdering_RunTime

Definition: AkSpeakerConfig.h:353

AkChannelConfig::Standard

static AkForceInline AkChannelConfig Standard(AkUInt32 in_uChannelMask)

Construct standard channel config from channel mask.

Definition: AkSpeakerConfig.h:502

AkChannelConfig::IsValid

AkForceInline bool IsValid() const

Returns true if valid, false otherwise (as when it is constructed, or invalidated using Clear()).

Definition: AkSpeakerConfig.h:618

AK_SPEAKER_SETUP_4_0

#define AK_SPEAKER_SETUP_4_0

Definition: AkSpeakerConfig.h:192

AK_SPEAKER_BACK_RIGHT

#define AK_SPEAKER_BACK_RIGHT

Rear right speaker bit mask.

Definition: AkSpeakerConfig.h:38

AK_SPEAKER_SIDE_RIGHT

#define AK_SPEAKER_SIDE_RIGHT

Side right speaker bit mask.

Definition: AkSpeakerConfig.h:41

AK::HasStrictlyOnePairOfSurroundChannels

AkForceInline bool HasStrictlyOnePairOfSurroundChannels(AkChannelMask in_uChannelMask)

Definition: AkSpeakerConfig.h:366

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Get started with Wwise

Wwise SDK 2022.1.7