struttura XAUDIO2FX_REVERB_PARAMETERS (xaudio2fx.h)

Articolo
03/13/2024

Descrive i parametri da usare nell'APO riverbero.

Sintassi

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;

Members

WetDryMix

Percentuale dell'output che verrà ripristinato. I valori consentiti sono compresi tra 0 e 100.

ReflectionsDelay

Tempo di ritardo della prima reflection rispetto al percorso diretto. L'intervallo consentito è compreso tra 0 e 300 millisecondi.

Nota Tutti i parametri correlati alla frequenza di campionamento o al tempo sono relativi a una frequenza di campionamento a 48 kHz e devono essere ridimensionati per l'uso con altre frequenze di campionamento. Per altre informazioni, vedere la sezione osservazioni di seguito.

ReverbDelay

Ritardo del riverbero rispetto alla prima reflection. L'intervallo consentito è compreso tra 0 e 85 millisecondi.

RearDelay

Ritardo per l'output posteriore sinistro e l'output posteriore destro. L'intervallo consentito è compreso tra 0 e 5 millisecondi.

SideDelay

Ritardo per l'output sul lato sinistro e l'output sul lato destro. L'intervallo consentito è compreso tra 0 e 5 millisecondi.

Nota Questo valore è supportato a partire da Windows 10.

PositionLeft

Posizione dell'input sinistro all'interno dello spazio simulato rispetto al listener. Con PositionLeft impostato sul valore minimo, l'input sinistro viene posizionato vicino al listener. In questa posizione, le prime riflessioni sono dominanti e il decadimento del riverbero è tornato nel campo sonoro e ridotto in ampiezza. Con PositionLeft impostato sul valore massimo, l'input sinistro viene posizionato a una distanza massima dal listener all'interno della sala simulata. PositionLeft non influisce sul tempo di decadimento del riverbero (liveness della stanza), ma solo sulla posizione apparente dell'origine rispetto al listener. L'intervallo consentito è compreso tra 0 e 30 (nessuna unità).

PositionRight

Uguale a PositionLeft, ma che influisce solo sull'input corretto. L'intervallo consentito è compreso tra 0 e 30 (nessuna unità).

Nota PositionRight viene ignorato in modalità mono-in/mono out.

PositionMatrixLeft

Dà un'impressione maggiore o minore di distanza dall'origine al listener. L'intervallo consentito è compreso tra 0 e 30 (nessuna unità).

PositionMatrixRight

Dà un'impressione maggiore o minore di distanza dall'origine al listener. L'intervallo consentito è compreso tra 0 e 30 (nessuna unità).

NotaPositionMatrixRight viene ignorato in modalità mono-in/mono-out.

EarlyDiffusion

Controlla il carattere dei singoli riflessi del muro. Impostare su valore minimo per simulare una superficie piatta rigida e su un valore massimo per simulare una superficie diffusa. L'intervallo consentito è compreso tra 0 e 15 (nessuna unità).

LateDiffusion

Controlla il carattere dei singoli riverberi delle pareti. Impostare su valore minimo per simulare una superficie piatta rigida e su un valore massimo per simulare una superficie diffusa. L'intervallo consentito è compreso tra 0 e 15 (nessuna unità).

LowEQGain

Regola il tempo di decadimento delle frequenze basse rispetto al tempo di decadimento a 1 kHz. I valori corrispondono a dB di gain come indicato di seguito:

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

Nota Un valore LowEQGain pari a 8 determina il tempo di decadimento delle frequenze basse uguale al tempo di decadimento a 1 kHz.

L'intervallo consentito è compreso tra 0 e 12 (nessuna unità).

LowEQCutoff

Imposta la frequenza dell'angolo del filtro a basso passaggio controllato dal parametro LowEQGain . I valori corrispondono alla frequenza in Hz come indicato di seguito:

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

L'intervallo consentito è compreso tra 0 e 9 (nessuna unità).

HighEQGain

Regola il tempo di decadimento delle frequenze elevate rispetto al tempo di decadimento a 1 kHz. Se impostato su zero, le frequenze elevate decadono alla stessa velocità di 1 kHz. Se impostato su valore massimo, le frequenze elevate decadono a una velocità molto più veloce di 1 kHz.

Valore	0	1	2	3	4	5	6	7	8
Guadagno (dB)	-8	-7	-6	-5	-4	-3	-2	-1	0

L'intervallo consentito è compreso tra 0 e 8 (nessuna unità).

HighEQCutoff

Imposta la frequenza dell'angolo del filtro di passaggio elevato controllato dal parametro HighEQGain . I valori corrispondono alla frequenza in kHz come indicato di seguito:

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

L'intervallo consentito è compreso tra 0 e 14 (nessuna unità).

RoomFilterFreq

Imposta la frequenza dell'angolo del filtro di passaggio basso per l'effetto stanza. L'intervallo consentito è compreso tra 20 e 20.000 Hz.

RoomFilterMain

Imposta il livello di intensità della banda di passaggio del filtro a basso passaggio sia per i riflessi iniziali che per il riverbero del campo in ritardo. L'intervallo consentito è compreso tra -100 e 0 dB.

RoomFilterHF

Imposta l'intensità del filtro a basso passaggio sia per i riflessi iniziali che per il riverbero del campo in ritardo alla frequenza dell'angolo (RoomFilterFreq). L'intervallo consentito è compreso tra -100 e 0 dB.

ReflectionsGain

Regola l'intensità dei riflessi iniziali. L'intervallo consentito è compreso tra -100 e 20 dB.

ReverbGain

Regola l'intensità dei riverberi. L'intervallo consentito è compreso tra -100 e 20 dB.

DecayTime

Tempo di decadimento del riverbero a 1 kHz. Questo è il momento in cui un segnale di input a scala completa decade di 60 dB. L'intervallo consentito è compreso tra 0,1 e infinito secondi.

Density

Controlla la densità modale nel riverbero del campo in ritardo. Per gli spazi senza colori, densità deve essere impostata sul valore massimo (100). Man mano che la densità è diminuita, il suono diventa vuoto (filtrare il pettine). Si tratta di un effetto che può essere utile se si sta tentando di modellare un silo. L'intervallo consentito come percentuale è compreso tra 0 e 100.

RoomSize

Dimensioni apparenti dello spazio acustico. L'intervallo consentito è compreso tra 1 e 100 piedi.

DisableLateField

Se impostata su TRUE, disabilita i calcoli di reflection dei campi in ritardo. La disabilitazione dei calcoli di reflection dei campi in ritardo comporta un notevole risparmio di tempo della CPU.

Nota Le versioni di DirectX SDK di XAUDIO2 non supportano questo membro.

Commenti

Tutti i parametri correlati alla frequenza di campionamento o al tempo sono relativi a una voce a 48 kHz e devono essere ridimensionati per l'uso con altre frequenze di campionamento. Ad esempio, l'impostazione di ReflectionsDelay su 300 ms dà un vero ritardo di 300 ms quando il riverbero è ospitato in una voce a 48 kHz, ma diventa un ritardo di 150 ms quando è ospitato in una voce a 24 kHz.