BASS_Mixer_ChannelSetMatrixEx

Sets a source channel's mixing matrix, transitioning from the current matrix over some time.

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

Parameters

handleThe channel handle.
matrixPointer to the matrix... NULL = use the default matrix based on the current BASS_MIXER_CHAN_DOWNMIX flag setting.
timeThe time to take (in seconds) to transition from the current matrix to the specified matrix... less than 0 = use default ramping.

Return value

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

Error codes

BASS_ERROR_HANDLEhandle is not a mixer source.
BASS_ERROR_NOTAVAILThe channel is not using matrix mixing.

Remarks

This function is identical to BASS_Mixer_ChannelSetMatrix but with the option of overriding the default ramping. If a previous transition is still in progress, that will be stopped at its current values and the matrix will transition from there to the new values.

See also

BASS_Mixer_ChannelFlags, BASS_Mixer_ChannelGetMatrix, BASS_Mixer_ChannelSetMatrix, BASS_Mixer_StreamAddChannel