BASSmix

BASS_Mixer_ChannelSetEnvelopePos

Sets the current position of an envelope on a channel.

BOOL BASS_Mixer_ChannelSetEnvelopePos(
    DWORD handle,
    DWORD type,
    QWORD pos
);

Parameters

handle

The channel handle.

type

The envelope to set the position of. One of the following.

BASS_MIXER_ENV_FREQ	Sample rate.
BASS_MIXER_ENV_VOL	Volume.
BASS_MIXER_ENV_PAN	Panning/balance.

pos

The new envelope position, in bytes. If this is beyond the end of the envelope it will be capped or looped, depending on whether the envelope has looping enabled.

Return value

If successful, the current position of the envelope is returned, else -1 is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_HANDLE	The channel is not plugged into a mixer.
BASS_ERROR_ILLTYPE	type is not valid.
BASS_ERROR_NOTAVAIL	There is no envelope of the requested type on the channel.

Remarks

During playback, the effect of changes are not heard instantaneously, due to buffering. To reduce the delay, use the BASS_CONFIG_BUFFER config option config option to reduce the buffer length.