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

Mix_ReserveChannels

アプリケーション用のチャネルを予約する

構文

int Mix_ReserveChannels(int num)

引数

num予約する0番目からのチャネルの数

戻り値

予約したチャネルの数を戻す.

詳細

SDL_mixerは最大Mix_AllocateChannels()で確保した数のチャネルを使用するが, この関数はMix_PlayChannel()でチャネルに-1(未使用の最初のチャネル)を指定しても選択されないチャネルを設定する. この場合, SDL_mixerは予約されたチャネルが再生中であってもなくても「使用中」とみなす.

これは一部のチャネルを専用の音声のために確保し, 残りは可能ならば使用したい場合に有用である.

この関数を呼ぶと0番からn-1番のチャネルが予約される. 予約によってチャネルの確保数が変わることはない. 予約されたチャネルの数は現在の確保されたチャネルで固定される.

デフォルトではチャネルは予約されない.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_ReserveChannels