X3DAudioCalculate 関数 (x3daudio.h)
3D パラメータに関する DSP 設定を計算します。
構文
X3DAUDIO_API_(void) X3DAudioCalculate(
[in] const X3DAUDIO_HANDLE Instance,
[in] const X3DAUDIO_LISTENER *pListener,
[in] const X3DAUDIO_EMITTER *pEmitter,
[in] UINT32 Flags,
[in, out] X3DAUDIO_DSP_SETTINGS *pDSPSettings
);
パラメーター
[in] Instance
3D オーディオ インスタンス ハンドル。 このハンドルを取得するには 、X3DAudioInitialize を呼び出します。
[in] pListener
受信ポイントを表す X3DAUDIO_LISTENER へのポインター。
[in] pEmitter
音源を表す X3DAUDIO_EMITTER へのポインター。
[in] Flags
| 値 | 説明 |
|---|---|
| X3DAUDIO_CALCULATE_MATRIX | 行列係数テーブルの計算を有効にします。 |
| X3DAUDIO_CALCULATE_DELAY | 遅延時間配列計算を有効にします (ステレオのみ)。 |
| X3DAUDIO_CALCULATE_LPF_DIRECT | ローパスフィルタ(LPF)ダイレクトパス係数計算を有効にします。 |
| X3DAUDIO_CALCULATE_LPF_REVERB | LPF リバーブ パス係数の計算を有効にします。 |
| X3DAUDIO_CALCULATE_REVERB | リバーブの送信レベルの計算を有効にします。 |
| X3DAUDIO_CALCULATE_DOPPLER | ドップラーシフト係数の計算を有効にします。 |
| X3DAUDIO_CALCULATE_EMITTER_ANGLE | エミッタからリスナーへの内部角度の計算を有効にします。 |
| X3DAUDIO_CALCULATE_ZEROCENTER | 中央のチャンネルを無音で埋めます。 このフラグを使用すると、チャネルを再マップする必要がないように 6 チャネル マトリックスを保持できますが、中央のチャネルはサイレントになります。 このフラグは、X3DAUDIO_CALCULATE_MATRIXも設定した場合にのみ有効です。 |
| X3DAUDIO_CALCULATE_REDIRECT_TO_LFE | すべてのソース チャネルの同じ組み合わせを、低周波数効果 (LFE) の宛先チャネルに適用します。 これは、LFE チャネルを持たないソースと LFE チャネルを持つ宛先を持つマトリックス計算にのみ適用されます。 このフラグは、X3DAUDIO_CALCULATE_MATRIXも設定した場合にのみ有効です。 |
[in, out] pDSPSettings
計算結果を受け取る X3DAUDIO_DSP_SETTINGS 構造体へのポインター。
戻り値
この関数は値を返しません。
注釈
通常、シーン内のオブジェクトとリスナーを出力するペアごとに X3DAudioCalculate を 1 回呼び出します。 各呼び出しの後、3D 効果を適用するために、 アプリは pDSPSettings の計算結果を手動でXAUDIO2 グラフに適用します。 詳細については、「 方法: X3DAudio と XAudio2 を統合する」を参照してください。
大事な リスナーとエミッターの値は有効である必要があります。 浮動小数点スペシャル (NaN、QNaN、+INF、-INF) を使用すると、実行中のオーディオ グラフに導入された場合、オーディオ出力全体がサイレントになる可能性があります。
プラットフォームの要件
Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)Windows Phone 8.1: この API はサポートされています。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | x3daudio.h |
| Library | Xaudio2.lib |