structure X3DAUDIO_LISTENER (x3daudio.h)

Définit un point de réception audio 3D.

Syntaxe

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

Membres

OrientFront

Orientation de la direction avant. Lorsque pCone a la valeur NULL , OrientFront est utilisé uniquement pour les calculs de matrice et de délai. Lorsque pCone n’a pas la valeur NULL, OrientFront est utilisé pour la matrice, le LPF (chemins d’accès direct et de réverbération) et les calculs de réverbération. Cette valeur doit être orthonormale avec OrientTop lorsqu’elle est utilisée.

OrientTop

Orientation de la direction supérieure, utilisée uniquement pour les calculs de matrice et de délai. Cette valeur doit être orthonormale avec OrientFront lorsqu’elle est utilisée.

Position

Position dans les unités mondiales définies par l’utilisateur. Cette valeur n’affecte pas la vélocité.

Velocity

Vecteur de vélocité dans les unités mondiales définies par l’utilisateur par seconde, utilisé uniquement pour les calculs doppler. Cette valeur n’affecte pas Position.

pCone

Pointeur vers une structure de X3DAUDIO_CONE pour cet écouteur. La fourniture d’un cône d’écouteur spécifie que des calculs supplémentaires sont effectués lors de la détermination du volume et filtrent les paramètres DSP pour des sources sonores individuelles. Une valeur pCone NULL spécifie un son omnidirectionnel et aucun traitement cône n’est appliqué. pCone est utilisé uniquement pour les calculs de matrice, de LPF (chemins d’accès direct et de réverbération) et de réverbération.

Remarques

X3DAudio utilise un système de coordonnées cartésien gaucher, avec des valeurs sur l’axe X qui augmentent de gauche à droite, sur l’axe y de bas en haut et sur l’axe z de près à loin. Les azimuts sont mesurés dans le sens des aiguilles d’une montre à partir d’une direction de référence donnée.

Pour utiliser X3DAudio avec des coordonnées de droite, vous devez annuler l’élément .z d’OrientFront, OrientTop, Position et Velocity.

Le type de paramètre X3DAUDIO_VECTOR est tapé dans DirectX ::XMFLOAT3 pour fournir des valeurs à virgule flottante x, y et z.

Les vecteurs avant et supérieur d’un écouteur doivent être orthonormals. Pour être considérée comme orthonormale, une paire de vecteurs doit avoir une magnitude de 1 +- 1x10-5 et un produit de point de 0 +- 1x10-5.

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Configuration requise

Condition requise	Valeur
En-tête	x3daudio.h