3Dリスナーの作成

説明:

3Dリスナーオブジェクトを作成します。

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

3Dリスナーオブジェクトの破棄

説明:

3Dリスナーオブジェクトを破棄します。
本関数を実行した時点で、3Dリスナー作成時にDLL内で確保されたリソースが全て解放されます。
3DリスナーオブジェクトをセットしたAtomExプレーヤで再生している音声がある場合、 本関数を実行する前に、それらの音声を停止するか、そのAtomExプレーヤを破棄してください。

3Dリスナーの更新

説明:

3Dリスナーに設定されているパラメータを使用して、3Dリスナーを更新します。
本関数では、3Dリスナーに設定されているすべてのパラメータを更新します。 パラメータをひとつ変更する度に本関数にて更新処理を行うよりも、 複数のパラメータを変更してから更新処理を行った方が効率的です。

例:

    ：
 // リスナーの作成
 CriAtomExListener listener = new CriAtomEx3dListener();
    ：
 // リスナー位置の設定
 listener.SetPosition(0.0f, 0.0f, 1.0f);

 // リスナー速度の設定
 listener.SetVelocity(1.0f, 0.0f, 0.0f);

 // 注意）この時点ではリスナーの位置や速度はまだ変更されていません。

 // 変更の適用
 listener.Update();
    ：

注意:

本関数はAtomExプレーヤのパラメータ更新（ CriAtomExPlayer::UpdateAll, CriAtomExPlayer::Update ） とは独立して動作します。
3Dリスナーのパラメータを変更した際は、本関数にて更新処理を行ってください。

3D音源パラメータの初期化

説明:

3Dリスナーに設定されているパラメータをクリアし、初期値に戻します。

注意:

クリアしたパラメータを実際に適用するには、 CriAtomEx3dListener::Update 関数を呼び出す必要があります。

3Dリスナーの位置の設定

引数:

x	X座標
y	Y座標
z	Z座標

説明:

3Dリスナーの位置を設定します。
位置は、距離減衰、および定位計算に使用されます。
位置は、3次元ベクトルで指定します。
位置の単位がいくつであるかは、3Dリスナーの距離計数 （ CriAtomEx3dListener::SetDistanceFactor 関数で設定）で決まります。
デフォルト値は(0.0f, 0.0f, 0.0f)です。
データ側には位置は設定できないため、常に本関数での設定値が使用されます。

注意:

設定したパラメータを実際に適用するには、 CriAtomEx3dListener::Update 関数を呼び出す必要があります。

参照:

CriAtomEx3dListener::Update

3Dリスナーの速度の設定

引数:

x	X軸方向の速度
y	Y軸方向の速度
z	Z軸方向の速度

説明:

3Dリスナーの速度を設定します。
速度は、ドップラー効果の計算に使用されます。
速度は、3次元ベクトルで指定します。
速度の単位は、1秒あたりの移動距離です。
距離の単位がいくつであるかは、3Dリスナーの距離計数 （ CriAtomEx3dListener::SetDistanceFactor 関数で設定）で決まります。
デフォルト値は(0.0f, 0.0f, 0.0f)です。
データ側には速度は設定できないため、常に本関数での設定値が使用されます。

注意:

設定したパラメータを実際に適用するには、 CriAtomEx3dListener::Update 関数を呼び出す必要があります。

参照:

CriAtomEx3dListener::Update

3Dリスナーの向きの設定

引数:

fx	前方ベクトルのX方向の値
fy	前方ベクトルのY方向の値
fz	前方ベクトルのZ方向の値
ux	上方ベクトルのX方向の値
uy	上方ベクトルのY方向の値
uz	上方ベクトルのZ方向の値

説明:

3Dリスナーの向きを前方ベクトルと上方ベクトルで設定します。
向きは、3次元ベクトルで指定します。
設定された向きベクトルは、ライブラリ内部で正規化して使用されます。
デフォルト値以下のとおりです。

• 前方ベクトル：(0.0f, 0.0f, 1.0f)
• 上方ベクトル：(0.0f, 1.0f, 0.0f)

データ側にはリスナーの向きは設定できないため、常に本関数での設定値が使用されます。

注意:

設定したパラメータを実際に適用するには、 CriAtomEx3dListener::Update 関数を呼び出す必要があります。

参照:

CriAtomEx3dListener::Update

3Dリスナーの距離係数の設定

引数:

distanceFactor

距離係数

説明:

3Dリスナーの距離係数を設定します。
距離係数はベクトルの単位となるメートル数です。ドップラー効果の計算に使用されます。
例えば、distanceFactorに10.0fを指定すると、位置や速度等の1.0fを10メートルとして扱います。
デフォルト値は1.0fです。
データ側にはリスナーの距離係数は設定できないため、常に本関数での設定値が使用されます。

注意:

設定したパラメータを実際に適用するには、 CriAtomEx3dListener::Update 関数を呼び出す必要があります。

参照:

CriAtomEx3dListener::Update