X3DAudioCalculate 함수(x3daudio.h)
3D 매개 변수와 관련하여 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
3D 오디오 instance 핸들. X3DAudioInitialize를 호출하여 이 핸들을 가져옵니다.
[in] pListener
수신 지점을 나타내는 X3DAUDIO_LISTENER 대한 포인터입니다.
[in] pEmitter
사운드 소스를 나타내는 X3DAUDIO_EMITTER 대한 포인터입니다.
[in] Flags
| 값 | Description |
|---|---|
| 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 를 한 번 호출합니다. 각 호출 후 3D 효과를 적용하기 위해 앱은 pDSPSettings 의 계산 결과를 XAUDIO2 그래프에 수동으로 적용합니다. 자세한 내용은 방법: XAudio2와 X3DAudio 통합을 참조하세요.
중요 수신기 및 방출기 값은 유효해야 합니다. 부동 소수점 특수(NaN, QNaN, +INF, -INF)는 실행 중인 오디오 그래프에 도입될 경우 전체 오디오 출력이 자동으로 진행되도록 할 수 있습니다.
플랫폼 요구 사항
Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)Windows Phone 8.1: 이 API가 지원됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | x3daudio.h |
| 라이브러리 | Xaudio2.lib |