структура X3DAUDIO_LISTENER (x3daudio.h)

  • Статья

Определяет точку приема трехмерного звука.

Синтаксис

typedef struct X3DAUDIO_LISTENER {
  X3DAUDIO_VECTOR OrientFront;
  X3DAUDIO_VECTOR OrientTop;
  X3DAUDIO_VECTOR Position;
  X3DAUDIO_VECTOR Velocity;
  X3DAUDIO_CONE   *pCone;
} X3DAUDIO_LISTENER, *LPX3DAUDIO_LISTENER;

Члены

OrientFront

Ориентация переднего направления. Если pCone имеет значение NULL , OrientFront используется только для матричных вычислений и вычислений задержки. Если значение pCone не равно NULL, orientFront используется для матричных, LPF (прямых и реверберующих путей) и реверберации вычислений. При использовании это значение должно быть ортонормальным с OrientTop .

OrientTop

Ориентация верхнего направления, используемая только для матричных вычислений и вычислений задержки. При использовании это значение должно быть ортонормальным с OrientFront .

Position

Положение в единицах мира, определяемых пользователем. Это значение не влияет на скорость.

Velocity

Вектор скорости в единицах пользовательского мира в секунду, используемый только для доплеровских вычислений. Это значение не влияет на позицию.

pCone

Указатель на структуру X3DAUDIO_CONE для этого прослушивателя. Предоставление конуса прослушивателя указывает, что при определении громкости и фильтрации параметров DSP для отдельных источников звука выполняются дополнительные вычисления. Значение null pCone указывает всенаправленный звук, и обработка конусов не применяется. pCone используется только для матричных вычислений, LPF (как прямых, так и реверберных путей) и реверберации.

Комментарии

X3DAudio использует левшнюю декартовую систему координат, при этом значения на оси X увеличиваются слева направо, на оси Y снизу вверх и на оси Z с близкого к дальнему. Азимуты измеряются по часовой стрелке от заданного направления ссылок.

Чтобы использовать X3DAudio с праворучными координатами, необходимо отрицать элемент .z orientFront, OrientTop, Position и Velocity.

Тип параметра X3DAUDIO_VECTOR имеет тип DirectX::XMFLOAT3 для предоставления значений x, y и z с плавающей запятой.

Передний и верхний векторы прослушивателя должны быть ортонормальными. Чтобы считаться ортонормальным, пара векторов должна иметь величину 1 +- 1x10-5 и точечное произведение 0 +- 1x10-5.

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

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

Требования

Требование Значение
Заголовок x3daudio.h