int Mix_VolumeChunk(Mix_Chunk *chunk, int volume)
| chunk | 音量を設定するチャンク |
| volume | 0からMIX_MAX_VOLUMEの間の新しい音量. -1のとき獲得 |
チャネルの音量設定に加え, 個別のチャンクにも音量を設定する. 両方の値がミキシング時に考慮され, 最終的な音声の減衰となる. これによりアプリケーションは全インスタンスの音量に加え, 個別のインスタンスの音量も調整できる.
音量は0(無音)からMIX_MAX_VOLUME(最大音量)の間の値である. MIX_MAX_VOLUMEは128である. MIX_MAX_VOLUMEより大きな値はMIX_MAX_VOLUMEとなる.
負の値を指定した場合, 現在の音量は変化しない. これはこの関数は呼び出し前の音量(この場合は変わらない)を戻すため, 音量を変えずに現在の音量を得るために使える
チャンクの音量のデフォルト値はMIX_MAX_VOLUME(減衰なし)である.