.\" vim:filetype=groff
.TH pqiv 1 "November 2025" "2.13.3"
.SH "نام (NAME)"
pqiv \- نمایشگر سریع و قدرتمند تصویر
.\"
.SH "خلاصه دستور (SYNOPSIS)"
\fBpqiv\fR [options] [filename(s)...]
.\"
.SH "توضیحات (DESCRIPTION)"
دستور \fBpqiv\fR یک نمایشگر تصویر خط فرمانی ساده با الهام از qiv است. این ابزار
بسیار انعطاف‌پذیر و سفارشی‌پذیر بوده و از فرمت‌های متنوعی پشتیبانی می‌کند.
.\"
.SH "گزینه‌ها (OPTIONS)"
.\"
.TP
.BR \-c ", " \-\-transparent\-background
رسم پنجرهٔ \fBpqiv\fR بدون حاشیه و به صورت شفاف. در حالت پنجره‌ای، کلیک
ماوس تزئینات پنجره را فعال و غیرفعال می‌کند.
.\"
.TP
.BR \-d ", " \-\-slideshow\-interval=\fISECONDS\fR
در حالت اسلایدشو (به‌طور پیش‌فرض با \fB\-\-slideshow\fR یا کلید \fBs\fR فعال می‌شود)،
تصاویر را با این نرخ جابه‌جا می‌کند. مقادیر ممیز شناور نیز پشتیبانی می‌شوند؛ برای
نمونه استفاده از 0.5 تصاویر را با نرخ دو تصویر در ثانیه جابه‌جا می‌کند.
.\"
.TP
.BR \-f ", " \-\-fullscreen
شروع در حالت تمام‌صفحه. به‌طور پیش‌فرض در زمان اجرا می‌توان با فشردن کلید \fBf\fR
حالت تمام‌صفحه را تغییر وضعیت داد.
.\"
.TP
.BR \-F  ", " \-\-fade
محو شدن تدریجی (Fade) میان تصاویر. همچنین \fB\-\-fade\-duration\fR را ببینید.
.\"
.TP
.BR \-i ", " \-\-hide\-info\-box
پنهان کردن اولیهٔ جعبهٔ اطلاعات. به‌طور پیش‌فرض می‌توان وضعیت نمایش این
جعبه را در زمان اجرا با فشردن کلید \fBi\fR تغییر داد.
.\"
.TP
.BR \-\-font=\fIFONT\fR
مشخص کردن رشتهٔ قلم Pango برای جعبهٔ اطلاعات. توجه داشته باشید که اندازهٔ قلم
متناسب با اندازهٔ پنجره مقیاس‌بندی خواهد شد.
.\"
.TP
.BR \-l ", " \-\-lazy\-load
دستور \fBpqiv\fR معمولاً پیش از نمایش پنجرهٔ اصلی خود، تمامی آرگومان‌های خط فرمان
را پردازش می‌کند. با فعال بودن این گزینه، پنجره به محض پیدا شدن و بارگذاری نخستین تصویر
نمایش داده می‌شود.
.\"
.TP
.BR \-n ", " \-\-sort
مرتب‌سازی تصاویر به‌جای ذخیرهٔ آن‌ها به همان ترتیبی که در خط فرمان داده شده و
در پوشه‌ها پیدا شده‌اند. ترتیب پیش‌فرض بر اساس نام است (ترتیب طبیعی). برای
تغییر این ترتیب \fB\-\-sort\-key\fR را ببینید.
.\"
.TP
.BR \-P ", " \-\-window\-position=\fIPOSITION\fR
تنظیم موقعیت اولیهٔ پنجره. مقدار \fIPOSITION\fR می‌تواند یکی از موارد زیر باشد:
.RS
.IP x,y 5
مختصات صفحهٔ نمایش، یا
.IP off
برای عدم تعیین موقعیت پنجره به طور کلی.
.RE
.\"
.TP
.BR \-r ", " \-\-additional\-from\-stdin
خواندن نام‌فایل‌ها/پوشه‌های اضافی از ورودی استاندارد. این گزینه با
\fB\-\-actions\-from\-stdin\fR تداخل دارد.
.\"
.TP
.BR \-s ", " \-\-slideshow
شروع در حالت اسلایدشو. به‌طور پیش‌فرض، حالت اسلایدشو در هنگام اجرا با فشردن
کلید \fBs\fR تغییر وضعیت می‌دهد.
.\"
.TP
.BR \-t ", " \-\-scale\-images\-up
بزرگ‌نمایی تصاویر تا حدی که کل صفحه را پر کنند. این گزینه به‌طور پیش‌فرض در زمان
اجرا با فشردن کلید \fBt\fR تغییر می‌کند. همچنین \fB\-\-disable\-scaling\fR را ببینید.
.\"
.TP
.BR \-T ", " \-\-window\-title=\fITITLE\fR
تنظیم عنوان پنجره. دستور \fBpqiv\fR چندین متغیر را درون \fITITLE\fR جایگزین می‌کند:
.RS
.IP $BASEFILENAME 15
نام پایهٔ فایل جاری (مانند `\fIimage.png\fR')،
.IP $FILENAME
مسیر و نام کامل فایل جاری (مانند `\fI/home/user/image.png\fR')،
.IP $WIDTH
عرض تصویر جاری بر حسب پیکسل،
.IP $HEIGHT
ارتفاع تصویر جاری بر حسب پیکسل،
.IP $ZOOM
سطح بزرگ‌نمایی جاری،
.IP $IMAGE_NUMBER
شماره یا اندیس تصویر جاری،
.IP $IMAGE_COUNT
تعداد کل تصاویر.
.PP
مقدار پیش‌فرض `pqiv: $FILENAME ($WIDTHx$HEIGHT) $ZOOM% [$IMAGE_NUMBER/$IMAGE_COUNT]' است.
.RE
.\"
.TP
.BR \-z ", " \-\-zoom\-level=\fIFLOAT\fR
تنظیم سطح بزرگ‌نمایی اولیه با یک مقدار ممیز شناور؛ به عنوان نمونه 1.0 معادل 100%
است. این مقدار تنها روی تصویر نخست اعمال می‌شود و تصاویر دیگر بر اساس حالت
مقیاس‌بندی (نگاه کنید به \fB\-\-scale\-images\-up\fR و \fB\-\-disable\-scaling\fR)
و اندازهٔ پنجره مقیاس‌بندی می‌شوند.
.\"
.TP
.BR \-1 ", " \-\-command\-1=\fICOMMAND\fR
انتساب دستور خارجی \fICOMMAND\fR به کلید 1. می‌توانید از 2..9 برای انتساب
دستورهای بیشتر استفاده کنید. قابلیت \fBACTIONS\fR (در ادامه) امکان انتساب کلیدهای دیگر به
سایر دستورها را فراهم می‌کند. دستور \fICOMMAND\fR با استفاده از پردازشگر پوستهٔ پیش‌فرض
اجرا می‌شود. مقدار `$1' با نام فایل جاری جایگزین می‌شود. اگر دستور با `|' یا `-' شروع نشود،
در صورت عدم وجود `$1'، نام فایل به انتهای خط فرمان ضمیمه می‌گردد.
.RS
.PP
اگر \fICOMMAND\fR با `>' شروع شود، خروجی استاندارد آن در یک پنجرهٔ بازشو (popup) نمایش داده می‌شود.
.PP
اگر \fICOMMAND\fR با `|' شروع شود، تصویر جاری به ورودی استاندارد آن هدایت (pipe) شده
و خروجی استاندارد آن به عنوان تصویر بارگذاری می‌شود. این روش می‌تواند برای پردازش تصاویر
مفید باشد.
.PP
اگر \fICOMMAND\fR با `-' شروع شود، فهرستی از تصاویر علامت‌گذاری‌شدهٔ جاری به ورودی
استاندارد آن هدایت می‌گردد.
.RE
.\"
.TP
.BR \-\-action=\fIACTION\fR
اجرای یک اقدام (\fIACTION\fR) مشخص هنگام شروع \fBpqiv\fR. ساختار نحو به این صورت است:
.RS
.RS
command(parameter); command(parameter);
.RE
برای دستورهای دردسترس، بخش \fBACTIONS\fR را در زیر ببینید.
.RE
.\"
.TP
.BR \-\-actions\-from\-stdin
مشابه \fB\-\-action\fR، اما اقدام‌ها را از ورودی استاندارد می‌خواند. برای نحو و دستورهای
موجود، بخش \fBACTIONS\fR در زیر را مشاهده کنید. این گزینه با \fB\-\-additional\-from\-stdin\fR
تداخل دارد.
.\"
.TP
.BR \-\-allow\-empty\-window
به‌طور معمول \fBpqiv\fR پنجرهٔ اصلی را تا زمان پیدا شدن دست‌کم یک تصویر نمایش نمی‌دهد،
و زمانی که دیگر نتواند هیچ تصویری را بارگذاری کند خارج می‌شود. با فعال بودن این گزینه،
در هر دو وضعیت یک پنجرهٔ خالی \fBpqiv\fR نشان داده می‌شود.
.\"
.TP
.BR \-\-auto\-montage\-mode
ورود خودکار به حالت مونتاژ (montage) در صورتی که \fBpqiv\fR با بیش از یک تصویر اجرا شود.
.\"
.TP
.BR \-\-background\-pattern=\fIPATTERN\fR
دستور \fBpqiv\fR به عنوان پس‌زمینهٔ تصاویر شفاف، یک طرح شطرنجی رسم می‌کند. با استفاده
از این گزینه می‌توانید پس‌زمینهٔ سفید یا سیاه را جایگزین کنید. مقادیر معتبر عبارتند از:
\fIcheckerboard\fR، \fIwhite\fR و \fIblack\fR.
.\"
.TP
.BR \-\-bind\-key=\fIKEY\ BINDING\fR
انتساب مجدد یک کلید به یک اقدام (action). ساختار نحو به این صورت است:
.RS
.RS
key sequence { command(parameter); command(parameter); }
.RE
توالی کلید (key sequence) می‌تواند شامل یک یا چند نویسه باشد، یا نویسه‌های ویژه که به شکل
`<name>' مشخص می‌شوند؛ که در آن name یک مشخصه‌ساز کلید GDK، یک دکمهٔ ماوس (`Mouse-1')،
یا جهت پیمایش (`Mouse-Scroll-1') است. برای نمونه اگر از `a<Control>b' استفاده کنید،
کاربر باید ابتدا کلید `a' و سپس control + `b' را بفشارد تا دستور اجرا شود. امکان انتساب همزمان
`a' و `ab' نیز وجود دارد؛ در این حالت اقدام منتسب به `a' با اندکی تأخیر اجرا می‌شود تا به کاربر
فرصت فشردن `b' داده شود. علامت نقطه ویرگول برای جداسازی دستورها اختیاری است. برای فهرست
دستورهای معتبر، بخش \fBACTIONS\fR را در زیر ببینید.
.PP
اگر مایلید نام مشخصه‌ساز یک کلید را بدانید، می‌توانید ابزار \fBxev\fR را اجرا کرده
و کلید مورد نظر را فشار دهید. نام keysym داخل پرانتز و پس از `keysym' و یک نمایش
هگزادسیمال چاپ می‌شود. روش جایگزین، اجرای دستور \fBxmodmap \-pk\fR است که نام‌های
نمادین را درون پرانتز خروجی می‌دهد؛ همچنین می‌توانید از فهرست موجود در
\fIhttps://git.gnome.org/browse/gtk+/plain/gdk/gdkkeysyms.h\fR استفاده کنید..PP
برنامه \fBpqiv\fR میانبرهای کلید را در زمینه‌های مختلفی گروه‌بندی می‌کند. در حال حاضر،
حالت \fImontage\fR تنها زمینه‌ای غیر از زمینه پیش‌فرض است: در
حالت \fImontage\fR، میانبرهای متفاوتی به کار می‌روند. برای تغییر زمینه
در زمان تنظیم توالی کلیدها، بنویسید
.RS
@MONTAGE { ... }
.RE
و میانبرهای ویژهٔ کلید را درون آکولادها درج کنید.
.RE
.\"
.TP
.BR \-\-box\-colors=\fIFOREGROUND\ COLOR:BACKGROUND\ COLOR\fR
سفارشی‌سازی رنگ‌های استفاده‌شده برای رسم جعبه اطلاعات و حاشیه‌های حالت montage. رنگ‌ها
را می‌توان به صورت فهرستی از مقادیر RGB جداشده با ویرگول در محدوده 0 تا 255 یا به عنوان
یک مقدار شانزده‌شانزدهی (hexvalue) مانند #aabbcc مشخص کرد. مقدار پیش‌فرض
\fI#000000:#ffff00\fR است.
.\"
.TP
.BR \-\-browse
به ازای هر آرگومان خط فرمان، علاوه بر آن تمامی تصاویر موجود در دایرکتوری آن تصویر
را بارگذاری می‌کند. \fBpqiv\fR همچنان از تصویری شروع خواهد کرد که به عنوان نخستین پارامتر
داده شده است.
.\"
.TP
.BR \-\-disable\-backends=\fILIST\ OF\ BACKENDS\fR
از این گزینه برای غیرفعال‌سازی انتخابی برخی از بک‌اندهای \fBpqiv\fR استفاده کنید. می‌توانید
فهرستی از بک‌اندهای جداشده با ویرگول را در اینجا مشخص نمایید. بک‌اندهای ناموجود بدون هشدار
نادیده گرفته می‌شوند. غیرفعال کردن بک‌اندهایی که نیاز ندارید، سرعت بارگذاری بازگشتی را به‌طور
چشمگیری افزایش می‌دهد، به‌ویژه اگر بک‌اند archive را غیرفعال کنید.
بک‌اندهای موجود عبارتند از:
.RS
.IP archive 14
پشتیبانی عمومی از فایل‌های آرشیو
.IP archive_cbx
پشتیبانی از آرشیو کتاب‌های مصور *.cb?
.IP libav
پشتیبانی از ویدیو، همچنین با ffmpeg نیز کار می‌کند
.IP gdkpixbuf
تصاویر
.IP poppler
PDF
.IP spectre
PS/EPS
.IP wand
ImageMagick، قالب‌های مختلف، مانند PSD
.IP webp
قالب WebP
.RE
.\"
.TP
.BR \-\-disable\-scaling
غیرفعال‌سازی کامل تغییر مقیاس. این مورد را می‌توان در زمان اجرا به‌طور پیش‌فرض
با فشردن \fBt\fR تغییر وضعیت داد. همچنین \fB\-\-scale\-images\-up\fR را ببینید.
.\"
.TP
.BR \-\-end\-of\-files\-action=\fIACTION\fR
اگر همهٔ فایل‌ها مشاهده شده باشند و قرار باشد تصویر بعدی نمایش داده شود، چه با درخواست
کاربر یا به دلیل فعال بودن حالت اسلایدشو، \fBpqiv\fR به‌طور پیش‌فرض چرخه را تکرار کرده
و از تصویر نخست دوباره شروع می‌کند. این پارامتر می‌تواند برای تغییر این رفتار استفاده شود.
گزینه‌های معتبر برای \fIACTION\fR عبارتند از:
.RS
.IP quit 20
خروج از \fBpqiv\fR،
.IP wait
انتظار تا زمانی که تصویر جدیدی در دسترس قرار گیرد. این گزینه تنها در صورتی منطقی است که
به همراه گزینه‌ای مانند \fB\-\-watch\-directories\fR استفاده شود،
.IP wrap\ (پیش‌فرض)
شروع مجدد از تصویر نخست. در حالت تصادفی (shuffle)، یک ترتیب تصادفی جدید انتخاب می‌شود،
.IP wrap-no-reshuffle
همانند wrap، اما در حالت تصادفی ترتیب را دوباره بر هم نمی‌زند.
.RE
.\"
.TP
.BR \-\-enforce\-window\-aspect\-ratio
به مدیر پنجره اعلام می‌کند که نسبت ابعاد پنجره را تحمیل کند. اگر این پرچم تنظیم
شده باشد، یک مدیر پنجرهٔ سازگار به کاربران اجازه نخواهد داد که اندازهٔ پنجرهٔ \fBpqiv\fR
را به نسبت ابعاد متفاوتی تغییر دهند.
این مورد پیش‌تر رفتار پیش‌فرض بود، اما مدیران پنجره معمولاً در کد مدیریت نسبت‌های
ابعاد اجباری دارای باگ هستند. اگر این پرچم تنظیم نشده باشد و نسبت ابعاد پنجره و تصویر
همخوانی نداشته باشند، تصویر همچنان با نسبت ابعاد درست رسم خواهد شد و حاشیه‌های سیاهی
در کناره‌ها افزوده می‌شود.
.\"
.TP
.BR \-\-fade\-duration=\fISECONDS\fR
همراه با \fB\-\-fade\fR، مدت‌زمان هر محو شدن را به این مقدار تنظیم می‌کند. مقادیر ممیز
شناور پذیرفته می‌شوند، برای مثال 0.5 باعث می‌شود هر بار محو شدن نیم ثانیه طول بکشد.
.\"
.TP
.BR \-\-low\-memory
تلاش برای نگه داشتن مصرف حافظه در کمترین مقدار ممکن. به عنوان مثال، \fBpqiv\fR به‌طور پیش‌فرض
تصاویر بعدی و قبلی را از پیش بارگذاری می‌کند تا پیمایش سریع‌تر شود، و تصاویر مقیاس‌بندی‌شده را
در حافظهٔ پنهان نگه می‌دارد تا بازترسیم‌ها تسریع شوند. این پرچم چنین بهینه‌سازی‌هایی را غیرفعال می‌کند.
.\"
.TP
.BR \-\-max\-depth=\fILEVELS\fR
برای پارامترهایی که دایرکتوری هستند، \fBpqiv\fR به صورت بازگشتی به دنبال تصاویر می‌گردد.
از این پارامتر برای محدود کردن عمق جستجوی \fBpqiv\fR استفاده کنید. سطح 0 بازگشت را
به‌طور کامل غیرفعال می‌کند؛ یعنی اگر pqiv را با یک دایرکتوری به عنوان پارامتر فراخوانی کنید،
اصلاً درون آن را جستجو نخواهد کرد.
.\"
.TP
.BR \-\-negate
نمایش نگاتیو (معکوس) تصاویر. می‌توانید این ویژگی را در زمان اجرا با فشردن
\fIn\fR تغییر وضعیت دهید.
.\"
.TP
.BR \-\-shuffle
نمایش فایل‌ها به ترتیب تصادفی. این گزینه با \fB\-\-sort\fR تداخل دارد. پس از اینکه همهٔ
تصاویر نمایش داده شدند، فایل‌ها دوباره بر هم زده می‌شوند، اما در طول یک چرخه، ترتیب
پایدار است. این بر هم زدن مجدد را می‌توان با استفاده از \fB\-\-end\-of\-files\-action\fR
غیرفعال کرد. در زمان اجرا، می‌توانید به‌طور پیش‌فرض از \fBControl + R\fR برای تغییر وضعیت
حالت تصادفی استفاده کنید؛ این کار ترتیب به‌هم‌ریخته را حفظ می‌کند، یعنی می‌توانید حالت تصادفی را
غیرفعال کرده، چند تصویر را مشاهده کنید، سپس دوباره آن را فعال کرده و پس از آخرین تصویری که
پیش‌تر در حالت تصادفی مشاهده کرده بودید ادامه دهید.
.\"
.TP
.BR \-\-show\-bindings
نمایش میانبرهای صفحه‌کلید و موشواره و سپس خروج. این گزینه میانبرهای کلید را در قالبی
که توسط \fB\-\-bind\-key\fR پذیرفته می‌شود نمایش می‌دهد. برای جزئیات درباره کنش‌های موجود،
آن بخش و بخش \fBACTIONS\fR را ببینید.
.\"
.TP
.BR \-\-sort\-key=\fIPROPERTY\fR
کلید مورد استفاده برای مرتب‌سازی. مقادیر پشتیبانی‌شده برای \fIPROPERTY\fR عبارتند از:
.RS
.IP name 8
مرتب‌سازی بر اساس نام فایل با ترتیب طبیعی، برای مثال \fIabc32d\fR قبل از \fIabc112d\fR،
اما \fIb1\fR بعد از هر دو،
.IP mtime
مرتب‌سازی بر اساس تاریخ ویرایش فایل.
.RE
.\"
.TP
.BR \-\-thumbnail\-size=\fIWIDTHxHEIGHT\fR
تنظیم اندازهٔ تصاویر بندانگشتی در حالت \fImontage\fR. مقدار پیش‌فرض 128x128 است.
.\"
.TP
.BR \-\-thumbnail\-preload=\fICOUNT\fR
پیش‌بارگذاری به تعداد \fICOUNT\fR بندانگشتی مجاور تصویر فعلی هنگام نمایش تصاویر
یا در زمان انتخاب آن‌ها در حالت montage. از این گزینه می‌توان برای افزایش سرعت
حالت montage استفاده کرد، اما منجر به بار پردازشی بالایی خواهد شد.
.\"
.TP
.BR \-\-thumbnail\-persistence=\fIDIRECTORY/STATUS\fR
ذخیرهٔ پایدار بندانگشتی‌ها روی دیسک. ساده‌ترین راه برای استفاده از این گزینه، ارائهٔ
مقدار \fIyes\fR است. سپس بندانگشتی‌ها مطابق با استاندارد Thumbnail Managing Standard،
در مسیر \fI$XDG_CACHE_HOME/thumbnails/*\fR ذخیره می‌شوند. این استاندارد منحصراً اجازهٔ
ذخیرهٔ بندانگشتی‌ها را در اندازه‌های 128x128، 256x256، 512x512 و 1024x1024 می‌دهد، و
مشخص نمی‌کند که بندانگشتی‌های فایل‌های درون آرشیوها یا اسناد چندصفحه‌ای چگونه باید ذخیره
شوند. بندانگشتی‌هایی که این محدودیت‌ها را نقض کنند در یک زیرپوشهٔ ویژه به نام \fIx-pqiv\fR
ذخیره خواهند شد. برای ذخیرهٔ صرفاً بندانگشتی‌های منطبق با استاندارد، مقدار \fIstandard\fR را
ارائه دهید. اگر از این گزینه استفاده نشود، بندانگشتی‌ها از حافظهٔ پنهان نیز بارگذاری نخواهند شد
\- هر بار که از حالت \fImontage\fR استفاده شود، همهٔ بندانگشتی‌ها از نو تولید خواهند شد.
مقدار \fIread-only\fR می‌تواند برای بارگذاری بندانگشتی‌ها بدون ذخیرهٔ آن‌ها به کار رود.
مقدار \fIread-only\fR پیش‌فرض است.
.PP
.RS
اگر مقدار آرگومان را \fIlocal\fR قرار دهید، \fBpqiv\fR بندانگشتی‌ها را طبق آنچه در
Thumbnail Managing Standard مشخص شده، در یک زیرپوشه به نام \fI.sh_thumbnails\fR به صورت
نسبی در کنار تصاویر ذخیره خواهد کرد. گزینهٔ سوم شما ارائهٔ نام یک دایرکتوری است؛ در این صورت
\fBpqiv\fR از آن دایرکتوری برای ذخیرهٔ بندانگشتی‌ها استفاده خواهد کرد. این پوشه باید به عنوان
یک مسیر مطلق داده شود، مسیرهای نسبی کار نمی‌کنند. توجه داشته باشید که هر پوشه‌ای به جز
پوشه‌ای با نام \fI.sh_thumbnails\fR در \fB\-\-watch\-directories\fR در نظر گرفته خواهد شد.
همچنین توجه داشته باشید با اینکه \fBpqiv\fR بندانگشتی‌ها را در پوشهٔ دیگری ذخیره می‌کند، اما
همچنان تلاش خواهد کرد تا آن‌ها را از پوشه‌های استاندارد نیز بارگذاری نماید.
.RE
.\"
.TP
.BR \-\-recreate\-window
راهکاری برای مدیران پنجره‌ای که درخواست‌های تغییر اندازه را به درستی پردازش نمی‌کنند:
به جای تغییر اندازه، هر زمان که تصویر تغییر کرد پنجره را دوباره ایجاد می‌کند. این کار
تصاویر را صرفاً با تغییر بزرگ‌نمایی بازترسیم نمی‌کند.
.\"
.TP
.BR \-\-scale\-mode\-screen\-fraction=\fIFRACTION\fR
تنظیم میزان فضای اشغال‌شده از صفحه توسط \fBpqiv\fR در زمان تغییر مقیاس خودکار تصاویر
در خارج از حالت تمام‌صفحه. مقدار پیش‌فرض 0.8 (80%) است.
.\".TP
.BR \-\-wait\-for\-images\-to\-appear
اگر هیچ تصویری در دایرکتوری‌های مشخص‌شده در خط فرمان یافت نشود، به جای خروج، منتظر ظاهر شدن تصاویری می‌ماند. این گزینه تنها همراه با \fB\-\-lazy\-load\fR و \fB\-\-watch\-directories\fR کار می‌کند.
.\"
.TP
.BR \-\-watch\-directories
تمام دایرکتوری‌های ارائه‌شده به عنوان پارامتر به \fBpqiv\fR را برای فایل‌های جدید زیر نظر می‌گیرد و به محض پدیدار شدن، آن‌ها را اضافه می‌کند. در حالت \fB\-\-sort\fR، فایل‌ها در موقعیت صحیح مرتب‌سازی می‌شوند، در غیر این صورت به انتهای فهرست افزوده خواهند شد. همچنین گزینهٔ \fB\-\-watch\-files\fR را ببینید که نحوهٔ مدیریت تغییرات تصویری را که در حال حاضر مشاهده می‌شود مشخص می‌کند.
.\"
.TP
.BR \-\-watch\-files=\fIVALUE\fR
زیر نظر گرفتن فایل‌ها برای تغییرات روی دیسک. مقادیر معتبر برای \fIVALUE\fR عبارتند از:
.RS
.IP "on (پیش‌فرض)" 15
زیر نظر گرفتن فایل‌ها برای تغییرات، بازخوانی مجدد هنگام تغییر، و رفتن به فایل بعدی در صورت حذف یک فایل،
.IP changes-only
زیر نظر گرفتن فایل‌ها برای تغییرات، بازخوانی مجدد هنگام تغییر، اما انجام ندادن هیچ کاری در صورت حذف یک فایل،
.IP off
به هیچ وجه فایل‌ها برای تغییرات زیر نظر گرفته نمی‌شوند.
.PP
توجه داشته باشید فایلی که حذف شده است، همچنان پس از تخلیه شدن از حافظه (unload)، یعنی در صورتی که کاربر بیش از یک تصویر از آن دور شود، از فهرست تصاویر \fBpqiv\fR حذف خواهد شد. (همچنین گزینهٔ \fB\-\-low\-memory\fR را ببینید.)
.RE
.\"
.\"
.SH "کنش‌ها (ACTIONS)"
کنش‌ها واحدهای سازنده برای کنترل \fBpqiv\fR هستند. نحو وارد کردن یک کنش به صورت زیر است:
.RS
\fICOMMAND\fR(\fIPARAMETER\fR)
.RE
که در آن \fICOMMAND\fR یکی از دستورهای شرح‌داده‌شده در ادامه و \fIPARAMETER\fR پارامتر آن دستور است. رشته‌ها درون نقل‌قول قرار نمی‌گیرند. در عوض، اگر پرانتز بسته در یک رشته استفاده شود، باید با یک ممیز وارونه (backslash) گریز داده شود (escape شود). به عنوان مثال، `command(echo \\))' یک تک‌نویسهٔ `)' خروجی می‌دهد. دستورهای موجود عبارتند از:
.TP
.BR add_file(STRING)
افزودن یک فایل یا دایرکتوری.
.TP
.BR animation_step(INT)
متوقف کردن یک پویانمایی و جلو رفتن به اندازهٔ تعداد فریم‌های مشخص‌شده به‌علاوهٔ یک فریم.
.TP
.BR animation_continue()
ادامه دادن یک پویانمایی متوقف‌شده.
.TP
.BR animation_set_speed_relative(DOUBLE)
مقیاس‌بندی سرعت نمایش پویانمایی.
.TP
.BR animation_set_speed_absolute(DOUBLE)
تنظیم سطح مقیاس سرعت نمایش پویانمایی روی یک مقدار مطلق. مقدار 1.0 سرعت طبیعی پویانمایی است.
.TP
.BR bind_key(STRING)
بازنویسی یک کلید مقیدشده (key binding). به یاد داشته باشید که پرانتز بسته در تعریف جدید را با قرار دادن یک ممیز وارونه در ابتدای آن گریز دهید. همراه با \fBsend_keys(STRING)\fR برای برپاسازی پیوندهای چرخشی مفید است.
.TP
.BR clear_marks()
پاک کردن همهٔ نشانه‌ها.
.TP
.BR command(STRING)
اجرای دستور شل مشخص‌شده. نحو این آرگومان مانند گزینهٔ \fB\-\-command\-1\fR است.
.TP
.BR flip_horizontally()
قرینه‌سازی افقی تصویر جاری.
.TP
.BR flip_vertically()
قرینه‌سازی عمودی تصویر جاری.
.TP
.BR goto_directory_relative(INT)
پرش به \fIn\fR\-امین دایرکتوری بعدی یا قبلی.
.TP
.BR goto_earlier_file()
بازگشت به تصویری که پیش از تصویر جاری باز شده بود.
.TP
.BR goto_file_byindex(INT)
پرش به یک فایل بر اساس شمارهٔ آن.
.TP
.BR goto_file_byname(STRING)
پرش به یک فایل بر اساس نام نمایش‌داده‌شدهٔ آن.
.TP
.BR goto_file_relative(INT)
پرش به \fIn\fR\-امین فایل بعدی یا قبلی.
.TP
.BR goto_logical_directory_relative(INT)
پرش به \fIn\fR\-امین دایرکتوری منطقی بعدی یا قبلی. هر سند چندصفحه‌ای، مانند PDFها یا فایل‌های آرشیو، به عنوان دایرکتوری منطقی در نظر گرفته می‌شوند. دایرکتوری‌های درون فایل‌های آرشیو، که با وجود یک اسلش در نام فایلِ عضو آرشیو قابل تشخیص هستند نیز دایرکتوری محسوب می‌شوند. اساساً قاعده بر این است که دو تصویر در یک دایرکتوری منطقی یکسان قرار دارند اگر پس از پیشوند مشترک نام فایل‌های آن‌ها، هیچ نویسه‌ای در هیچ‌یک از نام‌ها اسلش (/) یا علامت هش (#) نباشد.
.TP
.BR hardlink_current_image()
ایجاد پیوند سخت (hardlink) از تصویر جاری به \fI./.pqiv-select/\fR، یا رونوشت گرفتن از آن در صورت امکان‌پذیر نبودن ایجاد پیوند سخت.
.TP
.BR jump_dialog()
نمایش کادر گفتگوی پرش.
.TP
.BR montage_mode_enter()
ورود به حالت مونتاژ، نمایی برای انتخاب تعاملی تصاویر.
.TP
.BR montage_mode_follow(KEYS)
برپاسازی حالت پیگیری (follow): مقید کردن دنباله‌ای متشکل از کلیدها در KEYS به هر بندانگشتی قابل مشاهده، به‌گونه‌ای که فشردن آن دنباله، مکان‌نما را به موقعیت مذکور منتقل کند. هم‌زمان، روکش‌های کلیدها (binding overlays) فعال شده، مهلت زمانی صفحه‌کلید افزایش می‌یابد و پس از انتخاب یک تصویر، همه چیز به حالت اولیه بازمی‌گردد.
.TP
.BR montage_mode_return_proceed()
خروج از حالت مونتاژ و رفتن به تصویر در حال حاضر انتخاب‌شده.
.TP
.BR montage_mode_return_cancel()
خروج از حالت مونتاژ و بازگشت به آخرین تصویری که پیش از ورود به حالت مونتاژ مشاهده شده بود.
.TP
.BR montage_mode_set_shift_x(INT)
تنظیم موقعیت افقی مکان‌نما در حالت مونتاژ روی یک مقدار مطلق، نمایه‌گذاری‌شده از 0.
.TP
.BR montage_mode_set_shift_y(INT)
تنظیم موقعیت عمودی مکان‌نما در حالت مونتاژ روی یک مقدار مطلق، نمایه‌گذاری‌شده از 0.
.TP
.BR montage_mode_set_wrap_mode(INT)
تنظیم نحوهٔ پیچش دور لبه‌ها هنگام جابجایی موقعیت مکان‌نما در حالت مونتاژ:
مقدار پیش‌فرض، \fI1\fR، پیچش به دور ردیف‌هاست ولی نه دور کل فهرست تصاویر. برای غیرفعال کردن کامل پیچش، این مقدار را برابر با \fI0\fR قرار دهید. مقدار \fI2\fR پیچش کامل را فعال می‌کند.
.TP
.BR montage_mode_shift_x(INT)
جابجایی مکان‌نما در حالت مونتاژ در جهت افقی. جابجایی‌ها دور لبه‌ها به خطوط عمودی مجاور می‌پیچند، اما از انتهای فهرست به ابتدای آن بازنمی‌گردند.
.TP
.BR montage_mode_shift_y(INT)
جابجایی مکان‌نما در حالت مونتاژ در جهت عمودی.
.TP
.BR montage_mode_show_binding_overlays(INT)
غیرفعال کردن (با استفاده از پارامتر 0) یا فعال کردن (با استفاده از هر مقدار دیگر) حالت پیگیری (follow mode). در حالت پیگیری، \fBpqiv\fR نشانه‌های یاد یار (mnemonics) را روی هر بندانگشتی که با فشردن یک کلید (یا ترکیب کلیدها) قابل دسترسی است رسم می‌کند. از این قابلیت برای دستیابی به ناوبری با صفحه‌کلید مشابه vimperator/pentadactyl/vimium و غیره استفاده کنید.
.TP
.BR montage_mode_shift_y_pg(INT)
جابجایی مکان‌نما در حالت مونتاژ در جهت عمودی به اندازهٔ \fIn\fR صفحه.
.TP
.BR move_window(INT,\ INT)
انتقال پنجرهٔ \fBpqiv\fR به مختصات مشخص‌شده. مقادیر منفی، پنجره را روی نمایشگر جاری متمرکز (وسط‌چین) می‌کنند.
.TP
.BR nop()
انجام ندادن هیچ کاری. می‌تواند برای پاک کردن یک کلید مقیدشدهٔ موجود استفاده شود.
.TP
.BR numeric_command(INT)
اجرای \fIn\fR\-امین دستور تعریف‌شده از طریق \fB\-\-command\-1\fR و غیره.
.TP
.BR output_file_list()
ارسال فهرستی از تمام فایل‌های بارگذاری‌شده به خروجی استاندارد.
.TP
.BR quit()
خروج از pqiv.
.TP
.BR reload()
بارگذاری مجدد تصویر جاری از دیسک.
.TP
.BR remove_file_byindex(INT)
حذف یک فایل بر اساس شمارهٔ آن.
.TP
.BR remove_file_byname(STRING)
حذف یک فایل بر اساس نام نمایش‌داده‌شدهٔ آن.
.TP
.BR reset_scale_level()
بازنشانی سطح مقیاس به مقدار پیش‌فرض.
.TP
.BR rotate_left()
چرخاندن تصویر جاری به اندازهٔ ۹۰ درجه به چپ..TP
.BR rotate_right()
تصویر فعلی را ۹۰ درجه به راست می‌چرخاند.
.TP
.BR send_keys(STRING)
فشردن دنباله‌ای از کلیدها را شبیه‌سازی می‌کند. این کنش در حال حاضر از کلیدهای ویژه‌ای که بازنمایی ASCII ندارند پشتیبانی نمی‌کند. در ترکیب با \fBbind_key(STRING)\fR برای برپاسازی کلیدهای میانبر چرخشی مفید است.
.TP
.BR set_cursor_visibility(INT)
نمایانی نشانگر را تنظیم می‌کند؛ مقدار 0 آن را غیرفعال کرده و مقادیر دیگر نمایانی را فعال می‌کنند.
.TP
.BR set_cursor_auto_hide(INT)
هنگام حرکت نشانگر، آن را به‌طور خودکار نشان می‌دهد و پس از یک ثانیه عدم فعالیت، پنهان می‌کند. برای غیرفعال کردن این ویژگی مقدار 0 و برای فعال‌سازی آن هر مقدار دیگری را تنظیم کنید. توجه داشته باشید که این کار رویدادهای حرکت نشانگر را فعال می‌کند، که ممکن است در صورت استفاده از pqiv روی پیوندهای شبکه کند، سرعت آن را کاهش دهد.
.TP
.BR set_fade_duration(DOUBLE)
مدت‌زمان محوشدگی (fade) میان تصاویر را تنظیم می‌کند. بر خلاف گزینه خط فرمان، این کنش محوشدگی را به‌طور ضمنی نیز فعال می‌کند. برای غیرفعال کردن این ویژگی مدت‌زمان را روی صفر تنظیم کنید.
.TP
.BR set_interpolation_quality(INT)
کیفیت درون‌یابی را برای تصاویر تغییراندازه‌یافته تعیین می‌کند. گزینه‌ها عبارتند از: 0 برای چرخش میان حالت‌های گوناگون، 1 برای انتخاب خودکار بر اساس اندازه تصویر (تصاویر کوچک از درون‌یابی nearest و تصاویر بزرگ از حالت \(lqgood\(rq متعلق به Cairo استفاده می‌کنند)، 2 برای \(lqfast\(rq، 3 برای \(lqgood\(rq و 4 برای \(lqbest\(rq.
.TP
.BR set_keyboard_timeout(DOUBLE)
مهلت زمانی (timeout) برای ورودی دنباله کلید را تنظیم می‌کند. برای نمونه، اگر کنشی را به \fIa\fI و کنش دیگری را به \fIab\fR مقید کنید، \fBpqiv\fR به‌طور پیش‌فرض نیم ثانیه به شما فرصت می‌دهد تا \fIb\fR را وارد کنید پیش از آنکه فرض کند قصد شما تنها فشردن \fIa\fR بوده است. از این کنش برای تغییر این مقدار استفاده کنید.
.TP
.BR set_scale_level_absolute(DOUBLE)
سطح مقیاس را روی مقدار پارامتر تنظیم می‌کند. 1.0 معادل ۱۰۰٪ است. همچنین ببینید: \fB\-\-zoom\-level\fR.
.TP
.BR set_scale_level_relative(DOUBLE)
سطح مقیاس را به‌صورت ضربی با مقدار پارامتر تنظیم می‌کند.
.TP
.BR set_scale_mode_fit_px(INT,\ INT)
همواره سطح مقیاس را به‌گونه‌ای تنظیم می‌کند که هر تصویر در ابعاد ارائه‌شده بگنجد.
.TP
.BR set_scale_mode_screen_fraction(DOUBLE)
میزان استفاده از فضای در دسترس صفحه نمایش برای مقیاس‌بندی پنجره در خارج از حالت تمام‌صفحه را تنظیم می‌کند. پیش‌فرض 0.8 است. این گزینه بر اندازه پنجره در حالت \fImontage\fR نیز اثر می‌گذارد.
.TP
.BR set_shift_align_corner(STRING)
تصویر را با لبه پنجره/صفحه تراز می‌کند. مقادیر ممکن برای پارامتر جهت‌های اصلی هستند؛ برای نمونه \fINE\fR تصویر را به گوشه شمال شرقی (بالا راست) تراز می‌کند. می‌توانید یک \fIC\fR اضافی به ابتدای پارامتر بیفزایید تا این تراز تنها در صورتی انجام شود که ابعاد تصویر از فضای موجود فراتر رود، و در غیر این صورت تصویر در مرکز قرار گیرد.
.TP
.BR set_shift_x(INT)
میزان جابه‌جایی در جهت افقی را روی یک مقدار ثابت تنظیم می‌کند.
.TP
.BR set_shift_y(INT)
میزان جابه‌جایی در جهت عمودی را روی یک مقدار ثابت تنظیم می‌کند.
.TP
.BR set_slideshow_interval_absolute(DOUBLE)
بازه زمانی اسلایدشو را بر حسب ثانیه روی مقدار پارامتر تنظیم می‌کند.
.TP
.BR set_slideshow_interval_relative(DOUBLE)
بازه زمانی اسلایدشو را به‌صورت جمعی با مقدار پارامتر تنظیم می‌کند. همچنین ببینید: \fB\-\-slideshow\-interval\fR.
.TP
.BR set_status_output(INT)
تنظیم این گزینه روی مقداری غیر از صفر باعث می‌شود pqiv اطلاعات وضعیت را برای اسکریپت‌ها در خروجی استاندارد (stdout) چاپ کند؛ یک بار در هنگام فعال‌سازی و سپس هر بار که کاربر میان تصاویر جابه‌جا می‌شود. قالب آن با تعریف متغیرهای پوسته سازگار است. متغیرهایی که در حال حاضر پیاده‌سازی شده‌اند \fICURRENT_FILE_NAME\fR و \fICURRENT_FILE_INDEX\fR هستند. هر خروجی همیشه با یک خط خالی پایان می‌یابد.
.TP
.BR set_thumbnail_preload(INT)
تعداد تصاویر بندانگشتی که باید از پیش بارگذاری شوند را تغییر می‌دهد. مقدار صفر این ویژگی را غیرفعال می‌کند.
.TP
.BR set_thumbnail_size(INT, INT)
اندازه تصاویر بندانگشتی را تغییر می‌دهد. ترتیب آرگومان‌ها ابتدا عرض و سپس ارتفاع است. بندانگشتی‌ها همیشه به‌گونه‌ای مقیاس‌بندی می‌شوند که هیچ ضلعی بزرگ‌تر از این حد نباشد.
.TP
.BR shift_x(INT)
تصویر فعلی را در جهت x جابه‌جا می‌کند.
.TP
.BR shift_y(INT)
تصویر فعلی را در جهت y جابه‌جا می‌کند.
.TP
.BR toggle_background_pattern(INT)
تغییر وضعیت میان الگوهای مختلف پس‌زمینه: 0 برای تعویض چرخشی، 1 برای الگوی شطرنجی، 2 برای مشکی، 3 برای سفید.
.TP
.BR toggle_fullscreen(INT)
تغییر وضعیت حالت تمام‌صفحه: 0 برای تغییر وضعیت، 1 برای رفتن به تمام‌صفحه، 2 برای بازگشت به حالت پنجره.
.TP
.BR toggle_info_box()
تغییر وضعیت نمایانی جعبه اطلاعات (info box).
.TP
.BR toggle_mark()
تغییر وضعیت علامت‌گذاری تصویر فعلی.
.TP
.BR toggle_negate_mode(INT)
تغییر وضعیت حالت نگاتیو (معکوس کردن رنگ‌ها): 0 برای تغییر وضعیت، 1 برای فعال‌سازی، 2 برای غیرفعال‌سازی.
.TP
.BR toggle_scale_mode(INT)
تغییر حالت مقیاس‌بندی: استفاده از 1 برای غیرفعال کردن مقیاس‌بندی، 2 برای کاهش خودکار مقیاس (پیش‌فرض)، 3 برای همیشه بزرگ‌نمایی کردن تصاویر، 4 برای حفظ سطح بزرگ‌نمایی تعیین‌شده توسط کاربر، و 5 برای حفظ اندازه پنجره.
مقدار 0 میان حالت‌های 1\-3 می‌چرخد.
.TP
.BR toggle_shuffle_mode(INT)
تغییر وضعیت حالت برزدن (shuffle). از 0 برای چرخش میان مقادیر ممکن، 1 برای فعال‌سازی shuffle و هر مقدار دیگری برای غیرفعال کردن آن استفاده کنید.
.TP
.BR toggle_slideshow()
تغییر وضعیت حالت اسلایدشو.
.\".SH "کلیدهای میانبر پیش‌فرض (DEFAULT KEY BINDINGS)"
.IP Backspace/Space 25
فایل قبلی/بعدی.
.IP ctrl-a
پیوند دادن تصویر جاری به \fI./.pqiv-select/\fR، یا رونوشت از آن در صورتی که ایجاد پیوند سخت (hardlink) ممکن نباشد.
.IP f
تغییر وضعیت حالت تمام‌صفحه.
.IP h/v
قرینه‌سازی افقی یا عمودی تصویر.
.IP k/l
چرخش تصویر به راست یا چپ.
.IP i
تغییر وضعیت نمایش جعبه اطلاعات.
.IP j
نمایش پنجره‌ای شامل فهرست تمام فایل‌ها برای انتخاب سریع.
.IP m
تغییر وضعیت حالت \fImontage\fR، یک حالت تعاملی برای انتخاب تصویر. از کلیدهای جهت‌نما یا موشواره برای انتخاب تصویر و از کلید Return برای بازگشت به نمای تک‌تصویر استفاده کنید. از \fIg\fR برای پیمایش سریع به یک تصویر بندانگشتی (thumbnail) استفاده کنید.
.IP o
تغییر وضعیت نشانه‌گذاری روی یک تصویر. از \fIctrl-R\fR برای بازنشانی تمام نشانه‌ها استفاده کنید. در ترکیب با دستورهایی که با \fI-\fR آغاز می‌شوند کاربرد دارد.
.IP q
خروج از \fBpqiv\fR.
.IP r
بارگذاری مجدد تصویر جاری.
.IP s
تغییر وضعیت حالت اسلایدشو.
.IP t
تغییر وضعیت حالت مقیاس‌بندی؛ چرخش میان بزرگ‌نمایی تمام تصاویر، کوچک‌نمایی تصاویر بزرگ و عدم مقیاس‌بندی.
.IP ctrl-t
حفظ میزان مقیاس تعیین‌شده توسط کاربر.
.IP mod-t
حفظ اندازه پنجره.
.IP Plus/Minus
بزرگ‌نمایی و کوچک‌نمایی.
.IP "Period, ctrl-Period"
توقف، حرکت تک‌فریم و ادامه تصاویر متحرک.
.IP "mod-Plus, mod-Minus"
تغییر سرعت پویانمایی.
.IP ctrl-r
تغییر وضعیت حالت تصادفی (shuffle).
.IP ctrl-p
رفتن به تصویری که پیش از تصویر جاری دیده شده است.
.IP "ctrl-Space, ctrl-Backspace"
رفتن به پوشه منطقی بعدی/قبلی.
.IP "ctrl-Plus, ctrl-Minus"
تغییر بازه زمانی اسلایدشو.
.IP b
تغییر وضعیت الگوی پس‌زمینه برای تصاویر شفاف (transparent).
.IP n
تغییر وضعیت حالت نگاتیو ("negative").
.IP "Mouse buttons (fullscreen)"
رفتن به فایل‌های بعدی و قبلی.
.IP "Mouse drag (fullscreen)"
جابه‌جایی تصویر.
.IP "Mouse drag with right button (fullscreen)"
بزرگ‌نمایی و کوچک‌نمایی.
.IP "Arrow keys"
جابه‌جایی تصویر.
.PP
این فهرست برخی از میانبرهای پیش‌فرض پیشرفته را نادیده گرفته است. شرح کنش‌های فوق به همراه آن میانبرها مشخص شده است. همچنین می‌توانید دستور `\fBpqiv \-\-show\-bindings\fR' را برای نمایش یک فهرست کامل اجرا کنید.
.\"
.SH "فایل پیکربندی (CONFIGURATION FILE)"
هنگام راه‌اندازی، \fBpqiv\fR فایل \fI~/.config/pqivrc\fR را تجزیه می‌کند. این فایل باید یک فایل کلید/مقدار به سبک INI همراه با بخش \fIoptions\fR باشد. تمامی پارامترهای قالب بلند (long form) کلیدهای معتبری هستند. برای تنظیم یک پرچم بولی (boolean)، مقدار آن را روی 1 بگذارید. تنظیم یک پرچم، معنای پارامتر مربوطه را معکوس می‌کند. به عنوان مثال، اگر `\fIfullscreen=1\fR' را قرار دهید، \fBpqiv\fR در حالت تمام‌صفحه آغاز خواهد شد مگر اینکه هنگام راه‌اندازی گزینه \fB\-f\fR را ارسال کرده باشید.
.PP
به عنوان مثال،
.RS
.nf
[options]
fullscreen=1
sort=1
command-1=|convert - -blur 20 -
.fi
.RE
باعث می‌شود \fBpqiv\fR به صورت پیش‌فرض در حالت تمام‌صفحه آغاز به کار کند، فهرست فایل‌ها را مرتب سازد و یک فیلتر مات‌کننده (blur) را به کلید \fB1\fR اختصاص دهد. گزینه \fB\-f\fR در خط فرمان مانع از اجرای \fBpqiv\fR در حالت تمام‌صفحه شده و \fB\-n\fR مانع از مرتب‌سازی فهرست خواهد شد.
.PP
می‌توانید کلیدهای میانبر را با قالب پارامتر \fB\-\-bind\-key\fR در بخشی ویژه به نام \fI[keybindings]\fR قرار دهید. به عنوان مثال،
.RS
.nf
[keybindings]
q { goto_file_relative(-1); }
w { goto_file_relative(1); }

x { send_keys(#1); }
<numbersign>1 { set_scale_level_absolute(1.); bind_key(x { send_keys(#2\\); }); }
<numbersign>2 { set_scale_level_absolute(.5); bind_key(x { send_keys(#3\\); }); }
<numbersign>3 { set_scale_level_absolute(0.25); bind_key(x { send_keys(#1\\); }); }
.fi
.RE
کلیدهای \fIq\fR و \fIw\fR را برای جابه‌جایی میان تصاویر دوباره نگاشت می‌کند، و \fIx\fR را طوری تنظیم می‌کند که در سطوح بزرگ‌نمایی ۱۰۰٪، ۵۰٪ و ۲۵٪ گردش کند.
.PP
مشابهاً، می‌توانید کنش‌هایی (چندگانه) را در بخشی به نام \fI[actions]\fR تعیین کنید تا هر بار با اجرای \fBpqiv\fR اجرا گردند.
.PP
برای سازگاری رو به عقب با نسخه‌های قدیمی‌تر \fBpqiv\fR، اگر فایل با تعریف یک بخش آغاز نشود، خط نخست به عنوان پارامترهای خط فرمان تجزیه خواهد شد.
.PP
می‌توانید با قرار دادن ';' یا '#' در ابتدای خط، توضیحاتی درون فایل بنویسید. درج توضیحات در انتهای خطوط پشتیبانی نمی‌شود.
.PP
دیگر مسیرهای پشتیبانی‌شده برای فایل پیکربندی عبارتند از \fI~/.pqivrc\fR، \fI/etc/xdg/pqivrc\fR و \fI/etc/pqivrc\fR. برنامه \fBpqiv\fR از نخستین فایلی که بیابد استفاده خواهد کرد. می‌توانید از متغیر محیطی \fIPQIVRC_PATH\fR برای بازنویسی مسیر فایل پیکربندی استفاده کنید..SH "مثال‌ها (EXAMPLES)"
.\"
.TP
\fBpqiv \-\-bind\-key="a { goto_file_byindex(0) }" \-\-bind\-key='c { command(echo -n $1 | xclip) }' \-\-sort foo bar.pdf\fR
کلید \fBa\fR را برای بازگشت به نخستین تصویر و کلید \fBc\fR را برای ذخیرهٔ مسیر تصویر فعلی در کلیپ‌بورد با استفاده از \fIxclip\fR بازتعریف می‌کند، و تمام فایل‌های پوشهٔ \fIfoo\fR و \fIbar.pdf\fR را به صورت مرتب‌شده بارگذاری می‌نماید.
.TP
\fBpqiv \-\-slideshow \-\-watch\-directories \-\-end\-of\-files\-action=wait \-\-slideshow\-interval=0.001 test\fR
تمام فایل‌های پوشهٔ \fItest\fR را در یک اسلایدشو با پیشروی بسیار سریع بارگذاری می‌کند و در پایان منتظر می‌ماند تا فایل‌های جدید در دسترس قرار گیرند. این قابلیت در عمل تصاویر جدید را به محض ظاهر شدن در دایرکتوری نمایش می‌دهد و مثلاً زمانی مفید است که از طریق یک اسکریپت تصاویری تولید می‌کنید که بعداً قصد تبدیل آن‌ها به یک فیلم را دارید و می‌خواهید روند پیشرفت را نظاره کنید.
.TP
\fBpqiv \-\-slideshow \-\-allow\-empty\-window \-\-watch\-directories \-\-wait\-for\-images\-to\-appear \-\-lazy\-load test\fR
یک اسلایدشو راه‌اندازی می‌کند که تمام تصاویر پوشهٔ \fItest\fR را به گونه‌ای نمایش می‌دهد که بتوان همهٔ تصاویر را از دایرکتوری حذف کرد و تصاویر جدیدی را در آن قرار داد بدون اینکه \fBpqiv\fR بسته شود.
.TP
\fBecho "output_file_list(); quit()" | pqiv \-\-actions\-from\-stdin test\fR
فهرستی از تمام فایل‌های پوشهٔ \fItest\fR را که \fBpqiv\fR قادر به پردازش آن‌ها است در خروجی چاپ کرده و خارج می‌شود.
.\"
.SH "گزارش باگ‌ها (BUGS)"
لطفاً هرگونه باگ را در گیت‌هاب به نشانی https://github.com/phillipberndt/pqiv گزارش دهید.
.\"
.SH "نویسندگان (AUTHORS)"
Phillip Berndt (phillip dot berndt at googlemail dot com)