XAUDIO2FX_REVERB_PARAMETERS structure (xaudio2fx.h)

Article
08/28/2023

Décrit les paramètres à utiliser dans l’APO de réverbération.

Syntaxe

typedef struct XAUDIO2FX_REVERB_PARAMETERS {
  float  WetDryMix;
  UINT32 ReflectionsDelay;
  BYTE   ReverbDelay;
  BYTE   RearDelay;
  BYTE   SideDelay;
  BYTE   PositionLeft;
  BYTE   PositionRight;
  BYTE   PositionMatrixLeft;
  BYTE   PositionMatrixRight;
  BYTE   EarlyDiffusion;
  BYTE   LateDiffusion;
  BYTE   LowEQGain;
  BYTE   LowEQCutoff;
  BYTE   HighEQGain;
  BYTE   HighEQCutoff;
  float  RoomFilterFreq;
  float  RoomFilterMain;
  float  RoomFilterHF;
  float  ReflectionsGain;
  float  ReverbGain;
  float  DecayTime;
  float  Density;
  float  RoomSize;
  BOOL   DisableLateField;
} XAUDIO2FX_REVERB_PARAMETERS;

Membres

WetDryMix

Pourcentage de la sortie qui sera réverbération. Les valeurs autorisées sont comprises entre 0 et 100.

ReflectionsDelay

Délai de la première réflexion par rapport au chemin d’accès direct. La plage autorisée est comprise entre 0 et 300 millisecondes.

Note Tous les paramètres liés au taux d’échantillonnage ou au temps sont relatifs à un taux d’échantillonnage de 48 kHz et doivent être mis à l’échelle pour être utilisés avec d’autres taux d’échantillonnage. Pour plus d’informations, consultez la section remarques ci-dessous.

ReverbDelay

Délai de réverbération par rapport à la première réflexion. La plage autorisée est comprise entre 0 et 85 millisecondes.

RearDelay

Délai pour la sortie arrière gauche et la sortie arrière droite. La plage autorisée est comprise entre 0 et 5 millisecondes.

SideDelay

Délai pour la sortie du côté gauche et de la sortie du côté droit. La plage autorisée est comprise entre 0 et 5 millisecondes.

Note Cette valeur est prise en charge à partir de Windows 10.

PositionLeft

Position de l’entrée de gauche dans l’espace simulé par rapport à l’écouteur. Avec PositionLeft défini sur la valeur minimale, l’entrée gauche est placée près de l’écouteur. Dans cette position, les premières réflexions sont dominantes, et la décroissance de réverbération est répercutée dans le champ sonore et réduite en amplitude. Avec PositionLeft défini sur la valeur maximale, l’entrée gauche est placée à une distance maximale de l’écouteur dans la salle simulée. PositionLeft n’affecte pas le temps de désintégration de la réverbération (durée de vie de la pièce), mais uniquement la position apparente de la source par rapport à l’écouteur. La plage autorisée est comprise entre 0 et 30 (aucune unité).

PositionRight

Identique à PositionLeft, mais affectant uniquement l’entrée droite. La plage autorisée est comprise entre 0 et 30 (aucune unité).

Note PositionRight est ignoré en mode mono-entrée/mono-sortie.

PositionMatrixLeft

Donne une impression plus ou moins grande de distance entre la source et l’écouteur. La plage autorisée est comprise entre 0 et 30 (aucune unité).

PositionMatrixRight

Donne une impression plus ou moins grande de distance entre la source et l’écouteur. La plage autorisée est comprise entre 0 et 30 (aucune unité).

RemarquePositionMatrixRight est ignoré en mode mono-entrée/mono-sortie.

EarlyDiffusion

Contrôle le caractère des réflexions individuelles du mur. Définissez la valeur minimale pour simuler une surface plate dure et la valeur maximale pour simuler une surface diffuse. La plage autorisée est comprise entre 0 et 15 (aucune unité).

LateDiffusion

Contrôle le caractère des réverbérations individuelles du mur. Définissez la valeur minimale pour simuler une surface plate dure et la valeur maximale pour simuler une surface diffuse. La plage autorisée est comprise entre 0 et 15 (aucune unité).

LowEQGain

Ajuste la durée de désintégration des basses fréquences par rapport au temps de décroissance à 1 kHz. Les valeurs correspondent à dB de gain comme suit :

Valeur	0	1	2	3	4	5	6	7	8	9	10	11	12
Gain (dB)	-8	-7	-6	-5	-4	-3	-2	-1	0	+1	+2	+3	+4

Note Une valeur LowEQGain de 8 fait en sorte que le temps de décroissance des basses fréquences soit égal au temps de désintégration à 1 kHz.

La plage autorisée est comprise entre 0 et 12 (aucune unité).

LowEQCutoff

Définit la fréquence d’angle du filtre passe-bas contrôlé par le paramètre LowEQGain . Les valeurs correspondent à la fréquence en Hz comme suit :

Valeur	0	1	2	3	4	5	6	7	8	9
Fréquence (Hz)	50	100	150	200	250	300	350	400	450	500

La plage autorisée est comprise entre 0 et 9 (aucune unité).

HighEQGain

Ajuste le temps de désintégration des fréquences élevées par rapport au temps de décroissance à 1 kHz. Lorsqu’elle est définie sur zéro, les fréquences élevées se désintègrent au même rythme que 1 kHz. Lorsqu’elles sont définies sur la valeur maximale, les fréquences élevées se décomposent à un débit beaucoup plus rapide que 1 kHz.

Valeur	0	1	2	3	4	5	6	7	8
Gain (dB)	-8	-7	-6	-5	-4	-3	-2	-1	0

La plage autorisée est comprise entre 0 et 8 (aucune unité).

HighEQCutoff

Définit la fréquence d’angle du filtre passe-haut contrôlé par le paramètre HighEQGain . Les valeurs correspondent à la fréquence en kHz comme suit :

Valeur	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14
Fréquence (kHz)	1	1.5	2	2.5	3	3,5	4	4.5	5	5.5	6	6.5	7	7.5	8

La plage autorisée est comprise entre 0 et 14 (aucune unité).

RoomFilterFreq

Définit la fréquence d’angle du filtre passe-bas pour l’effet de pièce. La plage autorisée est comprise entre 20 et 20 000 Hz.

RoomFilterMain

Définit le niveau d’intensité de la bande de passage du filtre passe-bas pour les réflexions précoces et la réverbération de champ tardive. La plage autorisée est comprise entre -100 et 0 dB.

RoomFilterHF

Définit l’intensité du filtre passe-bas pour les réflexions précoces et la réverbération de champ tardive à la fréquence d’angle (RoomFilterFreq). La plage autorisée est comprise entre -100 et 0 dB.

ReflectionsGain

Ajuste l’intensité des premières réflexions. La plage autorisée est comprise entre -100 et 20 dB.

ReverbGain

Ajuste l’intensité des réverbérations. La plage autorisée est comprise entre -100 et 20 dB.

DecayTime

Temps de décroissance de réverbération à 1 kHz. Il s’agit du moment où un signal d’entrée à grande échelle décroît de 60 dB. La plage autorisée est comprise entre 0,1 et l’infini.

Density

Contrôle la densité modale dans la réverbération de champ tardive. Pour les espaces incolores, la densité doit être définie sur la valeur maximale (100). À mesure que la densité est réduite, le son devient creux (peigne filtré). Il s’agit d’un effet qui peut être utile si vous essayez de modéliser un silo. La plage autorisée en pourcentage est comprise entre 0 et 100.

RoomSize

La taille apparente de l’espace acoustique. La portée autorisée est comprise entre 1 et 100 pieds.

DisableLateField

Si la valeur est TRUE, désactive les calculs de réflexion de champ en retard. La désactivation des calculs de réflexion de champ en retard entraîne un gain de temps processeur important.

Note Les versions du Kit de développement logiciel (SDK) DirectX de XAUDIO2 ne prennent pas en charge ce membre.

Remarques

Tous les paramètres liés au taux d’échantillonnage ou au temps sont relatifs à une voix de 48 kHz et doivent être mis à l’échelle pour être utilisés avec d’autres taux d’échantillonnage. Par exemple, la définition de ReflectionsDelay sur 300 ms donne un vrai délai de 300 ms lorsque la réverbération est hébergée dans une voix de 48 kHz, mais devient un délai de 150 ms lorsqu’elle est hébergée dans une voix de 24 kHz.