X3DAUDIO_LISTENER構造体 (x3daudio.h)

3D オーディオ受信のポイントを定義します。

構文

typedef struct X3DAUDIO_LISTENER {
  X3DAUDIO_VECTOR OrientFront;
  X3DAUDIO_VECTOR OrientTop;
  X3DAUDIO_VECTOR Position;
  X3DAUDIO_VECTOR Velocity;
  X3DAUDIO_CONE   *pCone;
} X3DAUDIO_LISTENER, *LPX3DAUDIO_LISTENER;

メンバー

OrientFront

正面方向の向き。 pCone が NULL OrientFront の場合は、マトリックス計算と遅延計算にのみ使用されます。 pCone が NULL OrientFront でない場合は、マトリックス、LPF (直接パスとリバーブ パスの両方)、およびリバーブ計算に使用されます。 使用する場合、この値は OrientTop と共に正正規である必要があります。

OrientTop

行列と遅延の計算にのみ使用される、上端方向の向き。 この値は、 OrientFront を使用する場合は正正規正規である必要があります。

Position

ユーザー定義のワールド単位での位置。 この値は ベロシティには影響しません。

Velocity

1 秒あたりのユーザー定義ワールド単位の速度ベクトル。ドップラー計算にのみ使用されます。 この値は Position には影響しません。

pCone

このリスナーの X3DAUDIO_CONE 構造体へのポインター。 リスナー コーンを指定すると、個々のサウンド ソースのボリュームとフィルター DSP パラメーターを決定するときに追加の計算が実行されるように指定されます。 NULL pCone 値は全方向サウンドを指定し、コーン処理は適用されません。 pCone は、マトリックス、LPF (直接パスとリバーブ パスの両方)、およびリバーブ計算にのみ使用されます。

注釈

X3DAudio では左利きのデカルト座標系が使用され、x 軸の値は左から右、y 軸は下から上、z 軸は近くから遠方に増加します。 方位角は、特定の基準方向から時計回りに測定されます。

右辺座標で X3DAudio を使用するには、 OrientFront、 OrientTop、 Position、 Velocity の .z 要素を否定する必要があります。

パラメーター型X3DAUDIO_VECTORは DirectX::XMFLOAT3 に型指定され、x、y、z の浮動小数点値を指定します。

リスナーのフロントベクトルとトップベクトルは正正規である必要があります。 正正規と見なすには、ベクトルのペアの大きさが 1 +- 1x10-5 で、ドット積が 0 +- 1x10-5 である必要があります。

プラットフォームの要件

要件