Creative AWE32 - Receiver Functions

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.