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

handleThe channel handle... a HCHANNEL, HMUSIC, HSTREAM.
posPosition of the sound... NULL = leave current.
orientOrientation of the sound... NULL = leave current. This is automatically normalized.
velVelocity 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_HANDLEhandle is not a valid channel.
BASS_ERROR_NO3DThe 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