'\" t
.\"     Title: imv
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/06/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "IMV" "5" "07/06/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
imv \- پیکربندی نمایشگر تصویر imv
.SH "توضیحات (DESCRIPTION)"
.sp
می‌توان imv را با این فایل پیکربندی سفارشی‌سازی کرد و رفتار پیش‌فرض، کلیدهای میانبر و ظاهر آن را تغییر داد\&.
.sp
فایل پیکربندی imv یک فایل به سبک ini است، شامل چندین تنظیم \fIkey = value\fR که به چند \*(Aq[section]\*(Aq تفکیک شده است\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
بخش \fB[options]\fR تنظیمات زیر را می‌پذیرد:
.PP
\fBbackground\fR = <hex\-code|\fIchecks\fR>
.RS 4
تنظیم پس‌زمینه در imv\&. می‌تواند یک کد رنگی هگزادسیمال ۶ رقمی باشد، یا
\fIchecks\fR
برای یک پس‌زمینه شطرنجی\&. مقدار پیش‌فرض:
\fI000000\fR
.RE
.PP
\fBfullscreen\fR = <true|false>
.RS 4
اجرای imv به‌صورت تمام‌صفحه\&. مقدار پیش‌فرض:
\fIfalse\fR\&.
.RE
.PP
\fBwidth\fR = <width>
.RS 4
عرض اولیه پنجره imv\&. مقدار پیش‌فرض: 1280\&.
.RE
.PP
\fBheight\fR = <height>
.RS 4
ارتفاع اولیه پنجره imv\&. مقدار پیش‌فرض: 720\&.
.RE
.PP
\fBinitial_pan\fR = <pan_factor_x> <pan_factor_y>
.RS 4
ضریب موقعیت اولیه حرکت (pan) / فوکوس تصاویر باز شده\&. مقدار ۵۰ نشان‌دهنده نقطه میانی تصویر (۵۰٪) است\&. مقدار پیش‌فرض:
\fI50 50\fR
.RE
.PP
\fBlist_files_at_exit\fR = <true|false>
.RS 4
چاپ فایل‌های باز روی خروجی استاندارد (stdout) هنگام خروج، هر کدام در یک خط جداگانه\&. مقدار پیش‌فرض:
\fIfalse\fR\&.
.RE
.PP
\fBloop_input\fR = <true|false>
.RS 4
بازگشت به اولین تصویر پس از مشاهده آخرین تصویر\&. مقدار پیش‌فرض:
\fItrue\fR\&.
.RE
.PP
\fBoverlay\fR = <true|false>
.RS 4
شروع برنامه در حالی که لایه همپوشان (overlay) نمایان است\&. مقدار پیش‌فرض:
\fIfalse\fR\&.
.RE
.PP
\fBoverlay_font\fR = <typeface:size>
.RS 4
استفاده از قلم مشخص‌شده در همپوشان (overlay)\&. مقدار پیش‌فرض:
\fIMonospace:24\fR\&.
.RE
.PP
\fBoverlay_text\fR = <text>
.RS 4
استفاده از متن ارائه‌شده به عنوان متن لایه همپوشان (overlay)\&. متن داده‌شده در شل بسط می‌یابد، بنابراین می‌توان از خروجی دستورات استفاده کرد (برای مثال،
\fI$(ls)\fR)\&.
همچنین می‌توان از متغیرهای محیطی استفاده نمود، از جمله متغیرهای در دسترس برای دستور
\fIexec\fR
در imv\&.
.RE
.PP
\fBoverlay_text_color\fR = <hex\-code>
.RS 4
تنظیم رنگ متن در لایه همپوشان\&. یک کد رنگی هگزادسیمال ۶ رقمی است\&. مقدار پیش‌فرض:
\fIffffff\fR\&.
.RE
.PP
\fBoverlay_text_alpha\fR = <hex\-code>
.RS 4
تنظیم میزان شفافیت (alpha) برای متن در لایه همپوشان\&. یک کد هگزادسیمال ۲ رقمی است\&. مقدار پیش‌فرض:
\fIff\fR\&.
.RE
.PP
\fBoverlay_background_color\fR = <hex\-code>
.RS 4
تنظیم رنگ پس‌زمینه لایه همپوشان\&. یک کد رنگی هگزادسیمال ۶ رقمی است\&. مقدار پیش‌فرض:
\fI000000\fR\&.
.RE
.PP
\fBoverlay_background_alpha\fR = <hex\-code>
.RS 4
تنظیم میزان شفافیت (alpha) برای پس‌زمینه لایه همپوشان\&. یک کد هگزادسیمال ۲ رقمی است\&. مقدار پیش‌فرض:
\fIc3\fR\&.
.RE
.PP
\fBoverlay_position_bottom\fR = <true|false>
.RS 4
نمایش لایه همپوشان در پایین پنجره imv، به جای بالای آن\&.
.RE
.PP
\fBrecursively\fR = <true|false>
.RS 4
بارگذاری بازگشتی مسیرهای ورودی\&. مقدار پیش‌فرض:
\fIfalse\fR\&.
.RE
.PP
\fBscaling_mode\fR = <none|shrink|full|crop>
.RS 4
تنظیم حالت مقیاس‌بندی مورد استفاده\&.
\fInone\fR
هر تصویر را در اندازه واقعی‌اش نمایش می‌دهد\&.
\fIshrink\fR
تصویر را کوچک می‌کند تا درون پنجره جا شود\&.
\fIfull\fR
تصویر را بزرگ و کوچک می‌کند تا کاملاً درون پنجره جا گیرد\&.
\fIcrop\fR
تصویر را برای پر کردن پنجره، مقیاس‌بندی کرده و برش می‌زند\&. مقدار پیش‌فرض:
\fIfull\fR\&.
.RE
.PP
\fBslideshow_duration\fR = <duration>
.RS 4
اجرای imv در حالت اسلایدشو، و تنظیم مدت‌زمان نمایش هر تصویر بر حسب ثانیه\&. مقدار پیش‌فرض:
\fI0\fR،
یعنی بدون اسلایدشو\&.
.RE
.PP
\fBsuppress_default_binds\fR = <true|false>
.RS 4
غیرفعال کردن کلیدهای میانبر پیش‌ساخته imv تا با کلیدهای میانبر سفارشی تداخل نداشته باشند\&. مقدار پیش‌فرض:
\fIfalse\fR\&.
.RE
.PP
\fBtitle_text\fR = <text>
.RS 4
استفاده از متن ارائه‌شده به عنوان عنوان پنجره\&. متن ارائه‌شده در شل بسط می‌یابد، بنابراین می‌توان از خروجی دستورات استفاده کرد:
\fI$(ls)\fR
همچنین می‌توان از متغیرهای محیطی، از جمله متغیرهای در دسترس دستور
\fIexec\fR
در imv استفاده کرد\&.
.RE
.PP
\fBupscaling_method\fR = <linear|nearest_neighbour>
.RS 4
استفاده از روش مشخص‌شده برای بزرگ‌نمایی تصاویر\&. مقدار پیش‌فرض:
\fIlinear\fR\&.
.RE
.SH "نام‌های مستعار (ALIASES)"
.sp
بخش \fB[aliases]\fR اجازه می‌دهد تا نام‌های مستعار برای دستورات داخلی imv افزوده شوند\&. برای مثال، \fIx = close\fR یک دستور \fIx\fR اضافه می‌کند که به سادگی دستور \fIclose\fR را اجرا می‌کند\&. هر شناسه‌ای که به یک نام مستعار داده شود به انتهای دستوری که توسط آن نام مستعار پیکربندی شده اضافه می‌شود\&.
.SH "کلیدهای میانبر (BINDS)"
.sp
بخش \fB[binds]\fR اجازه می‌دهد تا کلیدهای میانبر سفارشی به imv اضافه شوند\&.
.sp
کلیدهای میانبر در قالب \fIترکیب کلید = دستور\fR هستند\&. یک ترکیب کلید می‌تواند شامل فشردن چندین کلید متوالی باشد\&. می‌توان چندین دستور را برای یک ترکیب کلید با جدا کردن هر دستور به وسیله \fI;\fR تعریف کرد\&. کوتیشن‌های تکی و دوتایی و همچنین اسکیپ با بک‌اسلش برای نقل‌قول صحیح دستورات شل پشتیبانی می‌شوند\&.
.sp
کلیدهای تکی مانند \fIq\fR دقیقاً همان هستند: \fIq = quit\fR کلید \fIq\fR را به دستور \fIquit\fR متصل می‌کند\&.
.sp
کلیدهای تغییردهنده (modifier) را می‌توان با پیشوند کردن آن‌ها مشخص کرد: \fICtrl+q\fR، \fIMeta+f\fR، \fIShift+G\fR\&. در صورتی که چند کلید تغییردهنده مورد نظر باشد، به ترتیب \fICtrl+Meta+Shift\fR مشخص می‌شوند\&. زمانی که نام کلید بیش از یک نویسه است، یا از یک کلید تغییردهنده استفاده می‌شود، باید در \fI<\fR و \fI>\fR محصور گردد، برای مثال: \fI<Ctrl+q>\fR\&.
.sp
چندین کلید متوالی را می‌توان با فهرست کردن آنها به ترتیب مشخص کرد: \fIgg = goto 1\fR دو بار فشردن کلید \fIg\fR را به پرش به اولین تصویر متصل می‌کند، و \fI<Ctrl+a>p = exec echo hi\fR توالی کلیدهای \fICtrl+a\fR و به دنبال آن \fIp\fR را به اجرای دستور شل \fIecho hi\fR متصل می‌کند\&.
.sp
بسیاری از کلیدها مانند \fI<\fR و \fI>\fR نام‌های ویژه‌ای دارند\&. در X11، این نام‌ها به آسانی با دستور xev(1) پیدا می‌شوند\&. برای مثال، \fI!\fR با نام \fIexclam\fR، کلید \fI<\fR با نام \fIless\fR، و \fI>\fR با نام \fIgreater\fR نامیده می‌شود\&.
.sp
فهرست کاملی از keysymها در اغلب سیستم‌ها با دستور \fIdumpkeys \-l\fR نیز قابل مشاهده است\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBimv\fR(1)