Funzione X3DAudioCalculate (x3daudio.h)

  • Articolo

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