目次 - SDL_mixer - API(機能別) - 音楽 - Mix_SetMusicCMD

Mix_SetMusicCMD

音楽ストリームのための外部コマンドを実行する

構文

int Mix_SetMusicCMD(const char *command)

引数

commandコマンド

戻り値

成功のとき0, エラーのとき-1を戻す.

詳細

この関数は現在再生中のあらゆる音楽を停止し, 次回の音楽再生があった場合, SDL_mixerはcommandで指定したコマンドラインでプロセスを生成する. コマンドにはシェル拡張は適用されない. 基本的な引数の分離を行い, ほとんどの環境ではsystem()ではなくexecvp()に渡される.

コマンドは音声の出力を担うものである. これはSDL_mixerではミックスされない. SDL_mixerは音楽の停止を求められたときプロセスをkillするが, そうでない限りプロセスが完了するまでなにもしない.

特別な理由がない限り, この関数は使用しないことを強く推奨する.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_SetMusicCMD