Поделиться через


Функция X3DAudioCalculate (x3daudio.h)

Вычисляет параметры DSP относительно трехмерных параметров.

Синтаксис

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

Параметры

[in] Instance

Дескриптор экземпляра трехмерного звука. Вызовите X3DAudioInitialize , чтобы получить этот дескриптор.

[in] pListener

Указатель на X3DAUDIO_LISTENER , представляющий точку приема.

[in] pEmitter

Указатель на X3DAUDIO_EMITTER , представляющий источник звука.

[in] Flags

Значение Описание
X3DAUDIO_CALCULATE_MATRIX Включает вычисление таблицы коэффициентов матрицы. 
X3DAUDIO_CALCULATE_DELAY Включает вычисление массива времени задержки (только стерео). 
X3DAUDIO_CALCULATE_LPF_DIRECT Включает вычисление коэффициента прямого пути фильтра низкого прохода (LPF). 
X3DAUDIO_CALCULATE_LPF_REVERB Включает вычисление коэффициента реверберации пути LPF. 
X3DAUDIO_CALCULATE_REVERB Включает вычисление уровня отправки реверберации. 
X3DAUDIO_CALCULATE_DOPPLER Включает вычисление коэффициента сдвига Doppler. 
X3DAUDIO_CALCULATE_EMITTER_ANGLE Включает вычисление внутреннего угла от излучателя к прослушивателю. 
X3DAUDIO_CALCULATE_ZEROCENTER Заполняет центральный канал тишиной. Этот флаг позволяет сохранить 6-канальную матрицу, чтобы вам не нужно было переназначить каналы, но центральный канал будет молчать. Этот флаг действителен только в том случае, если вы также задали X3DAUDIO_CALCULATE_MATRIX. 
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE Применяет равное сочетание всех исходных каналов к каналу назначения низкочастотного эффекта (LFE). Он применяется только к матричным вычислениям с источником, у которых нет канала LFE и назначения с каналом LFE. Этот флаг действителен только в том случае, если вы также задали X3DAUDIO_CALCULATE_MATRIX. 

[in, out] pDSPSettings

Указатель на структуру X3DAUDIO_DSP_SETTINGS , которая получает результаты вычисления.

Возвращаемое значение

Эта функция не возвращает значение.

Комментарии

Обычно метод X3DAudioCalculate вызывается один раз для каждой пары излучающих объектов и прослушивателей в сцене. После каждого вызова, чтобы применить трехмерные эффекты, приложение вручную применяет результаты вычислений в pDSPSettings к XAUDIO2 графу. Дополнительные сведения см. в разделе Практическое руководство. Интеграция X3DAudio с XAudio2.

Важно Значения прослушивателя и излучателя должны быть допустимыми. Специальные возможности с плавающей запятой (NaN, QNaN, +INF, -INF) могут привести к тому, что весь аудиовыход будет затихать, если они вводятся в работающий звуковой граф.
 

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK для DirectX (XAudio 2.7)

Windows Phone 8.1: этот API поддерживается.

Требования

Требование Значение
Целевая платформа Windows
Header x3daudio.h
Библиотека Xaudio2.lib

См. также

Функции