.TH zresample 1  "May 2010" "version 0.0.1" "USER COMMANDS"
.SH "نام (NAME)"
zresample \- نمونه‌برداری مجدد و تغییر قالب نمونه فایل‌های صوتی
.SH "خلاصه دستور (SYNOPSIS)"
.B zresample
[گزینه‌ها] input-file output-file
.SH "توضیحات (DESCRIPTION)"
دستور
.B zresample
یک فایل صوتی را کپی کرده و نرخ نمونه‌برداری (sample rate) و/یا قالب نمونه (sample format) آن را تغییر می‌دهد. برای خروجی 16\-bit، می‌تواند سیگنال صوتی را دیتر (dither) نیز بکند. ورودی می‌تواند هر فایل صوتی قابل خواندن توسط کتابخانه libsndfile باشد. نوع فایل خروجی یکی از قالب‌های WAV، WAVEX، CAF، AIFF یا FLAC است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B --help
نمایش یک متن راهنمای کوتاه.
.TP
.B --rate sample-rate
تنظیم نرخ نمونه‌برداری خروجی.
دستور
.B zresample
از کتابخانه zita-resampler استفاده می‌کند، به این معنی که همه ترکیب‌های نرخ نمونه‌برداری ورودی/خروجی پذیرفته نخواهند شد. نسبت نمونه‌برداری مجدد باید به کسر
.B a/b
قابل ساده‌سازی باشد، به‌طوری که هر دو مقدار
.B a
و
.B b
کوچک‌تر یا مساوی ۱۰۰۰ باشند.
.TP
.B --gain gain
بهره (gain) بر حسب dB، پیش‌فرض صفر است.
.SS "نوع فایل خروجی"
.TP
.B --wav
تولید یک فایل WAV، یا برای بیش از ۲ کانال، یک فایل WAVEX. این حالت پیش‌فرض است.
.TP
.B --amb
تولید یک فایل WAVEX با Ambisonic GUID. چنین فایل‌هایی باید پسوند نام فایل
.B .amb
داشته باشند.
.TP
.B --caf
تولید یک فایل Core Audio.
.TP
.B --aiff
تولید یک فایل AIFF.
.TP
.B --flac
تولید یک فایل FLAC.
.SS "قالب نمونه خروجی"
.TP
.B --16bit
قالب نمونه خروجی 16\-bit علامت‌دار است. این گزینه همچنین استفاده از دیترینگ (dithering) را که در ادامه شرح داده شده، فعال می‌کند.
.TP
.B --24bit
قالب نمونه خروجی 24\-bit است. این حالت پیش‌فرض است.
.TP
.B --float
قالب نمونه خروجی ممیز شناور (floating point) ۳۲ بیتی است.
.SS "دیترینگ (Dithering)"
.TP
.B --rec
افزودن نویز دیترینگ سفید با توزیع مستطیلی (rectangular). اگر قرار است داده‌های خروجی دوباره پردازش شوند، این بهترین گزینه است، اما در این حالت توصیه می‌شود از 24\-bit یا float استفاده شود.
.TP
.B --tri
افزودن نویز فیلترشده با توزیع مثلثی (triangular). در مقایسه با دیتر مستطیلی، این کار چگالی نویز را در محدوده بسامدی پایین‌تر کاهش می‌دهد.
.TP
.B --lips
این گزینه از فیلتر بهینه بازخورد خطا توصیف‌شده توسط Stanley Lipschitz استفاده می‌کند. در صورتی که خروجی، قالب توزیع نهایی باشد (مانند انتشار روی CD)، این گزینه توصیه می‌شود.
.SS "زمان‌بندی"
.TP
.B --pad
درج نمونه‌های ورودی با مقدار صفر در ابتدا و انتها، تا خروجی حتی برای اولین و آخرین نمونه‌ها نیز شامل پاسخ فیلتر متقارن کامل باشد.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت نبود خطا صفر، و در غیر این صورت مقداری غیرصفر بازگردانده می‌شود.
.SH "نویسندگان (AUTHORS)"
Fons Adriaensen (fons (at) linuxaudio.org)