X3DAUDIO_LISTENER struttura (x3daudio.h)

Definisce un punto di ricezione audio 3D.

Sintassi

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

Members

OrientFront

Orientamento della direzione anteriore. Quando pCone è NULL OrientFront viene usato solo per i calcoli di matrice e ritardo. Quando pCone non è NULL OrientFront viene usato per matrice, LPF (sia percorsi diretti che di riverbero) e calcoli di riverbero. Questo valore deve essere ortonormale con OrientTop quando usato.

OrientTop

Orientamento della direzione superiore, usato solo per i calcoli di matrice e ritardo. Questo valore deve essere ortonormale con OrientFront quando usato.

Position

Posizione nelle unità mondiali definite dall'utente. Questo valore non influisce sulla velocità.

Velocity

Vettore di velocità nelle unità mondiali definite dall'utente al secondo, usato solo per i calcoli doppler. Questo valore non influisce sulla posizione.

pCone

Puntatore a una struttura X3DAUDIO_CONE per questo listener. Fornire un cono listener specifica che vengono eseguiti calcoli aggiuntivi quando si determinano i parametri DSP del volume e del filtro per le singole origini audio. Un valore pCone NULL specifica un suono omnidirectionale e non viene applicata alcuna elaborazione cone. pCone viene usato solo per i calcoli matrice, LPF (sia percorsi diretti che di riverbero) e riverbero.

Commenti

X3DAudio usa un sistema di coordinate cartesiano a sinistra, con valori sull'asse x che aumentano da sinistra a destra, sull'asse y dal basso verso l'alto e sull'asse z da vicino a lontano. Gli Azimuth vengono misurati in senso orario da una determinata direzione di riferimento.

Per usare X3DAudio con coordinate di destra, è necessario negare l'elemento .z di OrientFront, OrientTop, Position e Velocity.

Il tipo di parametro X3DAUDIO_VECTOR viene digitato in DirectX::XMFLOAT3, per fornire valori x, y e z a virgola mobile.

I vettori front-end e top di un listener devono essere ortonormali. Per essere considerato ortonormale, una coppia di vettori deve avere una grandezza di 1 +- 1x10-5 e un prodotto dot di 0 +- 1x10-5.

Requisiti della piattaforma

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

Requisiti

Requisito	Valore
Intestazione	x3daudio.h