(This function is part of SDL_mixer, a separate library from SDL.)

Mix_GroupChannel

Assign a tag to a channel.

Header File

Defined in <SDL3_mixer/SDL_mixer.h>

Syntax

bool Mix_GroupChannel(int which, int tag);

Function Parameters

int	which	the channel to set the tag on.
int	tag	an arbitrary value to assign a channel.

Return Value

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

Remarks

A tag is an arbitrary 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 channel's current tag; you may only have one tag per channel.

You may not specify MAX_CHANNEL_POST for a channel.

Version

This function is available since SDL_mixer 3.0.0.

---

CategoryAPI, CategoryAPIFunction

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.