maim(1) maim man page maim(1)

maim - تصویربرداری از میزکار و ساخت تصویر

maim [OPTIONS] [FILEPATH]

برنامه maim (کوتاه‌شده‌ی make image) ابزاری است که از میزکار شما اسکرین‌شات (تصویر صفحه) می‌گیرد و آن را در قالب تصویر png، jpg، bmp یا webp کدگذاری می‌کند. به‌طور پیش‌فرض، داده‌های تصویر کدگذاری‌شده مستقیماً به خروجی استاندارد فرستاده می‌شوند.

نمایش راهنما و خروج.
نمایش نسخه و خروج.
تنظیم xdisplay مورد استفاده.
تنظیم فرمت خروجی دلخواه؛ به‌طور پیش‌فرض maim تلاش می‌کند تا فرمت خروجی مورد نظر را به شکل خودکار بر اساس فایل خروجی تشخیص دهد. در صورت عدم موفقیت، به فرمت بدون افت png بازمی‌گردد. در حال حاضر فقط از `png`، `jpg`، `bmp` و `webp` پشتیبانی می‌کند.
به‌طور پیش‌فرض، maim پنجره ریشه (root) را ضبط می‌کند. این پارامتر این رفتار را لغو کرده و پنجره مورد نظر را برای تصویربرداری تنظیم می‌کند. برای ورودی یک عدد صحیح، مقدار هگزادسیمال یا `root` را می‌پذیرد.
ناحیه مورد نظر برای ضبط را مشخص می‌کند و از مختصات محلی پنجره داده‌شده استفاده می‌نماید. بنابراین -g 10x30-5+0 نشان‌دهنده مستطیل wxh+x+y است که در آن w=10، h=30، x=-5 و y=0 می‌باشد. x و y موقعیت گوشه بالا و سمت چپ این مستطیل هستند.
به‌طور پیش‌فرض، maim مقادیر --geometry را نسبت به --window مشخص‌شده (یا ریشه در صورت مشخص نشدن) در نظر می‌گیرد. این پارامتر این رفتار را بازنویسی کرده و باعث می‌شود هندسه نسبت به هر پنجره‌ای که به --parent داده‌اید تعیین شود. ورودی می‌تواند عدد صحیح، هگزادسیمال یا `root` باشد.
به‌طور پیش‌فرض هنگام ضبط یک پنجره، maim هر چیزی که زیر پنجره مشخص‌شده قرار دارد را نادیده می‌گیرد. این پارامتر رفتار پیش‌فرض را لغو کرده و عناصر زیر پنجره را نیز ضبط می‌کند.
تنظیم زمان انتظار بر حسب ثانیه پیش از گرفتن تصویر صفحه. پیامی ساده برای نمایش ثانیه‌های باقی‌مانده تا گرفتن تصویر چاپ می‌کند. برای غیرفعال کردن این پیام، --quiet را ببینید.
به‌طور پیش‌فرض maim مکان‌نما را روی تصویر قرار می‌دهد؛ با این گزینه می‌توانید این رفتار را غیرفعال کنید.
یک عدد صحیح بین 1 تا 10 که کیفیت فشرده‌سازی را مشخص می‌کند. برای فرمت‌های اتلافی (jpg و webp)، مقادیر کمتر فایل‌های کوچک‌تر با کیفیت پایین‌تر ایجاد می‌کنند، در حالی که مقادیر بیشتر کیفیت را به قیمت افزایش حجم فایل بالا می‌برند. کیفیت 10 برای webp بدون افت است. برای png، مقادیر کمتر سریع‌تر فشرده شده و فایل‌های بزرگ‌تری تولید می‌کنند، در حالی که مقادیر بالاتر کندتر فشرده شده اما فایل‌های کوچک‌تری تولید می‌نمایند. روی تصاویر bmp بی‌تأثیر است.
فعال‌سازی حالت انتخاب تعاملی که در آن می‌توانید پیش از گرفتن اسکرین‌شات، ناحیه یا پنجره مورد نظر را انتخاب کنید. از تنظیمات زیر برای تعیین جلوه‌های بصری و تنظیمات slop استفاده می‌کند.

ضخامت مستطیل انتخاب را تعیین می‌کند.
اندازه حاشیه (padding) برای ناحیه انتخابی را تنظیم می‌کند؛ این مقدار می‌تواند منفی باشد.
میزان جابه‌جایی ماوس بر حسب پیکسل پس از کلیک که همچنان به عنوان یک کلیک عادی در نظر گرفته شود و نه کلیک و کشیدن (drag). تنظیم این مقدار روی 0 انتخاب پنجره را غیرفعال می‌کند. از طرف دیگر، تنظیم آن روی 9999999 انتخاب پنجره را اجباری می‌سازد.
رنگ مستطیل انتخاب را تعیین می‌کند. از ورودی RGB یا RGBA پشتیبانی می‌نماید. بسته به مدیر پنجره سیستم یا پشتیبانی از OpenGL، ممکن است شفافیت نادیده گرفته شود.
ترکیب شیدرهای راس (vertex shader) و شیدرهای پیکسلی (fragment shader) را برای رسم فریم‌بافر نهایی روی صفحه تنظیم می‌کند. طبیعتاً این گزینه تنها زمانی کار می‌کند که OpenGL فعال باشد. شیدرها از مسیر ~/.config/maim بارگذاری می‌شوند. برای اطلاعات بیشتر در مورد نحوه ساخت شیدرهای خود به https://github.com/naelstrof/slop مراجعه کنید.
میزان شدت عمل در هنگام تلاش برای حذف تزیینات پنجره را تعیین می‌کند. مقدار `0' غیرفعال است، `1' تلاشی ملایم برای حذف تزیینات انجام می‌دهد، و `2' به شکل بازگشتی در درخت ریشه پایین می‌رود تا عمیق‌ترین عنصر فرزند قابل مشاهده زیر ماوس را بیابد. پیش‌فرض `0' است.
به جای کادربندی دور ناحیه انتخابی، maim آن را برجسته (highlight) می‌کند. این گزینه به‌ویژه زمانی که شفافیت رنگ کمتر از 1 تنظیم شده باشد مفید است.
به جای کلیک و کشیدن، به شما امکان می‌دهد با دو بار کلیک کردن ناحیه انتخابی را مشخص کنید.
غیرفعال کردن هرگونه خروجی غیرضروری cerr. هیچ هشدار یا اطلاعاتی چاپ نخواهد شد.
قابلیت لغو انتخاب‌ها با صفحه‌کلید را غیرفعال می‌کند.
شتاب‌دهنده گرافیکی سخت‌افزاری را غیرفعال می‌کند.

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

maim -i $(xdotool getactivewindow) | xclip -selection clipboard -t image/png

ذخیره تصویر صفحه نمایش با برچسب زمانی یکتا و مرتب در پوشه Pictures.

maim ~/Pictures/$(date +%s).png

ذخیره تصویر صفحه در پوشه Pictures و همزمان افزودن آن به حافظه موقت.

maim | tee ~/Pictures/$(date +%s).png | xclip -selection clipboard -t image/png

درخواست از کاربر برای مشخص کردن ناحیه تصویربرداری، افزودن سایه جذاب به آن و سپس ذخیره در shadow.png.

maim -s | convert - \( +clone -background black -shadow 80x3+5+5 \) +swap -background none -layers merge +repage shadow.png

در اسکریپت‌ها، در اینجا در مدیر پنجره i3: روشن کردن چراغ روی لپ‌تاپ Thinkpad T430، پنج ثانیه انتظار، گرفتن تصویر از تمامی نمایشگرها، ذخیره فایلی مانند ~/screenshots/2022-dec-21--12-56-08_maim.png، خاموش کردن چراغ و نمایش پیام هشدار i3 به مدت ۳ ثانیه.

bindsym $mod+Shift+x exec "    echo 1 > /sys/class/leds/platformmicmute/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/platformmicmute/brightness;     i3-nagbar --message 'Screenshot created' --type warning &     sleep 3; pkill i3-nagbar"

slop(1)

هیچ اشکال شناخته‌شده‌ای وجود ندارد.

Dalton Nell (naelstrof@gmail.com)

2021-02-03 Linux