Справочник параметров DpdoEngine
Документ описывает все параметры командной строки DpdoEngine по категориям.
Общий формат: DpdoEngine -i <INFILE> <OUTFILE> [OPTIONS]
1. Основные параметры
| Параметр | Описание | Пример |
-i INFILE | Путь входного PCM-файла (FLAC / WAV / AIFF / MP3 и др.) | -i track.flac |
OUTFILE | Путь выходного файла; расширение определяет формат (.dsf/.dff/.dst/.wsd) | track.dsf |
--reverse | Обратный режим: DSD → PCM | --reverse |
--oversampling N | Коэффициент оверсэмплинга | --oversampling 256 |
--help | Показать справку | --help |
2. Шейпинг шума (IIR)
| Параметр | Описание | Значения |
--order N | Порядок IIR-шейпера | 3, 5, 7, 9, 11 |
--pole V | Размещение полюсов | число с плавающей точкой (по умолч. 8.5) |
--zero | Оптимизация нулей | — |
--mash | Структура MASH | — |
--cifb | Структура CIFB (Chain of Integrators with FeedBack) | — |
--poly | Полиномиальный шейпинг | — |
Примеры
# IIR 11-го порядка + 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
3. FIR-фильтры
| Параметр | Описание | По умолчанию |
--taps N | Число FIR taps | авто (минимум 4096) |
--beta V | Параметр окна Kaiser | авто |
--window-type TYPE | Тип окна | kaiser |
Типы окон
| Значение | Описание | Особенности |
kaiser | Окно Kaiser | регулируемое подавление боковых лепестков |
blackman | Окно Blackman | высокое затухание боковых лепестков |
flattop | Окно Flat Top | точное измерение амплитуды |
bartlett | Окно Бартлетта (треугольное) | простое, умеренное затухание |
hamming | Окно Хэмминга | классика, баланс разрешения и утечки |
hanning | Окно Ханна | хорошая низкочастотная утечка |
remez | Parks-McClellan (Remez) | оптимальный равноволновой FIR |
4. Оверсэмплинг
| Параметр | Описание |
--oversampling N | Коэффициент (64–4096, степени 2) |
Рекомендуемые соответствия
| Входная частота | Целевой DSD | Рекомендуемый OSR |
| 44.1 кГц | DSD64 | 64 |
| 88.2 кГц | DSD64 | 32 |
| 96 кГц | DSD128 | 64 |
| 192 кГц | DSD256 | 64 |
5. Ускорение GPU
| Параметр | Описание |
--opencl | Включить ускорение OpenCL |
Рекомендуется при:
- высоком оверсэмплинге (OSR ≥ 256)
- IIR высокого порядка (≥ 9)
- больших пакетных обработках
6. DSP-эффекты
Эквалайзер
| Параметр | Формат |
--equalizer | <частота(Гц)>:<усиление(дБ)>:<Q>,... |
--equalizer "60:1.0:2,1000:-0.5:1,8000:0.3:3"
Гармоническое насыщение
| Параметр | Формат |
--harmonics | <тип>,<количество> |
Типы: tanh, poly, softclip, fullwave, tape
--harmonics tanh,0.3
--harmonics tape,0.5
Динамическая обработка
| Параметр | Описание |
--lal | Лимитер с предпросмотром |
--adaptive | Адаптивная настройка |
--apo | Антиклиппинговый фильтр |
Нормализация громкости
| Параметр | Описание |
--lufs V | Целевая громкость (дБ LUFS) |
--rg | Нормализация ReplayGain |
--lufs -16 # нормализация до -16 LUFS
--rg # нормализация по тегам ReplayGain
7. Стерео и пространственный звук
| Параметр | Описание |
--auto-pan | Автоматическая коррекция панорамы |
--target-width V | Целевая ширина стерео |
--stereoexpander V | Стерео-экспандер |
--hrtf | Пространственный рендеринг HRTF |
--dxd | Режим вывода DXD |
Расширение стерео
--stereoexpander 1.5
--auto-pan --target-width 0.8
8. Аудиоформаты
| Параметр | Описание |
--quad | Включить квадроканальный PDM |
--dst | Переключатель сжатия DST |
--dst-compression N | Уровень сжатия DST (1–128, порядок предсказания) |
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" |
10. Аналитические отчёты
| Параметр | Описание |
--report | Текстовый отчёт |
--pdfrp | PDF-отчёт (со спектрограммой) |
--noise-profiling | Анализ распределения шума |
--spectrogram | Генерация спектрограммы |
--stats | Статистика данных |
11. Квантование и диттер
| Параметр | Описание |
--dither TYPE | Тип диттера |
Типы диттера
8 алгоритмов:
| Тип | Описание |
0 | TPDF (по умолчанию, ±1 LSB треугольный) |
1 | POW-R Type1 (1-z⁻¹, лёгкий шейпинг) |
2 | POW-R Type2 ((1-z⁻¹)², умеренный) |
3 | POW-R Type3 ((1-z⁻¹)³, сильный) |
4 | Lipshitz (5-го порядка FIR) |
5 | F-weighted (9-го порядка FIR) |
6 | Gesemann (4-го порядка IIR) |
7 | Shibata (16-20-го порядка FIR) |
12. Пользовательские пресеты
| Параметр | Описание |
--preset-load NAME | Загрузить сохранённый пресет |
--preset-save NAME | Сохранить текущие параметры |
--preset-list | Список пресетов |
13. Dpdo DSP
| Параметр | Описание |
--bass V | Усиление баса Dpdo DSP |
--treble V | Регулировка верхов Dpdo DSP |
--pbe V | Параметрический эквалайзер Dpdo DSP |
--eq ... | Эквалайзер Dpdo DSP |
--crossfeed V | Кроссфид Dpdo DSP |
14. Pipe и запись
| Параметр | Описание |
--pipe | Режим pipe (stdin/stdout) |
--record | Режим записи |
--record-dsd | Нативная запись DSD (DoP или ALSA raw DSD) |
Подробнее: Пакетная обработка и запись.