Condividi tramite


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.

Effetti Audio