estructura X3DAUDIO_LISTENER (x3daudio.h)

Define un punto de recepción de audio 3D.

Sintaxis

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

Miembros

OrientFront

Orientación de la dirección delantera. Cuando pCone es NULL OrientFront solo se usa para cálculos de matriz y retraso. Cuando pCone no es NULL OrientFront se usa para la matriz, LPF (rutas directas y de reverberación) y cálculos de reverberación. Este valor debe ser ortonormal con OrientTop cuando se usa.

OrientTop

Orientación de la dirección superior, utilizada solo para cálculos de matriz y retraso. Este valor debe ser ortonormal con OrientFront cuando se use.

Position

Posición en unidades del mundo definidas por el usuario. Este valor no afecta a La velocidad.

Velocity

Vector de velocidad en unidades del mundo definidas por el usuario por segundo, que solo se usan para los cálculos vectoriales. Este valor no afecta a Position.

pCone

Puntero a una estructura de X3DAUDIO_CONE para este agente de escucha. Proporcionar un cono del agente de escucha especificará que se realizan cálculos adicionales al determinar el volumen y filtrar los parámetros DSP para orígenes de sonido individuales. Un valor pCone NULL especifica un sonido omnidireccional y no se aplica ningún procesamiento de cono. pCone solo se usa para matrices, LPF (rutas directas y de reverberación) y cálculos de reverberación.

Comentarios

X3DAudio usa un sistema de coordenadas cartesiano a la izquierda, con valores en el eje X que aumentan de izquierda a derecha, en el eje y de abajo a arriba y en el eje z de cerca a lejos. Los Azimuths se miden en el sentido de las agujas del reloj desde una dirección de referencia determinada.

Para usar X3DAudio con coordenadas a la derecha, debe negar el elemento .z de OrientFront, OrientTop, Position y Velocity.

El tipo de parámetro X3DAUDIO_VECTOR se escribe en DirectX::XMFLOAT3, para proporcionar valores de punto flotante x, y y z.

Los vectores frontal y superior de un agente de escucha deben ser ortonormales. Para considerarse ortonormal, un par de vectores debe tener una magnitud de 1 +- 1x10-5 y un producto de punto de 0 +- 1x10-5.

Requisitos de la plataforma

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

Requisitos

Requisito	Valor
Header	x3daudio.h