Files

ssdfasd 161a0896d5 docs: 添加 Audio 模块和 Components 模块 API 文档

- 新增 Audio 模块文档 (54 个文件)
  - AudioSystem 单例类及 20 个方法页
  - AudioMixer 混音器类及 11 个方法页
  - IAudioBackend、IAudioEffect 接口
  - FFTFilter、Reverbation、Equalizer、HRTF 效果类
  - WASAPIBackend Windows 后端
  - AudioConfig、Audio3DParams 等结构体
  - 9 个枚举类型文档
- 新增 Components 模块文档 (3 个文件)
  - AudioSourceComponent 音频源组件
  - AudioListenerComponent 音频监听器组件
- 更新 docs/api/main.md 添加模块导航

2026-03-22 01:56:16 +08:00

2.1 KiB

Raw Blame History

Equalizer

命名空间: XCEngine::Audio

类型: class

头文件: XCEngine/Audio/Equalizer.h

描述: 多频段参数均衡器。

概述

Equalizer 是基于双二阶滤波器（Biquad Filter）的多频段参数均衡器实现。它支持设置任意数量的频段，每个频段可独立调节频率、增益（Gain/dB）和 Q 值。可用于调整音频频谱响应，实现低音增强、高音切平等效果。

公共方法

方法	描述
`Equalizer`	构造函数
`~Equalizer`	析构函数
`ProcessAudio`	处理均衡后的音频
`SetBandCount`	设置频段数量
`GetBandCount`	获取频段数量
`SetBandFrequency`	设置频段频率
`GetBandFrequency`	获取频段频率
`SetBandGain`	设置频段增益
`GetBandGain`	获取频段增益
`SetBandQ`	设置频段 Q 值
`GetBandQ`	获取频段 Q 值
`SetEnabled`	设置启用状态
`IsEnabled`	检查启用状态
`SetWetMix`	设置湿信号混合比例
`GetWetMix`	获取湿信号混合比例

使用示例

#include <XCEngine/Audio/Equalizer.h>

using namespace XCEngine::Audio;

void SetupEqualizer() {
    Equalizer* eq = new Equalizer();
    eq->SetBandCount(4);
    
    eq->SetBandFrequency(0, 100.0f);
    eq->SetBandGain(0, 3.0f);
    eq->SetBandQ(0, 1.0f);
    
    eq->SetBandFrequency(1, 1000.0f);
    eq->SetBandGain(1, 0.0f);
    eq->SetBandQ(1, 1.0f);
    
    eq->SetBandFrequency(2, 5000.0f);
    eq->SetBandGain(2, -2.0f);
    eq->SetBandQ(2, 1.0f);
    
    eq->SetBandFrequency(3, 10000.0f);
    eq->SetBandGain(3, 0.0f);
    eq->SetBandQ(3, 1.0f);
}

2.1 KiB Raw Blame History Unescape Escape

Equalizer

概述

公共方法

使用示例

相关文档

2.1 KiB

Raw Blame History