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


Play a new music object.

Header File

Defined in <SDL3_mixer/SDL_mixer.h>


int Mix_PlayMusic(Mix_Music *music, int loops);

Function Parameters

Mix_Music * music the new music object to schedule for mixing.
int loops the number of loops to play the music for (0 means "play once and stop").

Return Value

(int) Returns zero on success, -1 on error.


This will schedule the music object to begin mixing for playback.

There is only ever one music object playing at a time; if this is called when another music object is playing, the currently-playing music is halted and the new music will replace it.

Please note that if the currently-playing music is in the process of fading out (via Mix_FadeOutMusic()), this function will block until the fade completes. If you need to avoid this, be sure to call Mix_HaltMusic() before starting new music.


This function is available since SDL_mixer 3.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.