estrutura X3DAUDIO_LISTENER (x3daudio.h)

Define um ponto de recepção de áudio 3D.

Sintaxe

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

Membros

OrientFront

Orientação da direção frontal. Quando pCone é NULL OrientFront é usado apenas para cálculos de matriz e atraso. Quando pCone não é NULL OrientFront é usado para matriz, LPF (caminhos diretos e reverb) e cálculos de reverb. Esse valor deve ser orthonormal com OrientTop quando usado.

OrientTop

Orientação da direção superior, usada apenas para cálculos de matriz e atraso. Esse valor deve ser orthonormal com OrientFront quando usado.

Position

Posição em unidades mundiais definidas pelo usuário. Esse valor não afeta Velocity.

Velocity

Vetor de velocidade em unidades mundiais definidas pelo usuário por segundo, usado apenas para cálculos doppler. Esse valor não afeta Position.

pCone

Ponteiro para uma estrutura de X3DAUDIO_CONE para esse ouvinte. Fornecer um cone de ouvinte especificará que cálculos adicionais são executados ao determinar o volume e filtrar parâmetros DSP para fontes de som individuais. Um valor pCone NULL especifica um som omnidirecional e nenhum processamento de cone é aplicado. o pCone é usado apenas para matriz, LPF (caminhos diretos e reverb) e cálculos de reverb.

Comentários

X3DAudio usa um sistema de coordenadas cartesiano canhoto, com valores no eixo x aumentando da esquerda para a direita, no eixo y de baixo para cima e no eixo z de perto para longe. Os azimutes são medidos no sentido horário de uma determinada direção de referência.

Para usar X3DAudio com coordenadas destros, você deve negar o elemento .z de OrientFront, OrientTop, Position e Velocity.

O tipo de parâmetro X3DAUDIO_VECTOR é digitado para DirectX::XMFLOAT3, para fornecer valores de ponto flutuante x, y e z.

Os vetores frontal e superior de um ouvinte devem ser orthonormal. Para ser considerado orthonormal, um par de vetores deve ter uma magnitude de 1 +- 1x10-5 e um produto de ponto de 0 +- 1x10-5.

Requisitos da plataforma

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

Requisitos

Requisito	Valor
Cabeçalho	x3daudio.h