.\" 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 "grim" "1" "2025-08-05"
.PP
.SH "نام (NAME)"
.PP
grim \- گرفتن اسکرین‌شات و تصویربرداری از کامپوزیتور ویلند (Wayland)
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBgrim\fR [گزینه‌ها.\&.\&.\&] [output-file]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور grim یک ابزار خط فرمانی برای گرفتن اسکرین‌شات از محیط‌های دسکتاپ ویلند (Wayland) است.\& در حال حاضر برای کارکرد صحیح نیازمند پشتیبانی از پروتکل screencopy است.\& پشتیبانی از پروتکل xdg-output اختیاری است، اما سازگاری با مقیاس‌بندی کسری (fractional scaling) را بهبود می‌بخشد.\&
.PP
دستور grim تصویر را در \fIoutput-file\fR می‌نویسد، یا در صورت مشخص نشدن، آن را در فایلی با نام حاوی برچسب زمانی در \fB$GRIM_DEFAULT_DIR\fR ذخیره می‌کند.\& اگر متغیر \fB$GRIM_DEFAULT_DIR\fR تنظیم نشده باشد، ابتدا به متغیر \fB$XDG_PICTURES_DIR\fR و سپس به دایرکتوری کاری جاری رجوع می‌کند.\& اگر \fIoutput-file\fR برابر با \fB-\fR باشد، grim در عوض تصویر را در خروجی استاندارد می‌نویسد.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-s\fR <factor>
.RS 4
تنظیم ضریب مقیاس تصویر خروجی روی \fIfactor\fR.\& به‌طور پیش‌فرض، ضریب مقیاس برابر با بیشترین مقدار در میان تمام خروجی‌ها تنظیم می‌شود.\&
.PP
.RE
\fB-g\fR "<x>,<y> <width>x<height>"
.RS 4
تنظیم ناحیه مورد نظر برای تصویربرداری بر حسب مختصات چیدمان (layout coordinates).\&
.PP
اگر برابر با \fB-\fR تنظیم شود، در عوض ناحیه را از ورودی استاندارد می‌خواند.\&
.PP
.RE
\fB-t\fR <type>
.RS 4
تنظیم فرمت فایل تصویر خروجی روی \fItype\fR.\& به‌طور پیش‌فرض، فرمت فایل روی \fBpng\fR تنظیم شده است؛ مقادیر معتبر عبارتند از \fBpng\fR، \fBjpeg\fR یا \fBppm\fR.\&
.PP
.RE
\fB-q\fR <quality>
.RS 4
تنظیم نرخ فشرده‌سازی فرمت jpeg خروجی روی \fIquality\fR.\& به‌طور پیش‌فرض، کیفیت jpeg برابر با \fB80\fR است؛ مقادیر معتبر بین ۰ تا ۱۰۰ هستند.\&
.PP
.RE
\fB-l\fR <level>
.RS 4
تنظیم سطح فشرده‌سازی فرمت PNG خروجی روی \fIlevel\fR.\& به‌طور پیش‌فرض، سطح فشرده‌سازی PNG برابر با ۶ در مقیاسی بین ۰ تا ۹ است.\& سطح ۹ بالاترین نسبت فشرده‌سازی را ارائه می‌دهد، اما ممکن است کند باشد؛ سطح ۱ نسبت فشرده‌سازی پایین‌تری ارائه می‌دهد، اما سریع‌تر است.\& سطح ۰ هیچ‌گونه فشرده‌سازی انجام نمی‌دهد و فایل‌های بسیار حجیمی تولید می‌کند؛ این حالت می‌تواند زمانی مفید باشد که grim در یک خط لوله (pipeline) همراه با سایر دستورات استفاده شود.\&
.PP
.RE
\fB-o\fR <output>
.RS 4
تنظیم نام خروجی (صفحه‌نمایش) مورد نظر برای تصویربرداری.\&
.PP
.RE
\fB-c\fR
.RS 4
گنجاندن مکان‌نماها در اسکرین‌شات.\&
.PP
.RE
\fB-T\fR <identifier>
.RS 4
تنظیم شناسه هندل سطح بالای خارجی (foreign toplevel handle) برای تصویربرداری.\&
.PP
.RE
.SH "نویسندگان (AUTHORS)"
.PP
توسعه و نگهداری توسط Simon Ser <contact@emersion.\&fr>، با همراهی سایر مشارکت‌کنندگان متن‌باز انجام شده است.\& برای کسب اطلاعات بیشتر پیرامون روند توسعه grim، نشانی زیر را ببینید:
<https://gitlab.\&freedesktop.\&org/emersion/grim>.\&