نام (NAME)

slop - عملیات انتخاب، جهت علامت‌گذاری ناحیه‌ای از صفحه یا گزینش پنجره

خلاصه دستور (SYNOPSIS)

slop [-klqn] [OPTIONS]

توضیحات (DESCRIPTION)

برنامه slop ابزاری است که یک ناحیه انتخابی را از کاربر درخواست کرده و مشخصات آن ناحیه را در stdout چاپ می‌کند. این ابزار کنترل ماوس را به دست گرفته و نشانگر آن را به یک علامت بعلاوه تبدیل می‌کند، به کاربر اجازه می‌دهد با کلیک و کشیدن (یا کلیک روی یک پنجره) ناحیه‌ای را انتخاب کند در حالی که کادری منظم دور آن رسم می‌شود، و در نهایت ابعاد ناحیه انتخاب‌شده را در stdout چاپ می‌کند.

گزینه‌ها (OPTIONS)

-h, --help: چاپ راهنما و خروج.
-v, --version: چاپ نسخه و خروج.
-x, --xdisplay=hostname:number.screen_number: نمایشگر X (xdisplay) مورد استفاده را تنظیم می‌کند.
-b, --bordersize=FLOAT: ضخامت کادر مستطیل انتخابی را تنظیم می‌کند.
-p, --padding=FLOAT: اندازه حاشیه درونی (padding) را برای ناحیه انتخابی تعیین می‌کند؛ این مقدار می‌تواند منفی باشد.
-t, --tolerance=FLOAT: حداکثر میزان جابه‌جایی ماوس بر حسب پیکسل پس از کلیک، به طوری که همچنان به جای کلیک و کشیدن، به عنوان یک کلیک معمولی شناخته شود. تنظیم این مقدار روی 0 انتخاب پنجره را غیرفعال می‌کند. در مقابل، تنظیم آن روی 9999999 انتخاب پنجره را اجباری می‌سازد.
-c, --color=FLOAT,FLOAT,FLOAT,FLOAT: رنگ مستطیل انتخابی را تعیین می‌کند. از ورودی RGB یا RGBA پشتیبانی می‌کند. بسته به مدیر پنجره یا پشتیبانی OpenGL سیستم، ممکن است میزان شفافیت نادیده گرفته شود.
-r, --shader=STRING: ترکیب سایه‌زن رأس (vertex shader) و سایه‌زن قطعه (fragment shader) را برای رسم نهایی framebuffer روی صفحه مشخص می‌کند. بدیهی است که این ویژگی فقط در صورت فعال بودن OpenGL کار می‌کند. سایه‌زن‌ها از مسیر ~/.config/slop بارگذاری می‌شوند. برای اطلاعات بیشتر در مورد چگونگی ساخت سایه‌زن‌های اختصاصی به https://github.com/naelstrof/slop مراجعه کنید.
-f, --format=STRING: قالب خروجی را برای slop تنظیم می‌کند. مشخص‌کننده‌های قالب عبارتند از: %x (آفست افقی)، %y (آفست عمودی)، %w (عرض)، %h (ارتفاع)، %i (شناسه پنجره)، %c (مقدار 1 در صورت لغو، در غیر این صورت 0)، %g (هندسه - `%wx%h+%x+%y') و %% برای علامت درصد واقعی.
-n, --nodecorations=INT: میزان حساسیت در تلاش برای حذف تزیینات پنجره را تعیین می‌کند. مقدار `0' غیرفعال است، `1' تلاشی ملایم برای حذف تزیینات انجام می‌دهد، و `2' به صورت بازگشتی در درخت ریشه پایین می‌رود تا عمیق‌ترین فرزند مرئی موجود در زیر ماوس را پیدا کند. مقدار پیش‌فرض `0' است. اجرای slop تنها با `-n` معادل ارائه `-n1` است.
-l, --highlight: به جای کشیدن خط دور محدوده انتخابی، slop آن را برجسته (highlight) می‌کند. این گزینه به‌ویژه زمانی که شفافیت رنگ کمتر از 1 تنظیم شده باشد بسیار کاربردی است.
-D, --nodrag: به شما اجازه می‌دهد به جای کلیک و کشیدن، با دو بار کلیک ناحیه انتخاب را مشخص کنید.
-q, --quiet: غیرفعال کردن هرگونه خروجی غیرضروری cerr. هیچ هشداری چاپ نخواهد شد.
-k, --nokeyboard: امکان لغو کردن انتخاب با صفحه‌کلید را غیرفعال می‌کند.
-o, --noopengl: شتاب‌دهنده گرافیکی را غیرفعال می‌کند. در صورت بروز اشکالات گرافیکی در رندر تصویر می‌تواند مفید باشد.

مثال‌ها (EXAMPLES)

برای شبیه‌سازی سبک انتخاب در Windows XP، می‌توانید از دستوری شبیه به این استفاده کنید:

slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4

به منظور اجتناب از به‌کارگیری eval(1) در اسکریپت‌های خود (که یک معضل امنیتی بزرگ به شمار می‌رود)، می‌توانید در عوض از slop به صورت زیر استفاده کنید:

read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")

همچنین ببینید (SEE ALSO)

maim(1)

گزارش باگ‌ها (BUGS)

هیچ باگ شناخته‌شده‌ای وجود ندارد.

نویسندگان (AUTHORS)

Dalton Nell (naelstrof@gmail.com)