目次 - 4.関数 - 4.6エフェクト - Mix_SetDistance

Mix_SetDistance

int Mix_SetDistance(int channel, Uint8 distance)

channel
エフェクトを登録するチャネル番号. MIX_CHANNEL_POSTとするとミキシングの後の処理
distance
聞き手との距離. 0(近い/大きい)〜255(遠い/小さい)

このエフェクトは音を弱めることで距離をシミュレートする. ボリュームは最大距離でも無音にはならない.

メモ: distanceを0にするとchannelからこのエフェクトを削除する. チャネルに対してMix_UnregisterAllEffectsを使うことを除けば, この方法以外で削除することはできない.

戻り値: チャネルが不正, Mix_RegisterEffectに失敗などのとき0(偽)

サンプルコード

// チャネル1を最も遠くにする
if(!Mix_SetDistance(1, 255)) {
    printf("Mix_SetDistance: %s¥n", Mix_GetError());
    // 距離がない?
}

参照

Mix_SetPosition, Mix_UnregisterAllEffects

原文へのリンク

4.6.6 Mix_SetDistance