.\" Manpage for slop.
.\" Contact naelstrof@gmail.com to correct errors or typos.
.TH SLOP 1 2021-02-03 Linux "slop man page"
.SH "نام (NAME)"
slop \- عملیات انتخاب، جهت علامت‌گذاری ناحیه‌ای از صفحه یا گزینش پنجره
.SH "خلاصه دستور (SYNOPSIS)"
slop [-klqn] [OPTIONS]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBslop\fR ابزاری است که یک ناحیه انتخابی را از کاربر درخواست کرده و مشخصات آن ناحیه را در stdout چاپ می‌کند. این ابزار کنترل ماوس را به دست گرفته و نشانگر آن را به یک علامت بعلاوه تبدیل می‌کند، به کاربر اجازه می‌دهد با کلیک و کشیدن (یا کلیک روی یک پنجره) ناحیه‌ای را انتخاب کند در حالی که کادری منظم دور آن رسم می‌شود، و در نهایت ابعاد ناحیه انتخاب‌شده را در stdout چاپ می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-h ", " \-\-help
چاپ راهنما و خروج.
.TP
.BR \-v ", " \-\-version
چاپ نسخه و خروج.
.TP
.BR \-x ", " \-\-xdisplay=\fIhostname:number.screen_number\fR
نمایشگر X (xdisplay) مورد استفاده را تنظیم می‌کند.
.TP
.BR \-b ", " \-\-bordersize=\fIFLOAT\fR
ضخامت کادر مستطیل انتخابی را تنظیم می‌کند.
.TP
.BR \-p ", " \-\-padding=\fIFLOAT\fR
اندازه حاشیه درونی (padding) را برای ناحیه انتخابی تعیین می‌کند؛ این مقدار می‌تواند منفی باشد.
.TP
.BR \-t ", " \-\-tolerance=\fIFLOAT\fR
حداکثر میزان جابه‌جایی ماوس بر حسب پیکسل پس از کلیک، به طوری که همچنان به جای کلیک و کشیدن، به عنوان یک کلیک معمولی شناخته شود. تنظیم این مقدار روی 0 انتخاب پنجره را غیرفعال می‌کند. در مقابل، تنظیم آن روی 9999999 انتخاب پنجره را اجباری می‌سازد.
.TP
.BR \-c ", " \-\-color=\fIFLOAT,FLOAT,FLOAT,FLOAT\fR
رنگ مستطیل انتخابی را تعیین می‌کند. از ورودی RGB یا RGBA پشتیبانی می‌کند. بسته به مدیر پنجره یا پشتیبانی OpenGL سیستم، ممکن است میزان شفافیت نادیده گرفته شود.
.TP
.BR \-r ", " \-\-shader=\fISTRING\fR
ترکیب سایه‌زن رأس (vertex shader) و سایه‌زن قطعه (fragment shader) را برای رسم نهایی framebuffer روی صفحه مشخص می‌کند. بدیهی است که این ویژگی فقط در صورت فعال بودن OpenGL کار می‌کند. سایه‌زن‌ها از مسیر ~/.config/slop بارگذاری می‌شوند. برای اطلاعات بیشتر در مورد چگونگی ساخت سایه‌زن‌های اختصاصی به <https://github.com/naelstrof/slop> مراجعه کنید.
.TP
.BR \-f ", " \-\-format=\fISTRING\fR
قالب خروجی را برای slop تنظیم می‌کند. مشخص‌کننده‌های قالب عبارتند از: %x (آفست افقی)، %y (آفست عمودی)، %w (عرض)، %h (ارتفاع)، %i (شناسه پنجره)، %c (مقدار 1 در صورت لغو، در غیر این صورت 0)، %g (هندسه \- `%wx%h+%x+%y') و %% برای علامت درصد واقعی.
.TP
.BR \-n ", " \-\-nodecorations=INT
میزان حساسیت در تلاش برای حذف تزیینات پنجره را تعیین می‌کند. مقدار `0' غیرفعال است، `1' تلاشی ملایم برای حذف تزیینات انجام می‌دهد، و `2' به صورت بازگشتی در درخت ریشه پایین می‌رود تا عمیق‌ترین فرزند مرئی موجود در زیر ماوس را پیدا کند. مقدار پیش‌فرض `0' است. اجرای slop تنها با `-n` معادل ارائه `-n1` است.
.TP
.BR \-l ", " \-\-highlight
به جای کشیدن خط دور محدوده انتخابی، slop آن را برجسته (highlight) می‌کند. این گزینه به‌ویژه زمانی که شفافیت رنگ کمتر از 1 تنظیم شده باشد بسیار کاربردی است.
.TP
.BR \-D ", " \-\-nodrag
به شما اجازه می‌دهد به جای کلیک و کشیدن، با دو بار کلیک ناحیه انتخاب را مشخص کنید.
.TP
.BR \-q ", " \-\-quiet
غیرفعال کردن هرگونه خروجی غیرضروری cerr. هیچ هشداری چاپ نخواهد شد.
.TP
.BR \-k ", " \-\-nokeyboard
امکان لغو کردن انتخاب با صفحه‌کلید را غیرفعال می‌کند.
.TP
.BR \-o ", " \-\-noopengl
شتاب‌دهنده گرافیکی را غیرفعال می‌کند. در صورت بروز اشکالات گرافیکی در رندر تصویر می‌تواند مفید باشد.
.SH "مثال‌ها (EXAMPLES)"
برای شبیه‌سازی سبک انتخاب در Windows XP، می‌توانید از دستوری شبیه به این استفاده کنید:
.PP
.nf
.RS
slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4
.RE
.fi
.PP
به منظور اجتناب از به‌کارگیری
.BR eval(1)
در اسکریپت‌های خود (که یک معضل امنیتی بزرگ به شمار می‌رود)، می‌توانید در عوض از slop به صورت زیر استفاده کنید:
.PP
.nf
.RS
read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")
.RE
.fi
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR maim(1)
.SH "گزارش باگ‌ها (BUGS)"
هیچ باگ شناخته‌شده‌ای وجود ندارد.
.SH "نویسندگان (AUTHORS)"
Dalton Nell (naelstrof@gmail.com)