.\" # Copyright 2024-2025 David Robillard <d@drobilla.net>
.\" # SPDX-License-Identifier: ISC
.Dd August 1, 2025
.Dt JALV.GTK3 1
.Os
.Sh "نام (NAME)"
.Nm jalv.gtk3
.Nd اجرای یک پلاگین LV2 با واسط کاربری GTK3
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm jalv.gtk3
.Op Fl dghmpstx
.Op Fl b , Fl Fl buffer-size Ns = Ns Ar size
.Op Fl c , Fl Fl control Ns = Ns Ar setting
.Op Fl l , Fl Fl load Ns = Ns Ar dir
.Op Fl n , Fl Fl jack-name Ns = Ns Ar name
.Op Fl P , Fl Fl preset Ns = Ns Ar uri
.Op Fl r , Fl Fl update-frequency Ns = Ns Ar hz
.Op Fl S , Fl Fl scale-factor Ns = Ns Ar scale
.Op Fl U , Fl Fl ui-uri Ns = Ns Ar uri
.Op Ar plugin_state
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک میزبان سادهٔ LV2 است که یک تک‌پلاگین را اجرا می‌کند.
این نسخه دارای یک واسط کاربری GTK3 است که یا کنترل‌های عمومی و یا واسط گرافیکی سفارشی (GUI) پلاگین را نمایش می‌دهد.
.Pp
.Nm
دارای یک آرگومان موضعی است که می‌تواند URI یک پلاگین، URI یک پیش‌تنظیم (preset)، یا مسیر یک بسته (bundle) یا فایل داده باشد که آن را توصیف می‌کند.
اگر هیچ مقداری داده نشود، ابتدا پنجرهٔ انتخاب پلاگین نمایش داده می‌شود.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width 3n
.It Fl b , Fl Fl buffer-size Ns = Ns Ar size
اندازهٔ بافر برای ارتباط میان پلاگین و واسط کاربری (plugin <=> UI).
.It Fl c , Fl Fl control Ns = Ns Ar setting
تنظیم مقدار کنترل، برای مثال،
.Fl c Ar vol=1.4
که در آن
.Dq vol
نماد یک درگاه کنترلی روی پلاگین است.
.It Fl d , Fl Fl dump
تخلیه و ثبت ارتباطات میان پلاگین و واسط کاربری (plugin <=> UI).
.It Fl g , Fl Fl generic-ui
نمایش واسط کاربری عمومی به‌جای واسط گرافیکی سفارشی پلاگین.
.It Fl h , Fl Fl help
چاپ گزینه‌های خط فرمان.
.It Fl l Ar frames
طول یک بلوک صوتی.
.It Fl m , Fl Fl minimal-ui
نمایش تنها واسط کاربری پلاگین بدون هیچ مورد اضافی برنامه.
.It Fl n , Fl Fl jack-name Ns = Ns Ar name
استفاده از نام کلاینت JACK داده‌شده.
توجه داشته باشید که JACK ممکن است در صورت نیاز نام را تغییر دهد، مگر اینکه
.Fl x
نیز مشخص شده باشد.
.It Fl P , Fl Fl preset Ns = Ns Ar uri
بارگذاری پیش‌تنظیم داده‌شده پیش از اجرای پلاگین.
.It Fl p , Fl Fl print-controls
چاپ تغییرات خروجی کنترل در
.Dv stdout .
.It Fl r , Fl Fl update-frequency Ns = Ns Ar hz
تنظیم بسامد به‌روزرسانی واسط کاربری.
به‌طور پیش‌فرض از نرخ نوسازی نمایشگر، معمولاً ۳۰ یا ۶۰ هرتز استفاده می‌شود.
.It Fl S , Fl Fl scale-factor Ns = Ns Ar factor
جایگزینی ضریب مقیاس واسط کاربری.
.It Fl s , Fl Fl show-hidden
نمایش کنترل‌هایی که معمولاً پنهان هستند.
.It Fl t , Fl Fl trace
چاپ پیام‌های ردگیری اشکال‌زدایی.
این گزینه لاگ
.Dq trace
در LV2 را فعال می‌کند، که توسط برخی پلاگین‌ها برای چاپ خروجی اشکال‌زدایی به کار می‌رود.
برخی پیام‌های خطای داخلی اضافی نیز فعال می‌شوند.
توجه داشته باشید که این ممکن است در ریسهٔ صوتی چاپ شود که می‌تواند باعث قطعی صدا (dropouts) شود.
.It Fl U , Fl Fl ui-uri Ns = Ns Ar uri
بارگذاری واسط کاربری با URI داده‌شده.
.It Fl x , Fl Fl exact-jack-name
استفاده تنها از نام دقیق کلاینت JACK ارائه‌شده توسط
.Fl n
یا خروج در صورتی که در دسترس نباشد.
.El
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width LV2_PATH
.It Ev LV2_PATH
مسیر جستجو برای بسته‌های LV2، در قالب
.Ev PATH .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr jalv 1 ,
.Xr jalv.qt5 1
.Sh "نویسندگان (AUTHORS)"
برنامهٔ jalv توسط
.An David Robillard
.Aq Mt d@drobilla.net
و با مشارکت دیگران نوشته شده است.
واسط گرافیکی اولیهٔ GTK توسط Alexandros Theodotou و Nick Lanham اضافه شد.