目次 - SDL_mixer - API(機能別) - チャネル - Mix_GetChunkDecoder

Mix_MasterVolume

全チャネルの全体ボリュームを設定する

構文

int Mix_MasterVolume(int volume)

引数

volume0からMIX_MAX_VOLUMEまでの新しく設定するボリューム. -1のとき現在の値を問い合わせる

戻り値

設定前の値を戻す. 引数を-1とした場合は現在のボリュームを戻す.

詳細

SDL_mixerにはチャネル, チャンク, そして全体のボリューム値があり, オーディオのミキシング時にこの3つを考慮する. この関数はミキシング時に全ての再生チャネルに適用される全体ボリュームを設定する.

ボリュームは0(無音)からMIX_MAX_VOLUME(最大ボリューム)の範囲である必要がある. MIX_MAX_VOLUMEは128である. MIX_MAX_VOLUME以上の場合はMIX_MAX_VOLUMEになる.

負の数を指定するとボリュームは変わらない. この関数は設定前(この場合は変更なし)の値を戻すため, ボリュームを変更せずに現在の値を問い合わせることができる.

全体ボリューム音楽には適用されないので注意すること. これはチャンクのミキシングにのみ適用される. 音楽にはMix_VolumeMusic()を使用すること.

バージョン

SDL 2.6.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_MasterVolume