What is the difference between Pan 3D, 3D Positioning, and Auto?

You can select between Pan 3D, 3D Positioning and Auto to change the panning calculation method used during playback.

The panning calculation methods (pan types) that you can use in CRI Atom Craft are as follows:

1. Pan 3D
   The sound playback uses parameters such as the pan 3D angle set in the CRI Atom Craft tool or with the criAtomExPlayer_SetPan3dAngle function.
2. 3D Positioning
   The sound playback uses the 3D sound source handle and 3D listener handle passed to the AtomExPlayer.
3. Auto
   If a 3D sound source handle and a 3D listener handle have been set to the AtomExPlayer, 3D Positioning is used. Otherwise, Pan 3D is used.

Notes:

If you use the criAtomExPlayer_SetSendLevel function to set the send level, only that send level setting will then be used for playback, regardless of the pan type setting.

Attention

If the pan type is set to 3D Positioning, you must pass a 3D sound source handle and 3D listener handle to the AtomExPlayer.
If the pan type has been set to 3D Positioning but no 3D sound source handle or listener handle has been set, an error will occur and playback will fail.

The playback result will vary depending on the pan type and the 3D sound source/listener handle settings as shown in the following table.

Playback Result by Pan Type and 3D Sound Source and Listener Handle Settings

Pan Type Setting	3D Sound Source/Listener Handle Setting	Playback Result
Pan 3D	No	Pan 3D
Pan 3D	Yes	Pan 3D
3D Positioning	No	Error E2015012302 (Please set a 3D sound source and listener handle.)
3D Positioning	Yes	3D Positioning
Auto	No	Pan 3D
Auto	Yes	3D Positioning

Return:Tips