نام (NAME)

nsxiv - نمایش‌دهنده ساده تصویر برای سامانه پنجره X (نسخه نئو)

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

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

توضیحات (DESCRIPTION)

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

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

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

گزینه‌ها (OPTIONS)

-A, --framerate FRAMERATE: پخش پویانمایی‌ها با نرخ فریم ثابت تعیین‌شده توسط FRAMERATE. اگر FRAMERATE برابر با 0 تنظیم شود، پخش پویانمایی غیرفعال می‌شود.
-a, --animate: پخش پویانمایی تصاویر چندفریمی.
-b: عدم نمایش نوار وضعیت.
--bar, --no-bar: فعال یا غیرفعال کردن نوار وضعیت. --no-bar معادل -b است.
-c, --clean-cache: حذف تمام فایل‌های کش یتیم از دایرکتوری کش تصاویر بندانگشتی و خروج.
-e, --embed WID: جاسازی پنجره nsxiv در پنجره‌ای با شناسه WID.
-f, --fullscreen: شروع در حالت تمام‌صفحه.
-G, --gamma GAMMA: تنظیم گامای تصویر روی GAMMA (-32..32).
-g, --geometry GEOMETRY: تنظیم موقعیت و اندازه پنجره. برای اطلاعات بیشتر درباره آرگومان GEOMETRY، بخش GEOMETRY SPECIFICATIONS در X(7) را ببینید.
-H, --hidden[=no]: شامل کردن فایل‌ها و دایرکتوری‌های پنهان. گزینه طولانی می‌تواند برای غیرفعال‌سازی مقدار اختیاری "no" را بپذیرد.
-h, --help: چاپ اطلاعات خلاصه نحوه استفاده در خروجی استاندارد و خروج.
-i, --stdin: خواندن نام فایل‌ها برای باز شدن از ورودی استاندارد. همچنین اگر FILE برابر با `-' باشد انجام می‌شود.
-N, --name NAME: تنظیم نام پنجره (یعنی نام "Instance" در WM_CLASS همان‌طور که در ICCCM توضیح داده شده است) به NAME.
-n, --start-at NUM: شروع از تصویر شماره NUM.
-o, --stdout: نوشتن فهرست تمام فایل‌های نشانه‌گذاری‌شده در خروجی استاندارد هنگام خروج. در ترکیب با -i, --stdin می‌توان از nsxiv به عنوان یک فیلتر/پایپ بصری استفاده کرد.
-p, --private: فعال‌سازی حالت خصوصی، که در آن nsxiv هیچ فایل کش یا موقتی نمی‌نویسد.
-q, --quiet: حالت بی‌صدا و غیرفعال کردن هشدارها به جریان خطای استاندارد.
-r, --recursive: جستجوی بازگشتی در دایرکتوری‌های داده‌شده برای یافتن تصاویر جهت نمایش.
-S, --ss-delay DELAY: شروع در حالت اسلایدشو. تنظیم تاخیر بین تصاویر بر حسب DELAY ثانیه. DELAY می‌تواند یک عدد ممیز شناور باشد.
-s, --scale-mode MODE: تنظیم حالت مقیاس بر اساس نویسه MODE. حالت‌های پشتیبانی‌شده عبارتند از: [d]own، [f]it، [F]ill، [w]idth، [h]eight.
-t, --thumbnail[=no]: شروع در حالت بندانگشتی. گزینه طولانی یک "no" اختیاری برای غیرفعال کردن آن می‌پذیرد.
-v, --version: چاپ اطلاعات نسخه در خروجی استاندارد و خروج.
-Z, --zoom-100: همانند `-z 100'.
-z, --zoom ZOOM: تنظیم سطح زوم به ZOOM درصد.
-0, --null: استفاده از جداکننده NULL. با این گزینه، خروجی -o و فهرست فایل‌های ارسالی به گرداننده کلید و ورودی -i با نویسه NULL جدا می‌شوند.
--anti-alias[=no]: فعال کردن هموارسازی لبه‌ها (anti-aliasing)؛ در صورت دادن no به عنوان آرگومان، آن را غیرفعال می‌کند.
--alpha-layer[=no]: فعال کردن پس‌زمینه شطرنجی برای لایه آلفا؛ در صورت دادن no به عنوان آرگومان، آن را غیرفعال می‌کند.
--assume-files: صرف‌نظر کردن از پیمایش دایرکتوری، برای مواقعی که مشخص است فهرست فقط حاوی فایل‌ها است. این کار از برخی عملیات دیسک اولیه جلوگیری کرده و زمان بالا آمدن را در دیسک‌های کند کاهش می‌دهد.
--cache-allow, --cache-deny CACHE-PATHS: فهرست دایرکتوری‌ها جهت قرارگیری در فهرست مجاز (whitelist) یا فهرست سیاه (blacklist) برای کش تصاویر بندانگشتی. بخش کش کردن تصاویر بندانگشتی (THUMBNAIL CACHING) را برای اطلاعات بیشتر درباره فرمت آرگومان ببینید. این گزینه‌ها مانعة‌الجمع هستند؛ اگر بیش از یک بار مشخص شوند، تنها آخرین مورد اعمال می‌شود.
--update-cache: به‌روزرسانی کش تصاویر بندانگشتی (و ایجاد آن‌ها در صورت نیاز) برای آرگومان‌های داده‌شده و خروج. می‌تواند به همراه --clean-cache استفاده شود.

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

عمومی (General)

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

0-9: پیشوند کردن دستور بعدی با یک عدد (مشخص‌شده با count).
q: خروج از nsxiv.
Q: خروج از nsxiv، ولی در عین حال چاپ نام فایل جاری در صورت فعال بودن -o و نشانه‌گذاری نشدن هیچ فایلی.
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-u: حذف تمام نشانه‌های تصاویر.
N: رفتن به اندازه count تصویر نشانه‌گذاری‌شده به جلو.
P: رفتن به اندازه count تصویر نشانه‌گذاری‌شده به عقب.
{: کاهش تصحیح گاما به اندازه count گام.
}: افزایش تصحیح گاما به اندازه count گام.
Ctrl-g: بازنشانی تصحیح گاما به حالت اولیه.
Ctrl-[: کاهش تصحیح روشنایی به اندازه count گام.
Ctrl-]: افزایش تصحیح روشنایی به اندازه count گام.
(: کاهش کنتراست به اندازه count گام.
): افزایش کنتراست به اندازه count گام.

حالت بندانگشتی (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-6: رفتن به تصویری که قبلاً مشاهده شده بود.
مدیریت تصاویر چندفریمی:
Ctrl-n: رفتن به اندازه count فریم از تصویر چندفریمی به جلو.
Ctrl-p: رفتن به اندازه count فریم از تصویر چندفریمی به عقب.
Ctrl-a, Ctrl-Space: پخش/توقف پویانمایی تصاویر چندفریمی.
جا‌به‌جایی در تصویر (Panning):
h, Left: پیمایش تصویر به اندازه یک‌پنجم پهنای پنجره یا count پیکسل به چپ.
j, Down: پیمایش تصویر به اندازه یک‌پنجم ارتفاع پنجره یا count پیکسل به پایین.
k, Up: پیمایش تصویر به اندازه یک‌پنجم ارتفاع پنجره یا count پیکسل به بالا.
l, Right: پیمایش تصویر به اندازه یک‌پنجم پهنای پنجره یا count پیکسل به راست.
H: پیمایش به لبه چپ تصویر.
J: پیمایش به لبه پایین تصویر.
K: پیمایش به لبه بالای تصویر.
L: پیمایش به لبه راست تصویر.
z: پیمایش به مرکز تصویر.
بزرگ‌نمایی (Zooming):
=: تنظیم سطح زوم روی 100% یا count%.
w: تنظیم سطح زوم روی 100%، اما برازش تصاویر بزرگ در پنجره.
W: برازش تصویر درون پنجره.
F: پر کردن پنجره با تصویر.
e: برازش تصویر با عرض پنجره.
E: برازش تصویر با ارتفاع پنجره.
چرخش (Rotation):
<: چرخش 90 درجه‌ای تصویر در جهت پادساعت‌گرد.
>: چرخش 90 درجه‌ای تصویر در جهت ساعت‌گرد.
?: چرخش 180 درجه‌ای تصویر.
وارون‌سازی (Flipping):
|: وارون‌سازی افقی تصویر.
_: وارون‌سازی عمودی تصویر.
متفرقه:
a: تغییر وضعیت هموارسازی لبه‌ها (anti-aliasing).
A: تغییر وضعیت نمایش کانال آلفا، یعنی شفافیت تصویر.
s: تغییر وضعیت حالت اسلایدشو و/یا تنظیم تاخیر بین تصاویر روی count ثانیه.

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

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

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

Button1: انتخاب تصویر. در صورت دوبار کلیک وارد حالت تصویر می‌شود.
Button3: نشانه‌گذاری یا لغو نشانه‌گذاری تصویر. کشیدن هم‌زمان با نگه داشتن دکمه Button3 باعث نشانه‌گذاری یا لغو نشانه‌گذاری چندین تصویر می‌شود.
Button4: پیمایش به بالا به اندازه یک ردیف.
Button5: پیمایش به پایین به اندازه یک ردیف.
Ctrl-Button4: پیمایش به بالا به اندازه یک صفحه.
Ctrl-Button5: پیمایش به پایین به اندازه یک صفحه.

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

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

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

پیکربندی (CONFIGURATION)

منابع X زیر تحت "Nsxiv" پشتیبانی می‌شوند (مانند Nsxiv.bar.font ):

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

یک ورودی منبع X با مقدار خالی به این معناست که مقدار پیش‌فرض (تعریف‌شده در config.h) استفاده خواهد شد.

عنوان پنجره (WINDOW TITLE)

عنوان پنجره می‌تواند با خروجی اسکریپت ارائه‌شده توسط کاربر جایگزین شود؛ این اسکریپت هر زمان که هر یک از اطلاعات مربوطه تغییر کند، توسط nsxiv فراخوانی می‌شود. مسیر این اسکریپت $XDG_CONFIG_HOME/nsxiv/exec/win-title است و آرگومان‌های ارائه‌شده به آن (که در آن‌ها آرگومان‌های اختیاری ممکن است خالی باشند) عبارتند از:

$1: مسیر مطلق حل‌شده فایل جاری
$2: شماره فایل جاری
$3: تعداد کل فایل‌ها
$4: عرض تصویر (اختیاری: در حالت بندانگشتی غیرفعال است)
$5: ارتفاع تصویر (اختیاری: در حالت بندانگشتی غیرفعال است)
$6: زوم جاری (اختیاری: در حالت بندانگشتی غیرفعال است)

به جای تصویر از اصطلاح فایل استفاده می‌شود، زیرا nsxiv از قبل معتبر بودن فایل‌های ورودی به عنوان تصویر را بررسی نمی‌کند. تعداد کل فایل‌ها ممکن است با تعداد واقعی تصاویر معتبر متفاوت باشد.

همچنین یک اسکریپت نمونه همراه با nsxiv به صورت /usr/share/doc/nsxiv/examples/win-title نصب شده است.

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

اطلاعات نمایش‌داده‌شده در سمت چپ نوار وضعیت می‌تواند با خروجی اسکریپت ارائه‌شده توسط کاربر جایگزین شود.

اسکریپتی که هنگام بارگذاری یک تصویر توسط nsxiv فراخوانی می‌شود در مسیر زیر قرار دارد: $XDG_CONFIG_HOME/nsxiv/exec/image-info و آرگومان‌های داده‌شده به آن عبارتند از:

$1: مسیر فایل تصویر (همان‌گونه که توسط کاربر ارائه شده است)
$2: عرض تصویر
$3: ارتفاع تصویر
$4: مسیر کاملاً حل‌شده به فایل تصویر

در حالت بندانگشتی، اسکریپتی که فراخوانی می‌شود در مسیر زیر قرار دارد: $XDG_CONFIG_HOME/nsxiv/exec/thumb-info و آرگومان‌های داده‌شده به آن عبارتند از:

$1: مسیر فایل تصویر (همان‌گونه که توسط کاربر ارائه شده است)
$2: خالی
$3: خالی
$4: مسیر کاملاً حل‌شده به فایل تصویر

همچنین اسکریپت‌های نمونه‌ای همراه با nsxiv در مسیرهای /usr/share/doc/nsxiv/examples/image-info و /usr/share/doc/nsxiv/examples/thumb-info نصب شده‌اند.

گرداننده کلید خارجی (EXTERNAL KEY HANDLER)

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

به طور پیش‌فرض nsxiv(1) یک تصویر در هر خط به ورودی استاندارد ارسال می‌کند، اما هنگام استفاده از -0 فهرست تصاویر با NULL جدا خواهد شد و متغیر محیطی $NSXIV_USING_NULL روی 1 تنظیم می‌شود.

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

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

کش کردن تصاویر بندانگشتی (THUMBNAIL CACHING)

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

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

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

گزینه --cache-allow یا --cache-deny ممکن است برای قرار دادن دایرکتوری‌های خاصی در فهرست مجاز یا سیاه جهت کش نشدن استفاده شود. آرگومان فهرستی از مسیرها است که با : جدا شده‌اند. وجود یک * در ابتدای مسیر نشان می‌دهد که آن مسیر باید به صورت بازگشتی مطابقت داده شود.

برای مثال: --cache-allow "/user/pictures:*/media/pictures" دایرکتوری "/user/pictures" را به صورت غیربازگشتی و دایرکتوری "/media/pictures" را به صورت بازگشتی در فهرست مجاز قرار می‌دهد. هیچ چیزی خارج از این دو دایرکتوری کش نخواهد شد. و --cache-deny "*/secret" حالت فهرست سیاه را فعال کرده و هیچ چیزی را درون "/secret" یا زیردایرکتوری‌های آن کش نمی‌کند.

نویسنده اصلی (ORIGINAL AUTHOR)

Bert Muennich          <ber.t at posteo.de>

نگه‌دارندگان کنونی (CURRENT MAINTAINERS)

NRK                    <nrk at disroot.org>
Berke Kocaoğlu         <berke.kocaoglu at metu.edu.tr>
TAAPArthur             <taaparthur at gmail.com>
eylles                 <ed.ylles1997 at gmail.com>
Stein Gunnar Bakkeby   <bakkeby at gmail.com>
explosion-mental       <explosion0mental at gmail.com>

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

برای مشاهده فهرست مشارکت‌کنندگان، دستور `git shortlog -s` را در مخزن گیت nsxiv اجرا کنید.

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

وبگاه:: https://nsxiv.codeberg.page
کد منبع:: https://codeberg.org/nsxiv/nsxiv

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

X(7), xrdb(1)