'\" t .\" Title: imv .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 07/06/2026 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "IMV" "1" "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 \- نمایشگر تصویر برای X11 و ویلند .SH "توضیحات (DESCRIPTION)" .sp برنامه .B imv یک نمایشگر تصویر برای X11 و ویلند (Wayland) است که برای کاربران مدیر پنجره‌های کاشی‌کاری (tiling window managers) طراحی شده است\&. این برنامه از طیف گسترده‌ای از قالب‌های پرونده تصویر، از جمله پرونده‌های متحرک gif پشتیبانی می‌کند\&. چنانچه تصویر کنونی روی دیسک تغییر کند، .B imv به‌طور خودکار آن را دوباره بارگذاری خواهد کرد\&. .SH "خلاصه دستور (SYNOPSIS)" .sp \fBimv\fR [\fIگزینه‌ها\fR] [\fIمسیرها\fR\&...] .SH "گزینه‌ها (OPTIONS)" .PP \fB\-h\fR .RS 4 نمایش پیام راهنما و خروج\&. .RE .PP \fB\-v\fR .RS 4 نمایش نگارش و خروج\&. .RE .PP \fB\-b\fR .RS 4 رنگ پس‌زمینه را تنظیم می‌کند\&. این مقدار می‌تواند یک کد رنگی هگزادسیمال ۶ رقمی یا \fIchecks\fR برای نمایش یک پس‌زمینه شطرنجی باشد\&. .RE .PP \fB\-c\fR .RS 4 دستوری را برای اجرا هنگام راه‌اندازی، پس از بارگذاری پیکربندی مشخص می‌کند\&. این گزینه می‌تواند برای پیکربندی کلیدهای سفارشی با استفاده از دستور bind به کار رود\&. این گزینه می‌تواند چندین بار استفاده شود\&. دستورها به همان ترتیبی که به imv داده شده‌اند اجرا می‌شوند\&. .RE .PP \fB\-d\fR .RS 4 شروع به کار در حالتی که لایه رویی (overlay) قابل مشاهده است\&. .RE .PP \fB\-f\fR .RS 4 شروع به کار در حالت تمام‌صفحه\&. .RE .PP \fB\-i\fR .RS 4 تنظیم نام منبع X11 یا شناسه برنامه ویلند (wayland app id) پنجره ایجادشده\&. .RE .PP \fB\-l\fR .RS 4 فهرست کردن پرونده‌های باز در خروجی استاندارد (stdout) هنگام خروج\&. .RE .PP \fB\-n\fR .RS 4 شروع به کار با مسیر یا نمایه (اندیس) مشخص‌شده در حالت انتخاب\&. .RE .PP \fB\-r\fR .RS 4 بارگذاری بازگشتی دایرکتوری‌ها (پوشه‌ها)\&. .RE .PP \fB\-s\fR .RS 4 حالت مقیاس‌بندی مورد استفاده را تنظیم می‌کند\&. حالت \fInone\fR هر تصویر را در اندازه واقعی‌اش نشان می‌دهد\&. حالت \fIshrink\fR اندازه تصویر را کوچک می‌کند تا درون پنجره جا شود\&. حالت \fIfull\fR تصویر را بزرگ یا کوچک می‌کند تا کاملاً و به‌طور مناسب درون پنجره جا گیرد\&. حالت \fIcrop\fR تصویر را مقیاس‌بندی و برش می‌زند تا پنجره را پر کند\&. پیش‌فرض روی \fIfull\fR است\&. .RE .PP \fB\-t\fR .RS 4 شروع در حالت اسلایدشو، به‌طوری که هر تصویر برای تعداد ثانیه‌های مشخص‌شده نمایش داده می‌شود\&. .RE .PP \fB\-u\fR .RS 4 تنظیم روش بزرگ‌نمایی (upscaling) مورد استفاده توسط imv\&. .RE .PP \fB\-w\fR .RS 4 تنظیم عنوان پنجره هنگام شروع imv\&. .RE .PP \fB\-x\fR .RS 4 غیرفعال کردن چرخه (حلقه) مسیرهای ورودی\&. .RE .PP \fB\-W\fR .RS 4 عرض اولیه پنجره\&. .RE .PP \fB\-H\fR .RS 4 ارتفاع اولیه پنجره\&. .RE .SH "دستورها (COMMANDS)" .sp دستورها را می‌توان با فشردن کلید \fB:\fR وارد کرد\&. برنامه imv از دستورهای زیر پشتیبانی می‌کند: .PP \fBquit\fR .RS 4 خروج از imv\&. دارای نام مستعار \fIq\fR\&. .RE .PP \fBpan\fR .RS 4 جابه‌جایی نما (pan) به مقدارهای داده‌شده\&. .RE .PP \fBnext\fR .RS 4 حرکت به جلو به تعداد تصاویر داده‌شده\&. دارای نام مستعار \fIn\fR\&. .RE .PP \fBprev\fR .RS 4 حرکت به عقب به تعداد تصاویر داده‌شده\&. دارای نام مستعار \fIp\fR\&. .RE .PP \fBgoto\fR .RS 4 انتخاب یک تصویر با استفاده از نمایه (اندیس)\&. \fI1\fR نخستین تصویر است، \fI2\fR دومین تصویر و الی آخر\&. آخرین تصویر می‌تواند با نمایه \fI\-1\fR و تصویر یکی مانده به آخر با \fI\-2\fR مشخص شود\&. دارای نام مستعار \fIg\fR\&. .RE .PP \fBzoom\fR .RS 4 بزرگ‌نمایی روی تصویر به مقدار داده‌شده\&. مقادیر منفی باعث کوچک‌نمایی می‌شوند\&. مقدار \fIactual\fR بزرگ‌نمایی را به ۱۰۰٪ بازنشانی کرده و تصویر را در اندازه واقعی‌اش نشان می‌دهد\&. دارای نام مستعار \fIz\fR\&. .RE .PP \fBrotate\fR <\*(Aqto\*(Aq|\fIby\fR> .RS 4 چرخش تصویر در جهت عقربه‌های ساعت به/به‌اندازه مقدار داده‌شده بر حسب درجه\&. .RE .PP \fBflip\fR <\*(Aqhorizontal\*(Aq|\fIvertical\fR> .RS 4 وارونه‌سازی (قرینه‌سازی) افقی/عمودی تصویر (حول محور عمودی/افقی)\&. .RE .PP \fBopen\fR [\-r] .RS 4 افزودن مسیرهای داده‌شده به فهرست تصاویر باز\&. اگر گزینه \fI\-r\fR مشخص شده باشد، این کار به‌صورت بازگشتی انجام می‌شود\&. می‌توان از بسط‌های پوسته (shell expansions) نیز استفاده کرد\&. دارای نام مستعار \fIo\fR\&. .RE .PP \fBclose\fR [index|\fIall\fR] .RS 4 بستن تصویر انتخاب‌شده فعلی، یا تصویر در نمایه مشخص‌شده، یا تمام تصاویر\&. .RE .PP \fBfullscreen\fR .RS 4 تغییر وضعیت تمام‌صفحه (روشن/خاموش)\&. .RE .PP \fBoverlay\fR .RS 4 تغییر وضعیت نمایش لایه رویی (overlay)\&. .RE .PP \fBexec\fR .RS 4 اجرای یک دستور پوسته\&. برنامه imv متغیرهای محیطی گوناگونی را در اختیار دستور اجراشده قرار می‌دهد\&. این متغیرها در بخش \fIمتغیرهای محیطی (ENVIRONMENT VARIABLES)\fR شرح داده شده‌اند\&. .RE .PP \fBcenter\fR .RS 4 قرار دادن مجدد تصویر انتخاب‌شده در مرکز صفحه\&. .RE .PP \fBreset\fR .RS 4 بازنشانی نما، متمرکز کردن تصویر و استفاده از حالت مقیاس‌بندی فعلی برای تنظیم مجدد اندازه آن\&. .RE .PP \fBnext_frame\fR .RS 4 چنانچه یک فایل gif متحرک در حال نمایش باشد، فریم بعدی را بارگذاری می‌کند\&. .RE .PP \fBtoggle_playing\fR .RS 4 تغییر وضعیت پخش/توقف تصویر فعلی در صورتی که یک gif متحرک باشد\&. .RE .PP \fBscaling\fR .RS 4 تنظیم حالت مقیاس‌بندی فعلی\&. تنظیم حالت روی \fInext\fR آن را به حالت بعدی در فهرست می‌برد\&. .RE .PP \fBupscaling\fR .RS 4 تنظیم روش فعلی بزرگ‌نمایی (upscaling)\&. تنظیم روش روی \fInext\fR آن را به روش بعدی در فهرست پیش می‌برد\&. .RE .PP \fBslideshow\fR <+amount|\-amount|duration> .RS 4 افزایش یا کاهش مدت‌زمان اسلایدشو به مقدار داده‌شده بر حسب ثانیه، یا تنظیم مستقیم مدت‌زمان آن\&. دارای نام مستعار \fIss\fR\&. .RE .PP \fBbackground\fR .RS 4 تنظیم رنگ پس‌زمینه\&. مقدار \fIchecks\fR برای یک الگوی شطرنجی، یا تعیین یک کد رنگ هگزادسیمال ۶ رقمی\&. دارای نام مستعار \fIbg\fR\&. .RE .PP \fBbind\fR .RS 4 یک کنش را به مجموعه‌ای از ورودی‌های کلید پیوند می‌زند\&. از همان نحو فایل پیکربندی استفاده می‌کند، با این تفاوت که علامت مساوی بین کلیدها و دستورها قرار نمی‌گیرد\&. برای اطلاعات بیشتر درباره نحو، ببینید: \fBimv\fR(5)\&. .RE .SH "کلیدهای پیش‌فرض (DEFAULT BINDS)" .sp برنامه imv به‌طور پیش‌فرض همراه با چندین کلید پیکربندی‌شده عرضه می‌شود: .PP \fBq\fR .RS 4 خروج .RE .PP \fBLeft arrow,\fR .RS 4 تصویر قبلی .RE .PP \fBRight arrow\fR .RS 4 تصویر بعدی .RE .PP \fBgg\fR .RS 4 رفتن به نخستین تصویر .RE .PP \fBG\fR .RS 4 رفتن به آخرین تصویر .RE .PP \fBj\fR .RS 4 جابه‌جایی به پایین .RE .PP \fBk\fR .RS 4 جابه‌جایی به بالا .RE .PP \fBh\fR .RS 4 جابه‌جایی به چپ .RE .PP \fBl\fR .RS 4 جابه‌جایی به راست .RE .PP \fBx\fR .RS 4 بستن تصویر فعلی .RE .PP \fBf\fR .RS 4 تغییر وضعیت تمام‌صفحه .RE .PP \fBd\fR .RS 4 تغییر وضعیت لایه رویی (overlay) .RE .PP \fBp\fR .RS 4 چاپ تصویر فعلی در خروجی استاندارد (stdout) .RE .PP \fBUp arrow\fR .RS 4 بزرگ‌نمایی .RE .PP \fBDown arrow\fR .RS 4 کوچک‌نمایی .RE .PP \fBi\fR .RS 4 بزرگ‌نمایی .RE .PP \fBo\fR .RS 4 کوچک‌نمایی .RE .PP \fB+\fR .RS 4 بزرگ‌نمایی .RE .PP \fB\-\fR .RS 4 کوچک‌نمایی .RE .PP \fBCtrl+r\fR .RS 4 چرخش ۹۰ درجه در جهت عقربه‌های ساعت .RE .PP \fBc\fR .RS 4 وسط‌چین کردن تصویر .RE .PP \fBs\fR .RS 4 حالت مقیاس‌بندی بعدی .RE .PP \fBS\fR .RS 4 روش بزرگ‌نمایی (upscaling) بعدی .RE .PP \fBa\fR .RS 4 بزرگ‌نمایی به اندازه واقعی .RE .PP \fBr\fR .RS 4 بازنشانی بزرگ‌نمایی و جابه‌جایی .RE .PP \fB\&.\fR .RS 4 فریم بعدی (برای پویانمایی‌ها) .RE .PP \fBSpace\fR .RS 4 توقف/پخش پویانمایی‌ها .RE .PP \fBt\fR .RS 4 شروع اسلایدشو/افزایش تأخیر به میزان ۱ ثانیه .RE .PP \fBT\fR .RS 4 توقف اسلایدشو/کاهش تأخیر به میزان ۱ ثانیه .RE .SH "پیکربندی (CONFIGURATION)" .sp مسیر پرونده پیکربندی را می‌توان از طریق متغیر محیطی \fB$imv_config\fR مشخص کرد\&. در صورت پیدا نشدن، imv در مکان‌های زیر به دنبال آن خواهد گشت: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} $XDG_CONFIG_HOME/imv/config (توصیه‌شده) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} $HOME/\&.config/imv/config .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} $HOME/\&.imv_config .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} $HOME/\&.imv/config .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} /usr/local/etc/imv_config .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} /etc/imv_config .RE .sp یک پرونده پیکربندی پیش‌فرض به همراه imv در مسیر /etc/imv_config ارائه شده است\&. .sp برای مستندات قالب پرونده پیکربندی، ببینید: \fBimv\fR(5)\&. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .sp هنگامی که imv یک دستور پوسته را اجرا می‌کند، تعدادی متغیر محیطی در اختیار آن می‌گذارد که وضعیت imv را نشان می‌دهند\&. این متغیرهای محیطی هنگام سفارشی‌سازی عنوان پنجره یا متن لایه رویی (overlay) نیز در دسترس هستند\&. .PP \fB$imv_pid\fR .RS 4 شناسه فرآیند (PID) این نمونه از imv\&. برای اجرای imv\-msg در اسکریپت‌ها کاربرد دارد\&. .RE .PP \fB$imv_current_file\fR .RS 4 مسیر تصویر انتخاب‌شده فعلی\&. .RE .PP \fB$imv_scaling_mode\fR .RS 4 نام حالت مقیاس‌بندی فعلی\&. .RE .PP \fB$imv_loading\fR .RS 4 اگر یک تصویر جدید در حال بارگذاری باشد مقدار ۱، در غیر این صورت ۰\&. .RE .PP \fB$imv_current_index\fR .RS 4 نمایه (اندیس) تصویر فعلی، از ۱ تا N\&. .RE .PP \fB$imv_file_count\fR .RS 4 شمار کل پرونده‌ها\&. .RE .PP \fB$imv_width\fR .RS 4 عرض تصویر فعلی\&. .RE .PP \fB$imv_height\fR .RS 4 ارتفاع تصویر فعلی\&. .RE .PP \fB$imv_scale\fR .RS 4 مقیاس تصویر فعلی بر حسب درصد\&. .RE .PP \fB$imv_slideshow_duration\fR .RS 4 تعداد ثانیه‌هایی که هر تصویر نمایش داده می‌شود\&. .RE .PP \fB$imv_slideshow_elapsed\fR .RS 4 مدت‌زمانی که تصویر فعلی نمایش داده شده است\&. .RE .SH "ارتباط بین‌فرآیندی (IPC)" .sp برنامه imv می‌تواند دستورها را از فرآیندی دیگر از طریق سوکت یونیکس (unix socket) بپذیرد\&. هر نمونه از imv یک سوکت یونیکس با نام \fI$XDG_RUNTIME_DIR/imv\-$PID\&.sock\fR باز خواهد کرد\&. اگر متغیر $XDG_RUNTIME_DIR تعریف نشده باشد، سوکت در مسیر \fI/tmp/\fR قرار می‌گیرد\&. .sp ابزار \fBimv\-msg\fR(1) برای ساده‌سازی این کار از طریق اسکریپت‌های پوسته ارائه شده است\&. .SH "نویسندگان (AUTHORS)" .sp برنامه imv توسط Harry Jeffery نوشته شده و با مشارکت سایر توسعه‌دهندگان نگهداری می‌شود\&. .sp کد منبع کامل و اطلاعات بیشتر را می‌توان در نشانی https://sr\&.ht/~exec64/imv یافت\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBimv\fR(5) \fBimv\-msg\fR(1) \fBimv\-dir\fR(1)