Udostępnij za pośrednictwem


XAPOFX — omówienie

XAPOFX to zbiór efektów dźwiękowych implementujących interfejsy XAPO do zastosowania w XAudio2. XAPOFX zawiera kilka efektów i wspólny mechanizm tworzenia wystąpień efektów.

Uwzględnione efekty

W poniższej tabeli opisano efekty zawarte w XAPOFX.

Efekt Opis Struktura parametrów Stałe parametrów Wymagania
FXECHO Efekt echa. FXECHO_PARAMETERS stałe FXECHO Obsługuje tylko FLOAT32 formaty audio.
FXEQ Czteropasmowy korektor. FXEQ_PARAMETERS stałe FXEQ Obsługuje tylko FLOAT32 formaty audio. Częstotliwość próbkowania musi wynosić od 22 000 Hz do 48 000 Hz.
FXMasteringLimiter Ogranicznik woluminu. FXMASTERINGLIMITER_PARAMETERS FXMASTERINGLIMIT Stałe Obsługuje tylko FLOAT32 formaty audio.
FXReverb Prosty efekt reverb.
XAudio2 zapewnia również efekt implementujący funkcję Princeton Digital Reverb, którą można utworzyć za pomocą XAudio2CreateReverb.
FXREVERB_PARAMETERS stałe FXREVERB Obsługuje tylko FLOAT32 formaty audio. Ponadto obsługuje tylko wejście mono do wyjścia mono i wejście stereo do wyjścia stereo.

 

Tworzenie instancji efektu zawartego w XAPOFX

XAPOFX udostępnia funkcję CreateFX jako wspólny mechanizm tworzenia instancji efektów. CreateFX przyjmuje identyfikator CLSID efektu i zwraca wskaźnik interfejsu IUnknown do wystąpienia efektu.

Korzystanie z XAPOFX w XAudio2

Efekty tworzone za pomocą CreateFX są używane w XAudio2 przez dołączenie ich do głosów. Każdy głos XAudio2 ma łańcuch efektu zawierający zero lub więcej efektów dźwiękowych. Dane audio wysyłane do głosu są przekazywane przez każdy efekt w łańcuchu, zanim zostaną wysłane do elementów wyjściowych głosu. Dźwięk pobiera dane wyjściowe każdego efektu i przekazuje je do następnego efektu w łańcuchu, aż w łańcuchu nie pozostanie żaden efekt. Aby dołączyć efekt XAPOFX do głosu XAudio2, wypełnij strukturę XAUDIO2_EFFECT_CHAIN ze szczegółami dotyczącymi efektu i przekaż ją do IXAudio2Voice::SetEffectChain.

Aby uzyskać więcej informacji na temat łańcuchów efektów XAudio2, zobacz XAudio2 Audio Effects.

Przykład użycia XAPOFX w XAudio2 można znaleźć w temacie How to: Use XAPOFX in XAudio2(Jak używać XAPOFX w środowisku XAudio2).

Efekty niejawne XAudio2

Oprócz biblioteki XAPOs dostarczanych przez XAPOFX, XAudio2 ma wbudowane efekty audio pogłosu i miernika głośności. Te wbudowane efekty można utworzyć za pomocą XAudio2CreateReverb i XAudio2CreateVolumeMeter. Zobacz Jak: stworzyć łańcuch efektów, aby zobaczyć, jak użyć jednego z tych wbudowanych efektów.

efekty dźwiękowe