.\" # Copyright 2024-2025 David Robillard <d@drobilla.net>
.\" # SPDX-License-Identifier: ISC
.Dd August 1, 2025
.Dt JALV 1
.Os
.Sh "نام (NAME)"
.Nm jalv
.Nd اجرای یک افزونه LV2 با رابط خط فرمان
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm jalv
.Op Fl dhipstx
.Op Fl b Ar size
.Op Fl c Ar symbol=value
.Op Fl U Ar ui_uri
.Op Fl l Ar dir
.Op Fl n Ar name
.Ar plugin_state
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک میزبان ساده LV2 است که یک افزونه را اجرا می‌کند.
این ابزار دارای چندین نسخه است و این نسخه دارای یک رابط خط فرمان تعاملی می‌باشد.
.Pp
.Nm
دارای یک آرگومان موضعی است که می‌تواند یک URI افزونه، یک URI پیش‌تنظیم، یا مسیر یک بسته یا فایل داده توصیف‌کننده آن باشد.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width 3n
.It Fl b Ar bytes
اندازه بافر برای ارتباط میان افزونه و رابط کاربری.
مقدار پیش‌فرض باید کافی باشد،
اما در صورت بروز سرریز،
می‌توان از این گزینه برای تخصیص فضای بیشتر استفاده کرد.
.It Fl c Ar symbol=value
تنظیم مقدار کنترل، برای مثال،
.Fl c Ar vol=1.4
که در آن
.Dq vol
نماد یک درگاه کنترلی روی افزونه است.
.It Fl d
تخلیه ارتباط میان افزونه و رابط کاربری در
.Dv stdout .
توجه داشته باشید که این ممکن است حجم بسیار زیادی از متن را چاپ کند،
بنابراین ارسال خروجی با لوله (pipe) به یک پیجر یا فایل توصیه می‌شود.
.It Fl h
چاپ گزینه‌های خط فرمان و خروج.
.It Fl i
نادیده گرفتن ورودی در
.Dv stdin
و اجرا به صورت غیرتعاملی.
.It Fl l Ar frames
طول یک بلوک صوتی.
.It Fl n Ar name
استفاده از نام داده‌شده برای کلاینت JACK.
توجه داشته باشید که JACK ممکن است در صورت نیاز نام را تغییر دهد مگر اینکه گزینه
.Fl x
نیز داده شده باشد.
.It Fl p
چاپ تغییرات خروجی کنترل در
.Dv stdout .
.It Fl s
نمایش رابط کاربری افزونه در صورت امکان.
این گزینه فقط زمانی کار می‌کند که افزونه‌ها رابط کاربری‌ای ارائه دهند که از رابط غیرقابل تعبیه
.Li showHide
استفاده کند.
برای رابط‌های کاربری تعبیه‌پذیر، به جای آن از
.Xr jalv.gtk3 1
استفاده کنید.
.It Fl t
چاپ پیام‌های ردگیری اشکال‌زدایی.
این گزینه لاگ LV2 از نوع
.Dq trace
را فعال می‌کند که توسط برخی افزونه‌ها برای چاپ خروجی اشکال‌زدایی استفاده می‌شود.
برخی پیام‌های خطای داخلی اضافه نیز فعال می‌شوند.
توجه داشته باشید که این ممکن است در ریسمان صوتی چاپ شود که می‌تواند باعث پرش صدا شود.
.It Fl U Ar uri
بارگذاری رابط کاربری با URI داده‌شده.
معمولاً در هر بستر تنها یک رابط کاربری مناسب در دسترس است
که به طور پیش‌فرض استفاده می‌شود.
اگر چند مورد وجود داشته باشد، می‌توان از این گزینه برای انتخاب رابط کاربری بارگذاری‌شده استفاده کرد.
.It Fl V
چاپ اطلاعات نسخه و خروج.
.It Fl x
استفاده دقیق و انحصاری از نام کلاینت JACK داده‌شده توسط
.Fl n
یا خروج در صورت عدم دسترسی به آن.
.El
.Sh "دستورات (COMMANDS)"
اعلان خط فرمان Jalv از چندین دستور برای کنترل تعاملی پشتیبانی می‌کند:
.Pp
.Bl -tag -width 16n -compact
.It Ic help
نمایش پیام راهنما.
.It Ic controls
چاپ مقادیر کنترلی قابل تنظیم.
.It Ic monitors
چاپ مقادیر کنترلی خروجی.
.It Ic presets
چاپ پیش‌تنظیم‌های موجود.
.It Ic preset Ar uri
.It Ic preset Ar path
بارگذاری و اعمال پیش‌تنظیم.
.It Ic quit
خروج از برنامه.
.It Ic set Ar index Ar value
تنظیم مقدار کنترل بر اساس شناسه درگاه (یک عدد صحیح غیرمنفی).
.It Ic set Ar symbol Ar value
تنظیم مقدار کنترل بر اساس نماد (یک شناسه متنی ساده).
.El
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width LV2_PATH
.It Ev LV2_PATH
مسیر جستجو برای بسته‌های LV2، در قالب
.Ev PATH .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr jalv.gtk3 1 ,
.Xr jalv.qt5 1 ,
.Xr lv2ls 1
.Sh "نویسندگان (AUTHORS)"
برنامه
.Nm
توسط
.An David Robillard
.Aq Mt d@drobilla.net ,
با مشارکت
Robin Gareus,
Hanspeter Portner,
و دیگران نوشته شده است.