目次 - 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