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


Run an external command as the music stream.

Header File

Defined in SDL_mixer.h


int Mix_SetMusicCMD(const char *command);

Function Parameters

command command

Return Value

Returns 0 if successful, -1 on error


This halts any currently-playing music, and next time the music stream is played, SDL_mixer will spawn a process using the command line specified in command. This command is not subject to shell expansion, and beyond some basic splitting up of arguments, is passed to execvp() on most platforms, not system().

The command is responsible for generating sound; it is NOT mixed by SDL_mixer! SDL_mixer will kill the child process if asked to halt the music, but otherwise does not have any control over what the process does.

You are strongly encouraged not to use this function without an extremely good reason.


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.