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

Mix_Volume

int Mix_Volume(int channel, int volume)

channels
ボリュームを設定するチャネル. -1のとき全てのチャネルを設定する
volume
0〜MIX_MAX_VOLUME(128)のボリューム. MIX_MAX_VOLUMEより大きい場合は, MIX_MAX_VOLUMEとなる. 0より小さい場合は, ボリュームは設定されない

確保されたチャネルのボリュームを設定する. channelを-1にすると一度に全てのチャネルを設定する. チャネルのボリュームはサンプリング音声のボリュームと共にミキシングの最後に適用される. もしこのボリュームを64に設定すると, 指定したチャネルの全てのサンプリング音声の出力のボリュームは半分になる. 全てのチャネルのデフォルトのボリュームは最大値の128である. 新たに確保されたチャネルのボリュームは最大値であり, 全てのチャネルのボリュームを設定しても, その後で確保されたチャネルには影響しない.

戻り値: channelの現在のボリューム. もし-1ならば, ボリュームの平均値

サンプルコード

// チャネル1のボリュームを半分にする
Mix_Volume(1,MIX_MAX_VOLUME/2);

// 平均ボリュームを表示する
printf("平均ボリュームは %d¥n",Mix_Volume(-1,-1));

参照

Mix_VolumeChunk, Mix_VolumeMusic

原文へのリンク

4.3.2 Mix_Volume