Compartilhar via

Função X3DAudioCalculate (x3daudio.h)

  • Artigo

Calcula as configurações de DSP em relação aos parâmetros 3D.

Sintaxe

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
);

Parâmetros

[in] Instance

Identificador de instância de áudio 3D. Chame X3DAudioInitialize para obter esse identificador.

[in] pListener

Ponteiro para um X3DAUDIO_LISTENER que representa o ponto de recepção.

[in] pEmitter

Ponteiro para um X3DAUDIO_EMITTER que representa a fonte de som.

[in] Flags

Valor Descrição
X3DAUDIO_CALCULATE_MATRIX Habilita o cálculo da tabela de coeficiente de matriz. 
X3DAUDIO_CALCULATE_DELAY Habilita o cálculo da matriz de tempo de atraso (somente estéreo). 
X3DAUDIO_CALCULATE_LPF_DIRECT Habilita o cálculo de coeficiente de caminho direto LPF (filtro de passagem baixa). 
X3DAUDIO_CALCULATE_LPF_REVERB Habilita o cálculo de coeficiente de reverb-path do LPF. 
X3DAUDIO_CALCULATE_REVERB Habilita o cálculo de nível de envio reverb. 
X3DAUDIO_CALCULATE_DOPPLER Habilita o cálculo do fator de deslocamento do Doppler. 
X3DAUDIO_CALCULATE_EMITTER_ANGLE Habilita o cálculo do ângulo interior do emissor para ouvinte. 
X3DAUDIO_CALCULATE_ZEROCENTER Preenche o canal central com silêncio. Esse sinalizador permite manter uma matriz de 6 canais para que você não precise remapear os canais, mas o canal central ficará silencioso. Esse sinalizador só será válido se você também definir X3DAUDIO_CALCULATE_MATRIX. 
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE Aplica uma combinação igual de todos os canais de origem a um canal de destino LFE (efeito de baixa frequência). Aplica-se apenas a cálculos de matriz com uma origem que não tem um canal LFE e um destino que tem um canal LFE. Esse sinalizador só será válido se você também definir X3DAUDIO_CALCULATE_MATRIX. 

[in, out] pDSPSettings

Ponteiro para uma estrutura X3DAUDIO_DSP_SETTINGS que recebe os resultados do cálculo.

Retornar valor

Essa função não retorna um valor.

Comentários

Normalmente, você chama X3DAudioCalculate uma vez para cada par de objetos e ouvintes emissores na cena. Após cada chamada, para aplicar os efeitos 3D, o aplicativo aplica manualmente os resultados de cálculo em pDSPSettings ao grafo XAUDIO2. Para obter mais informações, consulte Como integrar o X3DAudio ao XAudio2.

Importante Os valores de ouvinte e emissor devem ser válidos. Os especiais de ponto flutuante (NaN, QNaN, +INF, -INF) podem fazer com que toda a saída de áudio fique silenciosa se introduzida em um grafo de áudio em execução.
 

Requisitos da plataforma

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

Windows Phone 8.1: há suporte para essa API.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho x3daudio.h
Biblioteca Xaudio2.lib

Confira também

Funções