.\" Generated by scdoc 1.11.3
.\" 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 "swappy" "1" "2025-08-27"
.PP
.SH "نام (NAME)"
.PP
swappy \- گرفتن و ویرایش بلادرنگ نماگرفت‌ها در یک کامپوزیتور Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBswappy\fR [گزینه‌ها\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه swappy یک ابزار خط فرمانی برای گرفتن و ویرایش نماگرفت‌ها از میزکارهای
Wayland است.\& این ابزار به‌خوبی با grim، slurp و sway کار می‌کند.\& همچنین می‌تواند
به‌سادگی با دیگر ابزارهای رونوشت از صفحه که تصویر نهایی را به \fBstdout\fR ارسال
می‌کنند، کار کند.\&
.PP
برنامه swappy تصاویر یادداشت‌نویسی‌شده را در \fBsave_dir\fR فایل پیکربندی ذخیره می‌کند؛ بخش زیر را ببینید.\&
.PP
در صورت عدم تعیین، تلاش می‌کند تا طبق این الگو به‌طور پیش‌فرض از پوشه \fBDesktop\fR استفاده کند:
\fB$XDG_DESKTOP_DIR\fR.\& اگر این متغیر تنظیم نشده باشد، به \fB$XDG_CONFIG_HOME/Desktop\fR بازمی‌گردد.\&
اگر \fB$XDG_CONFIG_HOME\fR نیز تنظیم نشده باشد، به \fB$HOME/Desktop\fR رجوع خواهد کرد.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-v, --version\fR
.RS 4
نمایش نسخه و خروج.\&
.PP
.RE
\fB-f, --file\fR <file>
.RS 4
یک فایل تصویری برای بارگذاری جهت ویرایش.\&
.PP
اگر روی \fB-\fR تنظیم شود، فایل را به‌جای آن از ورودی استاندارد می‌خواند.\& این حالت با grim سازگار است.\&
.PP
.RE
\fB-o, --output-file <file>\fR
.RS 4
چاپ سطح نهایی در \fB<file>\fR هنگام خروج از برنامه.\&
.PP
اگر روی \fB-\fR تنظیم شود، سطح نهایی را در \fBstdout\fR چاپ می‌کند.\&
.PP
توجه داشته باشید که دکمه \fBSave\fR تصویر را در پارامتر \fBsave_dir\fR از فایل پیکربندی ذخیره می‌کند، همان‌گونه که در بخش «توضیحات (DESCRIPTION)» شرح داده شده است.\&
.PP
.RE
.SH "فایل پیکربندی (CONFIG FILE)"
.PP
فایل پیکربندی در \fB$XDG_CONFIG_HOME/swappy/config\fR یا \fB$HOME/.\&config/swappy/config\fR قرار دارد.\& این فایل از قالب \fBconf\fR مربوط به GLib پیروی می‌کند.\&
.PP
.nf
.RS 4
	[Section]
	key=value
.fi
.RE
.PP
سطرهای زیر می‌توانند به‌عنوان مقادیر پیش‌فرض swappy استفاده شوند:
.PP
.nf
.RS 4
	[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
.fi
.RE
.PP
.PD 0
.IP \(bu 4
\fBsave_dir\fR مکانی است که نماگرفت‌ها (swappshots) در آن ذخیره می‌شوند؛ می‌تواند شامل متغیرهای محیطی باشد. در صورتی که این پوشه وجود نداشته باشد، swappy ابتدا تلاش می‌کند آن را ایجاد کند، اما در صورت عدم موفقیت در ایجاد پوشه، اجرای برنامه متوقف نمی‌شود
.IP \(bu 4
\fBsave_filename_format\fR الگوی نام فایل است؛ اگر شامل قالب تاریخ باشد، به یک برچسب زمانی تبدیل خواهد شد.\& جزئیات قالب در strftime(3) آمده است.\& اگر این قالب تاریخ وجود نداشته باشد، نام فایل فاقد برچسب زمانی خواهد بود
.IP \(bu 4
\fBshow_panel\fR برای فعال یا غیرفعال کردن پنل نقاشی هنگام راه‌اندازی استفاده می‌شود
.IP \(bu 4
\fBline_size\fR اندازه خط پیش‌فرض است (باید بین 1 تا 50 باشد)
.IP \(bu 4
\fBtext_size\fR اندازه متن پیش‌فرض است (باید بین 10 تا 50 باشد)
.IP \(bu 4
\fBtext_font\fR قلمی است که برای ترسیم متن استفاده می‌شود؛ قالب آن با pango سازگار است
.IP \(bu 4
\fBpaint_mode\fR حالتی است که در زمان آغاز به کار برنامه فعال می‌شود (باید یکی از موارد brush|text|rectangle|ellipse|arrow|blur باشد؛ تطابق بدون توجه به بزرگی و کوچکی حروف انجام می‌شود)
.IP \(bu 4
\fBearly_exit\fR برای خروج از برنامه پس از ذخیره تصویر یا کپی کردن آن در کلیپ‌بورد استفاده می‌شود
.IP \(bu 4
\fBfill_shape\fR برای فعال یا غیرفعال کردن توپر بودن شکل‌ها (برای ابزارهای مستطیل و بیضی) در زمان راه‌اندازی استفاده می‌شود
.IP \(bu 4
\fBauto_save\fR برای فعال یا غیرفعال کردن ذخیره خودکار بافر نهایی در \fBsave_dir\fR هنگام خروج استفاده می‌شود
.IP \(bu 4
\fBcustom_color\fR برای تنظیم مقدار پیش‌فرض رنگ سفارشی استفاده می‌شود.\& قالب‌های
.PD
پذیرفته‌شده عبارتند از: نام استاندارد (یکی از موارد در: 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)
.PD 0
.IP \(bu 4
\fBtransparency\fR برای تنظیم شفافیت همه مواردی که در طول راه‌اندازی ترسیم می‌شوند، استفاده می‌شود
.IP \(bu 4
\fBtransparent\fR برای فعال یا غیرفعال کردن شفافیت هنگام راه‌اندازی استفاده می‌شود
.PD
.PP
.PP
.SH "کلیدهای میانبر (KEY BINDINGS)"
.PP
.SS "چیدمان (LAYOUT)"
.PP
.PD 0
.IP \(bu 4
\fBCtrl+b\fR: تغییر وضعیت نمایش پنل نقاشی
.PD
.PP
.SS "حالت نقاشی (PAINT MODE)"
.PP
.PD 0
.IP \(bu 4
\fBb\fR: تغییر به قلم‌مو (Brush)
.IP \(bu 4
`e` `t`: تغییر به متن / ویرایشگر (Text / Editor)
.IP \(bu 4
`r` `s`: تغییر به مستطیل / مربع (Rectangle / Square)
.IP \(bu 4
`c` `o`: تغییر به بیضی / دایره (Ellipse / Circle)
.IP \(bu 4
\fBa\fR: تغییر به پیکان (Arrow)
.IP \(bu 4
\fBd\fR: تغییر به تار کردن (Blur) (حرف d نماد droplet است)
.PD
.PP
.PD 0
.IP \(bu 4
\fBR\fR: استفاده از رنگ قرمز
.IP \(bu 4
\fBG\fR: استفاده از رنگ سبز
.IP \(bu 4
\fBB\fR: استفاده از رنگ آبی
.IP \(bu 4
\fBC\fR: استفاده از رنگ سفارشی
.IP \(bu 4
\fBMinus\fR: کاهش اندازه خط
.IP \(bu 4
\fBPlus\fR: افزایش اندازه خط
.IP \(bu 4
\fBEqual\fR: بازنشانی اندازه خط
.IP \(bu 4
\fBf\fR: تغییر وضعیت توپر بودن شکل
.IP \(bu 4
\fBT\fR: تغییر وضعیت شفافیت
.IP \(bu 4
`x` `k`: پاک کردن نقاشی‌ها (غیرقابل بازگشت)
.PD
.PP
.SS "کلیدهای تبدیل (MODIFIERS)"
.PP
.PD 0
.IP \(bu 4
\fBCtrl\fR: مرکز قرار دادن شکل (مستطیل و بیضی) بر اساس نقطه آغاز ترسیم
.PD
.PP
.SS "نوار سربرگ (HEADER BAR)"
.PP
.PD 0
.IP \(bu 4
\fBCtrl+z\fR: واگرد (Undo)
.IP \(bu 4
\fBCtrl+Shift+z\fR یا \fBCtrl+y\fR: ازنو (Redo)
.IP \(bu 4
\fBCtrl+s\fR: ذخیره در فایل (صفحه man را ببینید)
.IP \(bu 4
\fBCtrl+c\fR: کپی در کلیپ‌بورد
.IP \(bu 4
\fBEscape\fR یا \fBq\fR یا \fBCtrl+w\fR: خروج از swappy
.PD
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نوشته‌شده و نگه‌داری‌شده توسط jtheoof <contact@jtheoof.\&me>.\& صفحه
https://github.\&com/jtheoof/swappy را ببینید.\&