Share via

Panoramica di XAPOFX

  • Articolo

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 dei parametri Requisiti
FXECHO Un effetto eco. FXECHO_PARAMETERS Costanti FXECHO Supporta solo i formati audio FLOAT32.
FXEQ Equalizzatore a quattro bande. FXEQ_PARAMETERS Costanti FXEQ Supporta solo i formati audio FLOAT32. La frequenza di campionamento deve essere compresa tra 22.000 Hz e 48.000 Hz.
FXMasteringLimiter Un limiter del volume. FXMASTERINGLIMITER_PARAMETERS Costanti FXMASTERINGLIMIT Supporta solo i formati audio FLOAT32.
FXReverb Un semplice effetto riverbero.
XAudio2 fornisce anche un effetto che implementa Princeton Digital Reverb che può essere creata un'istanza con XAudio2CreateReverb.
 FXREVERB_PARAMETERS Costanti FXREVERB Supporta solo i formati audio FLOAT32. Supporta anche 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 accetta il CLSID di un effetto e restituisce un puntatore all'interfaccia IUnknown a 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 nella catena prima che vengano inviati 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 viene lasciato alcun effetto nella catena. Per collegare 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, vedi Effetti audio XAudio2.

Per un esempio di uso di XAPOFX in XAudio2, vedere Procedura: Usare XAPOFX in XAudio2.

Effetti impliciti di XAudio2

Oltre alla libreria di XAPO forniti da XAPOFX, XAudio2 include effetti audio del riverbero e del contatore del volume incorporati. È possibile creare questi effetti predefiniti con XAudio2CreateReverb e XAudio2CreateVolumeMeter. Vedere Procedura: Creare una catena di effetti per un esempio di utilizzo di uno di questi effetti predefiniti.

Effetti audio