BASS.NET API for the Un4seen BASS Audio Library

BassMixBASS_Mixer_ChannelSetMatrixEx Method

BASS.NET API for the Un4seen BASS Audio Library
Fades to a channel's mixing matrix, if it has one.

Namespace:  Un4seen.Bass.AddOn.Mix
Assembly:  Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax

[DllImportAttribute("bassmix")]
public static bool BASS_Mixer_ChannelSetMatrixEx(
	int handle,
	float[,] matrix,
	float time
)

Parameters

handle
Type: SystemInt32
The mixer source channel handle (which was add via BASS_Mixer_StreamAddChannel(Int32, Int32, BASSFlag) or BASS_Mixer_StreamAddChannelEx(Int32, Int32, BASSFlag, Int64, Int64)) beforehand).
matrix
Type: SystemSingle
The 2-dimensional array (float[,]) of the new mixing matrix.
time
Type: SystemSingle
A period (in seconds) for the channel's current matrix to smoothly transition to the specified (new) matrix.

Return Value

Type: Boolean
If successful, a is returned, else is returned. Use BASS_ErrorGetCode to get the error code.
Remarks

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

ERROR CODEDescription
BASS_ERROR_HANDLEhandle is not plugged into a mixer.
BASS_ERROR_NOTAVAILThe channel is not using matrix mixing.

See Also

Reference