نام (NAME)

slurp - انتخاب یک ناحیه در کامپوزیتور Wayland

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

slurp [options...]

توضیحات (DESCRIPTION)

ابزار slurp یک ابزار خط فرمانی برای انتخاب یک ناحیه در کامپوزیتورهای Wayland است که از پروتکل layer-shell پشتیبانی می‌کنند. این ابزار به کاربر اجازه می‌دهد اشاره‌گر را برای انتخاب نگه‌دارد، یا برای لغو انتخاب کلیک کند.

اگر ورودی استاندارد یک TTY نباشد یا از گزینهٔ -r استفاده شود، slurp فهرستی از مستطیل‌های از پیش تعریف‌شده را برای انتخاب سریع می‌خواند. هر خط باید به صورت "<x>,<y> <width>x<height> [label]" باشد. برچسب اختیاری است و می‌تواند هر رشته‌ای باشد که شامل نویسهٔ خط جدید نیست. می‌توان با استفاده از توالی "%l" در یک رشتهٔ قالب به آن دسترسی داشت.

اگر کلید Esc فشرده شود، انتخاب لغو می‌شود. اگر کلید Space پایین نگه داشته شود، ناحیهٔ انتخاب‌شده به جای تغییر اندازه، جابه‌جا می‌شود.

گزینه‌ها (OPTIONS)

-h

نمایش پیام راهنما و خروج.

-d

نمایش ابعاد ناحیهٔ انتخاب‌شده.

-b color

تنظیم رنگ پس‌زمینه. برای جزئیات بیشتر بخش رنگ‌ها (COLORS) را ببینید.

-c color

تنظیم رنگ کادر (حاشیه). برای جزئیات بیشتر بخش رنگ‌ها (COLORS) را ببینید.

-s color

تنظیم رنگ انتخاب. برای جزئیات بیشتر بخش رنگ‌ها (COLORS) را ببینید.

-B color

تنظیم رنگ برای برجسته‌سازی مستطیل‌های از پیش تعریف‌شده از ورودی استاندارد در زمانی که انتخاب نشده‌اند.

-F font family

تنظیم نام خانوادهٔ قلم (فونت) هنگام نمایش کادر ابعاد. فقط در صورت ترکیب با گزینهٔ -d کاربرد دارد. نام‌های تضمین‌شدهٔ خانوادهٔ قلم برای کارکرد، گزینه‌های عمومی استاندارد CSS2 هستند: serif، sans-serif، monospace، cursive و fantasy. مقدار پیش‌فرض آن، خانوادهٔ قلم sans-serif است.

-w weight

تنظیم ضخامت کادر.

-f format

تنظیم قالب خروجی. برای جزئیات بیشتر بخش قالب (FORMAT) را ببینید.

-p

انتخاب یک تک‌پیکسل به جای یک مستطیل. این حالت مستطیل‌های از پیش تعریف‌شدهٔ خوانده‌شده از ورودی استاندارد را نادیده می‌گیرد.

-o

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

-r

الزام کاربر به انتخاب یکی از مستطیل‌های از پیش تعریف‌شده. این مستطیل‌ها می‌توانند از ورودی استاندارد بیایند، یا در صورت استفاده از -o، مستطیل‌های تمام خروجی‌های تصویر باشند. این گزینه با -p در تضاد است.

-a width:height

اجبار انتخاب‌ها به داشتن نسبت ابعاد (aspect ratio) مشخص‌شده. این محدودیت روی مستطیل‌های از پیش تعریف‌شدهٔ مشخص‌شده با -o اعمال نمی‌شود.

رنگ‌ها (COLORS)

رنگ‌ها می‌توانند در قالب #RRGGBB یا #RRGGBBAA مشخص شوند. نویسهٔ # اختیاری است.

قالب (FORMAT)

توالی‌های تفسیرپذیر عبارتند از:

%x مختصات x ناحیهٔ انتخاب

%y مختصات y ناحیهٔ انتخاب

%w عرض ناحیهٔ انتخاب

%h ارتفاع ناحیهٔ انتخاب

%X مختصات x انتخاب با مختصات نسبی نسبت به خروجی‌ای که

شامل گوشهٔ بالا-چپ است.

%Y مختصات y انتخاب با مختصات نسبی نسبت به خروجی‌ای که

شامل گوشهٔ بالا-چپ است.

%W عرض انتخاب، برش‌خورده بر اساس خروجی‌ای که شامل گوشهٔ

بالا-چپ است.

%H ارتفاع انتخاب، برش‌خورده بر اساس خروجی‌ای که شامل گوشهٔ

بالا-چپ است.

%l برچسب ارائه‌شده همراه با ناحیه از stdin

%o نام خروجی شامل گوشهٔ بالا-چپ، یا "<unknown>" در صورت

نامشخص بودن

قالب پیش‌فرض "%x,%y %wx%h\n" است.

کلیدهای کنترلی (KEYBOARD CONTROLS)

اقدامات صفحه‌کلید زیر در حین انتخاب قابل استفاده هستند:

Escape لغو انتخاب و خروج از slurp

Space اگر در حال حاضر مشغول انتخاب هستید، با پایین نگه‌داشتن space، با حرکت اشاره‌گر به جای تغییر اندازه، کل ناحیهٔ انتخاب جابه‌جا می‌شود.

Shift آزمایشی. اگر گزینهٔ -a مشخص نشده باشد، در زمان پایین نگه‌داشتن shift نسبت ابعاد روی 1:1 تنظیم می‌شود؛ رها کردن آن نسبت ابعاد بدون محدودیت را بازمی‌گرداند. نکته: این رفتار ممکن است در آینده بر اساس بازخوردها تغییر کند.

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

نگهداری‌شده توسط Simon Ser <contact@emersion.fr>، با همکاری سایر مشارکت‌کنندگان متن‌باز. برای اطلاعات بیشتر دربارهٔ توسعهٔ slurp، به https://github.com/emersion/slurp مراجعه کنید.