imv - نمایشگر
تصویر برای
X11 و ویلند
برنامه imv
یک نمایشگر
تصویر برای
X11 و ویلند (Wayland)
است که برای
کاربران
مدیر
پنجره‌های
کاشی‌کاری
(tiling window managers) طراحی
شده است. این
برنامه از
طیف
گسترده‌ای
از
قالب‌های
پرونده
تصویر، از
جمله
پرونده‌های
متحرک gif
پشتیبانی
می‌کند.
چنانچه
تصویر
کنونی روی
دیسک تغییر
کند، imv
به‌طور
خودکار آن
را دوباره
بارگذاری
خواهد کرد.
imv
[گزینه‌ها]
[مسیرها...]
-h
نمایش
پیام
راهنما و
خروج.
-v
نمایش
نگارش و
خروج.
-b <background>
رنگ
پس‌زمینه
را تنظیم
می‌کند. این
مقدار
می‌تواند
یک کد رنگی
هگزادسیمال
۶ رقمی یا checks
برای نمایش
یک
پس‌زمینه
شطرنجی
باشد.
-c <command>
دستوری
را برای
اجرا هنگام
راه‌اندازی،
پس از
بارگذاری
پیکربندی
مشخص
می‌کند. این
گزینه
می‌تواند
برای
پیکربندی
کلیدهای
سفارشی با
استفاده از
دستور bind به
کار رود. این
گزینه
می‌تواند
چندین بار
استفاده
شود.
دستورها به
همان
ترتیبی که
به imv داده
شده‌اند
اجرا
می‌شوند.
-d
شروع به
کار در
حالتی که
لایه رویی (overlay)
قابل
مشاهده
است.
-f
شروع به
کار در حالت
تمام‌صفحه.
-i <id>
تنظیم
نام منبع X11 یا
شناسه
برنامه
ویلند (wayland app id)
پنجره
ایجادشده.
-l
فهرست
کردن
پرونده‌های
باز در
خروجی
استاندارد
(stdout) هنگام
خروج.
-n <path|index>
شروع به
کار با مسیر
یا نمایه
(اندیس)
مشخص‌شده
در حالت
انتخاب.
-r
بارگذاری
بازگشتی
دایرکتوری‌ها
(پوشه‌ها).
-s <none|shrink|full|crop>
حالت
مقیاس‌بندی
مورد
استفاده را
تنظیم
می‌کند.
حالت none هر
تصویر را در
اندازه
واقعی‌اش
نشان
می‌دهد.
حالت shrink
اندازه
تصویر را
کوچک
می‌کند تا
درون پنجره
جا شود. حالت
full تصویر را
بزرگ یا
کوچک
می‌کند تا
کاملاً و
به‌طور
مناسب درون
پنجره جا
گیرد. حالت crop
تصویر را
مقیاس‌بندی
و برش
می‌زند تا
پنجره را پر
کند.
پیش‌فرض
روی full است.
-t <slideshow_duration>
شروع در
حالت
اسلایدشو،
به‌طوری که
هر تصویر
برای تعداد
ثانیه‌های
مشخص‌شده
نمایش داده
می‌شود.
-u <linear|nearest_neighbour>
تنظیم
روش
بزرگ‌نمایی
(upscaling) مورد
استفاده
توسط imv.
-w <windowtitle>
تنظیم
عنوان
پنجره
هنگام شروع
imv.
-x
غیرفعال
کردن چرخه
(حلقه)
مسیرهای
ورودی.
-W <width>
عرض
اولیه
پنجره.
-H <height>
ارتفاع
اولیه
پنجره.
دستورها
را می‌توان
با فشردن
کلید : وارد
کرد. برنامه
imv از
دستورهای
زیر
پشتیبانی
می‌کند:
quit
خروج از imv.
دارای نام
مستعار q.
pan <x> <y>
جابه‌جایی
نما (pan) به
مقدارهای
داده‌شده.
next <offset>
حرکت به
جلو به
تعداد
تصاویر
داده‌شده.
دارای نام
مستعار n.
prev <offset>
حرکت به
عقب به
تعداد
تصاویر
داده‌شده.
دارای نام
مستعار p.
goto <index>
انتخاب
یک تصویر با
استفاده از
نمایه
(اندیس). 1
نخستین
تصویر است،
2 دومین
تصویر و الی
آخر. آخرین
تصویر
می‌تواند
با نمایه -1 و
تصویر یکی
مانده به
آخر با -2
مشخص شود.
دارای نام
مستعار g.
zoom <amount|actual>
بزرگ‌نمایی
روی تصویر
به مقدار
داده‌شده.
مقادیر
منفی باعث
کوچک‌نمایی
می‌شوند.
مقدار actual
بزرگ‌نمایی
را به ۱۰۰٪
بازنشانی
کرده و
تصویر را در
اندازه
واقعی‌اش
نشان
می‌دهد.
دارای نام
مستعار z.
rotate <'to'|by> <angle>
چرخش
تصویر در
جهت
عقربه‌های
ساعت
به/به‌اندازه
مقدار
داده‌شده
بر حسب
درجه.
flip <'horizontal'|vertical>
وارونه‌سازی
(قرینه‌سازی)
افقی/عمودی
تصویر (حول
محور
عمودی/افقی).
open [-r] <paths ...>
افزودن
مسیرهای
داده‌شده
به فهرست
تصاویر باز.
اگر گزینه -r
مشخص شده
باشد، این
کار
به‌صورت
بازگشتی
انجام
می‌شود.
می‌توان از
بسط‌های
پوسته (shell expansions)
نیز
استفاده
کرد. دارای
نام مستعار
o.
close [index|all]
بستن
تصویر
انتخاب‌شده
فعلی، یا
تصویر در
نمایه
مشخص‌شده،
یا تمام
تصاویر.
fullscreen
تغییر
وضعیت
تمام‌صفحه
(روشن/خاموش).
overlay
تغییر
وضعیت
نمایش لایه
رویی (overlay).
exec <command>
اجرای یک
دستور
پوسته.
برنامه imv
متغیرهای
محیطی
گوناگونی
را در
اختیار
دستور
اجراشده
قرار
می‌دهد. این
متغیرها در
بخش
متغیرهای
محیطی (ENVIRONMENT VARIABLES)
شرح داده
شده‌اند.
center
قرار
دادن مجدد
تصویر
انتخاب‌شده
در مرکز
صفحه.
reset
بازنشانی
نما،
متمرکز
کردن تصویر
و استفاده
از حالت
مقیاس‌بندی
فعلی برای
تنظیم مجدد
اندازه آن.
next_frame
چنانچه
یک فایل gif
متحرک در
حال نمایش
باشد، فریم
بعدی را
بارگذاری
می‌کند.
toggle_playing
تغییر
وضعیت
پخش/توقف
تصویر فعلی
در صورتی که
یک gif متحرک
باشد.
scaling <none|shrink|full|crop|next>
تنظیم
حالت
مقیاس‌بندی
فعلی. تنظیم
حالت روی next
آن را به
حالت بعدی
در فهرست
می‌برد.
upscaling <linear|nearest_neighbour|next>
تنظیم
روش فعلی
بزرگ‌نمایی
(upscaling). تنظیم روش
روی next آن را
به روش بعدی
در فهرست
پیش
می‌برد.
slideshow <+amount|-amount|duration>
افزایش
یا کاهش
مدت‌زمان
اسلایدشو
به مقدار
داده‌شده
بر حسب
ثانیه، یا
تنظیم
مستقیم
مدت‌زمان
آن. دارای
نام مستعار
ss.
background <checks|hexadecimal-code>
تنظیم
رنگ
پس‌زمینه.
مقدار checks
برای یک
الگوی
شطرنجی، یا
تعیین یک کد
رنگ
هگزادسیمال
۶ رقمی.
دارای نام
مستعار bg.
bind <keys> <commands>
یک کنش
را به
مجموعه‌ای
از
ورودی‌های
کلید پیوند
می‌زند. از
همان نحو
فایل
پیکربندی
استفاده
می‌کند، با
این تفاوت
که علامت
مساوی بین
کلیدها و
دستورها
قرار
نمی‌گیرد.
برای
اطلاعات
بیشتر
درباره
نحو،
ببینید:
imv(5).
برنامه imv
به‌طور
پیش‌فرض
همراه با
چندین کلید
پیکربندی‌شده
عرضه
می‌شود:
q
خروج
Left arrow,
تصویر
قبلی
Right arrow
تصویر
بعدی
gg
رفتن به
نخستین
تصویر
G
رفتن به
آخرین
تصویر
j
جابه‌جایی
به پایین
k
جابه‌جایی
به بالا
h
جابه‌جایی
به چپ
l
جابه‌جایی
به راست
x
بستن
تصویر
فعلی
f
تغییر
وضعیت
تمام‌صفحه
d
تغییر
وضعیت لایه
رویی (overlay)
p
چاپ
تصویر فعلی
در خروجی
استاندارد
(stdout)
Up arrow
بزرگ‌نمایی
Down arrow
کوچک‌نمایی
i
بزرگ‌نمایی
o
کوچک‌نمایی
+
بزرگ‌نمایی
-
کوچک‌نمایی
Ctrl+r
چرخش ۹۰
درجه در جهت
عقربه‌های
ساعت
c
وسط‌چین
کردن
تصویر
s
حالت
مقیاس‌بندی
بعدی
S
روش
بزرگ‌نمایی
(upscaling) بعدی
a
بزرگ‌نمایی
به اندازه
واقعی
r
بازنشانی
بزرگ‌نمایی
و
جابه‌جایی
.
فریم
بعدی (برای
پویانمایی‌ها)
Space
توقف/پخش
پویانمایی‌ها
t
شروع
اسلایدشو/افزایش
تأخیر به
میزان ۱
ثانیه
T
توقف
اسلایدشو/کاهش
تأخیر به
میزان ۱
ثانیه
مسیر
پرونده
پیکربندی
را می‌توان
از طریق
متغیر
محیطی $imv_config
مشخص کرد. در
صورت پیدا
نشدن، imv در
مکان‌های
زیر به
دنبال آن
خواهد گشت:
•$XDG_CONFIG_HOME/imv/config
(توصیه‌شده)
•$HOME/.config/imv/config
•$HOME/.imv_config
•$HOME/.imv/config
•/usr/local/etc/imv_config
•/etc/imv_config
یک پرونده
پیکربندی
پیش‌فرض به
همراه imv در
مسیر /etc/imv_config
ارائه شده
است.
برای
مستندات
قالب
پرونده
پیکربندی،
ببینید: imv(5).
هنگامی که
imv یک دستور
پوسته را
اجرا
می‌کند،
تعدادی
متغیر
محیطی در
اختیار آن
می‌گذارد
که وضعیت imv
را نشان
می‌دهند.
این
متغیرهای
محیطی
هنگام
سفارشی‌سازی
عنوان
پنجره یا
متن لایه
رویی (overlay) نیز
در دسترس
هستند.
$imv_pid
شناسه
فرآیند (PID)
این نمونه
از imv. برای
اجرای imv-msg در
اسکریپت‌ها
کاربرد
دارد.
$imv_current_file
مسیر
تصویر
انتخاب‌شده
فعلی.
$imv_scaling_mode
نام حالت
مقیاس‌بندی
فعلی.
$imv_loading
اگر یک
تصویر جدید
در حال
بارگذاری
باشد مقدار
۱، در غیر
این صورت ۰.
$imv_current_index
نمایه
(اندیس)
تصویر
فعلی، از ۱
تا N.
$imv_file_count
شمار کل
پرونده‌ها.
$imv_width
عرض
تصویر
فعلی.
$imv_height
ارتفاع
تصویر
فعلی.
$imv_scale
مقیاس
تصویر فعلی
بر حسب
درصد.
$imv_slideshow_duration
تعداد
ثانیه‌هایی
که هر تصویر
نمایش داده
می‌شود.
$imv_slideshow_elapsed
مدت‌زمانی
که تصویر
فعلی نمایش
داده شده
است.
برنامه imv
می‌تواند
دستورها را
از فرآیندی
دیگر از
طریق سوکت
یونیکس (unix socket)
بپذیرد. هر
نمونه از imv
یک سوکت
یونیکس با
نام $XDG_RUNTIME_DIR/imv-$PID.sock
باز خواهد
کرد. اگر
متغیر $XDG_RUNTIME_DIR
تعریف نشده
باشد، سوکت
در مسیر /tmp/
قرار
می‌گیرد.
ابزار imv-msg(1)
برای
ساده‌سازی
این کار از
طریق
اسکریپت‌های
پوسته
ارائه شده
است.
برنامه imv
توسط Harry Jeffery <me@harry.pm>
نوشته شده و
با مشارکت
سایر
توسعه‌دهندگان
نگهداری
می‌شود.
کد منبع
کامل و
اطلاعات
بیشتر را
می‌توان در
نشانی https://sr.ht/~exec64/imv
یافت.
