نام (NAME)

zretune - بازنمونه‌برداری از فایل صوتی به‌منظور تغییر زیروبمی آن

خلاصه دستور (SYNOPSIS)

zretune [گزینه‌ها] input-file output-file

توضیحات (DESCRIPTION)

zretune یک فایل صوتی را با معکوس نسبتی که به‌صورت مستقیم یا برحسب سنت (cent) مشخص شده، بدون تغییر نرخ نمونه‌برداری اسمی بازنمونه‌برداری (resample) می‌کند. نتیجه این کار، تغییر زیروبمی موسیقایی و طول فایل است. ورودی می‌تواند هر فایل صوتی قابل خواندن توسط کتابخانه libsndfile باشد. نوع فایل خروجی یکی از قالب‌های WAV، WAVEX، CAF، AIFF یا FLAC است.

گزینه‌ها (OPTIONS)

--help: نمایش متن راهنمای کوتاه.
--ratio pitch ratio: محدوده پذیرفته‌شده بین 0.5 تا 2.0 است. محدوده کاربردی در عمل کوچک‌تر خواهد بود.
--cent pitch change in cents: تعداد سنت‌هایی که زیروبمی صدا بر اساس آن تغییر می‌کند. محدوده پذیرفته‌شده +/- 1200 سنت است؛ محدوده کاربردی در عمل در حدود +/- 100 سنت خواهد بود.

نوع فایل خروجی (Output file type)

--wav: تولید یک فایل WAV، یا برای بیش از ۲ کانال، یک فایل WAVEX. این گزینه پیش‌فرض است.
--amb: تولید یک فایل WAVEX با شناسه Ambisonic GUID. چنین فایل‌هایی باید دارای پسوند نام فایل .amb باشند.
--caf: تولید یک فایل Core Audio.
--aiff: تولید یک فایل AIFF.
--flac: تولید یک فایل FLAC.

قالب نمونه خروجی (Output sample format)

--16bit: قالب نمونه خروجی ۱۶ بیتی علامت‌دار (signed 16-bit) است. این گزینه همچنین استفاده از دیترینگ (dithering) را که در ادامه توضیح داده شده، فعال می‌کند.
--24bit: قالب نمونه خروجی ۲۴ بیتی است. این گزینه پیش‌فرض است.
--float: قالب نمونه خروجی ۳۲ بیتی ممیز شناور (floating point) است.

دیترینگ (Dithering)

--rec: افزودن نویز دیتر سفید با توزیع مستطیلی (rectangular distribution). این گزینه در صورتی که قرار باشد داده‌های خروجی دوباره پردازش شوند بهترین حالت است، هرچند در آن شرایط توصیه می‌شود از ۲۴ بیتی یا float استفاده شود.
--tri: افزودن نویز فیلترشده با توزیع مثلثی (triangular distribution). در مقایسه با دیتر مستطیلی، این گزینه چگالی نویز را در محدوده فرکانسی پایین‌تر کاهش می‌دهد.
--lips: استفاده از فیلتر بهینه بازخورد خطا که توسط استنلی لیپشیتز (Stanley Lipschitz) توصیف شده است. این گزینه در صورتی توصیه می‌شود که خروجی، قالب توزیع نهایی باشد (مانند دیسک صوتی CD).

زمان‌بندی (Timing)

--pad: درج نمونه‌های ورودی با مقدار صفر در ابتدا و انتها، تا خروجی شامل پاسخ متقارن کامل فیلتر حتی برای اولین و آخرین نمونه‌ها باشد.

وضعیت خروج (EXIT STATUS)

در صورت نبود خطا مقدار صفر، در غیر این صورت مقداری غیرصفر بازگردانده می‌شود.

نویسنده (AUTHOR)

Fons Adriaensen (fons (at) linuxaudio.org)