DpdoEngine 파라미터 레퍼런스
이 문서는 DpdoEngine의 모든 CLI 파라미터를 분류별로 설명합니다.
일반 형식: 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 | 다항식 노이즈 셰이핑 | — |
사용 예시
# 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
3. FIR 필터
| 파라미터 | 설명 | 기본값 |
|---|
--taps N | FIR 탭 수 | 자동 계산 (최소 4096) |
--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 |
4. 오버샘플링 비율
| 파라미터 | 설명 |
|---|
--oversampling N | 오버샘플링 비율 (64–4096, 2의 거듭제곱) |
권장 매칭
| 입력 샘플레이트 | 목표 DSD | 권장 OSR |
|---|
| 44.1 kHz | DSD64 | 64 |
| 88.2 kHz | DSD64 | 32 |
| 96 kHz | DSD128 | 64 |
| 192 kHz | DSD256 | 64 |
5. GPU 가속
| 파라미터 | 설명 |
|---|
--opencl | OpenCL GPU 가속 활성화 |
GPU 가속 권장 시나리오:
- 고차 오버샘플링 (OSR ≥ 256)
- 고차 IIR (차수 ≥ 9)
- 대량 배치 처리
6. DSP 효과
이퀄라이저
| 파라미터 | 형식 |
|---|
--equalizer | <freq(Hz)>:<gain(dB)>:<Q>,... |
# 3밴드 EQ
--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 | 룩어헤드 리미터 |
--adaptive | 적응형 파라미터 조정 |
--apo | 안티 클리핑 필터 |
라우드니스 노멀라이제이션
| 파라미터 | 설명 |
|---|
--lufs V | 라우드니스 노멀라이제이션 목표 (dB LUFS) |
--rg | ReplayGain 노멀라이제이션 활성화 |
--lufs -16 # -16 LUFS로 노멀라이즈
--rg # ReplayGain 태그로 노멀라이즈
7. 스테레오 및 공간 오디오
| 파라미터 | 설명 |
|---|
--auto-pan | 자동 패닝 보정 |
--target-width V | 목표 스테레오 폭 |
--stereoexpander V | 스테레오 익스팬더 |
--hrtf | HRTF 공간 오디오 렌더링 |
--dxd | DXD 출력 모드 |
스테레오 확장
# 스테레오 폭 150% 확장
--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 |
--eq ... | Dpdo DSP EQ |
--crossfeed V | Dpdo DSP 크로스피드 |
14. 파이프 및 녹음
| 파라미터 | 설명 |
|---|
--pipe | 파이프 출력 모드 (stdin/stdout) |
--record | 녹음 모드 |
--record-dsd | DSD 네이티브 녹음 (DoP 또는 ALSA raw DSD) |
자세한 내용은 배치 및 녹음 페이지를 참조하세요.