Files
XCEngine/docs/api/audio/hrtf/hrtf.md
ssdfasd fae7362e9f docs: 更新 audio 和 resources 模块文档
- audio: 更新 audio-mixer, equalizer, fft-filter, hrtf, reverbation 方法文档
- resources: 更新资源管理文档
- debug: 新增 renderdoc-capture 文档
2026-03-26 01:52:36 +08:00

1.7 KiB
Raw Blame History

HRTF

命名空间: XCEngine::Audio

类型: class

头文件: XCEngine/Audio/HRTF.h

描述: 基于头部相关传输函数Head-Related Transfer Function的 3D 空间音频处理器。

概述

HRTF 实现了基于头部相关传输函数Head-Related Transfer Function的 3D 空间音频算法。它通过计算声音的耳间时间差ITD、耳间电平差ILD和耳廓线索Pinna Cues在双耳耳机或扬声器上重现逼真的 3D 空间音效。支持多普勒效应、交叉馈送Cross-feed调节和质量级别设置。

公共方法

方法 描述
ProcessAudio 处理 3D 空间化音频
SetEnabled 设置启用状态
IsEnabled 检查启用状态
SetHRTFEnabled 设置 HRTF 处理启用状态
IsHRTFEnabled 检查 HRTF 处理启用状态
SetQualityLevel 设置质量级别
GetQualityLevel 获取质量级别
SetCrossFeed 设置交叉馈送值
GetCrossFeed 获取交叉馈送值
SetDopplerShiftEnabled 设置多普勒效应启用状态
IsDopplerShiftEnabled 检查多普勒效应启用状态
SetSpeedOfSound 设置声速
GetSpeedOfSound 获取声速

使用示例

#include <XCEngine/Audio/HRTF.h>

using namespace XCEngine::Audio;

void SetupHRTF() {
    HRTF* hrtf = new HRTF();
    hrtf->SetHRTFEnabled(true);
    hrtf->SetQualityLevel(2);
    hrtf->SetCrossFeed(0.2f);
    hrtf->SetDopplerShiftEnabled(true);
    hrtf->SetSpeedOfSound(343.0f);
}

相关文档