SB AWE32 Developer's Information Pack
PART V 3D Positional Audio API
••
98
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Remarks
Any calls to the library after a call to c3daEnd will result in strange and unusual
behavior (except for c3daInit to reinitialize the library).
c3daSetDopplerEffect
c3daError
PASCAL
c3daSetDopplerEffect(UINT uDoppEffect)
Actions
Set the Doppler effect for all emitters. By using this function, the user can control the
“magnitude” of the Doppler effects that may be heard as a result of emitter position
changes.
Parameters
uDoppEffect
The valid range for uDoppEffect is 0-255 where a value of 0 turns off Doppler effects
completely and a value of 255 turns on the full effects of Doppler. The default value
is 127.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
c3daSetMaxDistance
c3daError
PASCAL
c3daSetMaxDistance(int MaxDistance)
Actions
Set the maximum distance that emitter volumes will attenuate across. At maximum
distance, attenuation is at maximum (-96dB). By using this maximum distance, the user
can adjust the distance attenuation that correspond to modeled world.
Parameters
MaxDistance
The valid range for MaxDistance is 1 - 32767.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
Emitter Functions
This group of API consists of the following :
•
c3daCreateEmitter
•
c3daDestroyEmitter
•
c3daSetEmitterPosition
•
c3daSetEmitterOrientation
•
c3daSetEmitterSoundState
•
c3daSetEmitterGain
•
c3daSetEmitterPitchInc