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


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

Header File

Defined in <SDL_mixer.h>


int Mix_FadeOutMusic(int ms);

Function Parameters

int ms number of milliseconds to fade before halting the channel.

Return Value

(int) Returns non-zero if music was scheduled to fade, zero otherwise. If no music is currently playing, this returns zero.


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.


This function is available since SDL_mixer 2.0.0.

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

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