SB AWE32 Developer's Information Pack
PART V 3D Positional Audio API
••
103
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Receiver Functions
This group of API consists of the following :
•
c3daCreateReceiver
•
c3daDestroyReceiver
•
c3daSetActiveReceiver
•
c3daGetActiveReceiver
•
c3daSetReceiverPosition
c3daCreateReceiver
c3daError
PASCAL
c3daCreateReceiver(
c3daReceiver FAR* lpRx,
int x,
int y,
int z
)
Actions
Initialize a receiver object and places it in 3D space.
Parameters
lpRx
Specify a far pointer to a receiver object.
x, y, z
Specify the initial coordinates of the receiver.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
Remarks
The position of a receiver is used by the audio spatialization algorithms if/when this
receiver becomes the active receiver. The orientation of receivers is fixed to be
facing along the positive x-axis with the left ear along the positive y-axis.
c3daDestroyReceiver
c3daError
PASCAL
c3daDestroyReceiver(c3daReceiver FAR* lpRx)
Actions
Destroy a receiver object. All resources associated with the receiver are released.
Parameters
lpRx
Specify a far pointer to a receiver object.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
