3D positioning

Sample directory

/cri/pc/samples/criatomex/control_3d_pos

Data used in the sample

/cri/common/smpdata/criatomex/

• SampleProject.acf
• AtomCueSheet.acb
• AtomCueSheet.awb
  

Sample description

3D positioning The following elements are required to perform "3D positioning".

• 3D listener handle: CriAtomEx3dListenerHn
• 3D sound source handle: CriAtomEx3dSourceHn

These must be registered with the AtomEx player ( CriAtomExPlayerHn ).
The following are the registration functions.

• criAtomExPlayer_Set3dListenerHn function
• criAtomExPlayer_Set3dSourceHn function

To set listener and sound source parameters, such as position information, use the following functions.

• criAtomEx3dListener_SetPosition function
• criAtomEx3dSource_SetPosition function

After setting the parameters, use the following functions to actually reflect the parameters.

• criAtomEx3dListener_Update function
• criAtomEx3dSource_Update function

Several other parameters can be set for listeners and sound sources.

The code for 3D positioning is shown below.

CriAtomEx3dListenerHn listener;
CriAtomEx3dSourceHn source;
CriAtomExVector pos;
 
listener = criAtomEx3dListener_Create(NULL, NULL, 0);
source = criAtomEx3dSource_Create(NULL, NULL, 0);
player = criAtomExPlayer_Create(NULL, NULL, 0);
criAtomExPlayer_Set3dListenerHn(player, listener);
criAtomExPlayer_Set3dSourceHn(player, source);
 
pos.x = 0.0f;
pos.y = 0.0f;
pos.z = 0.0f;
criAtomEx3dSource_SetPosition(source, &pos);
criAtomEx3dSource_Update(source);
// Start playback
id = criAtomExPlayer_Start(player);
               :
pos.x += 10.0f;
criAtomEx3dSource_SetPosition(source, &pos);
criAtomEx3dSource_Update(source);