NAME¶

Mix_PlayMusic - Play a new music object.

SYNOPSIS¶

#include "SDL3_mixer/SDL_mixer.h"

int Mix_PlayMusic(Mix_Music *music, int loops);

DESCRIPTION¶

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.

FUNCTION PARAMETERS¶

music

the new music object to schedule for mixing.

loops

the number of loops to play the music for (0 means "play once and stop").

RETURN VALUE¶

Returns zero on success, -1 on error.

AVAILABILITY¶

This function is available since SDL_mixer 3.0.0.