diff --git a/include/SDL_mixer.h b/include/SDL_mixer.h index 08b456ab5..a6af01c1d 100644 --- a/include/SDL_mixer.h +++ b/include/SDL_mixer.h @@ -2421,8 +2421,30 @@ extern DECLSPEC int SDLCALL Mix_PausedMusic(void); */ extern DECLSPEC int SDLCALL Mix_ModMusicJumpToOrder(int order); -/* Tracks */ +/** + * Start a track in music object. + * + * This only applies to GME music formats. + * + * \param music the music object. + * \param track the track number to play. 0 is the first track. + * \returns 0 if successful, or -1 if failed or isn't implemented. + * + * \since This function is available since SDL_mixer 2.8.0. + */ extern DECLSPEC int SDLCALL Mix_StartTrack(Mix_Music *music, int track); + +/** + * Get number of tracks in music object. + * + * This only applies to GME music formats. + * + * \param music the music object. + * \returns number of tracks if successful, or -1 if failed or isn't + * implemented. + * + * \since This function is available since SDL_mixer 2.8.0. + */ extern DECLSPEC int SDLCALL Mix_GetNumTracks(Mix_Music *music); /**