目次 - SDL_mixer 3.0 - MIX_CreateGroup

MIX_CreateGroup

ミキシンググループを生成する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

MIX_Group * MIX_CreateGroup(MIX_Mixer *mixer);

引数

MIX_Mixer *mixerミキシンググループを生成するミキサー

戻り値

(MIX_Group *) 新しく生成したミキシンググループを戻す. エラーのときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

トラックはミキシンググループに割り付けられている(割り付けられていないならば, ミキサー内部のデフォルトグループ内にある). グループ内の全トラックは一緒にミックスされる. アプリケーションはこのミックスされたデータに他の全てのグループとミックスされて最終的な出力となる前にアクセスできる.

これは便利な機能になりうるが, 完全なオプションである. アプリケーションはミキシンググループを全く無視してもSDL_mixerを完全に使用できる.

グループを生成した後は, MIX_SetTrackGroup()でトラックを割り付ける. MIX_SetGroupPostMixCallback()を使用するとグループのミックスされたデータにアクセスできる.

ミキシンググループは不要になればMIX_DestroyGroup()で破棄できる. ミキサーを破棄すると生成済みのミキシンググループの全て破棄される.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_CreateGroup