Assign several consecutive channels to the same tag.
int Mix_GroupChannels(int from, int to, int tag);from |
the first channel to set the tag on. |
to |
the last channel to set the tag on, inclusive. |
tag |
an arbitrary value to assign a channel. |
Returns 0 if successful, negative on error
A tag is an arbitary number that can be assigned to several mixer channels, to form groups of channels.
If 'tag' is -1, the tag is removed (actually -1 is the tag used to represent the group of all the channels).
This function replaces the requested channels' current tags; you may only have one tag per channel.
You may not specify MAX_CHANNEL_POST for a channel.
Note that this returns success and failure in the _opposite_ way from Mix_GroupChannel(). We regret the API design mistake.
This function is available since SDL_mixer 2.0.0.