نام (NAME)

swappy - گرفتن و ویرایش بلادرنگ نماگرفت‌ها در یک کامپوزیتور Wayland

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

swappy [گزینه‌ها..]

توضیحات (DESCRIPTION)

برنامه swappy یک ابزار خط فرمانی برای گرفتن و ویرایش نماگرفت‌ها از میزکارهای Wayland است. این ابزار به‌خوبی با grim، slurp و sway کار می‌کند. همچنین می‌تواند به‌سادگی با دیگر ابزارهای رونوشت از صفحه که تصویر نهایی را به stdout ارسال می‌کنند، کار کند.

برنامه swappy تصاویر یادداشت‌نویسی‌شده را در save_dir فایل پیکربندی ذخیره می‌کند؛ بخش زیر را ببینید.

در صورت عدم تعیین، تلاش می‌کند تا طبق این الگو به‌طور پیش‌فرض از پوشه Desktop استفاده کند: $XDG_DESKTOP_DIR. اگر این متغیر تنظیم نشده باشد، به $XDG_CONFIG_HOME/Desktop بازمی‌گردد. اگر $XDG_CONFIG_HOME نیز تنظیم نشده باشد، به $HOME/Desktop رجوع خواهد کرد.

گزینه‌ها (OPTIONS)

-h, --help

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

-v, --version

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

-f, --file <file>

یک فایل تصویری برای بارگذاری جهت ویرایش.

اگر روی - تنظیم شود، فایل را به‌جای آن از ورودی استاندارد می‌خواند. این حالت با grim سازگار است.

-o, --output-file <file>

چاپ سطح نهایی در <file> هنگام خروج از برنامه.

اگر روی - تنظیم شود، سطح نهایی را در stdout چاپ می‌کند.

توجه داشته باشید که دکمه Save تصویر را در پارامتر save_dir از فایل پیکربندی ذخیره می‌کند، همان‌گونه که در بخش «توضیحات (DESCRIPTION)» شرح داده شده است.

فایل پیکربندی (CONFIG FILE)

فایل پیکربندی در $XDG_CONFIG_HOME/swappy/config یا $HOME/.config/swappy/config قرار دارد. این فایل از قالب conf مربوط به GLib پیروی می‌کند.

[Section]
key=value

سطرهای زیر می‌توانند به‌عنوان مقادیر پیش‌فرض swappy استفاده شوند:

[Default]
save_dir=$HOME/Desktop
save_filename_format=swappy-%Y%m%d-%H%M%S.png
show_panel=false
line_size=5
text_size=20
text_font=sans-serif
paint_mode=brush
early_exit=false
fill_shape=false
auto_save=false
custom_color=rgba(192,125,17,1)
transparent=false
transparency=50

save_dir مکانی است که نماگرفت‌ها (swappshots) در آن ذخیره می‌شوند؛ می‌تواند شامل متغیرهای محیطی باشد. در صورتی که این پوشه وجود نداشته باشد، swappy ابتدا تلاش می‌کند آن را ایجاد کند، اما در صورت عدم موفقیت در ایجاد پوشه، اجرای برنامه متوقف نمی‌شود
save_filename_format الگوی نام فایل است؛ اگر شامل قالب تاریخ باشد، به یک برچسب زمانی تبدیل خواهد شد. جزئیات قالب در strftime(3) آمده است. اگر این قالب تاریخ وجود نداشته باشد، نام فایل فاقد برچسب زمانی خواهد بود
show_panel برای فعال یا غیرفعال کردن پنل نقاشی هنگام راه‌اندازی استفاده می‌شود
line_size اندازه خط پیش‌فرض است (باید بین 1 تا 50 باشد)
text_size اندازه متن پیش‌فرض است (باید بین 10 تا 50 باشد)
text_font قلمی است که برای ترسیم متن استفاده می‌شود؛ قالب آن با pango سازگار است
paint_mode حالتی است که در زمان آغاز به کار برنامه فعال می‌شود (باید یکی از موارد brush|text|rectangle|ellipse|arrow|blur باشد؛ تطابق بدون توجه به بزرگی و کوچکی حروف انجام می‌شود)
early_exit برای خروج از برنامه پس از ذخیره تصویر یا کپی کردن آن در کلیپ‌بورد استفاده می‌شود
fill_shape برای فعال یا غیرفعال کردن توپر بودن شکل‌ها (برای ابزارهای مستطیل و بیضی) در زمان راه‌اندازی استفاده می‌شود
auto_save برای فعال یا غیرفعال کردن ذخیره خودکار بافر نهایی در save_dir هنگام خروج استفاده می‌شود
custom_color برای تنظیم مقدار پیش‌فرض رنگ سفارشی استفاده می‌شود. قالب‌های پذیرفته‌شده عبارتند از: نام استاندارد (یکی از موارد در: https://github.com/rgb-x/system/blob/master/root/etc/X11/rgb.txt)، #rgb، #rrggbb، #rrrgggbbb، #rrrrggggbbbb، rgb(r,b,g)، rgba(r,g,b,a)
transparency برای تنظیم شفافیت همه مواردی که در طول راه‌اندازی ترسیم می‌شوند، استفاده می‌شود
transparent برای فعال یا غیرفعال کردن شفافیت هنگام راه‌اندازی استفاده می‌شود

کلیدهای میانبر (KEY BINDINGS)

چیدمان (LAYOUT)

•: Ctrl+b: تغییر وضعیت نمایش پنل نقاشی

حالت نقاشی (PAINT MODE)

b: تغییر به قلم‌مو (Brush)
`e` `t`: تغییر به متن / ویرایشگر (Text / Editor)
`r` `s`: تغییر به مستطیل / مربع (Rectangle / Square)
`c` `o`: تغییر به بیضی / دایره (Ellipse / Circle)
a: تغییر به پیکان (Arrow)
d: تغییر به تار کردن (Blur) (حرف d نماد droplet است)

R: استفاده از رنگ قرمز
G: استفاده از رنگ سبز
B: استفاده از رنگ آبی
C: استفاده از رنگ سفارشی
Minus: کاهش اندازه خط
Plus: افزایش اندازه خط
Equal: بازنشانی اندازه خط
f: تغییر وضعیت توپر بودن شکل
T: تغییر وضعیت شفافیت
`x` `k`: پاک کردن نقاشی‌ها (غیرقابل بازگشت)

کلیدهای تبدیل (MODIFIERS)

•: Ctrl: مرکز قرار دادن شکل (مستطیل و بیضی) بر اساس نقطه آغاز ترسیم

نوار سربرگ (HEADER BAR)

Ctrl+z: واگرد (Undo)
Ctrl+Shift+z یا Ctrl+y: ازنو (Redo)
Ctrl+s: ذخیره در فایل (صفحه man را ببینید)
Ctrl+c: کپی در کلیپ‌بورد
Escape یا q یا Ctrl+w: خروج از swappy

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

نوشته‌شده و نگه‌داری‌شده توسط jtheoof <contact@jtheoof.me>. صفحه https://github.com/jtheoof/swappy را ببینید.