.TH zretune 1  "Sept 2012" "version 0.0.1" "USER COMMANDS"
.SH "نام (NAME)"
zretune \- بازنمونه‌برداری از فایل صوتی به‌منظور تغییر زیروبمی آن
.SH "خلاصه دستور (SYNOPSIS)"
.B zretune
[\fIگزینه‌ها\fR] \fIinput-file\fR \fIoutput-file\fR
.SH "توضیحات (DESCRIPTION)"
.B zretune
یک فایل صوتی را با معکوس نسبتی که به‌صورت مستقیم یا برحسب سنت (cent) مشخص شده، بدون تغییر نرخ نمونه‌برداری اسمی بازنمونه‌برداری (resample) می‌کند.
نتیجه این کار، تغییر زیروبمی موسیقایی و طول فایل است.
ورودی می‌تواند هر فایل صوتی قابل خواندن توسط کتابخانه
.B libsndfile
باشد.
نوع فایل خروجی یکی از قالب‌های WAV، WAVEX، CAF، AIFF یا FLAC است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-help
نمایش متن راهنمای کوتاه.
.TP
.B \-\-ratio pitch ratio
محدوده پذیرفته‌شده بین 0.5 تا 2.0 است. محدوده کاربردی در عمل کوچک‌تر خواهد بود.
.TP
.B \-\-cent pitch change in cents
تعداد سنت‌هایی که زیروبمی صدا بر اساس آن تغییر می‌کند. محدوده پذیرفته‌شده
.B +/\- 1200
سنت است؛ محدوده کاربردی در عمل در حدود
.B +/\- 100
سنت خواهد بود.
.SS "نوع فایل خروجی (Output file type)"
.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 "قالب نمونه خروجی (Output sample format)"
.TP
.B \-\-16bit
قالب نمونه خروجی ۱۶ بیتی علامت‌دار (signed 16-bit) است. این گزینه همچنین استفاده از دیترینگ (dithering) را که در ادامه توضیح داده شده، فعال می‌کند.
.TP
.B \-\-24bit
قالب نمونه خروجی ۲۴ بیتی است. این گزینه پیش‌فرض است.
.TP
.B \-\-float
قالب نمونه خروجی ۳۲ بیتی ممیز شناور (floating point) است.
.SS "دیترینگ (Dithering)"
.TP
.B \-\-rec
افزودن نویز دیتر سفید با توزیع مستطیلی (rectangular distribution). این گزینه در صورتی که قرار باشد داده‌های خروجی دوباره پردازش شوند بهترین حالت است، هرچند در آن شرایط توصیه می‌شود از ۲۴ بیتی یا float استفاده شود.
.TP
.B \-\-tri
افزودن نویز فیلترشده با توزیع مثلثی (triangular distribution). در مقایسه با دیتر مستطیلی، این گزینه چگالی نویز را در محدوده فرکانسی پایین‌تر کاهش می‌دهد.
.TP
.B \-\-lips
استفاده از فیلتر بهینه بازخورد خطا که توسط استنلی لیپشیتز (Stanley Lipschitz) توصیف شده است. این گزینه در صورتی توصیه می‌شود که خروجی، قالب توزیع نهایی باشد (مانند دیسک صوتی CD).
.SS "زمان‌بندی (Timing)"
.TP
.B \-\-pad
درج نمونه‌های ورودی با مقدار صفر در ابتدا و انتها، تا خروجی شامل پاسخ متقارن کامل فیلتر حتی برای اولین و آخرین نمونه‌ها باشد.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت نبود خطا مقدار صفر، در غیر این صورت مقداری غیرصفر بازگردانده می‌شود.
.SH "نویسنده (AUTHOR)"
Fons Adriaensen (fons (at) linuxaudio.org)