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 | 錄音輸出格式 |
詳見批量與錄音頁面。