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

Статья
03/04/2024

Вычисляет параметры 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

См. также

Функции