XWAX(1) General Commands Manual XWAX(1)

xwax - شبیه‌ساز صفحه وینیل در لینوکس

xwax [options] [-- path ...]

نرم‌افزار xwax یک شبیه‌ساز صفحه وینیل برای لینوکس است. این برنامه به دی‌جی‌ها و ترن‌تیبلیست‌ها امکان می‌دهد فایل‌های صوتی دیجیتال (مانند MP3،‏ Ogg Vorbis،‏ FLAC، AAC و موارد دیگر) را از طریق صفحه‌های وینیل تایم‌کد با استفاده از یک جفت گرامافون معمولی پخش و کنترل کنند.

ترتیب گزینه‌ها اهمیت دارد. بیشتر گزینه‌ها روی کتابخانه‌های موسیقی یا دک‌های بعدی اعمال می‌شوند که می‌توان آن‌ها را چندین بار مشخص کرد. بخش مثال‌ها (EXAMPLES) را در ادامه ببینید.

پویش برای یافتن قطعه‌ها یا فهرست پخش در مسیر داده‌شده. قطعه‌ها درون یک جعبه (crate) در کتابخانه موسیقی گروه‌بندی می‌شوند. مسیرها را می‌توان در انتهای دستور، پس از آرگومان -- نیز تعیین کرد.
استفاده از تایم‌کد مشخص‌شده برای دک‌های بعدی. برای فهرستی از تایم‌کدهای معتبر به --help مراجعه کنید. برای کنترل پخش، به سیگنال تایم‌کد متناظر روی صفحه وینیل نیاز خواهید داشت.
--33
تنظیم سرعت مرجع پخش برای دک‌های بعدی روی ۳۳ و یک‌سوم دور در دقیقه. این مقدار پیش‌فرض است.
--45
تنظیم سرعت مرجع پخش برای دک‌های بعدی روی ۴۵ دور در دقیقه.
--[no-]protect
محافظت در برابر بارگذاری قطعه جدید یا بازنشانی نقطه شروع قطعه در صورتی که دک در حال پخش باشد. بر دک‌های بعدی اعمال می‌شود و پیش‌فرض آن خاموش (غیرفعال) است.
تنظیم آستانه‌های نوفه (noise) در دک‌های بعدی برای سازگاری با سیگنال سطح کارتریج که به یک رابط صوتی سطح خط (line-level) متصل شده است. این قابلیت یک «پیش‌تقویت‌کننده نرم‌افزاری» است. مگر اینکه مسیر صوتی شما نویز پایینی داشته باشد، در غیر این صورت نتایج بدتری خواهد داد یا اصلاً کار نخواهد کرد؛ همواره استفاده از یک پیش‌تقویت‌کننده phono واقعی ترجیح داده می‌شود.
تنظیم آستانه‌های نوفه دک‌های بعدی روی سطوح استاندارد صوتی. این گزینه اثر --phono را خنثی می‌کند و حالت پیش‌فرض است.
اجرای برنامه داده‌شده جهت بارگذاری قطعه‌ها برای پخش. برنامه یک جریان صوتی علامت‌دار، لیتل‌اندین (little-endian)، ۱۶ بیتی و ۲ کاناله در خروجی استاندارد تولید می‌کند.
اجرای برنامه داده‌شده برای پویش کتابخانه‌های موسیقی. بر استفاده‌های بعدی از پرچم --crate اعمال می‌شود.
ایجاد یک دک که به هیچ دستگاه صوتی متصل نیست؛ برای آزمایش استفاده می‌شود.
قفل کردن حافظه مورد نیاز برای پردازش بی‌درنگ (real-time) در رم (RAM). این شامل قطعه‌های صوتی بارگذاری‌شده در حافظه نیز می‌شود که ممکن است حجیم باشند. از ulimit -l برای افزایش سقف حافظه مجاز هسته استفاده کنید.
تغییر اولویت بی‌درنگ (real-time priority) فرایند. مقدار 0 هیچ اولویتی به فرایند نمی‌دهد و فقط برای مقاصد آزمایشی کاربرد دارد.
تغییر ابعاد، موقعیت و مقیاس (بزرگ‌نمایی) صفحه نمایش به‌ترتیب. اندازه و موقعیت به SDL فرستاده می‌شود که ممکن است از آن برای تنظیم حالت نمایش یا اندازه پنجره X استفاده کند. بخش مثال‌ها (EXAMPLES) را ببینید.
درخواست از مدیر پنجره برای ایجاد پنجره‌ای «بدون حاشیه» که فاقد کنترل‌های معمول مانند نوار عنوان و دکمه‌ها است. این گزینه می‌تواند در ترکیب با پرچم --geometry برای سیستم‌های اختصاصی xwax سودمند باشد.
نمایش پیام راهنما و مقادیر پیش‌فرض.

گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از ALSA کامپایل شده باشد.

ایجاد دکی که از دستگاه ALSA داده‌شده استفاده می‌کند (مانند plughw:0).
تنظیم نرخ نمونه‌برداری برای دک‌های بعدی. پیش‌فرض ترجیح دادن 48000Hz است، اما در صورت عدم پشتیبانی از 44100Hz استفاده می‌شود. برای حفظ بهترین کارایی، تنها نرخ‌های نمونه‌برداری ارائه‌شده توسط سخت‌افزار در دسترس هستند.
تنظیم اندازه بافر ALSA برای دک‌های بعدی. مقادیر کوچک‌تر برای تأخیر کمتر و پاسخ‌دهی بهتر مناسب‌تر هستند. تنظیم مقدار بسیار پایین موجب ایجاد نویزها و اختلالات صوتی شنیداری و گزارش افت جریان داده (underrun) در کنسول می‌شود.

گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از JACK کامپایل شده باشد.

ایجاد دکی که به JACK متصل شده و تحت نام داده‌شده ثبت می‌شود.

برنامه xwax نرخ نمونه‌برداری را برای دستگاه‌های JACK تنظیم نمی‌کند؛ بلکه از نرخ نمونه‌برداری موجود در پیکربندی سراسری JACK استفاده می‌کند.

گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از OSS کامپایل شده باشد.

ایجاد دکی که از دستگاه OSS داده‌شده استفاده می‌کند (مانند /dev/dsp).
تنظیم نرخ نمونه‌برداری برای دک‌های بعدی. مقدار پیش‌فرض برای دستگاه‌های OSS برابر با 48000Hz است.
تنظیم تعداد بافرهای استفاده‌شده توسط دستگاه OSS. بر دک‌های بعدی اعمال می‌شود.
تنظیم اندازه بافر مورد استفاده توسط دستگاه OSS. اندازه واقعی بافر 2^n بایت است. بر دک‌های بعدی اعمال می‌شود.

گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از ALSA کامپایل شده باشد.

استفاده از یک یا دو کنترل‌کننده Dicer که به‌عنوان دستگاه ALSA داده‌شده متصل شده‌اند (مانند hw:Dicer). برای اطلاعات بیشتر بخش کنترل‌های NOVATION DICER (NOVATION DICER CONTROLS) را ببینید.

افزودن یک کنترل‌کننده سخت‌افزاری امکان کنترل دک‌های بعدی را تا سقف ظرفیت سخت‌افزار فراهم می‌کند.

پخش هر دک (جهت، سرعت و موقعیت) از طریق سیگنال تایم‌کد ورودی از گرامافون‌ها کنترل می‌شود. صفحه‌کلید کنترل‌های تکمیلی را فراهم می‌کند.

پیشوندهای "C-" و "S-" به‌ترتیب به معنای فشردن هم‌زمان کلید با کلیدهای 'Control' یا 'Shift' هستند.

کنترل‌های انتخاب قطعه:

حرکت دادن قطعه برجسته‌شده به بالا/پایین به اندازه یک ردیف.
پیمایش فهرست قطعه‌ها به بالا/پایین به اندازه یک صفحه.
جابه‌جایی به جعبه (crate) قبلی/بعدی.
تغییر وضعیت میان جعبه فعلی و جعبه «همه قطعه‌ها» (All records).
تغییر حالت مرتب‌سازی میان: نام هنرمند/قطعه، BPM و ترتیب «فهرست پخش» (playlist). ترتیب فهرست پخش همان ترتیبی است که قطعه‌ها از پویشگر بازگردانده شده‌اند.
پویش مجدد جعبه انتخاب‌شده فعلی.

برای پالایش (فیلتر کردن) فهرست فعلی قطعه‌ها، بخشی از نام قطعه را تایپ کنید. چندین جستجو را با فاصله جدا کرده و از backspace برای حذف استفاده کنید.

کنترل‌های مختص دک:

Deck 0 Deck 1 Deck 2
F1 F5 F9 بارگذاری قطعه انتخاب‌شده فعلی روی این دک
F2 F6 F10 بازنشانی شروع قطعه به موقعیت فعلی
F3 F7 F11 روشن/خاموش کردن کنترل تایم‌کد
C-F3 C-F7 C-F11 گردش میان تایم‌کدهای در دسترس

منظور از «تایم‌کدهای در دسترس»، مواردی هستند که پیش‌تر توسط هر پرچم --timecode در خط فرمان تعریف شده باشند.

کنترل‌های نمایشگر صوتی:

+, -
بزرگ‌نمایی/کوچک‌نمایی سنجه‌های صوتی نمای نزدیک برای تمام دک‌ها.

دستگاه Novation Dicer کنترل سخت‌افزاری نقاط cue را میسر می‌کند. این کنترل‌ها عبارتند از:

حالت cue: دکمه dice (۱-۵)
پرش به نقطه cue مشخص‌شده، یا ثبت آن در صورت تنظیم نبودن.
حالت loop-roll: دکمه dicer (۱-۵)
پرش لحظه‌ای (Punch) به نقطه cue تعیین‌شده، یا ثبت آن در صورت تنظیم نبودن. با رها کردن دکمه، پخش به حالت عادی بازمی‌گردد.
دکمه mode + دکمه dice (۱-۵)
پاک کردن نقطه cue مشخص‌شده.

دکمه‌های dice با روشن شدن نشان می‌دهند که نقطه cue متناظر آن‌ها تنظیم شده است.

راه‌اندازی دو دک با استفاده از یک دایرکتوری موسیقی و دستگاه‌های OSS:

xwax --crate ~/music --oss /dev/dsp --oss /dev/dsp1

مشابه بالا، اما با استفاده از دستگاه‌های ALSA:

xwax --crate ~/music --alsa hw:0 --alsa hw:1

راه‌اندازی دو دک با استفاده از تایم‌کد متفاوت برای هر دک:

xwax --crate ~/music --timecode serato_2a --alsa hw:0 --timecode mixvibes_v2 --alsa hw:1

مشابه بالا، اما با تنظیم دک دوم روی 45 RPM:

xwax --crate ~/music --timecode serato_2a --alsa hw:0 --timecode mixvibes_v2 --45 --alsa hw:1

تنظیم پیش‌فرض با تایم‌کد یکسان، همراه با امکان تغییر آن در حین اجرا:

xwax --crate ~/music --timecode serato_2a --timecode mixvibes_v2 --alsa hw:0 --alsa hw:1

راه‌اندازی سه دک به طوری که دک سوم نرخ نمونه‌برداری بالاتری دارد:

xwax --crate ~/music --rate 48000 --alsa hw:0 --alsa hw:1 --rate 96000 --alsa hw:2

استفاده هم‌زمان از هر سه نوع دستگاه، یک دک روی هر کدام:

xwax --crate ~/music --alsa hw:0 --oss /dev/dsp1 -j jack0

پویش چندین کتابخانه موسیقی:

xwax --crate ~/music --crate ~/sounds --crate ~/mixes --alsa hw:0

نگارش خلاصه‌تری از دستور بالا که نوشتن آن در اسکریپت نیز آسان‌تر است:

xwax --alsa hw:0 -- ~/music ~/sounds ~/mixes

بارگذاری تمام زیردایرکتوری‌ها و اختصاص هر یک به جعبه مجزا، با کمک نویسه عام پوسته:

xwax --alsa hw:0 -- ~/music/*

پویش کتابخانه موسیقی دوم با استفاده از یک اسکریپت سفارشی:

xwax --crate ~/music --scan ./custom-scan --crate ~/sounds --alsa hw:0

کنترل دو دک با سخت‌افزار Dicer:

xwax --dicer hw:Dicer --alsa hw:0 --alsa hw:1

استفاده از تفکیک‌پذیری بالا و بزرگ‌نمایی رابط کاربری:

xwax --geometry 1920x1200/1.8 --alsa hw:0

http://xwax.org

Mark Hills <mark@xwax.org>