estructura XAUDIO2FX_REVERB_PARAMETERS (xaudio2fx.h)

Artículo
03/13/2024

Describe los parámetros para su uso en el APO de reverberación.

Sintaxis

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;

Miembros

WetDryMix

Porcentaje de la salida que será reverberación. Los valores permitidos son de 0 a 100.

ReflectionsDelay

Tiempo de retraso de la primera reflexión en relación con la ruta de acceso directa. El intervalo permitido es de 0 a 300 milisegundos.

Nota Todos los parámetros relacionados con la frecuencia de muestreo o el tiempo son relativos a una frecuencia de muestreo de 48 kHz y se deben escalar para su uso con otras frecuencias de muestreo. Consulte la sección de comentarios a continuación para obtener información adicional.

ReverbDelay

Retraso de reverberación en relación con la primera reflexión. El intervalo permitido es de 0 a 85 milisegundos.

RearDelay

Retraso para la salida trasera izquierda y salida trasera derecha. El intervalo permitido es de 0 a 5 milisegundos.

SideDelay

Retraso para la salida del lado izquierdo y la salida del lado derecho. El intervalo permitido es de 0 a 5 milisegundos.

Nota Este valor se admite a partir de Windows 10.

PositionLeft

Posición de la entrada izquierda dentro del espacio simulado en relación con el agente de escucha. Con PositionLeft establecido en el valor mínimo, la entrada izquierda se coloca cerca del agente de escucha. En esta posición, las primeras reflexiones son dominantes y la reverberación se vuelve a establecer en el campo de sonido y se reduce en amplitud. Con PositionLeft establecido en el valor máximo, la entrada izquierda se coloca a una distancia máxima desde el agente de escucha dentro de la sala simulada. PositionLeft no afecta al tiempo de descomposición de reverberación (vida de la sala), solo la posición aparente del origen en relación con el agente de escucha. El intervalo permitido es de 0 a 30 (sin unidades).

PositionRight

Igual que PositionLeft, pero afecta solo a la entrada correcta. El intervalo permitido es de 0 a 30 (sin unidades).

Nota PositionRight se omite en modo mono-in/mono-out.

PositionMatrixLeft

Proporciona una impresión mayor o menor de distancia desde el origen hasta el agente de escucha. El intervalo permitido es de 0 a 30 (sin unidades).

PositionMatrixRight

Proporciona una impresión mayor o menor de distancia desde el origen hasta el agente de escucha. El intervalo permitido es de 0 a 30 (sin unidades).

NotaPositionMatrixRight se omite en modo mono-in/mono-out.

EarlyDiffusion

Controla el carácter de las reflexiones de pared individuales. Establézcalo en un valor mínimo para simular una superficie plana dura y para simular un valor máximo para simular una superficie difusa. El intervalo permitido es de 0 a 15 (sin unidades).

LateDiffusion

Controla el carácter de las reverberaciones de pared individuales. Establézcalo en un valor mínimo para simular una superficie plana dura y para simular un valor máximo para simular una superficie difusa. El intervalo permitido es de 0 a 15 (sin unidades).

LowEQGain

Ajusta el tiempo de descomposición de las frecuencias bajas en relación con el tiempo de descomposición a 1 kHz. Los valores corresponden a dB de ganancia de la siguiente manera:

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

Nota Un valor LowEQGain de 8 da como resultado que el tiempo de descomposición de las frecuencias bajas sea igual al tiempo de descomposición a 1 kHz.

El intervalo permitido es de 0 a 12 (sin unidades).

LowEQCutoff

Establece la frecuencia de esquina del filtro de paso bajo controlado por el parámetro LowEQGain . Los valores corresponden a la frecuencia en Hz de la siguiente manera:

Valor	0	1	2	3	4	5	6	7	8	9
Frecuencia (Hz)	50	100	150	200	250	300	350	400	450	500

El intervalo permitido es de 0 a 9 (sin unidades).

HighEQGain

Ajusta el tiempo de descomposición de las frecuencias altas en relación con el tiempo de descomposición a 1 kHz. Cuando se establece en cero, las frecuencias altas se desintegran a la misma velocidad que 1 kHz. Cuando se establece en el valor máximo, las frecuencias altas decaen a una velocidad mucho más rápida que 1 kHz.

Valor	0	1	2	3	4	5	6	7	8
Ganancia (dB)	-8	-7	-6	-5	-4	-3	-2	-1	0

El intervalo permitido es de 0 a 8 (sin unidades).

HighEQCutoff

Establece la frecuencia de esquina del filtro de paso alto controlado por el parámetro HighEQGain . Los valores corresponden a la frecuencia en kHz de la siguiente manera:

Valor	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14
Frecuencia (kHz)	1	1.5	2	2.5	3	3,5	4	4.5.	5	5.5	6	6.5	7	7.5	8

El intervalo permitido es de 0 a 14 (sin unidades).

RoomFilterFreq

Establece la frecuencia de esquina del filtro de paso bajo para el efecto de la sala. El intervalo permitido es de 20 a 20 000 Hz.

RoomFilterMain

Establece el nivel de intensidad de banda de paso del filtro de paso bajo para las primeras reflexiones y la reverberación de campo tardía. El intervalo permitido es de -100 a 0 dB.

RoomFilterHF

Establece la intensidad del filtro de paso bajo para las primeras reflexiones y la reverberación de campo tardía en la frecuencia de esquina (RoomFilterFreq). El intervalo permitido es de -100 a 0 dB.

ReflectionsGain

Ajusta la intensidad de las primeras reflexiones. El intervalo permitido es de -100 a 20 dB.

ReverbGain

Ajusta la intensidad de las reverberaciones. El intervalo permitido es de -100 a 20 dB.

DecayTime

Tiempo de descomposición de reverberación a 1 kHz. Este es el momento en que una señal de entrada de escala completa se desintegra en 60 dB. El intervalo permitido es de 0,1 a infinito segundos.

Density

Controla la densidad modal en la reverberación de campo tardía. En el caso de los espacios sin color, la densidad debe establecerse en el valor máximo (100). A medida que disminuye la densidad, el sonido se vuelve hueco (filtrado por comb). Este es un efecto que puede ser útil si está intentando modelar un silo. El intervalo permitido como porcentaje es de 0 a 100.

RoomSize

Tamaño aparente del espacio acústico. El intervalo permitido es de 1 a 100 pies.

DisableLateField

Si se establece en TRUE, deshabilita los cálculos de reflexión de campo en tiempo de ejecución. Al deshabilitar los cálculos de reflexión de campo en tiempo de ejecución, se ahorra mucho tiempo en la CPU.

Nota Las versiones del SDK de DirectX de XAUDIO2 no admiten este miembro.

Comentarios

Todos los parámetros relacionados con la frecuencia de muestreo o el tiempo son relativos a una voz de 48 kHz y se deben escalar para su uso con otras frecuencias de muestreo. Por ejemplo, si se establece ReflectionsDelay en 300 ms, se produce un retraso real de 300 ms cuando la reverberación se hospeda en una voz de 48 kHz, pero se convierte en un retraso de 150 ms cuando se hospeda en una voz de 24 kHz.