Version
menu_open
Wwise SDK 2019.1.11
AkReflectGameData.h
1 /*******************************************************************************
2 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
3 released in source code form as part of the SDK installer package.
4 
5 Commercial License Usage
6 
7 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
8 may use this file in accordance with the end user license agreement provided
9 with the software or, alternatively, in accordance with the terms contained in a
10 written agreement between you and Audiokinetic Inc.
11 
12 Apache License Usage
13 
14 Alternatively, this file may be used under the Apache License, Version 2.0 (the
15 "Apache License"); you may not use this file except in compliance with the
16 Apache License. You may obtain a copy of the Apache License at
17 http://www.apache.org/licenses/LICENSE-2.0.
18 
19 Unless required by applicable law or agreed to in writing, software distributed
20 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
21 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
22 the specific language governing permissions and limitations under the License.
23 
24 Version: <VERSION> Build: <BUILDNUMBER>
25 Copyright (c) <COPYRIGHTYEAR> Audiokinetic Inc.
26 *******************************************************************************/
27 
28 #ifndef _AK_REFLECT_GAMEDATA_H_
29 #define _AK_REFLECT_GAMEDATA_H_
30 
31 #include <AK/SoundEngine/Common/AkTypes.h>
32 
33 #define AK_MAX_NUM_TEXTURE 4
34 
35 /// Data used to describe one image source in Wwise Reflect.
36 struct AkImageSourceName
37 {
38  AkImageSourceName()
39  : uNumChar(0)
40  , pName(NULL)
41  {
42  }
43 
44  void SetName(const char * in_pName)
45  {
46  pName = in_pName;
47  if (pName)
48  {
49  uNumChar = (AkUInt32)strlen(in_pName);
50  }
51  else
52  {
53  uNumChar = 0;
54  }
55  }
56 
57  AkUInt32 uNumChar; ///< Number of characters in image source name.
58  const char * pName; ///< Optional image source name. Appears in Wwise Reflect's editor when profiling.
59 };
60 
61 struct AkImageSourceTexture
62 {
63  AkImageSourceTexture()
64  : uNumTexture(1)
65  {
66  arTextureID[0] = AK_INVALID_UNIQUE_ID;
67  }
68 
69  AkUInt32 uNumTexture; ///< Number of valid textures in the texture array.
70  AkUniqueID arTextureID[AK_MAX_NUM_TEXTURE]; ///< Unique IDs of the Acoustics Texture ShareSets used to filter this image source.
71 };
72 
73 struct AkImageSourceParams
74 {
75  AkImageSourceParams()
76  : fDistanceScalingFactor(1.f)
77  , fLevel(1.f)
78  , fDiffraction(0.f)
79  , uDiffractionEmitterSide(0)
80  , uDiffractionListenerSide(0)
81  {
82  sourcePosition.X = 0.f;
83  sourcePosition.Y = 0.f;
84  sourcePosition.Z = 0.f;
85  }
86 
87  AkImageSourceParams(AkVector in_sourcePosition, AkReal32 in_fDistanceScalingFactor, AkReal32 in_fLevel)
88  : sourcePosition(in_sourcePosition)
89  , fDistanceScalingFactor(in_fDistanceScalingFactor)
90  , fLevel(in_fLevel)
91  , fDiffraction(0.f)
92  , uDiffractionEmitterSide(0)
93  , uDiffractionListenerSide(0)
94  {
95  }
96 
97  AkVector sourcePosition; ///< Image source position, relative to the world.
98  AkReal32 fDistanceScalingFactor; ///< Image source distance scaling. This number effectively scales the sourcePosition vector with respect to the listener and, consequently, scales distance and preserves orientation.
99  AkReal32 fLevel; ///< Game-controlled level for this source, linear.
100  AkReal32 fDiffraction; ///< Diffraction amount, normalized to the range [0,1].
101  AkUInt8 uDiffractionEmitterSide; ///< If there is a shadow zone diffraction just after the emitter in the reflection path, indicates the number of diffraction edges, otherwise 0 if no diffraction.
102  AkUInt8 uDiffractionListenerSide; ///< If there is a shadow zone diffraction before reaching the listener in the reflection path, indicates the number of diffraction edges, otherwise 0 if no diffraction.
103 };
104 
105 struct AkReflectImageSource
106 {
107  AkReflectImageSource()
108  : uID((AkImageSourceID)-1)
109  , params()
110  , texture()
111  , name()
112  {}
113 
114  AkReflectImageSource(AkImageSourceID in_uID, AkVector in_sourcePosition, AkReal32 in_fDistanceScalingFactor, AkReal32 in_fLevel)
115  : uID(in_uID)
116  , params(in_sourcePosition, in_fDistanceScalingFactor, in_fLevel)
117  , texture()
118  , name()
119  {
120  }
121 
122  void SetName(const char * in_pName)
123  {
124  name.SetName(in_pName);
125  }
126 
127  AkImageSourceID uID; ///< Image source ID (for matching delay lines across frames)
128  AkImageSourceParams params;
129  AkImageSourceTexture texture;
130  AkImageSourceName name;
131 };
132 
133 /// Data structure sent by the game to an instance of the Wwise Reflect plug-in.
134 struct AkReflectGameData
135 {
136  AkGameObjectID listenerID; ///< ID of the listener used to compute spatialization and distance evaluation from within the targeted Reflect plug-in instance. It needs to be one of the listeners that are listening to the game object associated with the targeted plug-in instance. See AK::SoundEngine::SetListeners and AK::SoundEngine::SetGameObjectAuxSendValues.
137  AkUInt32 uNumImageSources; ///< Number of image sources passed in the variable array, below.
138  AkReflectImageSource arSources[1]; ///< Variable array of image sources. You should allocate storage for the structure by calling AkReflectGameData::GetSize() with the desired number of sources.
139 
140  /// Default constructor.
141  AkReflectGameData()
142  : listenerID( AK_INVALID_GAME_OBJECT )
143  , uNumImageSources(0)
144  {}
145 
146  /// Helper function for computing the size required to allocate the AkReflectGameData structure.
147  static AkUInt32 GetSize(AkUInt32 in_uNumSources)
148  {
149  return (in_uNumSources > 0) ? sizeof(AkReflectGameData) + (in_uNumSources - 1) * sizeof(AkReflectImageSource) : sizeof(AkReflectGameData);
150  }
151 };
152 #endif // _AK_REFLECT_GAMEDATA_H_
AkImageSourceName::uNumChar
AkUInt32 uNumChar
Number of characters in image source name.
Definition: AkReflectGameData.h:57
AkReflectImageSource::AkReflectImageSource
AkReflectImageSource(AkImageSourceID in_uID, AkVector in_sourcePosition, AkReal32 in_fDistanceScalingFactor, AkReal32 in_fLevel)
Definition: AkReflectGameData.h:114
AkReflectGameData::arSources
AkReflectImageSource arSources[1]
Variable array of image sources. You should allocate storage for the structure by calling AkReflectGa...
Definition: AkReflectGameData.h:138
AkReflectImageSource::texture
AkImageSourceTexture texture
Definition: AkReflectGameData.h:129
AkImageSourceName
Data used to describe one image source in Wwise Reflect.
Definition: AkReflectGameData.h:37
AkImageSourceTexture::uNumTexture
AkUInt32 uNumTexture
Number of valid textures in the texture array.
Definition: AkReflectGameData.h:69
AkImageSourceParams::fDiffraction
AkReal32 fDiffraction
Diffraction amount, normalized to the range [0,1].
Definition: AkReflectGameData.h:100
AkImageSourceParams::fLevel
AkReal32 fLevel
Game-controlled level for this source, linear.
Definition: AkReflectGameData.h:99
AkImageSourceParams::fDistanceScalingFactor
AkReal32 fDistanceScalingFactor
Image source distance scaling. This number effectively scales the sourcePosition vector with respect ...
Definition: AkReflectGameData.h:98
AkReflectGameData::uNumImageSources
AkUInt32 uNumImageSources
Number of image sources passed in the variable array, below.
Definition: AkReflectGameData.h:137
AkReflectImageSource::SetName
void SetName(const char *in_pName)
Definition: AkReflectGameData.h:122
AkVector::Y
AkReal32 Y
Y Position.
Definition: AkTypes.h:300
AkReflectGameData::GetSize
static AkUInt32 GetSize(AkUInt32 in_uNumSources)
Helper function for computing the size required to allocate the AkReflectGameData structure.
Definition: AkReflectGameData.h:147
AkReflectGameData::listenerID
AkGameObjectID listenerID
ID of the listener used to compute spatialization and distance evaluation from within the targeted Re...
Definition: AkReflectGameData.h:136
AkVector::X
AkReal32 X
X Position.
Definition: AkTypes.h:299
AkImageSourceParams::uDiffractionListenerSide
AkUInt8 uDiffractionListenerSide
If there is a shadow zone diffraction before reaching the listener in the reflection path,...
Definition: AkReflectGameData.h:102
AkReflectImageSource::uID
AkImageSourceID uID
Image source ID (for matching delay lines across frames)
Definition: AkReflectGameData.h:127
AkVector::Z
AkReal32 Z
Z Position.
Definition: AkTypes.h:301
AkReflectGameData
Data structure sent by the game to an instance of the Wwise Reflect plug-in.
Definition: AkReflectGameData.h:135
AkReflectGameData::AkReflectGameData
AkReflectGameData()
Default constructor.
Definition: AkReflectGameData.h:141
AkImageSourceName::pName
const char * pName
Optional image source name. Appears in Wwise Reflect's editor when profiling.
Definition: AkReflectGameData.h:58
AkImageSourceParams::sourcePosition
AkVector sourcePosition
Image source position, relative to the world.
Definition: AkReflectGameData.h:97
AkReflectImageSource::name
AkImageSourceName name
Definition: AkReflectGameData.h:130
AkVector
3D vector.
Definition: AkTypes.h:282
AkImageSourceName::SetName
void SetName(const char *in_pName)
Definition: AkReflectGameData.h:44
AkReflectImageSource::params
AkImageSourceParams params
Definition: AkReflectGameData.h:128
AkImageSourceTexture::arTextureID
AkUniqueID arTextureID[AK_MAX_NUM_TEXTURE]
Unique IDs of the Acoustics Texture ShareSets used to filter this image source.
Definition: AkReflectGameData.h:70
AkImageSourceParams::uDiffractionEmitterSide
AkUInt8 uDiffractionEmitterSide
If there is a shadow zone diffraction just after the emitter in the reflection path,...
Definition: AkReflectGameData.h:101
AkImageSourceParams::AkImageSourceParams
AkImageSourceParams(AkVector in_sourcePosition, AkReal32 in_fDistanceScalingFactor, AkReal32 in_fLevel)
Definition: AkReflectGameData.h:87

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.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise