maim(1) maim man page maim(1) نام (NAME) maim - تصویربرداری از میزکار و ساخت تصویر خلاصه دستور (SYNOPSIS) maim [OPTIONS] [FILEPATH] توضیحات (DESCRIPTION) برنامه maim (کوتاه‌شده‌ی make image) ابزاری است که از میزکار شما اسکرین‌شات (تصویر صفحه) می‌گیرد و آن را در قالب تصویر png، jpg، bmp یا webp کدگذاری می‌کند. به‌طور پیش‌فرض، داده‌های تصویر کدگذاری‌شده مستقیماً به خروجی استاندارد فرستاده می‌شوند. گزینه‌ها (OPTIONS) -h, --help نمایش راهنما و خروج. -v, --version نمایش نسخه و خروج. -x, --xdisplay=hostname:number.screen_number تنظیم xdisplay مورد استفاده. -f, --format=STRING تنظیم فرمت خروجی دلخواه؛ به‌طور پیش‌فرض maim تلاش می‌کند تا فرمت خروجی مورد نظر را به شکل خودکار بر اساس فایل خروجی تشخیص دهد. در صورت عدم موفقیت، به فرمت بدون افت png بازمی‌گردد. در حال حاضر فقط از `png`، `jpg`، `bmp` و `webp` پشتیبانی می‌کند. -i, --window=WINDOW به‌طور پیش‌فرض، maim پنجره ریشه (root) را ضبط می‌کند. این پارامتر این رفتار را لغو کرده و پنجره مورد نظر را برای تصویربرداری تنظیم می‌کند. برای ورودی یک عدد صحیح، مقدار هگزادسیمال یا `root` را می‌پذیرد. -g, --geometry=GEOMETRY ناحیه مورد نظر برای ضبط را مشخص می‌کند و از مختصات محلی پنجره داده‌شده استفاده می‌نماید. بنابراین -g 10x30-5+0 نشان‌دهنده مستطیل wxh+x+y است که در آن w=10، h=30، x=-5 و y=0 می‌باشد. x و y موقعیت گوشه بالا و سمت چپ این مستطیل هستند. -w, --parent=WINDOW به‌طور پیش‌فرض، maim مقادیر --geometry را نسبت به --window مشخص‌شده (یا ریشه در صورت مشخص نشدن) در نظر می‌گیرد. این پارامتر این رفتار را بازنویسی کرده و باعث می‌شود هندسه نسبت به هر پنجره‌ای که به --parent داده‌اید تعیین شود. ورودی می‌تواند عدد صحیح، هگزادسیمال یا `root` باشد. -B, --capturebackground به‌طور پیش‌فرض هنگام ضبط یک پنجره، maim هر چیزی که زیر پنجره مشخص‌شده قرار دارد را نادیده می‌گیرد. این پارامتر رفتار پیش‌فرض را لغو کرده و عناصر زیر پنجره را نیز ضبط می‌کند. -d, --delay=FLOAT تنظیم زمان انتظار بر حسب ثانیه پیش از گرفتن تصویر صفحه. پیامی ساده برای نمایش ثانیه‌های باقی‌مانده تا گرفتن تصویر چاپ می‌کند. برای غیرفعال کردن این پیام، --quiet را ببینید. -u, --hidecursor به‌طور پیش‌فرض maim مکان‌نما را روی تصویر قرار می‌دهد؛ با این گزینه می‌توانید این رفتار را غیرفعال کنید. -m, --quality یک عدد صحیح بین 1 تا 10 که کیفیت فشرده‌سازی را مشخص می‌کند. برای فرمت‌های اتلافی (jpg و webp)، مقادیر کمتر فایل‌های کوچک‌تر با کیفیت پایین‌تر ایجاد می‌کنند، در حالی که مقادیر بیشتر کیفیت را به قیمت افزایش حجم فایل بالا می‌برند. کیفیت 10 برای webp بدون افت است. برای png، مقادیر کمتر سریع‌تر فشرده شده و فایل‌های بزرگ‌تری تولید می‌کنند، در حالی که مقادیر بالاتر کندتر فشرده شده اما فایل‌های کوچک‌تری تولید می‌نمایند. روی تصاویر bmp بی‌تأثیر است. -s, --select فعال‌سازی حالت انتخاب تعاملی که در آن می‌توانید پیش از گرفتن اسکرین‌شات، ناحیه یا پنجره مورد نظر را انتخاب کنید. از تنظیمات زیر برای تعیین جلوه‌های بصری و تنظیمات slop استفاده می‌کند. گزینه‌های SLOP (SLOP OPTIONS) -b, --bordersize=FLOAT ضخامت مستطیل انتخاب را تعیین می‌کند. -p, --padding=FLOAT اندازه حاشیه (padding) برای ناحیه انتخابی را تنظیم می‌کند؛ این مقدار می‌تواند منفی باشد. -t, --tolerance=FLOAT میزان جابه‌جایی ماوس بر حسب پیکسل پس از کلیک که همچنان به عنوان یک کلیک عادی در نظر گرفته شود و نه کلیک و کشیدن (drag). تنظیم این مقدار روی 0 انتخاب پنجره را غیرفعال می‌کند. از طرف دیگر، تنظیم آن روی 9999999 انتخاب پنجره را اجباری می‌سازد. -c, --color=FLOAT,FLOAT,FLOAT,FLOAT رنگ مستطیل انتخاب را تعیین می‌کند. از ورودی RGB یا RGBA پشتیبانی می‌نماید. بسته به مدیر پنجره سیستم یا پشتیبانی از OpenGL، ممکن است شفافیت نادیده گرفته شود. -r, --shader=STRING ترکیب شیدرهای راس (vertex shader) و شیدرهای پیکسلی (fragment shader) را برای رسم فریم‌بافر نهایی روی صفحه تنظیم می‌کند. طبیعتاً این گزینه تنها زمانی کار می‌کند که OpenGL فعال باشد. شیدرها از مسیر ~/.config/maim بارگذاری می‌شوند. برای اطلاعات بیشتر در مورد نحوه ساخت شیدرهای خود به مراجعه کنید. -n, --nodecorations=INT میزان شدت عمل در هنگام تلاش برای حذف تزیینات پنجره را تعیین می‌کند. مقدار `0' غیرفعال است، `1' تلاشی ملایم برای حذف تزیینات انجام می‌دهد، و `2' به شکل بازگشتی در درخت ریشه پایین می‌رود تا عمیق‌ترین عنصر فرزند قابل مشاهده زیر ماوس را بیابد. پیش‌فرض `0' است. -l, --highlight به جای کادربندی دور ناحیه انتخابی، maim آن را برجسته (highlight) می‌کند. این گزینه به‌ویژه زمانی که شفافیت رنگ کمتر از 1 تنظیم شده باشد مفید است. -D, --nodrag به جای کلیک و کشیدن، به شما امکان می‌دهد با دو بار کلیک کردن ناحیه انتخابی را مشخص کنید. -q, --quiet غیرفعال کردن هرگونه خروجی غیرضروری cerr. هیچ هشدار یا اطلاعاتی چاپ نخواهد شد. -k, --nokeyboard قابلیت لغو انتخاب‌ها با صفحه‌کلید را غیرفعال می‌کند. -o, --noopengl شتاب‌دهنده گرافیکی سخت‌افزاری را غیرفعال می‌کند. مثال‌ها (EXAMPLES) تصویربرداری از پنجره فعال و ذخیره آن در حافظه موقت (کلیپ‌بورد) برای جای‌گذاری سریع. 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" همچنین ببینید (SEE ALSO) slop(1) اشکالات (BUGS) هیچ اشکال شناخته‌شده‌ای وجود ندارد. نویسنده (AUTHOR) Dalton Nell (naelstrof@gmail.com) Linux 2021-02-03 maim(1)