SB AWE32 Developer's Information Pack
PART V 3D Positional Audio API
••
97
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
•
c3daReceiver - a receiver object.
•
c3daError - the return type from all 3D Postional Audio Library functions. Possible
values are c3daSUCCESS and c3daFAILURE.
•
c3daSoundState - specifies a sound output or “play” state. Possible values are
c3daSTART, c3daSTOP, and c3daPAUSE.
•
The (x, y, z) coordinates are of type int. They must be in the range of between -32767 to
32767.
System Functions
This group of API consists of the following :
•
c3daInit
•
c3daEnd
•
c3daSetDopplerEffect
•
c3daSetMaxDistance
c3daInit
c3daError
PASCAL
c3daInit(VOID)
Actions
Initialize the 3D Positional Audio Library and must be called before any other calls to
the library.
Parameters
None.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
Remarks
A single receiver (with an orientation where the head is facing along the positive x-
axis and the left ear is on the positive y-axis) is also automatically created and used as
the active receiver. Use c3daGetActiveReceiver
to retrieve it.
c3daEnd
c3daError
PASCAL
c3daEnd(VOID)
Actions
Shuts down the 3D Positional Audio Library and releases all of its resources.
c3daEnd must be called before an application exits.
Parameters
None.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.