.\" 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 "slurp" "1" "2026-04-09"
.PP
.SH "نام (NAME)"
.PP
slurp \- انتخاب یک ناحیه در کامپوزیتور Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBslurp\fR [options.\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBslurp\fR یک ابزار خط فرمانی برای انتخاب یک ناحیه در کامپوزیتورهای Wayland
است که از پروتکل layer-shell پشتیبانی می‌کنند.\& این ابزار به کاربر اجازه می‌دهد اشاره‌گر
را برای انتخاب نگه‌دارد، یا برای لغو انتخاب کلیک کند.\&
.PP
اگر ورودی استاندارد یک TTY نباشد یا از گزینهٔ \fB-r\fR استفاده شود، slurp فهرستی از
مستطیل‌های از پیش تعریف‌شده را برای انتخاب سریع می‌خواند.\& هر خط باید به صورت
"<x>,<y> <width>x<height> [label]" باشد.\& برچسب اختیاری است و می‌تواند هر رشته‌ای
باشد که شامل نویسهٔ خط جدید نیست.\& می‌توان با استفاده از توالی "%l" در یک رشتهٔ قالب به
آن دسترسی داشت.\&
.PP
اگر کلید \fIEsc\fR فشرده شود، انتخاب لغو می‌شود.\& اگر کلید \fISpace\fR پایین نگه داشته
شود، ناحیهٔ انتخاب‌شده به جای تغییر اندازه، جابه‌جا می‌شود.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-d\fR
.RS 4
نمایش ابعاد ناحیهٔ انتخاب‌شده.\&
.PP
.RE
\fB-b\fR \fIcolor\fR
.RS 4
تنظیم رنگ پس‌زمینه.\& برای جزئیات بیشتر بخش \fBرنگ‌ها (COLORS)\fR را ببینید.\&
.PP
.RE
\fB-c\fR \fIcolor\fR
.RS 4
تنظیم رنگ کادر (حاشیه).\& برای جزئیات بیشتر بخش \fBرنگ‌ها (COLORS)\fR را ببینید.\&
.PP
.RE
\fB-s\fR \fIcolor\fR
.RS 4
تنظیم رنگ انتخاب.\& برای جزئیات بیشتر بخش \fBرنگ‌ها (COLORS)\fR را ببینید.\&
.PP
.RE
\fB-B\fR \fIcolor\fR
.RS 4
تنظیم رنگ برای برجسته‌سازی مستطیل‌های از پیش تعریف‌شده از ورودی استاندارد در زمانی که انتخاب نشده‌اند.\&
.PP
.RE
\fB-F\fR \fIfont family\fR
.RS 4
تنظیم نام خانوادهٔ قلم (فونت) هنگام نمایش کادر ابعاد.\& فقط در صورت ترکیب با گزینهٔ \fB-d\fR
کاربرد دارد.\& نام‌های تضمین‌شدهٔ خانوادهٔ قلم برای کارکرد، گزینه‌های عمومی استاندارد
CSS2 هستند: serif، sans-serif، monospace، cursive و fantasy.\& مقدار پیش‌فرض آن،
خانوادهٔ قلم sans-serif است.\&
.PP
.RE
\fB-w\fR \fIweight\fR
.RS 4
تنظیم ضخامت کادر.\&
.PP
.RE
\fB-f\fR \fIformat\fR
.RS 4
تنظیم قالب خروجی.\& برای جزئیات بیشتر بخش \fBقالب (FORMAT)\fR را ببینید.\&
.PP
.RE
\fB-p\fR
.RS 4
انتخاب یک تک‌پیکسل به جای یک مستطیل.\& این حالت مستطیل‌های از پیش تعریف‌شدهٔ
خوانده‌شده از ورودی استاندارد را نادیده می‌گیرد.\&
.PP
.RE
\fB-o\fR
.RS 4
افزودن مستطیل‌های از پیش تعریف‌شده برای تمام خروجی‌ها (نمایشگرها)، همانند حالتی که روی
ورودی استاندارد ارائه شده باشند.\& برچسب، نام خروجی خواهد بود.\&
.PP
.RE
\fB-r\fR
.RS 4
الزام کاربر به انتخاب یکی از مستطیل‌های از پیش تعریف‌شده.\& این مستطیل‌ها می‌توانند از ورودی
استاندارد بیایند، یا در صورت استفاده از \fB-o\fR، مستطیل‌های تمام خروجی‌های تصویر باشند.\&
این گزینه با \fB-p\fR در تضاد است.\&
.PP
.RE
\fB-a\fR \fIwidth\fR:\fIheight\fR
.RS 4
اجبار انتخاب‌ها به داشتن نسبت ابعاد (aspect ratio) مشخص‌شده.\& این محدودیت روی
مستطیل‌های از پیش تعریف‌شدهٔ مشخص‌شده با \fB-o\fR اعمال نمی‌شود.\&
.PP
.RE
.SH "رنگ‌ها (COLORS)"
.PP
رنگ‌ها می‌توانند در قالب #RRGGBB یا #RRGGBBAA مشخص شوند.\& نویسهٔ # اختیاری است.\&
.PP
.SH "قالب (FORMAT)"
.PP
توالی‌های تفسیرپذیر عبارتند از:
.PP
%x	مختصات x ناحیهٔ انتخاب
.PP
%y	مختصات y ناحیهٔ انتخاب
.PP
%w	عرض ناحیهٔ انتخاب
.PP
%h	ارتفاع ناحیهٔ انتخاب
.PP
%X	مختصات x انتخاب با مختصات نسبی نسبت به خروجی‌ای که
.RS 4
شامل گوشهٔ بالا-چپ است.\&
.PP
.RE
%Y	مختصات y انتخاب با مختصات نسبی نسبت به خروجی‌ای که
.RS 4
شامل گوشهٔ بالا-چپ است.\&
.PP
.RE
%W	عرض انتخاب، برش‌خورده بر اساس خروجی‌ای که شامل گوشهٔ
.RS 4
بالا-چپ است.\&
.PP
.RE
%H	ارتفاع انتخاب، برش‌خورده بر اساس خروجی‌ای که شامل گوشهٔ
.RS 4
بالا-چپ است.\&
.PP
.RE
%l	برچسب ارائه‌شده همراه با ناحیه از stdin
.PP
%o	نام خروجی شامل گوشهٔ بالا-چپ، یا "<unknown>" در صورت
.RS 4
نامشخص بودن
.PP
.RE
قالب پیش‌فرض "%x,%y %wx%h\en" است.\&
.PP
.SH "کلیدهای کنترلی (KEYBOARD CONTROLS)"
.PP
اقدامات صفحه‌کلید زیر در حین انتخاب قابل استفاده هستند:
.PP
\fBEscape\fR	لغو انتخاب و خروج از slurp
.PP
\fBSpace\fR	اگر در حال حاضر مشغول انتخاب هستید، با پایین نگه‌داشتن space، با حرکت اشاره‌گر به جای تغییر اندازه، کل ناحیهٔ انتخاب جابه‌جا می‌شود.\&
.PP
\fBShift\fR	آزمایشی.\& اگر گزینهٔ \fB-a\fR مشخص نشده باشد، در زمان پایین نگه‌داشتن shift نسبت ابعاد روی 1:1 تنظیم می‌شود؛ رها کردن آن نسبت ابعاد بدون محدودیت را بازمی‌گرداند.\& \fBنکته:\fR این رفتار ممکن است در آینده بر اساس بازخوردها تغییر کند.\&
.PP
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگهداری‌شده توسط Simon Ser <contact@emersion.\&fr>، با همکاری سایر
مشارکت‌کنندگان متن‌باز.\& برای اطلاعات بیشتر دربارهٔ توسعهٔ slurp، به
<https://github.com/emersion/slurp> مراجعه کنید.\&