.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "SHUTTER 1"
.TH SHUTTER 1 2026-01-11 "perl v5.42.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
Shutter \- ابزار تصویربرداری از صفحه با امکانات فراوان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
shutter [گزینه‌ها]
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر نرم‌افزار Shutter متعلق به Mario Kemper و تیم Shutter است (C).
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBShutter\fR یک برنامه تصویربرداری از صفحه با امکانات غنی است. شما می‌توانید از ناحیه‌ای خاص، یک پنجره، تمام صفحه نمایش یا حتی از یک وب‌گاه تصویر بگیرید \- جلوه‌های مختلفی روی آن اعمال کنید، برای برجسته‌سازی نکات روی آن نقاشی بکشید و سپس آن را در یک سایت میزبانی تصویر بارگذاری نمایید، همگی درون یک پنجره واحد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "مثال ۱" 8
.IX Item "Example 1"
shutter \-a \-p=myprofile \-\-min_at_startup
.IP "مثال ۲" 8
.IX Item "Example 2"
shutter \-s=100,100,300,300 \-e
.IP "مثال ۳" 8
.IX Item "Example 3"
shutter \-\-window=.*firefox.*
.IP "مثال ۴" 8
.IX Item "Example 4"
shutter \-\-web=http://shutter\-project.org \-e
.SS "گزینه‌های حالت تصویربرداری"
.IX Subsection "CAPTURE MODE OPTIONS"
.IP "\fB\-s, \-\-select=[X,Y,WIDTH,HEIGHT]\fR" 8
.IX Item "-s, --select=[X,Y,WIDTH,HEIGHT]"
تصویربرداری از ناحیه‌ای از صفحه نمایش. ارائه مقادیر X,Y,WIDTH,HEIGHT اختیاری است.
.IP "\fB\-f, \-\-full\fR" 8
.IX Item "-f, --full"
تصویربرداری از تمام صفحه نمایش.
.IP "\fB\-w, \-\-window=[NAME_PATTERN]\fR" 8
.IX Item "-w, --window=[NAME_PATTERN]"
انتخاب یک پنجره برای تصویربرداری. ارائه یک NAME_PATTERN (عبارت باقاعده به سبک Perl) اختیاری است.
.IP "\fB\-a, \-\-active\fR" 8
.IX Item "-a, --active"
تصویربرداری از پنجره فعال فعلی.
.IP "\fB\-m, \-\-menu\fR" 8
.IX Item "-m, --menu"
تصویربرداری از یک منو.
.IP "\fB\-t, \-\-tooltip\fR" 8
.IX Item "-t, --tooltip"
تصویربرداری از یک تول‌تیپ (راهنمای متنی).
.IP \fB\-\-web=[URL]\fR 8
.IX Item "--web=[URL]"
تصویربرداری از یک صفحه وب. ارائه یک URL اختیاری است.
.IP "\fB\-r, \-\-redo\fR" 8
.IX Item "-r, --redo"
تکرار آخرین تصویربرداری.
.SS "گزینه‌های تنظیمات"
.IX Subsection "SETTINGS OPTIONS"
.IP "\fB\-p, \-\-profile=NAME\fR" 8
.IX Item "-p, --profile=NAME"
بارگذاری یک نمایه (profile) مشخص در هنگام راه‌اندازی.
.IP "\fB\-o, \-\-output=FILENAME\fR" 8
.IX Item "-o, --output=FILENAME"
تعیین نام فایل برای ذخیره تصویر گرفته‌شده (تنظیمات مرتبط با نمایه را لغو و بازنویسی می‌کند).
.Sp
\&\fBقالب‌های تصویری پشتیبانی‌شده:\fR شما می‌توانید در هر یک از قالب‌های تصویری محبوب (مانند jpeg, png, gif, bmp) ذخیره کنید. علاوه بر این، امکان ذخیره در قالب‌های pdf, ps یا svg نیز وجود دارد.
.Sp
\&\fBلطفاً توجه داشته باشید:\fR کاراکترهای جانشین (wildcards) متعددی در دسترس هستند.
.Sp
کاراکترهای جانشین ارائه‌شده توسط Shutter عبارتند از:
.Sp
.Vb 7
\& $w = width
\& $h = height
\& $name = multi\-purpose (e.g. window title)
\& $nb_name = like $name but without blanks in resulting strings
\& $profile = name of current profile
\& $R = random char (e.g. $RRRR = ag4r)
\& %NN = counter
.Ve
.Sp
علاوه بر این، کاراکترهای جانشین مرتبط با تاریخ نیز وجود دارند:
.Sp
.Vb 4
\& %Y = year
\& %m = month
\& %d = day
\& %T = time
.Ve
.Sp
رشته متنی توسط strftime تفسیر می‌شود. برای مثال‌های بیشتر به \f(CW\*(C`man strftime\*(C'\fR مراجعه کنید.
.Sp
\&\fBبه عنوان مثال:\fR دستور shutter \-f \-e \-o \*(Aq./%y\-%m\-%d_$w_$h.png\*(Aq فایلی به نام \*(Aq11\-10\-28_1280_800.png\*(Aq در دایرکتوری جاری ایجاد می‌کند.
.IP "\fB\-d, \-\-delay=SECONDS\fR" 8
.IX Item "-d, --delay=SECONDS"
صبر کردن به مدت n ثانیه قبل از گرفتن تصویر.
.IP "\fB\-c, \-\-include_cursor\fR" 8
.IX Item "-c, --include_cursor"
گنجاندن مکان‌نما (cursor) هنگام تصویربرداری.
.IP "\fB\-C, \-\-remove_cursor\fR" 8
.IX Item "-C, --remove_cursor"
حذف مکان‌نما (cursor) هنگام تصویربرداری.
.SS "گزینه‌های برنامه"
.IX Subsection "APPLICATION OPTIONS"
.IP "\fB\-h, \-\-help\fR" 8
.IX Item "-h, --help"
نمایش یک پیام راهنمای خلاصه و خروج.
.IP "\fB\-v, \-\-version\fR" 8
.IX Item "-v, --version"
نمایش اطلاعات نسخه.
.IP \fB\-\-debug\fR 8
.IX Item "--debug"
چاپ مقادیر زیادی از اطلاعات اشکال‌زدایی در STDOUT.
.IP \fB\-\-clear_cache\fR 8
.IX Item "--clear_cache"
پاک‌سازی حافظه پنهان (cache)، به عنوان مثال افزونه‌های نصب‌شده، هنگام راه‌اندازی.
.IP \fB\-\-min_at_startup\fR 8
.IX Item "--min_at_startup"
اجرای Shutter به‌صورت کوچک‌شده در سینی سیستم (tray).
.IP \fB\-\-disable_systray\fR 8
.IX Item "--disable_systray"
غیرفعال کردن آیکون سینی سیستم (systray).
.IP "\fB\-e, \-\-exit_after_capture\fR" 8
.IX Item "-e, --exit_after_capture"
خروج پس از انجام نخستین تصویربرداری. این گزینه هنگام استفاده از Shutter در اسکریپت‌ها کاربردی است.
.IP "\fB\-n, \-\-no_session\fR" 8
.IX Item "-n, --no_session"
تصویر گرفته‌شده به نشست (session) افزوده نشود. این گزینه هنگام استفاده از Shutter در اسکریپت‌ها کاربردی است.
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUG REPORTS"
اگر نقصی در Shutter پیدا کردید، باید آن را گزارش دهید. اما نخست، باید مطمئن شوید که این واقعاً یک باگ است و در آخرین نسخه Shutter نیز وجود دارد.
.PP
جدیدترین نسخه همواره از این آدرس در دسترس است:
\&\fBhttps://github.com/shutter\-project/shutter/releases\fR
.PP
هنگامی که اطمینان یافتید یک باگ واقعاً وجود دارد، لطفاً آن را در گیت‌هاب گزارش کنید:
\&\fBhttps://github.com/shutter\-project/shutter/issues/new\fR