.Dd January 16, 2026
.Dt WAVPACK 1
.Os
.Sh "نام (NAME)"
.Nm wavpack
.Nd انکود کردن فایل‌های صوتی به wavpack
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm wavpack
.Op Fl options
.Op Fl o Ar output
.Ar
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm wavpack
فایل‌های منبع مشخص‌شده را به فایل‌های WavPack انکود می‌کند.
فایل‌های منبع می‌توانند هر یک از انواع فرمت‌های فهرست‌شده در زیر باشند،
و داده‌های صوتی بسته به فرمت، می‌توانند
PCM غیرفشرده یا DSD باشند.
همچنین می‌توان صدای خام (raw) را نیز مشخص کرد (ببینید:
.Fl -raw-pcm ) .
.Pp
مگر اینکه با گزینهٔ
.Fl o
لغو شود، نام فایل خروجی همان نام فایل منبع خواهد بود با این تفاوت که پسوند آن به
.Dq .wv
تغییر می‌یابد.
می‌توان چندین فایل ورودی را مشخص کرد که منجر به تولید چندین فایل WavPack می‌شود؛
در این حالت، می‌توان از
.Fl o
برای مشخص کردن یک دایرکتوری مقصد جایگزین استفاده کرد.
نام فایل
.Dq -
بیانگر
.Pa stdin
یا
.Pa stdout
است.
.Pp
هنگام ترنسکود (تبدیل مجدد) از فایل‌های موجود WavPack،
تمامی تگ‌ها کپی می‌شوند و می‌توان آن‌ها را با آرگومان‌های اضافی ویرایش کرد؛
مگر اینکه فایل خروجی یا دایرکتوری دیگری مشخص شده باشد،
فایل‌های منبع به صورت ایمن بازنویسی می‌شوند.
.Pp
در سیستم‌های چندهسته‌ای،
.Nm wavpack
تلاش می‌کند تا از چندین ریسه (thread) برای افزایش سرعت عملیات،
که اغلب چشمگیر است، استفاده کند.
این قابلیت در حالت هیبریدی (ترکیبی) اعمال نمی‌شود
(به‌جز در فایل‌های چندکاناله).
برای اجبار به اجرای تک‌ریسه‌ای از گزینهٔ
.Fl -no-threads
استفاده کنید، یا با گزینهٔ
.Fl -threads
تعداد ریسه‌های مورد استفاده را دقیقاً تنظیم نمایید.
.Ss "فرمت‌های ورودی (INPUT FORMATS)"
.Bl -bullet -compact
.It
فرمت Microsoft RIFF، پسوند
.Dq .wav ،
شامل گونه‌های BWF و RF64
.It
فرمت WavPack، پسوند
.Dq .wv ،
عملیات ترنسکود، تگ‌ها کپی می‌شوند
.It
فرمت Apple AIFF، پسوند
.Dq .aif
.It
فرمت Apple Core Audio، پسوند
.Dq .caf
.It
Sony Wave64، پسوند
.Dq .w64
.It
Philips DSDIFF، پسوند
.Dq .dff
.It
Sony DSD Stream، پسوند
.Dq .dsf
.El
.Ss "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl a
حالت Adobe Audition (CoolEdit) برای داده‌های ۳۲ بیتی ممیز شناور (float)
.It Fl -allow-huge-tags
اجازه دادن به داده‌های تگ تا سقف ۱۶ مگابایت.
تعبیهٔ بیش از ۱ مگابایت برای دستگاه‌های قابل‌حمل توصیه نمی‌شود
و ممکن است در برخی برنامه‌ها، از جمله نسخه‌های قدیمی‌تر WavPack، کار نکند.
.It Fl b Ns Ar n
فعال‌سازی فشرده‌سازی هیبریدی (ترکیبی)،
.Ar n
= ۲٫۰ تا ۲۳٫۹ بیت بر نمونه، یا
.Ar n
= ۲۴ تا ۹۶۰۰ کیلوبیت بر ثانیه (kbps). اگر این گزینه
.Em بدون
گزینهٔ
.Fl c
مشخص شود، عملیات با اتلاف (lossy) خواهد بود.
حالت هیبریدی برای صدای DSD قابل استفاده نیست (تنها برای PCM).
.It Fl -blocksize= Ns Ar n
مشخص کردن اندازهٔ بلوک برحسب نمونه (حداکثر ۱۳۱۰۷۲ و با
.Fl -merge-blocks ،
حداقل ۱۶، در غیر این صورت ۱۲۸)
.It Fl c
ایجاد فایل تصحیح (.wvc) برای حالت هیبریدی که منجر به فشرده‌سازی بدون‌اتلاف (lossless) دو فایلی می‌شود.
نرخ بیت با گزینهٔ
.Fl b Ns Ar n
مشخص می‌شود.
.It Fl cc
حداکثر فشرده‌سازی هیبریدی (به کیفیت حالت با اتلاف و سرعت دیکود آسیب می‌زند)
.It Fl c Ns Ar n
فعال‌سازی فشرده‌سازی بدون‌اتلاف هیبریدی (یعنی ۲ فایلی)،
.Ar n
= ۲٫۰ تا ۲۳٫۹ بیت بر نمونه، یا
.Ar n
= ۲۴ تا ۹۶۰۰ کیلوبیت بر ثانیه (kbps). این یک میان‌بُر است که گزینه‌های
.Fl b Ns Ar n
و
.Fl c
را ترکیب می‌کند.
حالت هیبریدی برای صدای DSD قابل استفاده نیست (تنها برای PCM).
.It Fl -channel-order= Ns Ar list
مشخص کردن ترتیب کانال‌ها با جداکنندهٔ کاما در صورتی که با استاندارد مایکروسافت یکسان نباشد؛
ترتیب استاندارد مایکروسافت عبارت است از: FL,FR,FC,LFE,BL,BR,FLC,FRC,BC,SL,SR,TC,TFL,TFC,TFR,TBL,TBC,TBR؛
مشخص کردن
.Dq ...
بیانگر آن است که کانال‌ها به بلندگوهای خاصی اختصاص داده نشده‌اند،
یا پایان دادن فهرست با
.Dq ...
بیانگر آن است که هر کانالی فراتر از موارد مشخص‌شده، تخصیص‌نیافته است.
.It Fl -cross-decorr
استفاده از همبستگی بین‌کانالی در حالت هیبریدی.
به‌طور پیش‌فرض در حالت بدون‌اتلاف و با گزینهٔ
.Fl cc
فعال است.
.It Fl d
حذف فایل منبع در صورت موفقیت‌آمیز بودن؛
.Sy با احتیاط استفاده شود!
.It Fl f
حالت سریع؛ افتی در نسبت فشرده‌سازی ایجاد می‌کند
.It Fl -force-even-byte-depth
گرد کردن عمق بیت مشخص‌شده در فایل منبع به سمت بالا
به نزدیک‌ترین بایت کامل (به عنوان مثال، ۲۰ بیتی به ۲۴ بیتی گرد می‌شود)
برای مدیریت مواردی که مقدار مشخص‌شده صحیح نیست
(یعنی بیت‌های پدینگ غیرصفر هستند).
.It Fl g
حالت عمومی/عادی، گزینه‌های قبلاً مشخص‌شدهٔ -f و -h را لغو می‌کند
.It Fl h
کیفیت بالا؛ نسبت فشرده‌سازی بهتر، اما کمی کندتر
.It Fl hh
کیفیت بسیار بالا؛ بهترین فشرده‌سازی، اما کندترین؛
برای دستگاه‌های پخش قدیمی توصیه نمی‌شود
.It Fl -help
نمایش راهنمای جامع
.It Fl i
نادیده گرفتن طول در هدر wav و مجاز دانستن فایل‌های WAV بزرگ‌تر از ۴ گیگابایت.
این کار تلاش می‌کند هدر WAV ذخیره‌شده در فایل WavPack را اصلاح کند؛
برای ایجاد یک هدر تازه به‌جای آن، با
.Fl r
ترکیب شود.
.It Fl -import-id3
وارد کردن موارد تگ مرتبط از تگ‌های ID3v2.3 یا ID3v2.4 موجود
در فایل‌های DSF و سایر فایل‌ها به تگ APEv2.
اگر تصاویر جلد بزرگ‌تر از ۱ مگابایت وجود دارد، گزینهٔ
.Fl -allow-huge-tags
را برای گنجاندن آن‌ها اضافه کنید، و گزینهٔ
.Fl r
را اگر نمی‌خواهید تصاویر بزرگ دوبار در فایل WavPack ظاهر شوند،
اگرچه این کار کل تگ ID3v2 اصلی را حذف خواهد کرد.
.It Fl j Ns Ar n
بازنویسی استریوی مشترک (joint-stereo) (۰ = چپ/راست، ۱ = میانی/کناری)
.It Fl m
محاسبه و ذخیرهٔ امضای MD5 داده‌های صوتی خام
.It Fl -merge-blocks
ادغام بلوک‌های متوالی با افزونگی یکسان (همراه با گزینهٔ
.Fl -blocksize
استفاده می‌شود و برای فایل‌های تولیدشده
توسط برنامهٔ lossyWAV یا فایل‌های دیکودشدهٔ HDCD مفید است)
.It Fl n
محاسبهٔ میانگین و اوج نویز کوانتیزاسیون
(تنها در حالت هیبریدی، بر مبنای سینوسی تمام‌مقیاس)
.It Fl -no-overwrite
هرگز روی فایل‌های موجود بازنویسی نکند و سؤالی هم نپرسد.
این گزینه برای ازسرگیری یک عملیات دسته‌ای لغوشده مفید است
و بدیهی است که نمی‌تواند با گزینهٔ
.Fl y
ترکیب شود.
.It Fl -no-threads
اجبار به اجرای تک‌ریسه‌ای، معادل
.Fl -threads=1
.It Fl -no-utf8-convert
عدم بازکدگذاری تگ‌های ارائه‌شده از کدگذاری محلی به UTF-8،
با این فرض که آن‌ها از قبل در قالب UTF-8 هستند.
.It Fl o Ar outfile
مشخص کردن یک نام فایل خروجی برای یک تک‌فایل منبع،
یا یک دایرکتوری مقصد (که باید از قبل وجود داشته باشد) برای چند فایل.
.It Fl -optimize-int32
بهینه‌سازی جدید برای فایل‌های صوتی عدد صحیح ۳۲ بیتی که در اصل
از صدای ممیز شناور ۳۲ بیتی به دست آمده‌اند.
می‌تواند فشرده‌سازی را تا ۱۰٪ بهبود بخشد، اما تنها در حالت‌های بدون‌اتلاف قابل استفاده است.
فایل‌های حاصل در دیکودرهای قدیمی‌تر تنها با وضوح ۲۴ بیتی دیکود می‌شوند
(یعنی از نظر فنی با اتلاف خواهد بود).
.It Fl -pair-unassigned-chans
انکود کردن کانال‌های تخصیص‌نیافته به جفت‌های استریو
.It Fl -pre-quantize= Ns Ar bits
پیش‌کوانتیزه کردن نمونه‌ها به عمق
.Ar bits
پیش از انکود و محاسبهٔ MD5
(کاربرد معمول آن
.Fl -pre-quantize=20
برای محتوای ۲۴ بیتی یا ممیز شناور ضبط‌شده با مبدل‌های متداول است)
.It Fl q
حالت ساکت (به حداقل رساندن خروجی کنسول)
.It Fl r
تجزیهٔ هدرها برای تشخیص فرمت و طول صدا،
اما عدم ذخیرهٔ هدرها در فایل نهایی WavPack
(یک هدر حداقلی توسط
.Nm wvunpack
تولید خواهد شد، اما ممکن است برخی فراداده‌های غیرصوتی از دست بروند)
.It Fl -raw-pcm
داده‌های ورودی، pcm خام هستند (۴۴٬۱۰۰ هرتز، ۱۶ بیتی، ۲ کاناله)
.It Fl -raw-pcm= Ns Ar sr , Ns Ar bits Ns [f|s|u], Ns Ar chans , Ns [le|be]
داده‌های ورودی، pcm خام با نرخ نمونه‌برداری مشخص‌شده،
عمق بیت (float, unsigned, signed)، تعداد کانال‌ها، و ترتیب بایت (endianness) هستند.
پارامترهایی که مقدار پیش‌فرض دارند را می‌توان حذف کرد؛ برای DSD مقدار
.Ar bits Ns =1
را مشخص کنید.
.It Fl -raw-pcm-skip= Ns Ar begin Ns [, Ns Ar end ]
نادیده گرفتن
.Ar begin
بایت پیش از انکود PCM خام (هدر) و نادیده گرفتن
.Ar end
بایت در انتهای فایل (EOF یا تریلر)
.It Fl s Ns Ar n
لغو شکل‌دهی پیش‌فرض نویز در حالت هیبریدی، به‌طوری‌که
.Ar n
یک مقدار ممیز شناور بین ۱٫۰- و ۱٫۰ است.
مقادیر منفی نویز را به فرکانس‌های پایین‌تر،
و مقادیر مثبت نویز را به فرکانس‌های بالاتر منتقل می‌کنند؛
از ۰ برای عدم شکل‌دهی (نویز سفید) استفاده کنید.
.It Fl t
کپی کردن برچسب زمانی (timestamp) فایل ورودی به فایل‌های خروجی.
.It Fl -threads= Ns Ar n
فعال‌سازی (یا غیرفعال‌سازی) اجرای چندریسه‌ای با
.Ar n=1
(بدون ریسه) تا
.Ar n=12
(حداکثر ریسه‌ها).
سرعت فشرده‌سازی بدون‌اتلاف را در پردازنده‌های چندهسته‌ای به میزان چشمگیری افزایش می‌دهد.
در حالت‌های هیبریدی، تنها فایل‌های چندکاناله می‌توانند از چندریسگی استفاده کنند.
حذف این پارامتر باعث انتخاب تعداد بهینهٔ ریسه‌ها می‌شود.
.It Fl -use-dns
اجبار به استفاده از شکل‌دهی پویای نویز (فقط در حالت هیبریدی)
.It Fl v
اعتبارسنجی درستی فایل خروجی پس از نوشتن (برای خروجی پایپ‌شده کاربرد ندارد)
.It Fl -version
نوشتن نسخهٔ برنامه در
.Pa stdout
.It Fl w Encoder
نوشتن فرادادهٔ انکودر در تگ APEv2 (مثلاً
.Dq Encoder=WavPack 5.8.0 )
.It Fl w Settings
نوشتن فرادادهٔ تنظیمات کاربر در تگ APEv2 (مثلاً
.Dq Settings=-hb384cx3 )
.It Fl w Do Ar Field Ns = Ns Ar Value Dc
نوشتن فرادادهٔ متنی مشخص‌شده در تگ APEv2
.It Fl w Do Ar Field Ns =@ Ns Ar file.ext Dc
نوشتن فرادادهٔ متنی مشخص‌شده از یک فایل در تگ APEv2؛
معمولاً برای cuesheetها و لاگ‌های تعبیه‌شده استفاده می‌شود
(نام‌های فیلد
.Dq Cuesheet
و
.Dq Log ) .
.It Fl -write-binary-tag Do Ar Field Ns =@ Ns Ar file.ext Dc
نوشتن فایل فرادادهٔ باینری مشخص‌شده در تگ APEv2؛
معمولاً برای تصویر جلد با نام فیلد
.Dq Cover Art (Front)
استفاده می‌شود.
.It Fl x[ Ns Ar n ]
پردازش اضافی انکود، n = 0 تا 6، پیش‌فرض=1؛
مقدار -x0 برای بدون پردازش اضافی،
مقدار -x1 تا -x3 برای انتخاب بهترین فیلترهای از پیش تعریف‌شده،
مقدار -x4 تا -x6 برای تولید فیلترهای سفارشی (بسیار کند!).
.It Fl y
پاسخ بله به تمام هشدارها؛
.Sy با احتیاط استفاده شود!
.It Fl z[ Ns Ar n ]
عنوان کنسول تنظیم نشود (n=0 یا بدون آرگومان) یا تنظیم شود (n=1)
تا پیشرفت کار نشان داده شود (در پایان عبارت "WavPack Completed" را باقی می‌گذارد)
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr wvgain 1 ,
.Xr wvtag 1 ,
.Xr wvunpack 1 ,
.Lk www.wavpack.com
.Sh "نویسندگان (AUTHORS)"
.An David Bryant Aq Mt david@wavpack.com
.An Sebastian Dröge Aq Mt slomo@debian.org
.An Jan Starý Aq Mt hans@stare.cz