Funzione X3DAudioCalculate (x3daudio.h)

Articolo
08/28/2023

Calcola le impostazioni DSP rispetto ai parametri 3D.

Sintassi

X3DAUDIO_API_(void) X3DAudioCalculate(
  [in]      const X3DAUDIO_HANDLE   Instance,
  [in]      const X3DAUDIO_LISTENER *pListener,
  [in]      const X3DAUDIO_EMITTER  *pEmitter,
  [in]      UINT32                  Flags,
  [in, out] X3DAUDIO_DSP_SETTINGS   *pDSPSettings
);

Parametri

[in] Instance

Handle dell'istanza audio 3D. Chiama X3DAudioInitialize per ottenere questo handle.

[in] pListener

Puntatore a un X3DAUDIO_LISTENER che rappresenta il punto di ricezione.

[in] pEmitter

Puntatore a un X3DAUDIO_EMITTER che rappresenta la sorgente audio.

[in] Flags

Valore	Descrizione
X3DAUDIO_CALCULATE_MATRIX	Abilita il calcolo della tabella dei coefficienti della matrice.
X3DAUDIO_CALCULATE_DELAY	Abilita il calcolo della matrice temporale ritardata (solo stereo).
X3DAUDIO_CALCULATE_LPF_DIRECT	Abilita il calcolo del coefficiente di percorso diretto APF (Low Pass Filter).
X3DAUDIO_CALCULATE_LPF_REVERB	Abilita il calcolo del coefficiente di riverbero del percorso LPF.
X3DAUDIO_CALCULATE_REVERB	Abilita il calcolo del livello di invio del riverbero.
X3DAUDIO_CALCULATE_DOPPLER	Abilita il calcolo del fattore di spostamento doppler.
X3DAUDIO_CALCULATE_EMITTER_ANGLE	Consente il calcolo dell'angolo interno del listener da emettitore a listener.
X3DAUDIO_CALCULATE_ZEROCENTER	Riempie il canale centrale con silenzio. Questo flag consente di mantenere una matrice a 6 canali in modo da non dover rieseguire il mapping dei canali, ma il canale centrale sarà invisibile all'utente. Questo flag è valido solo se si imposta anche X3DAUDIO_CALCULATE_MATRIX.
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	Applica una combinazione uguale di tutti i canali di origine a un canale di destinazione LFE (Low Frequency Effect). Si applica solo ai calcoli matrice con un'origine che non ha un canale LFE e una destinazione che dispone di un canale LFE. Questo flag è valido solo se si imposta anche X3DAUDIO_CALCULATE_MATRIX.

[in, out] pDSPSettings

Puntatore a una struttura X3DAUDIO_DSP_SETTINGS che riceve i risultati del calcolo.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

In genere si chiama X3DAudioCalculate una volta per ogni coppia di oggetti e listener di emissione nella scena. Dopo ogni chiamata, per applicare gli effetti 3D, l'app applica manualmente i risultati di calcolo in pDSPSettings al grafico XAUDIO2. Per altre info, vedi Procedura: Integrare X3DAudio con XAudio2.

Importante I valori del listener e dell'emettitore devono essere validi. Le speciali a virgola mobile (NaN, QNaN, +INF, -INF) possono causare l'silenzio dell'intero output audio se introdotto in un grafico audio in esecuzione.

Requisiti della piattaforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Windows Phone 8.1: questa API è supportata.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	x3daudio.h
Libreria	Xaudio2.lib

Vedi anche

Funzioni

Condividi tramite