X3DAUDIO_LISTENER 구조체(x3daudio.h)

3D 오디오 수신 지점을 정의합니다.

구문

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 오리엔트프론트인 경우 행렬 및 지연 계산에만 사용됩니다. pCone가 NULL OrientFront가 아닌 경우 행렬, LPF(직접 및 반향 경로 모두) 및 반향 계산에 사용됩니다. 이 값은 사용되는 경우 OrientTop 과 직렬이어야 합니다.

OrientTop

행렬 및 지연 계산에만 사용되는 최상위 방향의 방향입니다. 이 값은 사용되는 경우 OrientFront 에서 정형이어야 합니다.

Position

사용자 정의 월드 단위의 위치입니다. 이 값은 속도에 영향을 주지 않습니다.

Velocity

초당 사용자 정의 월드 단위의 속도 벡터이며, 도플러 계산에만 사용됩니다. 이 값은 Position에 영향을 주지 않습니다.

pCone

이 수신기의 X3DAUDIO_CONE 구조에 대한 포인터입니다. 수신기 원뿔을 제공하면 볼륨을 결정할 때 추가 계산이 수행되고 개별 사운드 소스에 대한 DSP 매개 변수가 필터링됩니다. NULL pCone 값은 전방향 사운드를 지정하며 원뿔 처리가 적용되지 않습니다. pCone 는 행렬, LPF(직접 및 반향 경로 모두) 및 반향 계산에만 사용됩니다.

설명

X3DAudio는 왼손 카티전 좌표계를 사용하며, x축의 값은 왼쪽에서 오른쪽으로, y축은 아래쪽에서 위쪽으로, z축은 근거리에서 먼 좌표로 증가합니다. Azimuths는 지정된 참조 방향에서 시계 방향으로 측정됩니다.

오른손 좌표와 함께 X3DAudio를 사용하려면 OrientFront, OrientTop, Position 및 Velocity의 .z 요소를 부정해야 합니다.

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); DirectX SDK(XAudio 2.7)

요구 사항

요구 사항	값
헤더	x3daudio.h