Set3DSoundOneMetre

３Ｄ空間の１メートルに相当する距離を設定する

Set3DSoundOneMetre Distance

Distance ： ３Ｄサウンドで１メートルに相当する距離の値

(プラグイン / モジュール : DxLibW)

解説

この関数では、Set3DPositionSoundMem などの３Ｄ座標を扱う関数での座標値が、
メートル換算ではどのような値になるかを設定します。( メートル換算された値を使用してドップラー効果などの処理が行われます )

例：３Ｄ座標での 1.0f を１メートルとして設定する

// DxLib_Init の前に Set3DSoundOneMetre に 1.0f を渡して呼ぶ
Set3DSoundOneMetre( 1.0f ) ;

if( DxLib_Init() == -1 )
{
return -1 ;
}

因みに上記の例にある通り、この関数は DxLib_Init を呼ぶ前にのみ呼ぶことができる関数です。

DxLib_Init の後に呼んでも設定を変更することができませんので注意してください。

何故このような関数があるかというと、３Ｄグラフィックスでは値の扱いが色々で、
例えば身長１８０ｃｍのキャラクターモデルの頭の天辺の y座標が、あるモデルでは 180.0f で、
また別のモデルでは 1.8f だったりと、作り手や製作環境によって１メートルの扱いが異なるからです。

３Ｄグラフィックスでは 1.0f を １メートルとするか、１センチメートルとするかは製作者同士で共通の認識ができていれば問題がありませんが、
３Ｄサウンドでは 1.0f が １メートルなのか、１センチメートルなのかでドップラー効果やリバーブエフェクトの掛かり方にかなりの違いが発生するので、
この関数で明示的に「これから動作するプログラムでは１メートルは 100.0f として扱います」のようにサウンドシステムに伝えておく必要があるというわけです。

戻り値:
  ０：成功

情報