Panoramica di XAPOFX
XAPOFX è una raccolta di effetti audio che implementano le interfacce XAPO da usare in XAudio2. XAPOFX contiene diversi effetti e un meccanismo comune per la creazione di istanze di effetto.
Effetti inclusi
La tabella seguente descrive gli effetti inclusi in XAPOFX.
| Effetto | Descrizione | Struttura dei parametri | Costanti parametri | Requisiti |
|---|---|---|---|---|
| FXECHO | Effetto eco. | FXECHO_PARAMETERS | Costanti FXECHO | Supporta solo FLOAT32 formati audio. |
| FXEQ | Equalizzatore a quattro bande. | FXEQ_PARAMETERS | costanti FXEQ | Supporta solo FLOAT32 formati audio. La frequenza di campionamento deve essere compresa tra 22.000 Hz e 48.000 Hz. |
| FXMasteringLimiter | Limitatore di volume. | FXMASTERINGLIMITER_PARAMETERS | Costanti FXMASTERINGLIMIT | Supporta solo FLOAT32 formati audio. |
| FXReverb | Un semplice effetto riverbero. XAudio2 fornisce anche un effetto che implementa Princeton Digital Reverb e del quale può essere creata un'istanza con XAudio2CreateReverb. |
FXREVERB_PARAMETERS | Costanti FXREVERB | Supporta solo FLOAT32 formati audio. Inoltre, supporta solo l'input mono per l'output mono e l'input stereo per l'output stereo. |
Creazione di un'istanza di un effetto incluso in XAPOFX
XAPOFX fornisce la funzione CreateFX come meccanismo comune per la creazione di istanze di effetto. CreateFX riceve il CLSID di un effetto e restituisce un puntatore a un'interfaccia IUnknown per un'istanza dell'effetto.
Uso di XAPOFX in XAudio2
Gli effetti creati con CreateFX vengono usati in XAudio2 collegandoli alle voci. Ogni voce XAudio2 ha una catena di effetti contenente zero o più effetti audio. I dati audio inviati a una voce vengono passati attraverso ogni effetto della catena prima che venga inviato alle destinazioni di output della voce. La voce prende l'output di ogni effetto e lo inserisce nell'effetto successivo nella catena fino a quando non ci sono più effetti nella catena. Per associare un effetto XAPOFX a una voce XAudio2, compilare una struttura XAUDIO2_EFFECT_CHAIN con le informazioni dell'effetto e passarla a IXAudio2Voice::SetEffectChain.
Per altre informazioni sulle catene di effetti XAudio2, vedere effetti audio XAudio2.
Per un esempio di uso di XAPOFX in XAudio2, vedere Procedura: Usare XAPOFX in XAudio2.
Effetti impliciti XAudio2
Oltre alla libreria di XAPO fornita da XAPOFX, XAudio2 include effetti audio integrati come il riverbero e il misuratore di volume. È possibile creare questi effetti predefiniti con XAudio2CreateReverb e XAudio2CreateVolumeMeter. Consulta la Procedura: Creare una catena di effetti per vedere un esempio di come utilizzare uno di questi effetti predefiniti.
Argomenti correlati