.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "wl-present" "1" "2026-02-10"
.PP
.SH "نام (NAME)"
.PP
wl-present \- یک کلاینت تعاملی برای \fBwl-mirror\fR(1)
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBwl-present\fR [OPTIONS] <COMMAND> [args.\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBwl-present\fR یک پوشش (wrapper) برای \fBwl-mirror\fR(1) است که از حالت جاری‌سازی (streaming) آن به همراه \fBpipectl\fR(1) برای کنترل تعاملی محتوای در حال ضبط استفاده می‌کند.\&
.PP
دستورهای فرعی \fBwl-present\fR طوری طراحی شده‌اند که برای دسترسی سریع و آسان، به کلیدهای میانبر در کامپوزیتور wayland شما متصل شوند.\&
.PP
.SH "دستورها (COMMANDS)"
.PP
\fBhelp\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fBmirror\fR [OUTPUT] [OPTIONS]
.RS 4
شروع \fBwl-mirror\fR(1) برای ضبط OUTPUT.\& اگر خروجی مشخص نشود، از \fBslurp\fR(1) برای انتخاب خروجی یا ناحیه جهت ضبط استفاده می‌شود.\& اگر گزینه‌های OPTIONS اضافی مشخص شده باشد، به \fBwl-mirror\fR ارسال خواهند شد.\&
.PP
.RE
\fBset-output\fR [OUTPUT]
.RS 4
تنظیم خروجی ضبط‌شده برای یک نشست در حال اجرای \fBwl-present\fR.\& اگر خروجی مشخص نشود، از \fBslurp\fR(1) برای انتخاب خروجی جهت ضبط استفاده می‌شود.\&
.PP
.RE
\fBset-region\fR [REGION]
\fBunset-region\fR
.RS 4
تنظیم ناحیه ضبط‌شده برای یک نشست در حال اجرای \fBwl-present\fR.\& اگر ناحیه‌ای مشخص نشود، از \fBslurp\fR(1) برای انتخاب ناحیه جهت ضبط استفاده می‌شود.\&
.PP
.RE
\fBset-scaling\fR [SCALING]
.RS 4
تنظیم حالت مقیاس‌بندی برای یک نشست در حال اجرای \fBwl-present\fR.\& اگر مقیاسی مشخص نشود، از \fBdmenu\fR(1) (یا یک جایگزین سازگار) برای انتخاب حالت مقیاس‌بندی استفاده می‌شود.\&
.PP
.RE
\fBfreeze\fR,
\fBunfreeze\fR,
\fBtoggle-freeze\fR
.RS 4
تنظیم وضعیت انجماد (توقف فریم) برای یک نشست در حال اجرای \fBwl-present\fR.\&
.PP
.RE
\fBfullscreen\fR
\fBunfullscreen\fR
.RS 4
تنظیم وضعیت تمام‌صفحه برای یک نشست در حال اجرای \fBwl-present\fR.\&
.PP
.RE
\fBfullscreen-output\fR [OUTPUT]
.RS 4
تنظیم خروجی مقصد تمام‌صفحه برای یک نشست در حال اجرای \fBwl-present\fR؛ متضمن \fBfullscreen\fR است.\&
.PP
.RE
\fBno-fullscreen-output\fR
.RS 4
لغو خروجی مقصد تمام‌صفحه که قبلاً تنظیم شده است در یک نشست در حال اجرای \fBwl-present\fR؛ متضمن \fBunfullscreen\fR است.\&
.PP
.RE
\fBcustom\fR [OPTIONS]
.RS 4
ارسال گزینه‌های سفارشی به یک نشست در حال اجرای \fBwl-present\fR.\& اگر گزینه‌ای مشخص نشود، از \fBdmenu\fR(1) (یا یک جایگزین سازگار) برای انتخاب یک گزینه استفاده می‌شود.\&
.PP
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-n\fR, \fB--name\fR
.RS 4
استفاده از یک نام پایپ (pipe) جایگزین (پیش‌فرض wl-present است).\&
این امکان اجازه می‌دهد چندین نمونه از wl-present به‌طور هم‌زمان اجرا شوند.\&
.PP
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBWL_PRESENT_DMENU\fR
.RS 4
پیاده‌سازی dmenu مورد استفاده را جایگزین می‌کند.\& در صورت تنظیم، این دستور به‌جای حالت پیش‌فرض برای انتخاب گزینه‌ها استفاده می‌شود.\& در صورت عدم تنظیم، \fBwl-present\fR تلاش می‌کند به‌ترتیب از \fBwofi\fR(1)، \fBwmenu\fR(1)، \fBfuzzel\fR(1)، \fBrofi\fR(1) و \fBdmenu\fR(1) استفاده کند.\&
.PP
مثال: WL_PRESENT_DMENU="rofi -dmenu -p present"
.PP
.RE
\fBWL_PRESENT_PIPECTL\fR
.RS 4
پیاده‌سازی pipectl مورد استفاده را جایگزین می‌کند.\& در صورت تنظیم، این دستور برای هدایت گزینه‌ها به \fBwl-mirror\fR(1) به‌جای حالت پیش‌فرض استفاده می‌شود.\& در صورت عدم تنظیم، \fBwl-present\fR تلاش می‌کند از \fBpipectl\fR(1) یا در صورت در دسترس نبودن آن، از لایهٔ تطبیقی (shim) داخلی نوشته‌شده به زبان bash استفاده کند.\&
.PP
.RE
\fBWL_PRESENT_SLURP\fR
.RS 4
پیاده‌سازی و گزینه‌های slurp مورد استفاده را جایگزین می‌کند.\& در صورت تنظیم، این دستور به‌جای حالت پیش‌فرض برای انتخاب ناحیه‌ها و خروجی‌ها استفاده می‌شود.\& در صورت عدم تنظیم، \fBwl-present\fR تلاش می‌کند از \fBslurp\fR(1) بدون هیچ گزینهٔ اضافی استفاده کند.\&
.PP
مثال: WL_PRESENT_SLURP="slurp -c #859900 -w 2"
.PP
.RE
\fBWL_PRESENT_PIPE_NAME\fR
.RS 4
نام پیش‌فرض پایپ را جایگزین می‌کند (پیش‌فرض wl-present است).\& این متغیر معادل گزینهٔ \fB--name\fR در بالا است.\&
.PP
مثال: WL_PRESENT_PIPE_NAME=monitor2 wl-present mirror HDMI-A-1
.PP
.RE
.SH "نویسندگان (AUTHORS)"
.PP
نگه‌داری‌شده توسط Ferdinand Bachmann <ferdinand.\&bachmann@yrlf.\&at>.\& اطلاعات بیشتر دربارهٔ \fBwl-mirror\fR در <https://github.\&com/Ferdi265/wl-mirror> در دسترس است.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBwl-mirror\fR(1) \fBpipectl\fR(1) \fBslurp\fR(1) \fBwofi\fR(1) \fBwmenu\fR(1) \fBfuzzel\fR(1)
\fBrofi\fR(1) \fBdmenu\fR(1)