BASS_ChannelSet3DPosition
Sets the 3D position of a sample, stream, or MOD music channel with 3D functionality.
BOOL BASS_ChannelSet3DPosition(
DWORD handle,
BASS_3DVECTOR *pos,
BASS_3DVECTOR *orient,
BASS_3DVECTOR *vel
);
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. This is automatically normalized.
|
| 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 successful, 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.
|
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_ChannelSetAttribute,
BASS_Set3DFactors,
BASS_Set3DPosition,
BASS_3DVECTOR structure