.\" Manpage for maim.
.\" Contact naelstrof@gmail.com to correct errors or typos.
.TH maim 1 2021-02-03 Linux "maim man page"
.SH "نام (NAME)"
maim \- تصویربرداری از میزکار و ساخت تصویر
.SH "خلاصه دستور (SYNOPSIS)"
maim [OPTIONS] [FILEPATH]
.SH "توضیحات (DESCRIPTION)"
برنامه maim (کوتاه‌شده‌ی make image) ابزاری است که از میزکار شما اسکرین‌شات (تصویر صفحه) می‌گیرد و آن را در قالب تصویر png، jpg، bmp یا webp کدگذاری می‌کند. به‌طور پیش‌فرض، داده‌های تصویر کدگذاری‌شده مستقیماً به خروجی استاندارد فرستاده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-h ", " \-\-help
نمایش راهنما و خروج.
.TP
.BR \-v ", " \-\-version
نمایش نسخه و خروج.
.TP
.BR \-x ", " \-\-xdisplay=\fIhostname:number.screen_number\fR
تنظیم xdisplay مورد استفاده.
.TP
.BR \-f ", " \-\-format=\fISTRING\fR
تنظیم فرمت خروجی دلخواه؛ به‌طور پیش‌فرض maim تلاش می‌کند تا فرمت خروجی مورد نظر را به شکل خودکار بر اساس فایل خروجی تشخیص دهد. در صورت عدم موفقیت، به فرمت بدون افت png بازمی‌گردد. در حال حاضر فقط از `png`، `jpg`، `bmp` و `webp` پشتیبانی می‌کند.
.TP
.BR \-i ", " \-\-window=\fIWINDOW\fR
به‌طور پیش‌فرض، maim پنجره ریشه (root) را ضبط می‌کند. این پارامتر این رفتار را لغو کرده و پنجره مورد نظر را برای تصویربرداری تنظیم می‌کند. برای ورودی یک عدد صحیح، مقدار هگزادسیمال یا `root` را می‌پذیرد.
.TP
.BR \-g ", " \-\-geometry=\fIGEOMETRY\fR
ناحیه مورد نظر برای ضبط را مشخص می‌کند و از مختصات محلی پنجره داده‌شده استفاده می‌نماید. بنابراین -g 10x30-5+0 نشان‌دهنده مستطیل wxh+x+y است که در آن w=10، h=30، x=-5 و y=0 می‌باشد. x و y موقعیت گوشه بالا و سمت چپ این مستطیل هستند.
.TP
.BR \-w ", " \-\-parent=\fIWINDOW\fR
به‌طور پیش‌فرض، maim مقادیر --geometry را نسبت به --window مشخص‌شده (یا ریشه در صورت مشخص نشدن) در نظر می‌گیرد. این پارامتر این رفتار را بازنویسی کرده و باعث می‌شود هندسه نسبت به هر پنجره‌ای که به --parent داده‌اید تعیین شود. ورودی می‌تواند عدد صحیح، هگزادسیمال یا `root` باشد.
.TP
.BR \-B ", " \-\-capturebackground
به‌طور پیش‌فرض هنگام ضبط یک پنجره، maim هر چیزی که زیر پنجره مشخص‌شده قرار دارد را نادیده می‌گیرد. این پارامتر رفتار پیش‌فرض را لغو کرده و عناصر زیر پنجره را نیز ضبط می‌کند.
.TP
.BR \-d ", " \-\-delay=\fIFLOAT\fR
تنظیم زمان انتظار بر حسب ثانیه پیش از گرفتن تصویر صفحه. پیامی ساده برای نمایش ثانیه‌های باقی‌مانده تا گرفتن تصویر چاپ می‌کند. برای غیرفعال کردن این پیام، \-\-quiet را ببینید.
.TP
.BR \-u ", " \-\-hidecursor
به‌طور پیش‌فرض maim مکان‌نما را روی تصویر قرار می‌دهد؛ با این گزینه می‌توانید این رفتار را غیرفعال کنید.
.TP
.BR \-m ", " \-\-quality
یک عدد صحیح بین 1 تا 10 که کیفیت فشرده‌سازی را مشخص می‌کند. برای فرمت‌های اتلافی (jpg و webp)، مقادیر کمتر فایل‌های کوچک‌تر با کیفیت پایین‌تر ایجاد می‌کنند، در حالی که مقادیر بیشتر کیفیت را به قیمت افزایش حجم فایل بالا می‌برند. کیفیت 10 برای webp بدون افت است. برای png، مقادیر کمتر سریع‌تر فشرده شده و فایل‌های بزرگ‌تری تولید می‌کنند، در حالی که مقادیر بالاتر کندتر فشرده شده اما فایل‌های کوچک‌تری تولید می‌نمایند. روی تصاویر bmp بی‌تأثیر است.
.TP
.BR \-s ", " \-\-select
فعال‌سازی حالت انتخاب تعاملی که در آن می‌توانید پیش از گرفتن اسکرین‌شات، ناحیه یا پنجره مورد نظر را انتخاب کنید. از تنظیمات زیر برای تعیین جلوه‌های بصری و تنظیمات slop استفاده می‌کند.
.SH "گزینه‌های SLOP (SLOP OPTIONS)"
.TP
.BR \-b ", " \-\-bordersize=\fIFLOAT\fR
ضخامت مستطیل انتخاب را تعیین می‌کند.
.TP
.BR \-p ", " \-\-padding=\fIFLOAT\fR
اندازه حاشیه (padding) برای ناحیه انتخابی را تنظیم می‌کند؛ این مقدار می‌تواند منفی باشد.
.TP
.BR \-t ", " \-\-tolerance=\fIFLOAT\fR
میزان جابه‌جایی ماوس بر حسب پیکسل پس از کلیک که همچنان به عنوان یک کلیک عادی در نظر گرفته شود و نه کلیک و کشیدن (drag). تنظیم این مقدار روی 0 انتخاب پنجره را غیرفعال می‌کند. از طرف دیگر، تنظیم آن روی 9999999 انتخاب پنجره را اجباری می‌سازد.
.TP
.BR \-c ", " \-\-color=\fIFLOAT,FLOAT,FLOAT,FLOAT\fR
رنگ مستطیل انتخاب را تعیین می‌کند. از ورودی RGB یا RGBA پشتیبانی می‌نماید. بسته به مدیر پنجره سیستم یا پشتیبانی از OpenGL، ممکن است شفافیت نادیده گرفته شود.
.TP
.BR \-r ", " \-\-shader=\fISTRING\fR
ترکیب شیدرهای راس (vertex shader) و شیدرهای پیکسلی (fragment shader) را برای رسم فریم‌بافر نهایی روی صفحه تنظیم می‌کند. طبیعتاً این گزینه تنها زمانی کار می‌کند که OpenGL فعال باشد. شیدرها از مسیر ~/.config/maim بارگذاری می‌شوند. برای اطلاعات بیشتر در مورد نحوه ساخت شیدرهای خود به <https://github.com/naelstrof/slop> مراجعه کنید.
.TP
.BR \-n ", " \-\-nodecorations=\fIINT\fR
میزان شدت عمل در هنگام تلاش برای حذف تزیینات پنجره را تعیین می‌کند. مقدار `0' غیرفعال است، `1' تلاشی ملایم برای حذف تزیینات انجام می‌دهد، و `2' به شکل بازگشتی در درخت ریشه پایین می‌رود تا عمیق‌ترین عنصر فرزند قابل مشاهده زیر ماوس را بیابد. پیش‌فرض `0' است.
.TP
.BR \-l ", " \-\-highlight
به جای کادربندی دور ناحیه انتخابی، maim آن را برجسته (highlight) می‌کند. این گزینه به‌ویژه زمانی که شفافیت رنگ کمتر از 1 تنظیم شده باشد مفید است.
.TP
.BR \-D ", " \-\-nodrag
به جای کلیک و کشیدن، به شما امکان می‌دهد با دو بار کلیک کردن ناحیه انتخابی را مشخص کنید.
.TP
.BR \-q ", " \-\-quiet
غیرفعال کردن هرگونه خروجی غیرضروری cerr. هیچ هشدار یا اطلاعاتی چاپ نخواهد شد.
.TP
.BR \-k ", " \-\-nokeyboard
قابلیت لغو انتخاب‌ها با صفحه‌کلید را غیرفعال می‌کند.
.TP
.BR \-o ", " \-\-noopengl
شتاب‌دهنده گرافیکی سخت‌افزاری را غیرفعال می‌کند.
.SH "مثال‌ها (EXAMPLES)"
تصویربرداری از پنجره فعال و ذخیره آن در حافظه موقت (کلیپ‌بورد) برای جای‌گذاری سریع.
.PP
.nf
.RS
maim -i $(xdotool getactivewindow) | xclip -selection clipboard -t image/png
.RE
.fi
.PP
ذخیره تصویر صفحه نمایش با برچسب زمانی یکتا و مرتب در پوشه Pictures.
.PP
.nf
.RS
maim ~/Pictures/$(date +%s).png
.RE
.fi
.PP
ذخیره تصویر صفحه در پوشه Pictures و همزمان افزودن آن به حافظه موقت.
.PP
.nf
.RS
maim | tee ~/Pictures/$(date +%s).png | xclip -selection clipboard -t image/png
.RE
.fi
.PP
درخواست از کاربر برای مشخص کردن ناحیه تصویربرداری، افزودن سایه جذاب به آن و سپس ذخیره در shadow.png.
.PP
.nf
.RS
maim -s | convert - \\( +clone -background black -shadow 80x3+5+5 \\) +swap -background none -layers merge +repage shadow.png
.RE
.fi
.PP
در اسکریپت‌ها، در اینجا در مدیر پنجره i3: روشن کردن چراغ روی لپ‌تاپ Thinkpad T430، پنج ثانیه انتظار، گرفتن تصویر از تمامی نمایشگرها، ذخیره فایلی مانند ~/screenshots/2022-dec-21--12-56-08_maim.png، خاموش کردن چراغ و نمایش پیام هشدار i3 به مدت ۳ ثانیه.
.PP
.nf
.RS
bindsym $mod+Shift+x exec "\
    echo 1 > /sys/class/leds/platform\:\:micmute/brightness; \
    sleep 5; \
    maim --hidecursor ~/screenshots/$(date +%Y-%b-%d--%H-%M-%S_maim | tr A-Z a-z).png; \
    echo 0 > /sys/class/leds/platform\:\:micmute/brightness; \
    i3-nagbar --message 'Screenshot created' --type warning & \
    sleep 3; pkill i3-nagbar"
.RE
.fi
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR slop(1)
.SH "اشکالات (BUGS)"
هیچ اشکال شناخته‌شده‌ای وجود ندارد.
.SH "نویسنده (AUTHOR)"
Dalton Nell (naelstrof@gmail.com)