目次 - SDL_mixer - API(機能別) - グループ - Mix_HaltGroup

Mix_HaltGroup

タグ付けされた複数のチャネルを停止する

構文

int Mix_HaltGroup(int tag)

引数

tagチャネルグループのタグ

戻り値

チャネルが停止したか否かに関わらず0を戻す.

詳細

この関数は新しいチャンクの再生が開始されるまで指定のタグのチャネルでの再生を停止する.

タグは複数のミキサーチャネルと関連付けられる任意の値で, チャネルをグループ化できる.

tagのデフォルト値は-1である.

停止したチャネルに設定されたエフェクトは解除され, Mix_ChannelFinished()で設定されたコールバックがこの関数から戻る前に呼ばれる.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_HaltGroup