BASS_Mixer_ChannelSetMatrixEx


Sets a channel's mixing matrix, transitioning from the current matrix.

BOOL BASS_Mixer_ChannelSetMatrixEx(
    DWORD handle,
    void *matrix,
    float time
);

Parameters

handleThe channel handle.
matrixPointer to the matrix.
timeThe time to take (in seconds) to transition from the current matrix to the specified matrix.

Return value

If successful, a TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_HANDLEThe channel is not plugged into a mixer.
BASS_ERROR_NOTAVAILThe channel is not using matrix mixing.

Remarks

The function is identical to BASS_Mixer_ChannelSetMatrix but with the option of transitioning over time to the specified matrix. If this function or BASS_Mixer_ChannelSetMatrix is called while a previous matrix transition is still in progress, then that transition will be stopped. If BASS_Mixer_ChannelGetMatrix is called mid-transition, it will give the mid-transition matrix values.

See also

BASS_Mixer_ChannelGetMatrix, BASS_Mixer_ChannelSetMatrix, BASS_Mixer_StreamAddChannel, BASS_Mixer_StreamAddChannelEx