Fungsi X3DAudioCalculate (x3daudio.h)

Artikel
03/13/2024

Menghitung pengaturan DSP sehubungan dengan parameter 3D.

Sintaks

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
);

Parameter

[in] Instance

Handel instans audio 3D. Panggil X3DAudioInitialize untuk mendapatkan handel ini.

[in] pListener

Arahkan ke X3DAUDIO_LISTENER yang mewakili titik penerimaan.

[in] pEmitter

Arahkan ke X3DAUDIO_EMITTER yang mewakili sumber suara.

[in] Flags

Nilai	Deskripsi
X3DAUDIO_CALCULATE_MATRIX	Mengaktifkan perhitungan tabel koefisien matriks.
X3DAUDIO_CALCULATE_DELAY	Mengaktifkan perhitungan array waktu penundaan (hanya stereo).
X3DAUDIO_CALCULATE_LPF_DIRECT	Mengaktifkan penghitungan koefisien jalur langsung filter low pass (LPF).
X3DAUDIO_CALCULATE_LPF_REVERB	Mengaktifkan penghitungan koefisien jalur gaung LPF.
X3DAUDIO_CALCULATE_REVERB	Mengaktifkan penghitungan tingkat pengiriman reverb.
X3DAUDIO_CALCULATE_DOPPLER	Mengaktifkan penghitungan faktor pergeseran Doppler.
X3DAUDIO_CALCULATE_EMITTER_ANGLE	Memungkinkan penghitungan sudut interior emiter-ke-pendengar.
X3DAUDIO_CALCULATE_ZEROCENTER	Mengisi saluran tengah dengan keheningan. Bendera ini memungkinkan Anda untuk menyimpan matriks 6 saluran sehingga Anda tidak perlu memetakan ulang saluran, tetapi saluran tengah akan diam. Bendera ini hanya valid jika Anda juga mengatur X3DAUDIO_CALCULATE_MATRIX.
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	Menerapkan campuran yang sama dari semua saluran sumber ke saluran tujuan efek frekuensi rendah (LFE). Ini hanya berlaku untuk perhitungan matriks dengan sumber yang tidak memiliki saluran LFE dan tujuan yang memang memiliki saluran LFE. Bendera ini hanya valid jika Anda juga mengatur X3DAUDIO_CALCULATE_MATRIX.

[in, out] pDSPSettings

Penunjuk ke struktur X3DAUDIO_DSP_SETTINGS yang menerima hasil perhitungan.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Keterangan

Anda biasanya memanggil X3DAudioCalculate sekali untuk setiap pasangan memancarkan objek dan pendengar di adegan. Setelah setiap panggilan, untuk menerapkan efek 3D, aplikasi secara manual menerapkan hasil perhitungan di pDSPSettings ke grafik XAUDIO2. Untuk informasi selengkapnya, lihat Cara: Mengintegrasikan X3DAudio dengan XAudio2.

Penting Nilai pendengar dan pemancar harus valid. Khusus floating-point (NaN, QNaN, +INF, -INF) dapat menyebabkan seluruh output audio menjadi senyap jika dimasukkan ke dalam grafik audio yang sedang berjalan.

Persyaratan Platform

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Windows Phone 8.1: API ini didukung.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	x3daudio.h
Pustaka	Xaudio2.lib

Lihat juga

Fungsi

Bagikan melalui