نام (NAME)

jack-dssi-host - یک میزبان سادهٔ JACK برای افزونه‌های DSSI

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

jack-dssi-host [-v] [-a] [-n] [-p <projdir>] [-c <cname>] [-<i>] <libname>[:<label>] [...]

توضیحات (DESCRIPTION)

jack-dssi-host یک میزبان سادهٔ DSSI است که به رویدادهای MIDI روی یک درگاه ALSA sequencer گوش می‌دهد، آن‌ها را به افزونه‌های ساز DSSI تحویل داده و صدای حاصل را از طریق JACK پخش می‌کند.
jack-dssi-host می‌تواند تا ۱۶ نمونه از افزونه‌های ساز DSSI را میزبانی کند که به هر یک از آن‌ها به‌ترتیب یک کانال MIDI از ۱ تا ۱۶ اختصاص داده می‌شود. خروجی‌های افزونه (اگر گزینهٔ -a مشخص نشده باشد) به‌ترتیب به درگاه‌های فیزیکی خروجیِ موجود در JACK متصل می‌شوند، و در صورت اتمام درگاه‌های در‌دسترس، اتصال مجدداً از اولین درگاه JACK ادامه می‌یابد. رابط‌های کاربری (UI) افزونه برای هر نمونه اجرا می‌شوند (مگر اینکه گزینهٔ -n مشخص شده باشد). برنامهٔ jack-dssi-host هنگامی که آخرین رابط کاربری افزونه بسته شود، خارج خواهد شد.
به‌عنوان یک حالت خاص، اگر jack-dssi-host با نامی غیر از «jack-dssi-host» اجرا شود، و اگر آن نام (به‌همراه پسوند .so) در مسیر جستجوی DSSI_PATH (بخش محیط (ENVIRONMENT) در زیر را ببینید) به‌عنوان یک کتابخانهٔ اشتراکی معتبر افزونه یافت شود، و در صورتی که هیچ آرگومان خط فرمان دیگری داده نشده باشد، اولین افزونه در آن کتابخانه به‌طور خودکار بارگذاری خواهد شد. این قابلیت روشی آسان برای اجرای یک افزونه را با ایجاد یک پیوند نمادین (symlink) از نام پایهٔ افزونه به jack-dssi-host فراهم می‌کند.

گزینه‌ها (OPTIONS)

-v

حالت پرگویی (Verbose).

-a

غیرفعال کردن اتصال خودکار خروجی‌ها به خروجی‌های فیزیکی JACK.

-n

غیرفعال کردن اجرای خودکار رابط‌های کاربری افزونه (UIs).

-p <projdir>

دایرکتوری پروژه برای ارسال به افزونه و رابط کاربری.

-c <cname>

نام کلاینت جهت استفاده برای ALSA و JACK.

-<i>

تعداد نمونه‌های افزونهٔ بعدی جهت اجرا (حداکثر ۱۶ در مجموع، پیش‌فرض ۱).

<libname>

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

<label>

برچسب افزونه برای بارگذاری از کتابخانه. در صورت حذف این مقدار، اولین افزونه در کتابخانه استفاده می‌شود.

[...]

تعداد نمونه‌ها، افزونه‌ها و برچسب‌های بیشتر به‌صورت اختیاری.

مثال‌ها (EXAMPLES)

jack-dssi-host -2 lib1.so -1 lib2.so:fuzzy
دو نمونه از اولین افزونهٔ یافت‌شده در lib1.so را اجرا می‌کند که به کانال‌های MIDI شمارهٔ ۱ و ۲ اختصاص یافته و به اولین خروجی‌های موجود JACK متصل می‌شوند، و یک نمونه از افزونهٔ «fuzzy» در lib2.so روی کانال ۳ MIDI که به خروجیِ موجود بعدی JACK متصل می‌گردد.

محیط (ENVIRONMENT)

jack-dssi-host برای یافتن کتابخانه‌های اشتراکی افزونه‌ها، دایرکتوری‌های مشخص‌شده توسط متغیر محیطی DSSI_PATH را جستجو خواهد کرد؛ این متغیر فهرستی از دایرکتوری‌ها است که با دونقطه (:) از هم جدا شده‌اند. اگر DSSI_PATH تنظیم نشده باشد، مسیر جستجوی پیش‌فرضی شامل /usr/lib/dssi، /usr/local/lib/dssi و (به شرط تنظیم بودن متغیر محیطی HOME) $HOME/.dssi استفاده می‌شود.

نویسندگان (AUTHORS)

این صفحهٔ راهنما در ابتدا توسط Mark Hymers بر اساس متن راهنمای برنامه و برای پروژهٔ Debian نوشته شده است (اما دیگران نیز می‌توانند آزادانه از آن استفاده کنند).