'\" t
.TH XWAX "1"
.SH "نام (NAME)"
xwax \- شبیه‌ساز صفحه وینیل در لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.B xwax
[\fIoptions\fR] [-- \fIpath\fR ...]
.SH "توضیحات (DESCRIPTION)"
.P
نرم‌افزار xwax یک شبیه‌ساز صفحه وینیل برای لینوکس است. این برنامه به دی‌جی‌ها و
ترن‌تیبلیست‌ها امکان می‌دهد فایل‌های صوتی دیجیتال (مانند MP3،‏ Ogg Vorbis،‏ FLAC،
AAC و موارد دیگر) را از طریق صفحه‌های وینیل تایم‌کد با استفاده از یک جفت گرامافون
معمولی پخش و کنترل کنند.
.SH "گزینه‌ها (OPTIONS)"
.P
ترتیب گزینه‌ها اهمیت دارد. بیشتر گزینه‌ها روی کتابخانه‌های موسیقی یا دک‌های بعدی
اعمال می‌شوند که می‌توان آن‌ها را چندین بار مشخص کرد. بخش
.B مثال‌ها (EXAMPLES)
را در ادامه ببینید.
.TP
.B \-l, \-\-crate \fIpath\fR
پویش برای یافتن قطعه‌ها یا فهرست پخش در مسیر داده‌شده. قطعه‌ها درون یک جعبه (crate)
در کتابخانه موسیقی گروه‌بندی می‌شوند. مسیرها را می‌توان در انتهای دستور، پس از آرگومان
.B \-\-
نیز تعیین کرد.
.TP
.B \-\-timecode \fIname\fR
استفاده از تایم‌کد مشخص‌شده برای دک‌های بعدی. برای فهرستی از تایم‌کدهای معتبر به
.B \-\-help
مراجعه کنید. برای کنترل پخش، به سیگنال تایم‌کد متناظر روی صفحه وینیل نیاز خواهید داشت.
.TP
.B \-\-33
تنظیم سرعت مرجع پخش برای دک‌های بعدی روی ۳۳ و یک‌سوم دور در دقیقه. این مقدار پیش‌فرض است.
.TP
.B \-\-45
تنظیم سرعت مرجع پخش برای دک‌های بعدی روی ۴۵ دور در دقیقه.
.TP
.B \-\-[no\-]protect
محافظت در برابر بارگذاری قطعه جدید یا بازنشانی نقطه شروع قطعه در صورتی که دک در حال پخش باشد.
بر دک‌های بعدی اعمال می‌شود و پیش‌فرض آن خاموش (غیرفعال) است.
.TP
.B \-\-phono
تنظیم آستانه‌های نوفه (noise) در دک‌های بعدی برای سازگاری با سیگنال سطح کارتریج که به
یک رابط صوتی سطح خط (line-level) متصل شده است. این قابلیت یک «پیش‌تقویت‌کننده نرم‌افزاری»
است. مگر اینکه مسیر صوتی شما نویز پایینی داشته باشد، در غیر این صورت نتایج بدتری خواهد داد
یا اصلاً کار نخواهد کرد؛ همواره استفاده از یک پیش‌تقویت‌کننده phono واقعی ترجیح داده می‌شود.
.TP
.B \-\-line
تنظیم آستانه‌های نوفه دک‌های بعدی روی سطوح استاندارد صوتی. این گزینه اثر
.B \-\-phono
را خنثی می‌کند و حالت پیش‌فرض است.
.TP
.B \-\-import \fIpath\fR
اجرای برنامه داده‌شده جهت بارگذاری قطعه‌ها برای پخش. برنامه یک جریان صوتی علامت‌دار،
لیتل‌اندین (little-endian)، ۱۶ بیتی و ۲ کاناله در خروجی استاندارد تولید می‌کند.
.TP
.B \-\-scan \fIpath\fR
اجرای برنامه داده‌شده برای پویش کتابخانه‌های موسیقی. بر استفاده‌های بعدی از پرچم
.B \-\-crate
اعمال می‌شود.
.TP
.B \-\-dummy
ایجاد یک دک که به هیچ دستگاه صوتی متصل نیست؛ برای آزمایش استفاده می‌شود.
.TP
.B \-\-lock\-ram
قفل کردن حافظه مورد نیاز برای پردازش بی‌درنگ (real-time) در رم (RAM).
این شامل قطعه‌های صوتی بارگذاری‌شده در حافظه نیز می‌شود که ممکن است حجیم باشند.
از
.B ulimit \-l
برای افزایش سقف حافظه مجاز هسته استفاده کنید.
.TP
.B \-\-rtprio \fIn\fR
تغییر اولویت بی‌درنگ (real-time priority) فرایند. مقدار 0 هیچ اولویتی به فرایند
نمی‌دهد و فقط برای مقاصد آزمایشی کاربرد دارد.
.TP
.B \-\-geometry [\fIn\fRx\fIn\fR][+\fIn\fR+\fIn\fR][/\fIf\fR]
تغییر ابعاد، موقعیت و مقیاس (بزرگ‌نمایی) صفحه نمایش به‌ترتیب.
اندازه و موقعیت به SDL فرستاده می‌شود که ممکن است از آن برای تنظیم حالت نمایش
یا اندازه پنجره X استفاده کند. بخش
.B مثال‌ها (EXAMPLES)
را ببینید.
.TP
.B \-\-no\-decor
درخواست از مدیر پنجره برای ایجاد پنجره‌ای «بدون حاشیه» که فاقد کنترل‌های معمول
مانند نوار عنوان و دکمه‌ها است. این گزینه می‌تواند در ترکیب با پرچم
.B \-\-geometry
برای سیستم‌های اختصاصی xwax سودمند باشد.
.TP
.B \-h, \-\-help
نمایش پیام راهنما و مقادیر پیش‌فرض.
.SH "گزینه‌های دستگاه ALSA (ALSA DEVICE OPTIONS)"
.P
گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از ALSA کامپایل شده باشد.
.TP
.B \-\-alsa \fIdevice\fR
ایجاد دکی که از دستگاه ALSA داده‌شده استفاده می‌کند (مانند plughw:0).
.TP
.B \-\-rate \fIhz\fR
تنظیم نرخ نمونه‌برداری برای دک‌های بعدی.
پیش‌فرض ترجیح دادن 48000Hz است، اما در صورت عدم پشتیبانی از 44100Hz استفاده می‌شود.
برای حفظ بهترین کارایی، تنها نرخ‌های نمونه‌برداری ارائه‌شده توسط سخت‌افزار در دسترس هستند.
.TP
.B \-\-buffer \fIsamples\fR
تنظیم اندازه بافر ALSA برای دک‌های بعدی.
مقادیر کوچک‌تر برای تأخیر کمتر و پاسخ‌دهی بهتر مناسب‌تر هستند.
تنظیم مقدار بسیار پایین موجب ایجاد نویزها و اختلالات صوتی شنیداری و گزارش افت جریان داده
(underrun) در کنسول می‌شود.
.SH "گزینه‌های دستگاه JACK (JACK DEVICE OPTIONS)"
.P
گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از JACK کامپایل شده باشد.
.TP
.B \-\-jack \fIname\fR
ایجاد دکی که به JACK متصل شده و تحت نام داده‌شده ثبت می‌شود.
.P
برنامه xwax نرخ نمونه‌برداری را برای دستگاه‌های JACK تنظیم نمی‌کند؛ بلکه از نرخ
نمونه‌برداری موجود در پیکربندی سراسری JACK استفاده می‌کند.
.SH "گزینه‌های دستگاه OSS (OSS DEVICE OPTIONS)"
.P
گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از OSS کامپایل شده باشد.
.TP
.B \-\-oss \fIpathname\fR
ایجاد دکی که از دستگاه OSS داده‌شده استفاده می‌کند (مانند /dev/dsp).
.TP
.B \-\-rate \fIhz\fR
تنظیم نرخ نمونه‌برداری برای دک‌های بعدی. مقدار پیش‌فرض برای دستگاه‌های OSS برابر با 48000Hz است.
.TP
.B \-\-oss\-buffers \fIn\fR
تنظیم تعداد بافرهای استفاده‌شده توسط دستگاه OSS. بر دک‌های بعدی اعمال می‌شود.
.TP
.B \-\-oss\-fragment \fIn\fR
تنظیم اندازه بافر مورد استفاده توسط دستگاه OSS. اندازه واقعی بافر 2^n بایت است.
بر دک‌های بعدی اعمال می‌شود.
.SH "گزینه‌های کنترل‌کننده سخت‌افزاری (HARDWARE CONTROLLER OPTIONS)"
.P
گزینه‌های زیر تنها زمانی در دسترس هستند که xwax با پشتیبانی از ALSA کامپایل شده باشد.
.TP
.B \-\-dicer \fIdevice\fR
استفاده از یک یا دو کنترل‌کننده Dicer که به‌عنوان دستگاه ALSA داده‌شده متصل شده‌اند
(مانند hw:Dicer). برای اطلاعات بیشتر بخش
.B کنترل‌های NOVATION DICER (NOVATION DICER CONTROLS)
را ببینید.
.P
افزودن یک کنترل‌کننده سخت‌افزاری امکان کنترل دک‌های بعدی را تا سقف ظرفیت سخت‌افزار فراهم می‌کند.
.SH "کلیدهای کنترلی (KEYBOARD CONTROLS)"
.P
پخش هر دک (جهت، سرعت و موقعیت) از طریق سیگنال تایم‌کد ورودی از گرامافون‌ها کنترل می‌شود.
صفحه‌کلید کنترل‌های تکمیلی را فراهم می‌کند.
.P
پیشوندهای "C-" و "S-" به‌ترتیب به معنای فشردن هم‌زمان کلید با کلیدهای 'Control' یا 'Shift' هستند.
.P
کنترل‌های انتخاب قطعه:
.TP
cursor up, cursor down
حرکت دادن قطعه برجسته‌شده به بالا/پایین به اندازه یک ردیف.
.TP
page up, page down
پیمایش فهرست قطعه‌ها به بالا/پایین به اندازه یک صفحه.
.TP
left cursor, right cursor
جابه‌جایی به جعبه (crate) قبلی/بعدی.
.TP
tab
تغییر وضعیت میان جعبه فعلی و جعبه «همه قطعه‌ها» (All records).
.TP
C-tab
تغییر حالت مرتب‌سازی میان: نام هنرمند/قطعه، BPM و ترتیب «فهرست پخش» (playlist).
ترتیب فهرست پخش همان ترتیبی است که قطعه‌ها از پویشگر بازگردانده شده‌اند.
.TP
C-S-tab
پویش مجدد جعبه انتخاب‌شده فعلی.
.P
برای پالایش (فیلتر کردن) فهرست فعلی قطعه‌ها، بخشی از نام قطعه را تایپ کنید.
چندین جستجو را با فاصله جدا کرده و از backspace برای حذف استفاده کنید.
.P
کنترل‌های مختص دک:
.TS
l l l l.
Deck 0	Deck 1	Deck 2
F1	F5	F9	بارگذاری قطعه انتخاب‌شده فعلی روی این دک
F2	F6	F10	بازنشانی شروع قطعه به موقعیت فعلی
F3	F7	F11	روشن/خاموش کردن کنترل تایم‌کد
C-F3	C-F7	C-F11	گردش میان تایم‌کدهای در دسترس
.TE
.P
منظور از «تایم‌کدهای در دسترس»، مواردی هستند که پیش‌تر توسط هر پرچم
.B \-\-timecode
در خط فرمان تعریف شده باشند.
.P
کنترل‌های نمایشگر صوتی:
.TP
+, \-
بزرگ‌نمایی/کوچک‌نمایی سنجه‌های صوتی نمای نزدیک برای تمام دک‌ها.
.SH "کنترل‌های NOVATION DICER (NOVATION DICER CONTROLS)"
.P
دستگاه Novation Dicer کنترل سخت‌افزاری نقاط cue را میسر می‌کند. این کنترل‌ها عبارتند از:
.TP
حالت cue: دکمه dice (۱-۵)
پرش به نقطه cue مشخص‌شده، یا ثبت آن در صورت تنظیم نبودن.
.TP
حالت loop-roll: دکمه dicer (۱-۵)
پرش لحظه‌ای (Punch) به نقطه cue تعیین‌شده، یا ثبت آن در صورت تنظیم نبودن. با رها کردن دکمه،
پخش به حالت عادی بازمی‌گردد.
.TP
دکمه mode + دکمه dice (۱-۵)
پاک کردن نقطه cue مشخص‌شده.
.P
دکمه‌های dice با روشن شدن نشان می‌دهند که نقطه cue متناظر آن‌ها تنظیم شده است.
.SH "مثال‌ها (EXAMPLES)"
.P
راه‌اندازی دو دک با استفاده از یک دایرکتوری موسیقی و دستگاه‌های OSS:
.sp
.RS
xwax \-\-crate ~/music \-\-oss /dev/dsp \-\-oss /dev/dsp1
.RE
.P
مشابه بالا، اما با استفاده از دستگاه‌های ALSA:
.sp
.RS
xwax \-\-crate ~/music \-\-alsa hw:0 \-\-alsa hw:1
.RE
.P
راه‌اندازی دو دک با استفاده از تایم‌کد متفاوت برای هر دک:
.sp
.RS
xwax \-\-crate ~/music \-\-timecode serato_2a \-\-alsa hw:0 \-\-timecode mixvibes_v2 \-\-alsa hw:1
.RE
.P
مشابه بالا، اما با تنظیم دک دوم روی 45 RPM:
.sp
.RS
xwax \-\-crate ~/music \-\-timecode serato_2a \-\-alsa hw:0 \-\-timecode mixvibes_v2 \-\-45 \-\-alsa hw:1
.RE
.P
تنظیم پیش‌فرض با تایم‌کد یکسان، همراه با امکان تغییر آن در حین اجرا:
.sp
.RS
xwax \-\-crate ~/music \-\-timecode serato_2a \-\-timecode mixvibes_v2 \-\-alsa hw:0 \-\-alsa hw:1
.RE
.P
راه‌اندازی سه دک به طوری که دک سوم نرخ نمونه‌برداری بالاتری دارد:
.sp
.RS
xwax \-\-crate ~/music \-\-rate 48000 \-\-alsa hw:0 \-\-alsa hw:1 \-\-rate 96000 \-\-alsa hw:2
.RE
.P
استفاده هم‌زمان از هر سه نوع دستگاه، یک دک روی هر کدام:
.sp
.RS
xwax \-\-crate ~/music \-\-alsa hw:0 \-\-oss /dev/dsp1 \-j jack0
.RE
.P
پویش چندین کتابخانه موسیقی:
.sp
.RS
xwax \-\-crate ~/music \-\-crate ~/sounds \-\-crate ~/mixes \-\-alsa hw:0
.RE
.P
نگارش خلاصه‌تری از دستور بالا که نوشتن آن در اسکریپت نیز آسان‌تر است:
.sp
.RS
xwax \-\-alsa hw:0 -- ~/music ~/sounds ~/mixes
.RE
.P
بارگذاری تمام زیردایرکتوری‌ها و اختصاص هر یک به جعبه مجزا، با کمک نویسه عام پوسته:
.sp
.RS
xwax \-\-alsa hw:0 -- ~/music/*
.RE
.P
پویش کتابخانه موسیقی دوم با استفاده از یک اسکریپت سفارشی:
.sp
.RS
xwax \-\-crate ~/music \-\-scan ./custom-scan \-\-crate ~/sounds \-\-alsa hw:0
.RE
.P
کنترل دو دک با سخت‌افزار Dicer:
.sp
.RS
xwax \-\-dicer hw:Dicer \-\-alsa hw:0 \-\-alsa hw:1
.RE
.P
استفاده از تفکیک‌پذیری بالا و بزرگ‌نمایی رابط کاربری:
.sp
.RS
xwax \-\-geometry 1920x1200/1.8 \-\-alsa hw:0
.RE
.SH "صفحه خانگی (HOMEPAGE)"
http://xwax.org
.SH "نویسنده (AUTHOR)"
Mark Hills <mark@xwax.org>