Sets the 3D position of a sample, stream, or MOD music channel with 3D functionality.
BOOL WINAPI BASS_ChannelSet3DPosition( |
Parameters
handle | The channel handle... a HCHANNEL, HMUSIC, HSTREAM. |
pos | Position of the sound... NULL = leave current. |
orient | Orientation of the sound... NULL = leave current. |
vel | Velocity of the sound... NULL = leave current. This is only used to calculate the doppler effect, and has no effect on the sound's position. |
Return value
If succesful, then TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.
Error codes
BASS_ERROR_HANDLE | handle is not a valid channel. |
BASS_ERROR_NO3D | The channel does not have 3D functionality... it wasn't created or loaded with the BASS_xxx_3D flag. |
Remarks
As with all 3D functions, BASS_Apply3D must be called to apply the changes made.
See also
BASS_Apply3D, BASS_ChannelGet3DPosition, BASS_ChannelSet3DAttributes, BASS_ChannelSetAttributes, BASS_Set3DFactors, BASS_Set3DPosition, BASS_3DVECTOR structure