目次 - 4.関数 - 4.5音楽 - Mix_VolumeMusic

Mix_VolumeMusic

int Mix_VolumeMusic(int volume)

volume
0〜MIX_MAX_VOLUME(128)のボリューム. MIX_MAX_VOLUMEより大きい場合は, MIX_MAX_VOLUMEとなる. -1の場合はボリュームは設定されないが, 現在のボリュームを得るときに使う.

volumeが0以上のときボリュームを設定し, 設定前の値を戻す. フェード中はボリュームの設定はできない. フェーダーがこの関数を使っているためである! Mix_SetMusicCMDで設定した外部音楽プレイヤーの場合は無効で, Mix_GetErrorで理由が示される.

戻り値: 設定前のボリューム

サンプルコード

// 音楽のボリュームを最大の1/2にして, それをチェックする
printf("設定前のボリューム : %d¥n", Mix_VolumeMusic(MIX_MAX_VOLUME/2));
printf("現在のボリューム   : %d¥n", Mix_VolumeMusic(-1));

参照

Mix_FadeInMusic, Mix_FadeOutMusic, Mix_SetMusicCMD

原文へのリンク

4.5.9 Mix_VolumeMusic