نام (NAME)

pqiv - نمایشگر سریع و قدرتمند تصویر

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

pqiv [options] [filename(s)...]

توضیحات (DESCRIPTION)

دستور pqiv یک نمایشگر تصویر خط فرمانی ساده با الهام از qiv است. این ابزار بسیار انعطاف‌پذیر و سفارشی‌پذیر بوده و از فرمت‌های متنوعی پشتیبانی می‌کند.

گزینه‌ها (OPTIONS)

-c, --transparent-background

رسم پنجرهٔ pqiv بدون حاشیه و به صورت شفاف. در حالت پنجره‌ای، کلیک ماوس تزئینات پنجره را فعال و غیرفعال می‌کند.

-d, --slideshow-interval=SECONDS

در حالت اسلایدشو (به‌طور پیش‌فرض با --slideshow یا کلید s فعال می‌شود)، تصاویر را با این نرخ جابه‌جا می‌کند. مقادیر ممیز شناور نیز پشتیبانی می‌شوند؛ برای نمونه استفاده از 0.5 تصاویر را با نرخ دو تصویر در ثانیه جابه‌جا می‌کند.

-f, --fullscreen

شروع در حالت تمام‌صفحه. به‌طور پیش‌فرض در زمان اجرا می‌توان با فشردن کلید f حالت تمام‌صفحه را تغییر وضعیت داد.

-F, --fade

محو شدن تدریجی (Fade) میان تصاویر. همچنین --fade-duration را ببینید.

-i, --hide-info-box

پنهان کردن اولیهٔ جعبهٔ اطلاعات. به‌طور پیش‌فرض می‌توان وضعیت نمایش این جعبه را در زمان اجرا با فشردن کلید i تغییر داد.

--font=FONT

مشخص کردن رشتهٔ قلم Pango برای جعبهٔ اطلاعات. توجه داشته باشید که اندازهٔ قلم متناسب با اندازهٔ پنجره مقیاس‌بندی خواهد شد.

-l, --lazy-load

دستور pqiv معمولاً پیش از نمایش پنجرهٔ اصلی خود، تمامی آرگومان‌های خط فرمان را پردازش می‌کند. با فعال بودن این گزینه، پنجره به محض پیدا شدن و بارگذاری نخستین تصویر نمایش داده می‌شود.

-n, --sort

مرتب‌سازی تصاویر به‌جای ذخیرهٔ آن‌ها به همان ترتیبی که در خط فرمان داده شده و در پوشه‌ها پیدا شده‌اند. ترتیب پیش‌فرض بر اساس نام است (ترتیب طبیعی). برای تغییر این ترتیب --sort-key را ببینید.

-P, --window-position=POSITION

تنظیم موقعیت اولیهٔ پنجره. مقدار POSITION می‌تواند یکی از موارد زیر باشد:

-r, --additional-from-stdin

خواندن نام‌فایل‌ها/پوشه‌های اضافی از ورودی استاندارد. این گزینه با --actions-from-stdin تداخل دارد.

-s, --slideshow

شروع در حالت اسلایدشو. به‌طور پیش‌فرض، حالت اسلایدشو در هنگام اجرا با فشردن کلید s تغییر وضعیت می‌دهد.

-t, --scale-images-up

بزرگ‌نمایی تصاویر تا حدی که کل صفحه را پر کنند. این گزینه به‌طور پیش‌فرض در زمان اجرا با فشردن کلید t تغییر می‌کند. همچنین --disable-scaling را ببینید.

-T, --window-title=TITLE

تنظیم عنوان پنجره. دستور pqiv چندین متغیر را درون TITLE جایگزین می‌کند:

-z, --zoom-level=FLOAT

تنظیم سطح بزرگ‌نمایی اولیه با یک مقدار ممیز شناور؛ به عنوان نمونه 1.0 معادل 100% است. این مقدار تنها روی تصویر نخست اعمال می‌شود و تصاویر دیگر بر اساس حالت مقیاس‌بندی (نگاه کنید به --scale-images-up و --disable-scaling) و اندازهٔ پنجره مقیاس‌بندی می‌شوند.

-1, --command-1=COMMAND

انتساب دستور خارجی COMMAND به کلید 1. می‌توانید از 2..9 برای انتساب دستورهای بیشتر استفاده کنید. قابلیت ACTIONS (در ادامه) امکان انتساب کلیدهای دیگر به سایر دستورها را فراهم می‌کند. دستور COMMAND با استفاده از پردازشگر پوستهٔ پیش‌فرض اجرا می‌شود. مقدار `$1' با نام فایل جاری جایگزین می‌شود. اگر دستور با `|' یا `-' شروع نشود، در صورت عدم وجود `$1'، نام فایل به انتهای خط فرمان ضمیمه می‌گردد.

--action=ACTION

اجرای یک اقدام (ACTION) مشخص هنگام شروع pqiv. ساختار نحو به این صورت است:

--actions-from-stdin

مشابه --action، اما اقدام‌ها را از ورودی استاندارد می‌خواند. برای نحو و دستورهای موجود، بخش ACTIONS در زیر را مشاهده کنید. این گزینه با --additional-from-stdin تداخل دارد.

--allow-empty-window

به‌طور معمول pqiv پنجرهٔ اصلی را تا زمان پیدا شدن دست‌کم یک تصویر نمایش نمی‌دهد، و زمانی که دیگر نتواند هیچ تصویری را بارگذاری کند خارج می‌شود. با فعال بودن این گزینه، در هر دو وضعیت یک پنجرهٔ خالی pqiv نشان داده می‌شود.

--auto-montage-mode

ورود خودکار به حالت مونتاژ (montage) در صورتی که pqiv با بیش از یک تصویر اجرا شود.

--background-pattern=PATTERN

دستور pqiv به عنوان پس‌زمینهٔ تصاویر شفاف، یک طرح شطرنجی رسم می‌کند. با استفاده از این گزینه می‌توانید پس‌زمینهٔ سفید یا سیاه را جایگزین کنید. مقادیر معتبر عبارتند از: checkerboard، white و black.

--bind-key=KEY BINDING

انتساب مجدد یک کلید به یک اقدام (action). ساختار نحو به این صورت است:

--box-colors=FOREGROUND COLOR:BACKGROUND COLOR

سفارشی‌سازی رنگ‌های استفاده‌شده برای رسم جعبه اطلاعات و حاشیه‌های حالت montage. رنگ‌ها را می‌توان به صورت فهرستی از مقادیر RGB جداشده با ویرگول در محدوده 0 تا 255 یا به عنوان یک مقدار شانزده‌شانزدهی (hexvalue) مانند #aabbcc مشخص کرد. مقدار پیش‌فرض #000000:#ffff00 است.

--browse

به ازای هر آرگومان خط فرمان، علاوه بر آن تمامی تصاویر موجود در دایرکتوری آن تصویر را بارگذاری می‌کند. pqiv همچنان از تصویری شروع خواهد کرد که به عنوان نخستین پارامتر داده شده است.

--disable-backends=LIST OF BACKENDS

از این گزینه برای غیرفعال‌سازی انتخابی برخی از بک‌اندهای pqiv استفاده کنید. می‌توانید فهرستی از بک‌اندهای جداشده با ویرگول را در اینجا مشخص نمایید. بک‌اندهای ناموجود بدون هشدار نادیده گرفته می‌شوند. غیرفعال کردن بک‌اندهایی که نیاز ندارید، سرعت بارگذاری بازگشتی را به‌طور چشمگیری افزایش می‌دهد، به‌ویژه اگر بک‌اند archive را غیرفعال کنید. بک‌اندهای موجود عبارتند از:

--disable-scaling

غیرفعال‌سازی کامل تغییر مقیاس. این مورد را می‌توان در زمان اجرا به‌طور پیش‌فرض با فشردن t تغییر وضعیت داد. همچنین --scale-images-up را ببینید.

--end-of-files-action=ACTION

اگر همهٔ فایل‌ها مشاهده شده باشند و قرار باشد تصویر بعدی نمایش داده شود، چه با درخواست کاربر یا به دلیل فعال بودن حالت اسلایدشو، pqiv به‌طور پیش‌فرض چرخه را تکرار کرده و از تصویر نخست دوباره شروع می‌کند. این پارامتر می‌تواند برای تغییر این رفتار استفاده شود. گزینه‌های معتبر برای ACTION عبارتند از:

--enforce-window-aspect-ratio

به مدیر پنجره اعلام می‌کند که نسبت ابعاد پنجره را تحمیل کند. اگر این پرچم تنظیم شده باشد، یک مدیر پنجرهٔ سازگار به کاربران اجازه نخواهد داد که اندازهٔ پنجرهٔ pqiv را به نسبت ابعاد متفاوتی تغییر دهند. این مورد پیش‌تر رفتار پیش‌فرض بود، اما مدیران پنجره معمولاً در کد مدیریت نسبت‌های ابعاد اجباری دارای باگ هستند. اگر این پرچم تنظیم نشده باشد و نسبت ابعاد پنجره و تصویر همخوانی نداشته باشند، تصویر همچنان با نسبت ابعاد درست رسم خواهد شد و حاشیه‌های سیاهی در کناره‌ها افزوده می‌شود.

--fade-duration=SECONDS

همراه با --fade، مدت‌زمان هر محو شدن را به این مقدار تنظیم می‌کند. مقادیر ممیز شناور پذیرفته می‌شوند، برای مثال 0.5 باعث می‌شود هر بار محو شدن نیم ثانیه طول بکشد.

--low-memory

تلاش برای نگه داشتن مصرف حافظه در کمترین مقدار ممکن. به عنوان مثال، pqiv به‌طور پیش‌فرض تصاویر بعدی و قبلی را از پیش بارگذاری می‌کند تا پیمایش سریع‌تر شود، و تصاویر مقیاس‌بندی‌شده را در حافظهٔ پنهان نگه می‌دارد تا بازترسیم‌ها تسریع شوند. این پرچم چنین بهینه‌سازی‌هایی را غیرفعال می‌کند.

--max-depth=LEVELS

برای پارامترهایی که دایرکتوری هستند، pqiv به صورت بازگشتی به دنبال تصاویر می‌گردد. از این پارامتر برای محدود کردن عمق جستجوی pqiv استفاده کنید. سطح 0 بازگشت را به‌طور کامل غیرفعال می‌کند؛ یعنی اگر pqiv را با یک دایرکتوری به عنوان پارامتر فراخوانی کنید، اصلاً درون آن را جستجو نخواهد کرد.

--negate

نمایش نگاتیو (معکوس) تصاویر. می‌توانید این ویژگی را در زمان اجرا با فشردن n تغییر وضعیت دهید.

--shuffle

نمایش فایل‌ها به ترتیب تصادفی. این گزینه با --sort تداخل دارد. پس از اینکه همهٔ تصاویر نمایش داده شدند، فایل‌ها دوباره بر هم زده می‌شوند، اما در طول یک چرخه، ترتیب پایدار است. این بر هم زدن مجدد را می‌توان با استفاده از --end-of-files-action غیرفعال کرد. در زمان اجرا، می‌توانید به‌طور پیش‌فرض از Control + R برای تغییر وضعیت حالت تصادفی استفاده کنید؛ این کار ترتیب به‌هم‌ریخته را حفظ می‌کند، یعنی می‌توانید حالت تصادفی را غیرفعال کرده، چند تصویر را مشاهده کنید، سپس دوباره آن را فعال کرده و پس از آخرین تصویری که پیش‌تر در حالت تصادفی مشاهده کرده بودید ادامه دهید.

--show-bindings

نمایش میانبرهای صفحه‌کلید و موشواره و سپس خروج. این گزینه میانبرهای کلید را در قالبی که توسط --bind-key پذیرفته می‌شود نمایش می‌دهد. برای جزئیات درباره کنش‌های موجود، آن بخش و بخش ACTIONS را ببینید.

--sort-key=PROPERTY

کلید مورد استفاده برای مرتب‌سازی. مقادیر پشتیبانی‌شده برای PROPERTY عبارتند از:

--thumbnail-size=WIDTHxHEIGHT

تنظیم اندازهٔ تصاویر بندانگشتی در حالت montage. مقدار پیش‌فرض 128x128 است.

--thumbnail-preload=COUNT

پیش‌بارگذاری به تعداد COUNT بندانگشتی مجاور تصویر فعلی هنگام نمایش تصاویر یا در زمان انتخاب آن‌ها در حالت montage. از این گزینه می‌توان برای افزایش سرعت حالت montage استفاده کرد، اما منجر به بار پردازشی بالایی خواهد شد.

--thumbnail-persistence=DIRECTORY/STATUS

ذخیرهٔ پایدار بندانگشتی‌ها روی دیسک. ساده‌ترین راه برای استفاده از این گزینه، ارائهٔ مقدار yes است. سپس بندانگشتی‌ها مطابق با استاندارد Thumbnail Managing Standard، در مسیر $XDG_CACHE_HOME/thumbnails/* ذخیره می‌شوند. این استاندارد منحصراً اجازهٔ ذخیرهٔ بندانگشتی‌ها را در اندازه‌های 128x128، 256x256، 512x512 و 1024x1024 می‌دهد، و مشخص نمی‌کند که بندانگشتی‌های فایل‌های درون آرشیوها یا اسناد چندصفحه‌ای چگونه باید ذخیره شوند. بندانگشتی‌هایی که این محدودیت‌ها را نقض کنند در یک زیرپوشهٔ ویژه به نام x-pqiv ذخیره خواهند شد. برای ذخیرهٔ صرفاً بندانگشتی‌های منطبق با استاندارد، مقدار standard را ارائه دهید. اگر از این گزینه استفاده نشود، بندانگشتی‌ها از حافظهٔ پنهان نیز بارگذاری نخواهند شد - هر بار که از حالت montage استفاده شود، همهٔ بندانگشتی‌ها از نو تولید خواهند شد. مقدار read-only می‌تواند برای بارگذاری بندانگشتی‌ها بدون ذخیرهٔ آن‌ها به کار رود. مقدار read-only پیش‌فرض است.

--recreate-window

راهکاری برای مدیران پنجره‌ای که درخواست‌های تغییر اندازه را به درستی پردازش نمی‌کنند: به جای تغییر اندازه، هر زمان که تصویر تغییر کرد پنجره را دوباره ایجاد می‌کند. این کار تصاویر را صرفاً با تغییر بزرگ‌نمایی بازترسیم نمی‌کند.

--scale-mode-screen-fraction=FRACTION

تنظیم میزان فضای اشغال‌شده از صفحه توسط pqiv در زمان تغییر مقیاس خودکار تصاویر در خارج از حالت تمام‌صفحه. مقدار پیش‌فرض 0.8 (80%) است. --wait-for-images-to-appear اگر هیچ تصویری در دایرکتوری‌های مشخص‌شده در خط فرمان یافت نشود، به جای خروج، منتظر ظاهر شدن تصاویری می‌ماند. این گزینه تنها همراه با --lazy-load و --watch-directories کار می‌کند.

--watch-directories

تمام دایرکتوری‌های ارائه‌شده به عنوان پارامتر به pqiv را برای فایل‌های جدید زیر نظر می‌گیرد و به محض پدیدار شدن، آن‌ها را اضافه می‌کند. در حالت --sort، فایل‌ها در موقعیت صحیح مرتب‌سازی می‌شوند، در غیر این صورت به انتهای فهرست افزوده خواهند شد. همچنین گزینهٔ --watch-files را ببینید که نحوهٔ مدیریت تغییرات تصویری را که در حال حاضر مشاهده می‌شود مشخص می‌کند.

--watch-files=VALUE

زیر نظر گرفتن فایل‌ها برای تغییرات روی دیسک. مقادیر معتبر برای VALUE عبارتند از:

کنش‌ها (ACTIONS)

کنش‌ها واحدهای سازنده برای کنترل pqiv هستند. نحو وارد کردن یک کنش به صورت زیر است:

add_file(STRING)

افزودن یک فایل یا دایرکتوری.

animation_step(INT)

متوقف کردن یک پویانمایی و جلو رفتن به اندازهٔ تعداد فریم‌های مشخص‌شده به‌علاوهٔ یک فریم.

animation_continue()

ادامه دادن یک پویانمایی متوقف‌شده.

animation_set_speed_relative(DOUBLE)

مقیاس‌بندی سرعت نمایش پویانمایی.

animation_set_speed_absolute(DOUBLE)

تنظیم سطح مقیاس سرعت نمایش پویانمایی روی یک مقدار مطلق. مقدار 1.0 سرعت طبیعی پویانمایی است.

bind_key(STRING)

بازنویسی یک کلید مقیدشده (key binding). به یاد داشته باشید که پرانتز بسته در تعریف جدید را با قرار دادن یک ممیز وارونه در ابتدای آن گریز دهید. همراه با send_keys(STRING) برای برپاسازی پیوندهای چرخشی مفید است.

clear_marks()

پاک کردن همهٔ نشانه‌ها.

command(STRING)

اجرای دستور شل مشخص‌شده. نحو این آرگومان مانند گزینهٔ --command-1 است.

flip_horizontally()

قرینه‌سازی افقی تصویر جاری.

flip_vertically()

قرینه‌سازی عمودی تصویر جاری.

goto_directory_relative(INT)

پرش به n-امین دایرکتوری بعدی یا قبلی.

goto_earlier_file()

بازگشت به تصویری که پیش از تصویر جاری باز شده بود.

goto_file_byindex(INT)

پرش به یک فایل بر اساس شمارهٔ آن.

goto_file_byname(STRING)

پرش به یک فایل بر اساس نام نمایش‌داده‌شدهٔ آن.

goto_file_relative(INT)

پرش به n-امین فایل بعدی یا قبلی.

goto_logical_directory_relative(INT)

پرش به n-امین دایرکتوری منطقی بعدی یا قبلی. هر سند چندصفحه‌ای، مانند PDFها یا فایل‌های آرشیو، به عنوان دایرکتوری منطقی در نظر گرفته می‌شوند. دایرکتوری‌های درون فایل‌های آرشیو، که با وجود یک اسلش در نام فایلِ عضو آرشیو قابل تشخیص هستند نیز دایرکتوری محسوب می‌شوند. اساساً قاعده بر این است که دو تصویر در یک دایرکتوری منطقی یکسان قرار دارند اگر پس از پیشوند مشترک نام فایل‌های آن‌ها، هیچ نویسه‌ای در هیچ‌یک از نام‌ها اسلش (/) یا علامت هش (#) نباشد.

hardlink_current_image()

ایجاد پیوند سخت (hardlink) از تصویر جاری به ./.pqiv-select/، یا رونوشت گرفتن از آن در صورت امکان‌پذیر نبودن ایجاد پیوند سخت.

jump_dialog()

نمایش کادر گفتگوی پرش.

montage_mode_enter()

ورود به حالت مونتاژ، نمایی برای انتخاب تعاملی تصاویر.

montage_mode_follow(KEYS)

برپاسازی حالت پیگیری (follow): مقید کردن دنباله‌ای متشکل از کلیدها در KEYS به هر بندانگشتی قابل مشاهده، به‌گونه‌ای که فشردن آن دنباله، مکان‌نما را به موقعیت مذکور منتقل کند. هم‌زمان، روکش‌های کلیدها (binding overlays) فعال شده، مهلت زمانی صفحه‌کلید افزایش می‌یابد و پس از انتخاب یک تصویر، همه چیز به حالت اولیه بازمی‌گردد.

montage_mode_return_proceed()

خروج از حالت مونتاژ و رفتن به تصویر در حال حاضر انتخاب‌شده.

montage_mode_return_cancel()

خروج از حالت مونتاژ و بازگشت به آخرین تصویری که پیش از ورود به حالت مونتاژ مشاهده شده بود.

montage_mode_set_shift_x(INT)

تنظیم موقعیت افقی مکان‌نما در حالت مونتاژ روی یک مقدار مطلق، نمایه‌گذاری‌شده از 0.

montage_mode_set_shift_y(INT)

تنظیم موقعیت عمودی مکان‌نما در حالت مونتاژ روی یک مقدار مطلق، نمایه‌گذاری‌شده از 0.

montage_mode_set_wrap_mode(INT)

تنظیم نحوهٔ پیچش دور لبه‌ها هنگام جابجایی موقعیت مکان‌نما در حالت مونتاژ: مقدار پیش‌فرض، 1، پیچش به دور ردیف‌هاست ولی نه دور کل فهرست تصاویر. برای غیرفعال کردن کامل پیچش، این مقدار را برابر با 0 قرار دهید. مقدار 2 پیچش کامل را فعال می‌کند.

montage_mode_shift_x(INT)

جابجایی مکان‌نما در حالت مونتاژ در جهت افقی. جابجایی‌ها دور لبه‌ها به خطوط عمودی مجاور می‌پیچند، اما از انتهای فهرست به ابتدای آن بازنمی‌گردند.

montage_mode_shift_y(INT)

جابجایی مکان‌نما در حالت مونتاژ در جهت عمودی.

montage_mode_show_binding_overlays(INT)

غیرفعال کردن (با استفاده از پارامتر 0) یا فعال کردن (با استفاده از هر مقدار دیگر) حالت پیگیری (follow mode). در حالت پیگیری، pqiv نشانه‌های یاد یار (mnemonics) را روی هر بندانگشتی که با فشردن یک کلید (یا ترکیب کلیدها) قابل دسترسی است رسم می‌کند. از این قابلیت برای دستیابی به ناوبری با صفحه‌کلید مشابه vimperator/pentadactyl/vimium و غیره استفاده کنید.

montage_mode_shift_y_pg(INT)

جابجایی مکان‌نما در حالت مونتاژ در جهت عمودی به اندازهٔ n صفحه.

move_window(INT, INT)

انتقال پنجرهٔ pqiv به مختصات مشخص‌شده. مقادیر منفی، پنجره را روی نمایشگر جاری متمرکز (وسط‌چین) می‌کنند.

nop()

انجام ندادن هیچ کاری. می‌تواند برای پاک کردن یک کلید مقیدشدهٔ موجود استفاده شود.

numeric_command(INT)

اجرای n-امین دستور تعریف‌شده از طریق --command-1 و غیره.

output_file_list()

ارسال فهرستی از تمام فایل‌های بارگذاری‌شده به خروجی استاندارد.

quit()

خروج از pqiv.

reload()

بارگذاری مجدد تصویر جاری از دیسک.

remove_file_byindex(INT)

حذف یک فایل بر اساس شمارهٔ آن.

remove_file_byname(STRING)

حذف یک فایل بر اساس نام نمایش‌داده‌شدهٔ آن.

reset_scale_level()

بازنشانی سطح مقیاس به مقدار پیش‌فرض.

rotate_left()

چرخاندن تصویر جاری به اندازهٔ ۹۰ درجه به چپ..TP rotate_right() تصویر فعلی را ۹۰ درجه به راست می‌چرخاند.

send_keys(STRING)

فشردن دنباله‌ای از کلیدها را شبیه‌سازی می‌کند. این کنش در حال حاضر از کلیدهای ویژه‌ای که بازنمایی ASCII ندارند پشتیبانی نمی‌کند. در ترکیب با bind_key(STRING) برای برپاسازی کلیدهای میانبر چرخشی مفید است.

set_cursor_visibility(INT)

نمایانی نشانگر را تنظیم می‌کند؛ مقدار 0 آن را غیرفعال کرده و مقادیر دیگر نمایانی را فعال می‌کنند.

set_cursor_auto_hide(INT)

هنگام حرکت نشانگر، آن را به‌طور خودکار نشان می‌دهد و پس از یک ثانیه عدم فعالیت، پنهان می‌کند. برای غیرفعال کردن این ویژگی مقدار 0 و برای فعال‌سازی آن هر مقدار دیگری را تنظیم کنید. توجه داشته باشید که این کار رویدادهای حرکت نشانگر را فعال می‌کند، که ممکن است در صورت استفاده از pqiv روی پیوندهای شبکه کند، سرعت آن را کاهش دهد.

set_fade_duration(DOUBLE)

مدت‌زمان محوشدگی (fade) میان تصاویر را تنظیم می‌کند. بر خلاف گزینه خط فرمان، این کنش محوشدگی را به‌طور ضمنی نیز فعال می‌کند. برای غیرفعال کردن این ویژگی مدت‌زمان را روی صفر تنظیم کنید.

set_interpolation_quality(INT)

کیفیت درون‌یابی را برای تصاویر تغییراندازه‌یافته تعیین می‌کند. گزینه‌ها عبارتند از: 0 برای چرخش میان حالت‌های گوناگون، 1 برای انتخاب خودکار بر اساس اندازه تصویر (تصاویر کوچک از درون‌یابی nearest و تصاویر بزرگ از حالت “good” متعلق به Cairo استفاده می‌کنند)، 2 برای “fast”، 3 برای “good” و 4 برای “best”.

set_keyboard_timeout(DOUBLE)

مهلت زمانی (timeout) برای ورودی دنباله کلید را تنظیم می‌کند. برای نمونه، اگر کنشی را به a و کنش دیگری را به ab مقید کنید، pqiv به‌طور پیش‌فرض نیم ثانیه به شما فرصت می‌دهد تا b را وارد کنید پیش از آنکه فرض کند قصد شما تنها فشردن a بوده است. از این کنش برای تغییر این مقدار استفاده کنید.

set_scale_level_absolute(DOUBLE)

سطح مقیاس را روی مقدار پارامتر تنظیم می‌کند. 1.0 معادل ۱۰۰٪ است. همچنین ببینید: --zoom-level.

set_scale_level_relative(DOUBLE)

سطح مقیاس را به‌صورت ضربی با مقدار پارامتر تنظیم می‌کند.

set_scale_mode_fit_px(INT, INT)

همواره سطح مقیاس را به‌گونه‌ای تنظیم می‌کند که هر تصویر در ابعاد ارائه‌شده بگنجد.

set_scale_mode_screen_fraction(DOUBLE)

میزان استفاده از فضای در دسترس صفحه نمایش برای مقیاس‌بندی پنجره در خارج از حالت تمام‌صفحه را تنظیم می‌کند. پیش‌فرض 0.8 است. این گزینه بر اندازه پنجره در حالت montage نیز اثر می‌گذارد.

set_shift_align_corner(STRING)

تصویر را با لبه پنجره/صفحه تراز می‌کند. مقادیر ممکن برای پارامتر جهت‌های اصلی هستند؛ برای نمونه NE تصویر را به گوشه شمال شرقی (بالا راست) تراز می‌کند. می‌توانید یک C اضافی به ابتدای پارامتر بیفزایید تا این تراز تنها در صورتی انجام شود که ابعاد تصویر از فضای موجود فراتر رود، و در غیر این صورت تصویر در مرکز قرار گیرد.

set_shift_x(INT)

میزان جابه‌جایی در جهت افقی را روی یک مقدار ثابت تنظیم می‌کند.

set_shift_y(INT)

میزان جابه‌جایی در جهت عمودی را روی یک مقدار ثابت تنظیم می‌کند.

set_slideshow_interval_absolute(DOUBLE)

بازه زمانی اسلایدشو را بر حسب ثانیه روی مقدار پارامتر تنظیم می‌کند.

set_slideshow_interval_relative(DOUBLE)

بازه زمانی اسلایدشو را به‌صورت جمعی با مقدار پارامتر تنظیم می‌کند. همچنین ببینید: --slideshow-interval.

set_status_output(INT)

تنظیم این گزینه روی مقداری غیر از صفر باعث می‌شود pqiv اطلاعات وضعیت را برای اسکریپت‌ها در خروجی استاندارد (stdout) چاپ کند؛ یک بار در هنگام فعال‌سازی و سپس هر بار که کاربر میان تصاویر جابه‌جا می‌شود. قالب آن با تعریف متغیرهای پوسته سازگار است. متغیرهایی که در حال حاضر پیاده‌سازی شده‌اند CURRENT_FILE_NAME و CURRENT_FILE_INDEX هستند. هر خروجی همیشه با یک خط خالی پایان می‌یابد.

set_thumbnail_preload(INT)

تعداد تصاویر بندانگشتی که باید از پیش بارگذاری شوند را تغییر می‌دهد. مقدار صفر این ویژگی را غیرفعال می‌کند.

set_thumbnail_size(INT,INT)

اندازه تصاویر بندانگشتی را تغییر می‌دهد. ترتیب آرگومان‌ها ابتدا عرض و سپس ارتفاع است. بندانگشتی‌ها همیشه به‌گونه‌ای مقیاس‌بندی می‌شوند که هیچ ضلعی بزرگ‌تر از این حد نباشد.

shift_x(INT)

تصویر فعلی را در جهت x جابه‌جا می‌کند.

shift_y(INT)

تصویر فعلی را در جهت y جابه‌جا می‌کند.

toggle_background_pattern(INT)

تغییر وضعیت میان الگوهای مختلف پس‌زمینه: 0 برای تعویض چرخشی، 1 برای الگوی شطرنجی، 2 برای مشکی، 3 برای سفید.

toggle_fullscreen(INT)

تغییر وضعیت حالت تمام‌صفحه: 0 برای تغییر وضعیت، 1 برای رفتن به تمام‌صفحه، 2 برای بازگشت به حالت پنجره.

toggle_info_box()

تغییر وضعیت نمایانی جعبه اطلاعات (info box).

toggle_mark()

تغییر وضعیت علامت‌گذاری تصویر فعلی.

toggle_negate_mode(INT)

تغییر وضعیت حالت نگاتیو (معکوس کردن رنگ‌ها): 0 برای تغییر وضعیت، 1 برای فعال‌سازی، 2 برای غیرفعال‌سازی.

toggle_scale_mode(INT)

تغییر حالت مقیاس‌بندی: استفاده از 1 برای غیرفعال کردن مقیاس‌بندی، 2 برای کاهش خودکار مقیاس (پیش‌فرض)، 3 برای همیشه بزرگ‌نمایی کردن تصاویر، 4 برای حفظ سطح بزرگ‌نمایی تعیین‌شده توسط کاربر، و 5 برای حفظ اندازه پنجره. مقدار 0 میان حالت‌های 1-3 می‌چرخد.

toggle_shuffle_mode(INT)

تغییر وضعیت حالت برزدن (shuffle). از 0 برای چرخش میان مقادیر ممکن، 1 برای فعال‌سازی shuffle و هر مقدار دیگری برای غیرفعال کردن آن استفاده کنید.

toggle_slideshow()

تغییر وضعیت حالت اسلایدشو.

Backspace/Space

فایل قبلی/بعدی.

ctrl-a

پیوند دادن تصویر جاری به ./.pqiv-select/، یا رونوشت از آن در صورتی که ایجاد پیوند سخت (hardlink) ممکن نباشد.

f

تغییر وضعیت حالت تمام‌صفحه.

h/v

قرینه‌سازی افقی یا عمودی تصویر.

k/l

چرخش تصویر به راست یا چپ.

i

تغییر وضعیت نمایش جعبه اطلاعات.

j

نمایش پنجره‌ای شامل فهرست تمام فایل‌ها برای انتخاب سریع.

m

تغییر وضعیت حالت montage، یک حالت تعاملی برای انتخاب تصویر. از کلیدهای جهت‌نما یا موشواره برای انتخاب تصویر و از کلید Return برای بازگشت به نمای تک‌تصویر استفاده کنید. از g برای پیمایش سریع به یک تصویر بندانگشتی (thumbnail) استفاده کنید.

o

تغییر وضعیت نشانه‌گذاری روی یک تصویر. از ctrl-R برای بازنشانی تمام نشانه‌ها استفاده کنید. در ترکیب با دستورهایی که با - آغاز می‌شوند کاربرد دارد.

q

خروج از pqiv.

r

بارگذاری مجدد تصویر جاری.

s

تغییر وضعیت حالت اسلایدشو.

t

تغییر وضعیت حالت مقیاس‌بندی؛ چرخش میان بزرگ‌نمایی تمام تصاویر، کوچک‌نمایی تصاویر بزرگ و عدم مقیاس‌بندی.

ctrl-t

حفظ میزان مقیاس تعیین‌شده توسط کاربر.

mod-t

حفظ اندازه پنجره.

Plus/Minus

بزرگ‌نمایی و کوچک‌نمایی.

Period, ctrl-Period

توقف، حرکت تک‌فریم و ادامه تصاویر متحرک.

mod-Plus, mod-Minus

تغییر سرعت پویانمایی.

ctrl-r

تغییر وضعیت حالت تصادفی (shuffle).

ctrl-p

رفتن به تصویری که پیش از تصویر جاری دیده شده است.

ctrl-Space, ctrl-Backspace

رفتن به پوشه منطقی بعدی/قبلی.

ctrl-Plus, ctrl-Minus

تغییر بازه زمانی اسلایدشو.

b

تغییر وضعیت الگوی پس‌زمینه برای تصاویر شفاف (transparent).

n

تغییر وضعیت حالت نگاتیو ("negative").

Mouse buttons (fullscreen)

رفتن به فایل‌های بعدی و قبلی.

Mouse drag (fullscreen)

جابه‌جایی تصویر.

Mouse drag with right button (fullscreen)

بزرگ‌نمایی و کوچک‌نمایی.

Arrow keys

جابه‌جایی تصویر.

این فهرست برخی از میانبرهای پیش‌فرض پیشرفته را نادیده گرفته است. شرح کنش‌های فوق به همراه آن میانبرها مشخص شده است. همچنین می‌توانید دستور `pqiv --show-bindings' را برای نمایش یک فهرست کامل اجرا کنید.

فایل پیکربندی (CONFIGURATION FILE)

هنگام راه‌اندازی، pqiv فایل ~/.config/pqivrc را تجزیه می‌کند. این فایل باید یک فایل کلید/مقدار به سبک INI همراه با بخش options باشد. تمامی پارامترهای قالب بلند (long form) کلیدهای معتبری هستند. برای تنظیم یک پرچم بولی (boolean)، مقدار آن را روی 1 بگذارید. تنظیم یک پرچم، معنای پارامتر مربوطه را معکوس می‌کند. به عنوان مثال، اگر `fullscreen=1' را قرار دهید، pqiv در حالت تمام‌صفحه آغاز خواهد شد مگر اینکه هنگام راه‌اندازی گزینه -f را ارسال کرده باشید.

به عنوان مثال،

[options]
fullscreen=1
sort=1
command-1=|convert - -blur 20 -

می‌توانید کلیدهای میانبر را با قالب پارامتر --bind-key در بخشی ویژه به نام [keybindings] قرار دهید. به عنوان مثال،

[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\); }); }

مشابهاً، می‌توانید کنش‌هایی (چندگانه) را در بخشی به نام [actions] تعیین کنید تا هر بار با اجرای pqiv اجرا گردند.

برای سازگاری رو به عقب با نسخه‌های قدیمی‌تر pqiv، اگر فایل با تعریف یک بخش آغاز نشود، خط نخست به عنوان پارامترهای خط فرمان تجزیه خواهد شد.

می‌توانید با قرار دادن ';' یا '#' در ابتدای خط، توضیحاتی درون فایل بنویسید. درج توضیحات در انتهای خطوط پشتیبانی نمی‌شود.

دیگر مسیرهای پشتیبانی‌شده برای فایل پیکربندی عبارتند از ~/.pqivrc، /etc/xdg/pqivrc و /etc/pqivrc. برنامه pqiv از نخستین فایلی که بیابد استفاده خواهد کرد. می‌توانید از متغیر محیطی PQIVRC_PATH برای بازنویسی مسیر فایل پیکربندی استفاده کنید..SH "مثال‌ها (EXAMPLES)"

pqiv --bind-key="a { goto_file_byindex(0) }" --bind-key='c { command(echo -n $1 | xclip) }' --sort foo bar.pdf

کلید a را برای بازگشت به نخستین تصویر و کلید c را برای ذخیرهٔ مسیر تصویر فعلی در کلیپ‌بورد با استفاده از xclip بازتعریف می‌کند، و تمام فایل‌های پوشهٔ foo و bar.pdf را به صورت مرتب‌شده بارگذاری می‌نماید.

pqiv --slideshow --watch-directories --end-of-files-action=wait --slideshow-interval=0.001 test

تمام فایل‌های پوشهٔ test را در یک اسلایدشو با پیشروی بسیار سریع بارگذاری می‌کند و در پایان منتظر می‌ماند تا فایل‌های جدید در دسترس قرار گیرند. این قابلیت در عمل تصاویر جدید را به محض ظاهر شدن در دایرکتوری نمایش می‌دهد و مثلاً زمانی مفید است که از طریق یک اسکریپت تصاویری تولید می‌کنید که بعداً قصد تبدیل آن‌ها به یک فیلم را دارید و می‌خواهید روند پیشرفت را نظاره کنید.

pqiv --slideshow --allow-empty-window --watch-directories --wait-for-images-to-appear --lazy-load test

یک اسلایدشو راه‌اندازی می‌کند که تمام تصاویر پوشهٔ test را به گونه‌ای نمایش می‌دهد که بتوان همهٔ تصاویر را از دایرکتوری حذف کرد و تصاویر جدیدی را در آن قرار داد بدون اینکه pqiv بسته شود.

echo "output_file_list(); quit()" | pqiv --actions-from-stdin test

فهرستی از تمام فایل‌های پوشهٔ test را که pqiv قادر به پردازش آن‌ها است در خروجی چاپ کرده و خارج می‌شود.

گزارش باگ‌ها (BUGS)

لطفاً هرگونه باگ را در گیت‌هاب به نشانی https://github.com/phillipberndt/pqiv گزارش دهید.

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

Phillip Berndt (phillip dot berndt at googlemail dot com)