SB AWE32 Developer's Information Pack
PART V 3D Positional Audio API
••
104
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Remarks
If
lpRx
is the active receiver, then destruction of this receiver will cause all sound
output to cease until a new active receiver is specified.
c3daSetActiveReceiver
c3daError
PASCAL
c3daSetActiveReceiver(c3daReceiver FAR* lpRx)
Actions
Set the current active receiver. The active receiver is the receiver for which audio
spatialization algorithms are applied.
Parameters
lpRx
Specify a far pointer to a receiver object.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
Remarks
On the AWE, multiple receivers can be created; however, there can only be one active
receiver at a time.
c3daGetActiveReceiver
c3daError
PASCAL
c3daGetActiveReceiver(c3daReceiver FAR* FAR* lpRx)
Actions
Return the current active receiver.
Parameters
lpRx
Specify a far pointer to a far pointer to a receiver object.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
c3daSetReceiverPosition
c3daError
PASCAL
c3daSetReceiverPosition(
c3daReceiver FAR* lpRx,
int x,
int y,
int z
)
Actions
Place a receiver in 3D space. Correspondingly, the positions of all existing emitters
are updated internally.
Parameters
lpRx
Specify a far pointer to a receiver object.
x, y, z