struktur X3DAUDIO_LISTENER (x3daudio.h)

Artikel
08/28/2023

Mendefinisikan titik penerimaan audio 3D.

Sintaks

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

Anggota

OrientFront

Orientasi arah depan. Ketika pCone adalah NULL OrientFront hanya digunakan untuk perhitungan matriks dan penundaan. Ketika pCone bukan NULL OrientFront digunakan untuk matriks, LPF (jalur langsung dan gaung), dan perhitungan gaung. Nilai ini harus orthonormal dengan OrientTop saat digunakan.

OrientTop

Orientasi arah atas, hanya digunakan untuk perhitungan matriks dan penundaan. Nilai ini harus orthonormal dengan OrientFront saat digunakan.

Position

Posisi dalam unit dunia yang ditentukan pengguna. Nilai ini tidak memengaruhi Kecepatan.

Velocity

Vektor kecepatan dalam unit dunia yang ditentukan pengguna per detik, hanya digunakan untuk perhitungan doppler. Nilai ini tidak mempengaruhi Posisi.

pCone

Arahkan ke struktur X3DAUDIO_CONE untuk pendengar ini. Menyediakan kerujut pendengar akan menentukan bahwa perhitungan tambahan dilakukan saat menentukan parameter DSP volume dan filter untuk sumber suara individual. Nilai pCone NULL menentukan suara omnidirectional dan tidak ada pemrosesan kerucut yang diterapkan. pCone hanya digunakan untuk matriks, LPF (jalur langsung dan gaung), dan perhitungan gaung.

Keterangan

X3DAudio menggunakan sistem koordinat Kartesius sebelah kiri, dengan nilai pada sumbu x meningkat dari kiri ke kanan, pada sumbu y dari bawah ke atas, dan pada sumbu z dari dekat ke jauh. Azimuth diukur searah jarang dari arah referensi tertentu.

Untuk menggunakan X3DAudio dengan koordinat tangan kanan, Anda harus meniadakan elemen .z dari OrientFront, OrientTop, Posisi, dan Velocity.

Jenis parameter X3DAUDIO_VECTOR di ketik ke DirectX::XMFLOAT3, untuk menyediakan nilai titik mengambang x, y, dan z.

Vektor depan dan atas pendengar harus orthonormal. Untuk dianggap orthonormal, sepasang vektor harus memiliki besaran 1 +- 1x10-5 dan produk titik 0 +- 1x10-5.

Persyaratan Platform

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

Persyaratan

Persyaratan	Nilai
Header	x3daudio.h

Bagikan melalui