نام (NAME)

grim - گرفتن اسکرین‌شات و تصویربرداری از کامپوزیتور ویلند (Wayland)

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

grim [گزینه‌ها...] [output-file]

توضیحات (DESCRIPTION)

دستور grim یک ابزار خط فرمانی برای گرفتن اسکرین‌شات از محیط‌های دسکتاپ ویلند (Wayland) است. در حال حاضر برای کارکرد صحیح نیازمند پشتیبانی از پروتکل screencopy است. پشتیبانی از پروتکل xdg-output اختیاری است، اما سازگاری با مقیاس‌بندی کسری (fractional scaling) را بهبود می‌بخشد.

دستور grim تصویر را در output-file می‌نویسد، یا در صورت مشخص نشدن، آن را در فایلی با نام حاوی برچسب زمانی در $GRIM_DEFAULT_DIR ذخیره می‌کند. اگر متغیر $GRIM_DEFAULT_DIR تنظیم نشده باشد، ابتدا به متغیر $XDG_PICTURES_DIR و سپس به دایرکتوری کاری جاری رجوع می‌کند. اگر output-file برابر با - باشد، grim در عوض تصویر را در خروجی استاندارد می‌نویسد.

گزینه‌ها (OPTIONS)

-h

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

-s <factor>

تنظیم ضریب مقیاس تصویر خروجی روی factor. به‌طور پیش‌فرض، ضریب مقیاس برابر با بیشترین مقدار در میان تمام خروجی‌ها تنظیم می‌شود.

-g "<x>,<y> <width>x<height>"

تنظیم ناحیه مورد نظر برای تصویربرداری بر حسب مختصات چیدمان (layout coordinates).

اگر برابر با - تنظیم شود، در عوض ناحیه را از ورودی استاندارد می‌خواند.

-t <type>

تنظیم فرمت فایل تصویر خروجی روی type. به‌طور پیش‌فرض، فرمت فایل روی png تنظیم شده است؛ مقادیر معتبر عبارتند از png، jpeg یا ppm.

-q <quality>

تنظیم نرخ فشرده‌سازی فرمت jpeg خروجی روی quality. به‌طور پیش‌فرض، کیفیت jpeg برابر با 80 است؛ مقادیر معتبر بین ۰ تا ۱۰۰ هستند.

-l <level>

تنظیم سطح فشرده‌سازی فرمت PNG خروجی روی level. به‌طور پیش‌فرض، سطح فشرده‌سازی PNG برابر با ۶ در مقیاسی بین ۰ تا ۹ است. سطح ۹ بالاترین نسبت فشرده‌سازی را ارائه می‌دهد، اما ممکن است کند باشد؛ سطح ۱ نسبت فشرده‌سازی پایین‌تری ارائه می‌دهد، اما سریع‌تر است. سطح ۰ هیچ‌گونه فشرده‌سازی انجام نمی‌دهد و فایل‌های بسیار حجیمی تولید می‌کند؛ این حالت می‌تواند زمانی مفید باشد که grim در یک خط لوله (pipeline) همراه با سایر دستورات استفاده شود.

-o <output>

تنظیم نام خروجی (صفحه‌نمایش) مورد نظر برای تصویربرداری.

-c

گنجاندن مکان‌نماها در اسکرین‌شات.

-T <identifier>

تنظیم شناسه هندل سطح بالای خارجی (foreign toplevel handle) برای تصویربرداری.

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

توسعه و نگهداری توسط Simon Ser <contact@emersion.fr>، با همراهی سایر مشارکت‌کنندگان متن‌باز انجام شده است. برای کسب اطلاعات بیشتر پیرامون روند توسعه grim، نشانی زیر را ببینید: https://gitlab.freedesktop.org/emersion/grim.