Halt a playing group of channels by arbitrary tag, after fading them out for a specified time.
int Mix_FadeOutGroup(int tag, int ms);tag |
an arbitrary value, assigned to channels, to search for. |
ms |
number of milliseconds to fade before halting the group. |
Returns the number of channels that were scheduled for fading.
This will begin fading a group of channels with a specific tag from their current volumes to silence over ms milliseconds. After that time, those channels are halted.
A tag is an arbitary number that can be assigned to several mixer channels, to form groups of channels.
The default tag for a channel is -1.
Any halted channels will have any currently-registered effects deregistered, and will call any callback specified by Mix_ChannelFinished() once the halt occurs.
A fading channel will change it's volume progressively, as if Mix_Volume() was called on it (which is to say: you probably shouldn't call Mix_Volume() on a fading channel).
Note that this function does not block for the number of milliseconds requested; it just schedules the group to fade and notes the time for the mixer to manage later, and returns immediately.
This function is available since SDL_mixer 2.0.0.