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

Mix_Volume

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

構文

int Mix_Volume(int channel, int volume)

引数

channel音量を設定/獲得するチャネル. -1のとき全てのチャネル
volume0からMIX_MAX_VOLUMEの間の新しい音量. -1のとき獲得

戻り値

設定前の音量を戻す. `volume`を-1とした場合, 現在の音量を戻す. `channel`が-1の場合は全てのチャネルの平均値を戻す.

詳細

音量は0(無音)からMIX_MAX_VOLUME(最大音量)の間の値である. MIX_MAX_VOLUMEは128である. MIX_MAX_VOLUMEより大きな値はMIX_MAX_VOLUMEとなる.

負の値を指定した場合, 現在の音量は変化しない. これはこの関数は呼び出し前の音量(この場合は変わらない)を戻すため, 音量を変えずに現在の音量を得るために使える

チャネルを-1にした場合, この関数は全てのチャネルの音量を設定し, 全てのチャネルの呼び出し前の音量の平均値を戻す.

チャネルの音量のデフォルト値はMIX_MAX_VOLUME(減衰なし)である.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_Volume