DpdoEngine 参数参考
本文档列出 DpdoEngine 所有命令行参数的分类说明。
通用格式：DpdoEngine -i <INFILE> <OUTFILE> [OPTIONS]
一、基本参数
| 参数 | 说明 | 示例 |
|---|
-i INFILE | 输入 PCM 文件路径（FLAC / WAV / AIFF / MP3 等） | -i track.flac |
OUTFILE | 输出文件路径，扩展名决定格式 | track.dsf |
--reverse | 反向模式：DSD → PCM | --reverse |
--oversampling N 或 --oversampling N | 设置上采样率倍数 | --oversampling 256 |
--help | 显示帮助信息 | --help |
二、噪声整形（IIR）
| 参数 | 说明 | 可选值 |
|---|
--order N | IIR 噪声整形器阶数 | 3, 5, 7, 9, 11 |
--pole V | 极点配置 | 浮点数（默认 8.5） |
--zero | 零点配置优化 | — |
--mash | MASH 结构 | — |
--cifb | CIFB (Chain of Integrators with FeedBack) 结构 | — |
--poly | 多项式噪声整形 | — |
使用示例
# 11 阶 IIR + MASH
DpdoEngine -i input.wav output.dsf --oversampling 128 --order 11 --mash
# 自定义极点
DpdoEngine -i input.wav output.dsf --oversampling 64 --order 7 --pole 9.2
三、FIR 滤波器
| 参数 | 说明 | 默认值 |
|---|
| `` | 启用 FIR 滤波器模式 | 关闭 |
--taps N | FIR taps 数量 | 自动计算（最小 4096） |
--beta V 或 --beta V | Kaiser 窗参数 beta | 自动 |
--window-type TYPE | 窗口类型 | kaiser |
窗口类型
| 值 | 说明 | 特点 |
|---|
kaiser | Kaiser 窗 | 可调旁瓣抑制，通用选择 |
blackman | Blackman 窗 | 高旁瓣衰减 |
flattop | Flat Top 窗 | 精确幅度测量 |
bartlett | Bartlett (三角) 窗 | 简单，旁瓣衰减一般 |
hamming | Hamming 窗 | 经典选择，分辨率与泄漏平衡 |
hanning | Hanning (Hann) 窗 | 低频泄漏好 |
remez | Parks-McClellan (Remez) | 等波纹最优 FIR |
四、上采样与倍率
| 参数 | 说明 |
|---|
--oversampling N | 上采样率（64 ~ 4096，2 的幂次） |
--oversampling N | 同上 |
推荐匹配
| 输入采样率 | 目标 DSD | 推荐 OSR |
|---|
| 44.1 kHz | DSD64 | 64 |
| 88.2 kHz | DSD64 | 32 |
| 96 kHz | DSD128 | 64 |
| 192 kHz | DSD256 | 64 |
五、GPU 加速
| 参数 | 说明 |
|---|
--opencl | 启用 OpenCL GPU 加速 |
--no-opencl | 强制禁用 GPU（纯 CPU 模式） |
GPU 加速建议在以下场景使用：
- 高阶上采样（OSR ≥ 256）
- 高阶 IIR（阶数 ≥ 9）
- 大批量文件批处理
六、DSP 效果
均衡器
| 参数 | 格式 |
|---|
--equalizer 或 --eq | <freq(Hz)>:<gain(dB)>:<Q>,... |
# 三段均衡
--equalizer "60:1.0:2,1000:-0.5:1,8000:0.3:3"
谐波饱和
| 参数 | 格式 |
|---|
--harmonics | <type>,<amount> |
类型： tanh、poly、softclip、fullwave、tape
--harmonics tanh,0.3
--harmonics tape,0.5
动态处理
| 参数 | 说明 |
|---|
--lal | 前瞻限制器（Look-Ahead Limiter） |
--adaptive | 自适应参数调整 |
--apo | 削波滤波器（Anti-Popping Overflow） |
响度标准化
| 参数 | 说明 |
|---|
--lufs V | 响度标准化目标值（dB LUFS） |
--rg | 启用 ReplayGain 标准化 |
--lufs -16 # 标准化到 -16 LUFS
--rg # 按 ReplayGain 标签标准化
七、立体声与空间音频
| 参数 | 说明 |
|---|
--auto-pan | 自动声像校正 |
-target-width V | 目标立体声宽度 |
-stereoexpander V | 立体声扩展器 |
--hrtf | HRTF 空间音频渲染 |
--DXD | DXD 输出模式 |
立体声扩展
# 立体声宽度扩展 150%
-stereoexpander 1.5
# 自动声像校正 + 目标宽度
--auto-pan -target-width 0.8
八、音频编码格式
| 参数 | 说明 |
|---|
--quad N | DSD 声道数 |
--dst [on/off] | DST 压缩开关 |
--dst-compression N | DST 压缩等级（0–9） |
九、元数据
| 参数 | 示例 |
|---|
--artist "Name" | --artist "Ludwig van Beethoven" |
--title "Track" | --title "Symphony No.5" |
--album "Album" | --album "Complete Symphonies" |
--genre "Genre" | --genre "Classical" |
--year YYYY | --year 2024 |
--label "Label" | --label "Deutsche Grammophon" |
--composer "Name" | --composer "Beethoven" |
--conductor "Name" | --conductor "Karajan" |
--barcode "CODE" | --barcode "028947757823" |
--isrc "CODE" | --isrc "DEF059003211" |
十、分析报告
| 参数 | 说明 |
|---|
--report | 生成文本分析报告 |
-pdfrp | 生成 PDF 分析报告（含频谱图） |
--noise-profiling | 噪声分布分析 |
--spectrogram | 频谱图生成 |
--stats | 数据统计 |
十一、量化与抖动
抖动类型
支持 8 种抖动算法：
| 类型 | 说明 |
|---|
rect | 矩形 PDF 抖动 |
tri | 三角形 PDF 抖动 |
shaped | 噪声整形抖动 |
gauss | 高斯抖动 |
rpdf | 矩形概率密度函数 |
tpdf | 三角概率密度函数 |
ns | 噪声整形抖动（高阶） |
none | 无抖动 |
十二、用户预设
| 参数 | 说明 |
|---|
--preset-load NAME | 加载保存的用户预设 |
--preset-save NAME | 保存当前参数为预设 |
--preset-list | 列出所有已保存预设 |
十三、Dpdo DSP
| 参数 | 说明 |
|---|
--bass V | Dpdo DSP 低音增强 |
--treble V | Dpdo DSP 高音调整 |
--pbe V | Dpdo DSP 参数均衡 |
--eq .... | Dpdo DSP EQ |
--crossfeed V | Dpdo DSP 交叉馈送 |
十四、管道与录放
| 参数 | 说明 |
|---|
--pipe | 管道输出模式（stdin/stdout） |
--record | 录音模式 |
-format TYPE | 录音输出格式 |
详见批量与录音页面。