.\" 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 "xdg-desktop-portal-wlr" "5" "2026-04-18"
.PP
.SH "نام (NAME)"
.PP
xdg-desktop-portal-wlr \- یک بک‌اند xdg-desktop-portal برای wlroots
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
.B xdg-desktop-portal-wlr
(یا به اختصار
.BR xdpw )
به برنامه‌های کاربردی اجازه می‌دهد تا در کامپوزیتورهای ویلند (Wayland) مبتنی بر wlroots، از طریق xdg-desktop-portal درخواست تصویربرداری از صفحه (اسکرین‌شات) و ضبط ویدئویی صفحه (اسکرین‌کست) ارسال کنند.\&
.PP
برنامه
.B xdpw
تلاش خواهد کرد تا فایل پیکربندی را از این مسیرها بارگذاری کند:
.PP
.PD 0
.IP \(bu 4
$XDG_CONFIG_HOME/xdg-desktop-portal-wlr/$XDG_CURRENT_DESKTOP
.IP \(bu 4
$XDG_CONFIG_HOME/xdg-desktop-portal-wlr/config
.IP \(bu 4
/etc/xdg/xdg-desktop-portal-wlr/$XDG_CURRENT_DESKTOP
.IP \(bu 4
/etc/xdg/xdg-desktop-portal-wlr/config
.PD
.PP
مقدار پیش‌فرض
\fI$XDG_CONFIG_HOME\fR
برابر با
\fI\(ti/.\&config\fR
است.\&
\fI$XDG_CURRENT_DESKTOP\fR
می‌تواند فهرستی باشد که با دو‌نقطه (:) از هم جدا شده‌اند.\& هر یک از اعضای این فهرست بررسی خواهند شد.\&
.PP
فایل‌های پیکربندی از قالب پرونده INI استفاده می‌کنند.\& مثال:
.PP
.nf
.RS 4
[screencast]
output_name=HDMI-A-1
max_fps=30
exec_before=disable_notifications\&.sh
exec_after=enable_notifications\&.sh
chooser_type=simple
chooser_cmd=slurp -f \&'Monitor: %o\&' -or
.fi
.RE
.PP
.SH "گزینه‌های ضبط صفحه (SCREENCAST OPTIONS)"
.PP
این گزینه‌ها باید زیر بخش \fB\fR[screencast]\fB\fR قرار گیرند.\&
.PP
\fB\fRoutput_name\fB\fR = \fIname\fR
.RS 4
انتخاب این که کدام خروجی ضبط ویدئویی شود.\&
.PP
این گزینه همراه با \fB\fRchooser_type\fB\fR = none استفاده می‌شود.\& فهرست خروجی‌های موجود را می‌توان از طریق \fB\fRwayland-info\fB\fR(1) (زیر بخش \fIwl_output\fR) به دست آورد.\&
.PP
.RE
\fB\fRmax_fps\fB\fR = \fIlimit\fR
.RS 4
محدود کردن تعداد فریم در ثانیه به نرخ ارائه‌شده.\&
.PP
این گزینه برای کاهش مصرف پردازنده (CPU) در مواردی که ضبط فریم‌ها با نرخ نوسازی کامل خروجی غیرضروری است، کاربرد دارد.\&
.PP
.RE
\fB\fRexec_before\fB\fR = \fIcommand\fR
.RS 4
اجرای \fIcommand\fR پیش از آغاز ضبط صفحه.\& این دستور در بستر sh اجرا خواهد شد.\&
.PP
.RE
\fB\fRexec_after\fB\fR = \fIcommand\fR
.RS 4
اجرای \fIcommand\fR پس از پایان تمام ضبط‌های صفحه.\& این دستور در بستر sh اجرا خواهد شد.\&
.PP
.RE
\fB\fRchooser_cmd\fB\fR = \fIcommand\fR
.RS 4
اجرای این دستور برای انتخاب یک خروجی.\&
.PP
برای جزئیات بیشتر به بخش \fB\fROUTPUT CHOOSER\fB\fR مراجعه کنید.\&
.PP
.RE
\fB\fRchooser_type\fB\fR = \fItype\fR
.RS 4
ورودی ارسالی به انتخاب‌گر را مشخص می‌کند.\&
.PP
نوع‌های پشتیبانی‌شده عبارتند از:
.PD 0
.IP \(bu 4
\fBdefault\fR: برنامه xdpw تلاش می‌کند از اولین انتخاب‌گر موجود در فهرست انتخاب‌گرهای تعبیه‌شده
(slurp, wmenu, wofi, rofi, bemenu, mew, fuzzel)
استفاده کند و در صورت عدم یافتن هیچ‌یک، به یک خروجی دلخواه بازمی‌گردد.\&
.IP \(bu 4
\fBnone\fR: برنامه xdpw اجازه ضبط صفحه را یا روی خروجی مشخص‌شده با \fB\fRoutput_name\fB\fR یا در صورت خالی بودن، روی یک خروجی دلخواه بدون نیاز به تعامل بیشتر می‌دهد.\&
.IP \(bu 4
\fBsimple, dmenu\fR: برنامه xdpw انتخاب‌گر مشخص‌شده با \fB\fRchooser_cmd\fB\fR را اجرا خواهد کرد.\& برای جزئیات بیشتر به بخش \fB\fROUTPUT CHOOSER\fB\fR مراجعه کنید.\&
.PD
.PP
.RE
\fB\fRforce_mod_linear\fB\fR = \fIbool\fR
.RS 4
اجبار بافرهای با اصلاح‌کننده ضمنی به خطی بودن (آزمایشی)
.PP
تنظیم این گزینه روی 1 برنامه xdpw را مجبور می‌کند بافرهای dma-buf با اصلاح‌کننده ضمنی (implicit modifier) را به صورت خطی (linear) تخصیص دهد.\&
این گزینه نباید در سیستم‌های تک پردازنده گرافیکی (GPU) مورد نیاز باشد، اما می‌تواند سازگاری را به‌ویژه در سیستم‌های دارای چند پردازنده گرافیکی افزایش دهد.\&
.PP
این گزینه آزمایشی است و ممکن است در نسخه‌های بعدی حذف یا جایگزین شود.\&
.PP
.RE
.SS "انتخاب‌گر خروجی (OUTPUT CHOOSER)"
.PP
انتخاب‌گر می‌تواند هر برنامه یا اسکریپتی با رفتار زیر باشد:
.PD 0
.IP \(bu 4
هر کد خطایی به جز 127 را بازگرداند.\& کد خطای 127 در داخل برنامه برای نشان دادن پیدا نشدن دستور استفاده می‌شود و تمام خروجی آن نادیده گرفته خواهد شد.\&
.IP \(bu 4
رشته‌ای را در stdout بازگرداند که در صورت تطابق با یکی از موارد زیر معتبر است:
 \- برای انتخاب‌گرهای simple:
   \- پیشوند "Monitor: " به همراه نام یک خروجی معتبر مطابق با \fB\fRwayland-info\fB\fR(1).\&
   \- پیشوند "Window: " به همراه شناسه ext-foreign-toplevel-list-v1 مطابق با \fB\fRlswt\fB\fR(1).\&
 \- برای انتخاب‌گرهای dmenu: یکی از خطوط ارائه‌شده از طریق stdin.\&
 هر چیز دیگری به منزله رد درخواست توسط کاربر در نظر گرفته خواهد شد.\&
.IP \(bu 4
برای اعلام این که کاربر ضبط صفحه را رد کرده است، انتخاب‌گر باید بدون ارسال هیچ محتوایی در stdout خارج شود.\&
.PD
.PP
نوع‌های پشتیبانی‌شده از انتخاب‌گرها از طریق گزینه \fB\fRchooser_type\fB\fR:
.PD 0
.IP \(bu 4
\fBsimple\fR: انتخاب‌گر بدون هیچ داده اضافی در stdin فراخوانی می‌شود.\&
.IP \(bu 4
\fBdmenu\fR: انتخاب‌گر فهرستی از خروجی‌ها را که با خط جدید جدا شده‌اند (به سبک dmenu) در stdin دریافت می‌کند.\&
.PD
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fB\fRpipewire\fB\fR(1)