Fonction X3DAudioCalculate (x3daudio.h)

Article
03/06/2024

Calcule les paramètres DSP par rapport aux paramètres 3D.

Syntaxe

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

Paramètres

[in] Instance

Poignée de instance audio 3D. Appelez X3DAudioInitialize pour obtenir ce handle.

[in] pListener

Pointeur vers un X3DAUDIO_LISTENER représentant le point de réception.

[in] pEmitter

Pointeur vers un X3DAUDIO_EMITTER représentant la source du son.

[in] Flags

Valeur	Description
X3DAUDIO_CALCULATE_MATRIX	Active le calcul de la table de coefficients de matrice.
X3DAUDIO_CALCULATE_DELAY	Active le calcul d’un tableau de temps de retard (stéréo uniquement).
X3DAUDIO_CALCULATE_LPF_DIRECT	Active le calcul du coefficient de chemin direct du filtre de passage bas (LPF).
X3DAUDIO_CALCULATE_LPF_REVERB	Active le calcul du coefficient de réverbération LPF.
X3DAUDIO_CALCULATE_REVERB	Active le calcul du niveau d’envoi de réverbération.
X3DAUDIO_CALCULATE_DOPPLER	Active le calcul du facteur de décalage Doppler.
X3DAUDIO_CALCULATE_EMITTER_ANGLE	Active le calcul de l’angle intérieur de l’émetteur à l’écouteur.
X3DAUDIO_CALCULATE_ZEROCENTER	Remplit le canal central de silence. Cet indicateur vous permet de conserver une matrice à 6 canaux afin que vous n’ayez pas à remapper les canaux, mais le canal central sera silencieux. Cet indicateur n’est valide que si vous définissez également X3DAUDIO_CALCULATE_MATRIX.
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	Applique une combinaison égale de tous les canaux sources à un canal de destination À effet faible (LFE). Elle s’applique uniquement aux calculs de matrice avec une source qui n’a pas de canal LFE et une destination qui a un canal LFE. Cet indicateur n’est valide que si vous définissez également X3DAUDIO_CALCULATE_MATRIX.

[in, out] pDSPSettings

Pointeur vers une structure X3DAUDIO_DSP_SETTINGS qui reçoit les résultats du calcul.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Vous appelez généralement X3DAudioCalculate une fois pour chaque paire d’objets et d’écouteurs émetteurs dans la scène. Après chaque appel, pour appliquer les effets 3D, l’application applique manuellement les résultats de calcul dans pDSPSettings au graphique XAUDIO2. Pour plus d’informations, consultez Guide pratique pour intégrer X3DAudio à XAudio2.

Important Les valeurs de l’écouteur et de l’émetteur doivent être valides. Les éléments spéciaux à virgule flottante (NaN, QNaN, +INF, -INF) peuvent rendre la sortie audio entière silencieuse si elles sont introduites dans un graphique audio en cours d’exécution.

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)

Windows Phone 8.1 : cette API est prise en charge.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	x3daudio.h
Bibliothèque	Xaudio2.lib

Voir aussi

Fonctions

Partager via