mixFadeOutMusic function

bool mixFadeOutMusic(int ms)

Halt the music stream after fading it out for a specified time.

This will begin the music fading from its current volume to silence over ms milliseconds. After that time, the music is halted.

Any halted music will call any callback specified by Mix_HookMusicFinished() once the halt occurs.

Fading music will change it's volume progressively, as if Mix_VolumeMusic() was called on it (which is to say: you probably shouldn't call Mix_VolumeMusic() on a fading channel).

Note that this function does not block for the number of milliseconds requested; it just schedules the music to fade and notes the time for the mixer to manage later, and returns immediately.

\param ms number of milliseconds to fade before halting the channel. \returns true if music was scheduled to fade, false otherwise. If no music is currently playing, this returns false.

\since This function is available since SDL_mixer 3.0.0.

extern SDL_DECLSPEC bool SDLCALL Mix_FadeOutMusic(int ms)

Implementation

bool mixFadeOutMusic(int ms) {
  final mixFadeOutMusicLookupFunction = libSdl3Mixer.lookupFunction<
      Uint8 Function(Int32 ms), int Function(int ms)>('Mix_FadeOutMusic');
  return mixFadeOutMusicLookupFunction(ms) == 1;
}