.TH NSXIV 1 nsxiv\-34 .SH "نام (NAME)" nsxiv \- نمایش‌دهنده ساده تصویر برای سامانه پنجره X (نسخه نئو) .SH "خلاصه دستور (SYNOPSIS)" .B nsxiv .RB [ \-abcfHhiopqrtvZ0 ] .RB [ \-A .IR FRAMERATE ] .RB [ \-e .IR WID ] .RB [ \-G .IR GAMMA ] .RB [ \-g .IR GEOMETRY ] .RB [ \-N .IR NAME ] .RB [ \-n .IR NUM ] .RB [ \-S .IR DELAY ] .RB [ \-s .IR MODE ] .RB [ \-z .IR ZOOM ] .IR FILE ... .SH "توضیحات (DESCRIPTION)" دستور .B nsxiv یک نمایش‌دهنده ساده تصویر برای سامانه پنجره X است. .P این برنامه دارای دو حالت کاری است: حالت تصویر (image) و حالت بندانگشتی (thumbnail). حالت پیش‌فرض، حالت تصویر است که در آن فقط تصویر جاری نشان داده می‌شود. در حالت بندانگشتی، شبکه‌ای از پیش‌نمایش‌های کوچک نمایش داده می‌شود که انتخاب تصویر برای باز کردن را آسان می‌کند. .P لطفاً توجه داشته باشید که حالت تمام‌صفحه به یک مدیر پنجره سازگار با EWMH/NetWM نیاز دارد. .SH "گزینه‌ها (OPTIONS)" .TP .BI "\-A, \-\-framerate " FRAMERATE پخش پویانمایی‌ها با نرخ فریم ثابت تعیین‌شده توسط .IR FRAMERATE . اگر .I FRAMERATE برابر با 0 تنظیم شود، پخش پویانمایی غیرفعال می‌شود. .TP .B "\-a, \-\-animate" پخش پویانمایی تصاویر چندفریمی. .TP .B "\-b" عدم نمایش نوار وضعیت. .TP .B "\-\-bar, \-\-no\-bar" فعال یا غیرفعال کردن نوار وضعیت. .B "\-\-no\-bar" معادل .B "\-b" است. .TP .B "\-c, \-\-clean\-cache" حذف تمام فایل‌های کش یتیم از دایرکتوری کش تصاویر بندانگشتی و خروج. .TP .BI "\-e, \-\-embed " WID جاسازی پنجره nsxiv در پنجره‌ای با شناسه .IR WID . .TP .B "\-f, \-\-fullscreen" شروع در حالت تمام‌صفحه. .TP .BI "\-G, \-\-gamma " GAMMA تنظیم گامای تصویر روی GAMMA (\-32..32). .TP .BI "\-g, \-\-geometry " GEOMETRY تنظیم موقعیت و اندازه پنجره. برای اطلاعات بیشتر درباره آرگومان GEOMETRY، بخش GEOMETRY SPECIFICATIONS در .BR X (7) را ببینید. .TP .BR "\-H, \-\-hidden" [=no] شامل کردن فایل‌ها و دایرکتوری‌های پنهان. گزینه طولانی می‌تواند برای غیرفعال‌سازی مقدار اختیاری "no" را بپذیرد. .TP .B "\-h, \-\-help" چاپ اطلاعات خلاصه نحوه استفاده در خروجی استاندارد و خروج. .TP .B "\-i, \-\-stdin" خواندن نام فایل‌ها برای باز شدن از ورودی استاندارد. همچنین اگر FILE برابر با `\-' باشد انجام می‌شود. .TP .BI "\-N, \-\-name " NAME تنظیم نام پنجره (یعنی نام "Instance" در WM_CLASS همان‌طور که در ICCCM توضیح داده شده است) به NAME. .TP .BI "\-n, \-\-start\-at " NUM شروع از تصویر شماره NUM. .TP .B "\-o, \-\-stdout" نوشتن فهرست تمام فایل‌های نشانه‌گذاری‌شده در خروجی استاندارد هنگام خروج. در ترکیب با .B "\-i, \-\-stdin" می‌توان از nsxiv به عنوان یک فیلتر/پایپ بصری استفاده کرد. .TP .B "\-p, \-\-private" فعال‌سازی حالت خصوصی، که در آن nsxiv هیچ فایل کش یا موقتی نمی‌نویسد. .TP .B "\-q, \-\-quiet" حالت بی‌صدا و غیرفعال کردن هشدارها به جریان خطای استاندارد. .TP .B "\-r, \-\-recursive" جستجوی بازگشتی در دایرکتوری‌های داده‌شده برای یافتن تصاویر جهت نمایش. .TP .BI "\-S, \-\-ss\-delay " DELAY شروع در حالت اسلایدشو. تنظیم تاخیر بین تصاویر بر حسب .I DELAY ثانیه. .I DELAY می‌تواند یک عدد ممیز شناور باشد. .TP .BI "\-s, \-\-scale\-mode " MODE تنظیم حالت مقیاس بر اساس نویسه MODE. حالت‌های پشتیبانی‌شده عبارتند از: [d]own، [f]it، [F]ill، [w]idth، [h]eight. .TP .BR "\-t, \-\-thumbnail" [=no] شروع در حالت بندانگشتی. گزینه طولانی یک "no" اختیاری برای غیرفعال کردن آن می‌پذیرد. .TP .B "\-v, \-\-version" چاپ اطلاعات نسخه در خروجی استاندارد و خروج. .TP .B "\-Z, \-\-zoom\-100" همانند `\-z 100'. .TP .BI "\-z, \-\-zoom " ZOOM تنظیم سطح زوم به ZOOM درصد. .TP .B "\-0, \-\-null" استفاده از جداکننده NULL. با این گزینه، خروجی \-o و فهرست فایل‌های ارسالی به گرداننده کلید و ورودی \-i با نویسه NULL جدا می‌شوند. .TP .BI "\-\-anti\-alias" [=no] فعال کردن هموارسازی لبه‌ها (anti-aliasing)؛ در صورت دادن .I no به عنوان آرگومان، آن را غیرفعال می‌کند. .TP .BI "\-\-alpha\-layer" [=no] فعال کردن پس‌زمینه شطرنجی برای لایه آلفا؛ در صورت دادن .I no به عنوان آرگومان، آن را غیرفعال می‌کند. .TP .B "\-\-assume\-files" صرف‌نظر کردن از پیمایش دایرکتوری، برای مواقعی که مشخص است فهرست فقط حاوی فایل‌ها است. این کار از برخی عملیات دیسک اولیه جلوگیری کرده و زمان بالا آمدن را در دیسک‌های کند کاهش می‌دهد. .TP .BI "\-\-cache\-allow, \-\-cache\-deny " "CACHE\-PATHS" فهرست دایرکتوری‌ها جهت قرارگیری در فهرست مجاز (whitelist) یا فهرست سیاه (blacklist) برای کش تصاویر بندانگشتی. بخش .I "کش کردن تصاویر بندانگشتی (THUMBNAIL CACHING)" را برای اطلاعات بیشتر درباره فرمت آرگومان ببینید. این گزینه‌ها مانعة‌الجمع هستند؛ اگر بیش از یک بار مشخص شوند، تنها آخرین مورد اعمال می‌شود. .TP .BI "\-\-update\-cache" به‌روزرسانی کش تصاویر بندانگشتی (و ایجاد آن‌ها در صورت نیاز) برای آرگومان‌های داده‌شده و خروج. می‌تواند به همراه .B "\-\-clean\-cache" استفاده شود. .SH "دستورات صفحه‌کلید (KEYBOARD COMMANDS)" .SS "عمومی (General)" دستورات صفحه‌کلید زیر در هر دو حالت تصویر و بندانگشتی در دسترس هستند: .TP .BR 0 \- 9 پیشوند کردن دستور بعدی با یک عدد (مشخص‌شده با .IR count ). .TP .B q خروج از nsxiv. .TP .B Q خروج از nsxiv، ولی در عین حال چاپ نام فایل جاری در صورت فعال بودن \-o و نشانه‌گذاری نشدن هیچ فایلی. .TP .B Return جابه‌جایی به حالت بندانگشتی / باز کردن تصویر انتخاب‌شده در حالت تصویر. .TP .B f تغییر وضعیت حالت تمام‌صفحه. .TP .B b تغییر وضعیت نمایش نوار وضعیت در پایین پنجره. .TP .B Ctrl-x ارسال کلید بعدی به گرداننده کلید خارجی. برای اطلاعات بیشتر بخش گرداننده کلید خارجی (EXTERNAL KEY HANDLER) را ببینید. .TP .B g رفتن به اولین تصویر. .TP .B G رفتن به آخرین تصویر، یا تصویر شماره .IR count . .TP .B r بارگذاری مجدد تصویر. .TP .B D حذف تصویر جاری از فهرست فایل‌ها و رفتن به تصویر بعدی. .TP .BR Ctrl-h ", " Ctrl-Left پیمایش به اندازه یک پهنای صفحه به چپ. .TP .BR Ctrl-j ", " Ctrl-Down پیمایش به اندازه یک ارتفاع صفحه به پایین. .TP .BR Ctrl-k ", " Ctrl-Up پیمایش به اندازه یک ارتفاع صفحه به بالا. .TP .BR Ctrl-l ", " Ctrl-Right پیمایش به اندازه یک پهنای صفحه به راست. .TP .BR + بزرگ‌نمایی (Zoom in). .TP .B \- کوچک‌نمایی (Zoom out). .TP .B m نشانه‌گذاری یا حذف نشانه‌گذاری تصویر جاری. .TP .B M نشانه‌گذاری یا حذف نشانه‌گذاری تمام تصاویر از آخرین تصویر نشانه‌گذاری‌شده/نشده تا تصویر جاری. .TP .B Ctrl-m معکوس کردن تمام نشانه‌های تصاویر. .TP .B Ctrl-u حذف تمام نشانه‌های تصاویر. .TP .B N رفتن به اندازه .I count تصویر نشانه‌گذاری‌شده به جلو. .TP .B P رفتن به اندازه .I count تصویر نشانه‌گذاری‌شده به عقب. .TP .B { کاهش تصحیح گاما به اندازه .I count گام. .TP .B } افزایش تصحیح گاما به اندازه .I count گام. .TP .B Ctrl-g بازنشانی تصحیح گاما به حالت اولیه. .TP .B Ctrl-[ کاهش تصحیح روشنایی به اندازه .I count گام. .TP .B Ctrl-] افزایش تصحیح روشنایی به اندازه .I count گام. .TP .B ( کاهش کنتراست به اندازه .I count گام. .TP .B ) افزایش کنتراست به اندازه .I count گام. .SS "حالت بندانگشتی (Thumbnail mode)" دستورات صفحه‌کلید زیر فقط در حالت بندانگشتی در دسترس هستند: .TP .BR h ", " Left انتقال انتخاب به اندازه .I count بار به چپ. .TP .BR j ", " Down انتقال انتخاب به اندازه .I count بار به پایین. .TP .BR k ", " Up انتقال انتخاب به اندازه .I count بار به بالا. .TP .BR l ", " Right انتقال انتخاب به اندازه .I count بار به راست. .TP .B R بارگذاری مجدد تمام تصاویر بندانگشتی. .SS "حالت تصویر (Image mode)" دستورات صفحه‌کلید زیر فقط در حالت تصویر در دسترس هستند: .TP پیمایش در فهرست تصاویر: .TP .BR n ", " Space رفتن به اندازه .I count تصویر به جلو. .TP .BR p ", " Backspace رفتن به اندازه .I count تصویر به عقب. .TP .B [ رفتن به اندازه .I count ضرب‌در 10 تصویر به عقب. .TP .B ] رفتن به اندازه .I count ضرب‌در 10 تصویر به جلو. .TP .B Ctrl-6 رفتن به تصویری که قبلاً مشاهده شده بود. .TP مدیریت تصاویر چندفریمی: .TP .B Ctrl-n رفتن به اندازه .I count فریم از تصویر چندفریمی به جلو. .TP .B Ctrl-p رفتن به اندازه .I count فریم از تصویر چندفریمی به عقب. .TP .BR Ctrl-a ", " Ctrl-Space پخش/توقف پویانمایی تصاویر چندفریمی. .TP جا‌به‌جایی در تصویر (Panning): .TP .BR h ", " Left پیمایش تصویر به اندازه یک‌پنجم پهنای پنجره یا .I count پیکسل به چپ. .TP .BR j ", " Down پیمایش تصویر به اندازه یک‌پنجم ارتفاع پنجره یا .I count پیکسل به پایین. .TP .BR k ", " Up پیمایش تصویر به اندازه یک‌پنجم ارتفاع پنجره یا .I count پیکسل به بالا. .TP .BR l ", " Right پیمایش تصویر به اندازه یک‌پنجم پهنای پنجره یا .I count پیکسل به راست. .TP .B H پیمایش به لبه چپ تصویر. .TP .B J پیمایش به لبه پایین تصویر. .TP .B K پیمایش به لبه بالای تصویر. .TP .B L پیمایش به لبه راست تصویر. .TP .B z پیمایش به مرکز تصویر. .TP بزرگ‌نمایی (Zooming): .TP .B = تنظیم سطح زوم روی 100% یا .IR count %. .TP .B w تنظیم سطح زوم روی 100%، اما برازش تصاویر بزرگ در پنجره. .TP .B W برازش تصویر درون پنجره. .TP .B F پر کردن پنجره با تصویر. .TP .B e برازش تصویر با عرض پنجره. .TP .B E برازش تصویر با ارتفاع پنجره. .TP چرخش (Rotation): .TP .B < چرخش 90 درجه‌ای تصویر در جهت پادساعت‌گرد. .TP .B > چرخش 90 درجه‌ای تصویر در جهت ساعت‌گرد. .TP .B ? چرخش 180 درجه‌ای تصویر. .TP وارون‌سازی (Flipping): .TP .B | وارون‌سازی افقی تصویر. .TP .B _ وارون‌سازی عمودی تصویر. .TP متفرقه: .TP .B a تغییر وضعیت هموارسازی لبه‌ها (anti-aliasing). .TP .B A تغییر وضعیت نمایش کانال آلفا، یعنی شفافیت تصویر. .TP .B s تغییر وضعیت حالت اسلایدشو و/یا تنظیم تاخیر بین تصاویر روی .I count ثانیه. .SH "دستورات ماوس (MOUSE COMMANDS)" .SS "حالت بندانگشتی (Thumbnail mode)" نگاشت‌های ماوس زیر در حالت بندانگشتی در دسترس هستند: .TP .B Button1 انتخاب تصویر. در صورت دوبار کلیک وارد حالت تصویر می‌شود. .TP .B Button3 نشانه‌گذاری یا لغو نشانه‌گذاری تصویر. کشیدن هم‌زمان با نگه داشتن دکمه Button3 باعث نشانه‌گذاری یا لغو نشانه‌گذاری چندین تصویر می‌شود. .TP .B Button4 پیمایش به بالا به اندازه یک ردیف. .TP .B Button5 پیمایش به پایین به اندازه یک ردیف. .TP .B Ctrl-Button4 پیمایش به بالا به اندازه یک صفحه. .TP .B Ctrl-Button5 پیمایش به پایین به اندازه یک صفحه. .SS "حالت تصویر (Image mode)" نگاشت‌های ماوس زیر در حالت تصویر در دسترس هستند: .TP .B Button1 رفتن به تصویر بعدی اگر مکان‌نمای ماوس در سمت راست پنجره باشد، یا تصویر قبلی اگر در سمت چپ باشد. .TP .B Ctrl-Button1 جابه‌جایی تصویر نسبت به مکان‌نمای ماوس. .TP .B Button2 جابه‌جایی تصویر بر اساس موقعیت مکان‌نمای ماوس در پنجره، در حالی که این دکمه پایین نگه داشته شده است. .TP .B Button3 جابه‌جایی به حالت بندانگشتی. .TP .B Button4 بزرگ‌نمایی (Zoom in). .TP .B Button5 کوچک‌نمایی (Zoom out). .SH "پیکربندی (CONFIGURATION)" منابع X زیر تحت "Nsxiv" پشتیبانی می‌شوند (مانند .B Nsxiv.bar.font ): .TP .B window.background رنگ پس‌زمینه پنجره .TP .B window.foreground رنگ متن و پیش‌زمینه پنجره .TP .B bar.font نام فونت Xft برای نوار وضعیت .TP .B bar.background رنگ پس‌زمینه نوار وضعیت. پیش‌فرض window.background است .TP .B bar.foreground رنگ پیش‌زمینه نوار وضعیت. پیش‌فرض window.foreground است .TP .B mark.foreground رنگ پیش‌زمینه نشانه‌گذاری. پیش‌فرض window.foreground است .TP لطفاً برای چگونگی تغییر آن‌ها به .BR xrdb (1) مراجعه کنید. .LP یک ورودی منبع X با مقدار خالی به این معناست که مقدار پیش‌فرض (تعریف‌شده در config.h) استفاده خواهد شد. .SH "عنوان پنجره (WINDOW TITLE)" عنوان پنجره می‌تواند با خروجی اسکریپت ارائه‌شده توسط کاربر جایگزین شود؛ این اسکریپت هر زمان که هر یک از اطلاعات مربوطه تغییر کند، توسط nsxiv فراخوانی می‌شود. مسیر این اسکریپت .I $XDG_CONFIG_HOME/nsxiv/exec/win-title است و آرگومان‌های ارائه‌شده به آن (که در آن‌ها آرگومان‌های اختیاری ممکن است خالی باشند) عبارتند از: .IP $1 4 مسیر مطلق حل‌شده فایل جاری .IP $2 4 شماره فایل جاری .IP $3 4 تعداد کل فایل‌ها .IP $4 4 عرض تصویر (اختیاری: در حالت بندانگشتی غیرفعال است) .IP $5 4 ارتفاع تصویر (اختیاری: در حالت بندانگشتی غیرفعال است) .IP $6 4 زوم جاری (اختیاری: در حالت بندانگشتی غیرفعال است) .P به جای تصویر از اصطلاح فایل استفاده می‌شود، زیرا nsxiv از قبل معتبر بودن فایل‌های ورودی به عنوان تصویر را بررسی نمی‌کند. تعداد کل فایل‌ها ممکن است با تعداد واقعی تصاویر معتبر متفاوت باشد. .P همچنین یک اسکریپت نمونه همراه با nsxiv به صورت .IR /usr/share/doc/nsxiv/examples/win-title نصب شده است. .SH "نوار وضعیت (STATUS BAR)" اطلاعات نمایش‌داده‌شده در سمت چپ نوار وضعیت می‌تواند با خروجی اسکریپت ارائه‌شده توسط کاربر جایگزین شود. .P اسکریپتی که هنگام بارگذاری یک تصویر توسط nsxiv فراخوانی می‌شود در مسیر زیر قرار دارد: .I $XDG_CONFIG_HOME/nsxiv/exec/image-info و آرگومان‌های داده‌شده به آن عبارتند از: .IP $1 4 مسیر فایل تصویر (همان‌گونه که توسط کاربر ارائه شده است) .IP $2 4 عرض تصویر .IP $3 4 ارتفاع تصویر .IP $4 4 مسیر کاملاً حل‌شده به فایل تصویر .P در حالت بندانگشتی، اسکریپتی که فراخوانی می‌شود در مسیر زیر قرار دارد: .I $XDG_CONFIG_HOME/nsxiv/exec/thumb-info و آرگومان‌های داده‌شده به آن عبارتند از: .IP $1 4 مسیر فایل تصویر (همان‌گونه که توسط کاربر ارائه شده است) .IP $2 4 خالی .IP $3 4 خالی .IP $4 4 مسیر کاملاً حل‌شده به فایل تصویر .P همچنین اسکریپت‌های نمونه‌ای همراه با nsxiv در مسیرهای .IR /usr/share/doc/nsxiv/examples/image-info و .IR /usr/share/doc/nsxiv/examples/thumb-info نصب شده‌اند. .SH "گرداننده کلید خارجی (EXTERNAL KEY HANDLER)" دستورات صفحه‌کلید خارجی تکمیلی را می‌توان با استفاده از یک برنامه گرداننده واقع در .IR $XDG_CONFIG_HOME/nsxiv/exec/key-handler تعریف کرد. این گرداننده با فشردن .BR Ctrl-x فراخوانی می‌شود. ترکیب کلید بعدی به عنوان اولین آرگومان به آن داده می‌شود. تصاویری که باید روی آن‌ها عمل شود از طریق ورودی استاندارد ارسال می‌شوند: تمام تصاویر نشانه‌گذاری‌شده در صورتی که در حالت بندانگشتی دست‌کم یک تصویر نشانه‌گذاری شده باشد، و در غیر این صورت تصویر جاری. دستور .BR nsxiv (1) تا زمان خاتمه گرداننده مسدود خواهد ماند. سپس بررسی می‌کند که کدام تصاویر تغییر یافته‌اند و آن‌ها را دوباره بارگذاری می‌کند. به طور پیش‌فرض .BR nsxiv (1) یک تصویر در هر خط به ورودی استاندارد ارسال می‌کند، اما هنگام استفاده از .B \-0 فهرست تصاویر با NULL جدا خواهد شد و متغیر محیطی .B "$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 به صورت .IR /usr/share/doc/nsxiv/examples/key-handler نصب شده است. .SH "کش کردن تصاویر بندانگشتی (THUMBNAIL CACHING)" برنامه nsxiv تمام تصاویر بندانگشتی را تحت .IR $XDG_CACHE_HOME/nsxiv/ ذخیره می‌کند. .P از گزینه خط فرمان .I \-c برای حذف تمام فایل‌های کش یتیم استفاده کنید. افزون بر این، دستور زیر را پس از آن در دایرکتوری کش اجرا کنید تا زیردایرکتوری‌های خالی حذف شوند: .P .RS find . \-depth \-type d \-empty ! \-name '.' \-exec rmdir {} \\; .RE .P گزینه .BR "\-\-cache\-allow " یا " \-\-cache\-deny" ممکن است برای قرار دادن دایرکتوری‌های خاصی در فهرست مجاز یا سیاه جهت کش نشدن استفاده شود. آرگومان فهرستی از مسیرها است که با .B : جدا شده‌اند. وجود یک .B * در ابتدای مسیر نشان می‌دهد که آن مسیر باید به صورت بازگشتی مطابقت داده شود. .P برای مثال: .B \-\-cache\-allow \(dq/user/pictures:*/media/pictures\(dq دایرکتوری \(dq/user/pictures\(dq را به صورت غیربازگشتی و دایرکتوری \(dq/media/pictures\(dq را به صورت بازگشتی در فهرست مجاز قرار می‌دهد. هیچ چیزی خارج از این دو دایرکتوری کش نخواهد شد. و .B \-\-cache\-deny \(dq*/secret\(dq حالت فهرست سیاه را فعال کرده و هیچ چیزی را درون \(dq/secret\(dq یا زیردایرکتوری‌های آن کش نمی‌کند. .SH "نویسنده اصلی (ORIGINAL AUTHOR)" .EX Bert Muennich .EE .SH "نگه‌دارندگان کنونی (CURRENT MAINTAINERS)" .EX NRK Berke Kocaoğlu TAAPArthur eylles Stein Gunnar Bakkeby explosion-mental .EE .SH "مشارکت‌کنندگان (CONTRIBUTORS)" .EX برای مشاهده فهرست مشارکت‌کنندگان، دستور `git shortlog -s` را در مخزن گیت nsxiv اجرا کنید. .EE .SH "صفحه خانگی (HOMEPAGE)" .TP وبگاه: https://nsxiv.codeberg.page .TP کد منبع: https://codeberg.org/nsxiv/nsxiv .SH "همچنین ببینید (SEE ALSO)" .BR X (7), .BR xrdb (1)