مرجع معاملات 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 (سلسلة مكاملات بتغذية راجعة) | — |
--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
| المعامل | الوصف | الافتراضي |
|---|
| (تفعيل وضع FIR) | تفعيل وضع مرشح FIR | معطّل |
--taps N | عدد taps لمرشح FIR | تلقائي (حد أدنى 4096) |
--beta V | بيتا نافذة Kaiser | تلقائي |
--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 | تفعيل تسريع GPU عبر OpenCL |
--no-opencl | تعطيل GPU قسرياً (وضع CPU خالص) |
يُنصح بتسريع GPU لـ:
- رفع عينات عالٍ (OSR ≥ 256)
- IIR عالي الرتبة (الرتبة ≥ 9)
- معالجة دفعات كبيرة
6. تأثيرات 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 | محدد النظر إلى الأمام |
--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 N | عدد قنوات DSD |
--dst [on/off] | مفتاح ضغط DST |
--dst-compression N | مستوى ضغط DST (0–9) |
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
| المعامل | الوصف |
|---|
--dither TYPE | نوع dither |
أنواع dither
8 خوارزميات dither مدعومة:
| النوع | الوصف |
|---|
rect | dither بـPDF مستطيل |
tri | dither بـPDF مثلثي |
shaped | dither مشكَّل الضجيج |
gauss | dither غاوسي |
rpdf | دالة كثافة احتمال مستطيلة |
tpdf | دالة كثافة احتمال مثلثية |
ns | dither مشكَّل الضجيج (رتبة عالية) |
none | بلا dither |
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 | وضع إخراج أنبوبي (stdin/stdout) |
--record | وضع التسجيل |
-format TYPE | صيغة إخراج التسجيل |
انظر الدفعات والتسجيل للتفاصيل.