目次 - 4.関数 - 4.3チャネル - Mix_AllocateChannels

Mix_AllocateChannels

int Mix_AllocateChannels(int numchans)

numchans
確保するミキシングチャネル数. 負の数のとき何もしない. 現在のチャネル数を得るときに使うとよい

ミキシングチャネルの数を設定する. この関数は再生中を含めいつでも呼べる. numchansが現在のチャネル数より少ない場合, 上位のチャネルが停止し解放され, それ以降ミキシングされない. しかし, 1秒間に1000回チャネル数を変えるような使い方はすべきではない. 確保されたチャネルが解除されたとき, Mix_ChannelFinishedで設定されたコールバック関数が, それぞれの停止し解放されたチャネルに対して呼ばれる.

メモ: 0を渡すと全てのミキシングチャネルが解放される. しかし音楽は再生される.

戻り値: 確保したチャネルの数. 決して失敗することはない...しかし, チャネル数が多すぎてメモリを使い果たすと異常終了する. とても多い場合のことである!

サンプルコード

// 16のミキシングチャネルを確保する
Mix_AllocateChannels(16);

参照

Mix_OpenAudio

原文へのリンク

4.3.1 Mix_AllocateChannels