SDL Wiki
[ front page | index | search | recent changes | git repo | offline html ]
(This function is part of SDL_mixer, a separate library from SDL.)

MIX_TrackPlaying

Query if a track is currently playing.

Header File

Defined in <SDL3_mixer/SDL_mixer.h>

Syntax

bool MIX_TrackPlaying(MIX_Track *track);

Function Parameters

MIX_Track * track the track to query.

Return Value

(bool) Returns true if playing, false otherwise.

Remarks

If this returns true, the track is currently contributing to the mixer's output (it's "playing"). It is not stopped nor paused.

On various errors (MIX_Init() was not called, the track is NULL), this returns false, but there is no mechanism to distinguish errors from non-playing tracks.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL_mixer 3.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategorySDLMixer


[ edit | delete | history | feedback | raw ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.