3D positioning

Samples Directory

/CRIWARE/SDK/pc/samples/criatomex/control_3d_pos

Sample Description

In order to perform 3D positioning , first set a 3D listener handle ( CriAtomEx3dListenerHn ) and 3D sound source handle ( CriAtomEx3dSourceHn ) to the AtomEx player ( CriAtomExPlayerHn ) using the criAtomExPlayer_Set3dListenerHn and criAtomExPlayer_Set3dSourceHn function.

In order to move listener or sound source, use the following functions respectively.

• The criAtomEx3dListener_SetPosition function
• The criAtomEx3dSource_SetPosition function
  

In addition, several parameters can be set to listener or sound source.
Please refer to the sample source which configures several parameters.

After setting parameters, by calling the criAtomEx3dListener_Update or criAtomEx3dSource_Update function, parameters are updated and position of the sound being played moves.

The following is a simple code to do 3D positioning.

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);