mixFadeOutGroup function

int mixFadeOutGroup(int tag, int ms)

Halt a playing group of channels by arbitrary tag, after fading them out for a specified time.

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 arbitrary 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.

\param tag an arbitrary value, assigned to channels, to search for. \param ms number of milliseconds to fade before halting the group. \returns the number of channels that were scheduled for fading.

\since This function is available since SDL_mixer 3.0.0.

extern SDL_DECLSPEC int SDLCALL Mix_FadeOutGroup(int tag, int ms)

Implementation

int mixFadeOutGroup(int tag, int ms) {
  final mixFadeOutGroupLookupFunction = libSdl3Mixer.lookupFunction<
      Int32 Function(Int32 tag, Int32 ms),
      int Function(int tag, int ms)>('Mix_FadeOutGroup');
  return mixFadeOutGroupLookupFunction(tag, ms);
}