نام (NAME)

sxiv - نمایشگر ساده تصویر برای سیستم پنجره‌ای X11

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

sxiv [-abcfhiopqrtvZ] [-A FRAMERATE] [-e WID] [-G GAMMA] [-g GEOMETRY] [-N NAME] [-n NUM] [-S DELAY] [-s MODE] [-z ZOOM] FILE...

توضیحات (DESCRIPTION)

برنامه sxiv یک نمایشگر تصویر ساده برای سیستم پنجره‌ای X است.

این برنامه دارای دو حالت کاری است: حالت تصویر و حالت تصویر بندانگشتی (thumbnail). حالت پیش‌فرض، حالت تصویر است که در آن فقط تصویر فعلی نشان داده می‌شود. در حالت تصویر بندانگشتی، شبکه‌ای از پیش‌نمایش‌های کوچک نمایش داده می‌شود که انتخاب تصویر برای باز کردن را آسان می‌کند.

لطفاً توجه داشته باشید که حالت تمام‌صفحه به یک مدیر پنجره سازگار با EWMH/NetWM نیاز دارد.

گزینه‌ها (OPTIONS)

-A FRAMERATE: پخش پویانمایی‌ها با نرخ فریم ثابت تنظیم‌شده روی FRAMERATE.
-a: پخش پویانمایی تصاویر چندفریمی.
-b: عدم نمایش نوار اطلاعات در پایین پنجره.
-c: حذف تمام فایل‌های کش رهاشده از دایرکتوری کش تصاویر بندانگشتی و خروج.
-e WID: جاسازی پنجره sxiv در پنجره‌ای با شناسه WID.
-f: شروع در حالت تمام‌صفحه.
-G GAMMA: تنظیم گامای تصویر روی GAMMA (-32..32).
-g GEOMETRY: تنظیم موقعیت و اندازه پنجره. برای اطلاعات بیشتر درباره آرگومان GEOMETRY، بخش GEOMETRY SPECIFICATIONS از X(7) را ببینید.
-N NAME: تنظیم نام منبع (resource name) پنجره X برنامه sxiv روی NAME.
-n NUM: شروع از تصویر شماره NUM.
-h: چاپ اطلاعات خلاصه نحوه استفاده در خروجی استاندارد و خروج.
-i: خواندن نام فایل‌ها برای باز کردن از ورودی استاندارد. همچنین اگر FILE برابر `-' باشد نیز انجام می‌شود.
-o: نوشتن فهرست تمام فایل‌های نشانه‌گذاری‌شده در خروجی استاندارد هنگام خروج. در ترکیب با گزینه -i می‌توان از sxiv به عنوان یک فیلتر/پایپ بصری استفاده کرد.
-p: فعال‌سازی حالت خصوصی، که در آن sxiv هیچ فایل کش یا موقتی نمی‌نویسد.
-q: حالت بی‌صدا، غیرفعال کردن هشدارها در جریان خطای استاندارد.
-r: جستجوی بازگشتی در دایرکتوری‌های داده‌شده برای تصاویری که باید نمایش داده شوند.
-S DELAY: شروع در حالت اسلایدشو. تنظیم تاخیر بین تصاویر به DELAY ثانیه. مقدار DELAY می‌تواند یک عدد ممیز شناور باشد.
-s MODE: تنظیم حالت مقیاس‌بندی بر اساس نویسه MODE. حالت‌های پشتیبانی‌شده عبارتند از: [d]own (کوچک‌سازی)، [f]it (برازش)، [w]idth (عرض)، [h]eight (ارتفاع).
-t: شروع در حالت بندانگشتی.
-v: چاپ اطلاعات نگارش در خروجی استاندارد و خروج.
-Z: مشابه `-z 100'.
-z ZOOM: تنظیم سطح بزرگ‌نمایی روی ZOOM درصد.

دستورات صفحه‌کلید (KEYBOARD COMMANDS)

عمومی (General)

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

0-9: پیشوند کردن دستور بعدی با یک عدد (مشخص‌شده با count).
q: خروج از sxiv.
Return: جابجایی به حالت بندانگشتی / باز کردن تصویر انتخاب‌شده در حالت تصویر.
f: تغییر وضعیت حالت تمام‌صفحه.
b: تغییر وضعیت نمایش نوار اطلاعات در پایین پنجره.
Ctrl-x: ارسال کلید بعدی به پردازشگر کلید خارجی. برای اطلاعات بیشتر بخش EXTERNAL KEY HANDLER را ببینید.
g: رفتن به اولین تصویر.
G: رفتن به آخرین تصویر، یا تصویر شماره count.
r: بارگذاری مجدد تصویر.
D: حذف تصویر فعلی از فهرست فایل‌ها و رفتن به تصویر بعدی.
Ctrl-h, Ctrl-Left: پیمایش به اندازه یک پهنای صفحه به چپ.
Ctrl-j, Ctrl-Down: پیمایش به اندازه یک ارتفاع صفحه به پایین.
Ctrl-k, Ctrl-Up: پیمایش به اندازه یک ارتفاع صفحه به بالا.
Ctrl-l, Ctrl-Right: پیمایش به اندازه یک پهنای صفحه به راست.
+: بزرگ‌نمایی (Zoom in).
-: کوچک‌نمایی (Zoom out).
m: علامت‌گذاری / لغو علامت‌گذاری تصویر فعلی.
M: معکوس کردن تمام علامت‌های تصاویر.
Ctrl-M: تکرار آخرین عمل علامت‌گذاری بر روی تمام تصاویر از آخرین تصویر علامت‌گذاری‌شده/نشده تا تصویر فعلی.
Ctrl-m: حذف تمام علامت‌های تصاویر.
N: رفتن به اندازه count تصویر علامت‌گذاری‌شده به جلو.
P: رفتن به اندازه count تصویر علامت‌گذاری‌شده به عقب.
{: کاهش تصحیح گاما به میزان count گام.
}: افزایش تصحیح گاما به میزان count گام.
Ctrl-g: بازنشانی تصحیح گاما.

حالت بندانگشتی (Thumbnail mode)

دستورات صفحه‌کلید زیر فقط در حالت بندانگشتی در دسترس هستند:

h, Left: حرکت انتخاب به اندازه count بار به چپ.
j, Down: حرکت انتخاب به اندازه count بار به پایین.
k, Up: حرکت انتخاب به اندازه count بار به بالا.
l, Right: حرکت انتخاب به اندازه count بار به راست.
R: بارگذاری مجدد تمام تصاویر بندانگشتی.

حالت تصویر (Image mode)

دستورات صفحه‌کلید زیر فقط در حالت تصویر در دسترس هستند:

پیمایش در فهرست تصاویر:
n, Space: رفتن به اندازه count تصویر به جلو.
p, Backspace: رفتن به اندازه count تصویر به عقب.
[: رفتن به اندازه count * 10 تصویر به عقب.
]: رفتن به اندازه count * 10 تصویر به جلو.
کار با تصاویر چندفریمی:
Ctrl-n: رفتن به اندازه count فریم از یک تصویر چندفریمی به جلو.
Ctrl-p: رفتن به اندازه count فریم از یک تصویر چندفریمی به عقب.
Ctrl-Space: پخش/توقف پویانمایی تصاویر چندفریمی.
پیمایش تصویر (Panning):
h, Left: پیمایش تصویر به اندازه ۱/۵ عرض پنجره یا count پیکسل به چپ.
j, Down: پیمایش تصویر به اندازه ۱/۵ ارتفاع پنجره یا count پیکسل به پایین.
k, Up: پیمایش تصویر به اندازه ۱/۵ ارتفاع پنجره یا count پیکسل به بالا.
l, Right: پیمایش تصویر به اندازه ۱/۵ عرض پنجره یا count پیکسل به راست.
H: پیمایش به لبه چپ تصویر.
J: پیمایش به لبه پایین تصویر.
K: پیمایش به لبه بالای تصویر.
L: پیمایش به لبه راست تصویر.
بزرگ‌نمایی:
=: تنظیم سطح بزرگ‌نمایی روی ۱۰۰٪، یا count%.
w: تنظیم سطح بزرگ‌نمایی روی ۱۰۰٪، با گنجاندن تصاویر بزرگ درون پنجره.
W: برازش تصویر درون پنجره.
e: برازش تصویر با عرض پنجره.
E: برازش تصویر با ارتفاع پنجره.
چرخش:
<: چرخش ۹۰ درجه تصویر در خلاف جهت عقربه‌های ساعت.
>: چرخش ۹۰ درجه تصویر در جهت عقربه‌های ساعت.
?: چرخش ۱۸۰ درجه تصویر.
قرینه‌سازی:
|: قرینه‌سازی افقی تصویر.
_: قرینه‌سازی عمودی تصویر.
متفرقه:
a: تغییر وضعیت هموارسازی لبه‌ها (anti-aliasing).
A: تغییر وضعیت نمایش کانال آلفا، یعنی شفافیت تصویر.
s: تغییر وضعیت حالت اسلایدشو و/یا تنظیم میزان تاخیر بین تصاویر روی count ثانیه.

دستورات ماوس (MOUSE COMMANDS)

نگاشت‌های ماوس زیر در حالت تصویر در دسترس هستند:

عمومی:
Button3: جابجایی به حالت بندانگشتی.
پیمایش در فهرست تصاویر:
Button1: رفتن به تصویر بعدی اگر مکان‌نمای ماوس در نیمه راست پنجره باشد، یا به تصویر قبلی اگر در نیمه چپ باشد.
پیمایش تصویر (Panning):
Button2: پیمایش تصویر مطابق با موقعیت مکان‌نمای ماوس در پنجره هنگام فشرده نگه داشتن این کلید.
بزرگ‌نمایی:
ScrollUp: بزرگ‌نمایی (Zoom in).
ScrollDown: کوچک‌نمایی (Zoom out).

پیکربندی (CONFIGURATION)

منابع X زیر پشتیبانی می‌شوند:

background: رنگ پس‌زمینه پنجره و پیش‌زمینه نوار وضعیت
foreground: رنگ پیش‌زمینه پنجره و پس‌زمینه نوار وضعیت
font: نام قلم Xft نوار وضعیت
لطفاً برای نحوه تغییر دادن آن‌ها: xrdb(1) را ببینید.

نوار وضعیت (STATUS BAR)

اطلاعات نمایش‌یافته در سمت چپ نوار وضعیت را می‌توان با خروجی یک اسکریپت سفارشی کاربر جایگزین کرد؛ این اسکریپت با هر بار بارگذاری تصویر توسط sxiv فراخوانی می‌شود. مسیر این اسکریپت $XDG_CONFIG_HOME/sxiv/exec/image-info است و آرگومان‌های ارسالی به آن عبارتند از: ۱) مسیر فایل تصویر، ۲) عرض تصویر، ۳) ارتفاع تصویر.

همچنین یک اسکریپت نمونه به همراه sxiv در مسیر /usr/share/sxiv/exec/image-info نصب شده است.

مدیریت‌کننده کلید خارجی (EXTERNAL KEY HANDLER)

دستورات صفحه‌کلید خارجی تکمیلی را می‌توان با استفاده از یک برنامه مدیریت‌کننده (handler) تعریف کرد که در مسیر $XDG_CONFIG_HOME/sxiv/exec/key-handler قرار دارد. این مدیریت‌کننده با فشردن Ctrl-x فراخوانی می‌شود. ترکیب کلید بعدی به عنوان نخستین آرگومان به آن فرستاده می‌شود. تصاویری که باید روی آن‌ها عملیاتی صورت گیرد از طریق ورودی استاندارد (stdin)، هر مسیر در یک خط فرستاده می‌شوند: همه تصاویر علامت‌گذاری‌شده در صورتی که در حالت بندانگشتی بوده و حداقل یک تصویر علامت‌گذاری شده باشد، در غیر این صورت تصویر فعلی. برنامه sxiv(1) تا زمان خاتمه مدیریت‌کننده مسدود (متوقف) می‌ماند. سپس بررسی می‌کند که کدام تصاویر تغییر یافته‌اند و آن‌ها را مجدداً بارگذاری می‌کند.

آرگومان ترکیب کلید دارای قالب زیر است: "[C-][M-][S-]KEY"، که در آن نشانه‌های C/M/S وضعیت کلیدهای تبدیل Ctrl/Meta(Alt)/Shift را مشخص می‌کنند و KEY همان نماد کلید X (keysym) است، همان‌طور که در مسیر /usr/include/X11/keysymdef.h بدون پیشوند "XK_" فهرست شده است.

همچنین یک اسکریپت نمونه همراه با sxiv در مسیر /usr/share/sxiv/exec/key-handler نصب شده است.

حافظه موقت تصاویر بندانگشتی (THUMBNAIL CACHING)

برنامه sxiv تمام تصاویر بندانگشتی را در مسیر $XDG_CACHE_HOME/sxiv/ ذخیره می‌کند.

از گزینه خط فرمان -c برای حذف تمامی فایل‌های کش رهاشده استفاده کنید. علاوه بر این، پس از آن دستور زیر را درون دایرکتوری کش اجرا کنید تا دایرکتوری‌های فرعی خالی نیز حذف شوند:

find . -depth -type d -empty ! -name '.' -exec rmdir {} \;

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

Bert Muennich   <ber.t at posteo.de>

مشارکت‌کنندگان (CONTRIBUTORS)

Bastien Dejean  <nihilhill at gmail.com>
Dave Reisner    <d at falconindy.com>
Fung SzeTat     <sthorde at gmail.com>
Max Voit        <mvdev at with-eyes.net>

صفحه خانگی (HOMEPAGE)

https://github.com/muennich/sxiv

همچنین ببینید (SEE ALSO)

X(7), xrdb(1)