.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "kitten-icat" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-icat \- نمایش تصاویر در ترمینال .SH "نمای کلی (OVERVIEW)" .sp \fIنمایش تصاویر در ترمینال\fP .sp کیتن \fBicat\fP می‌تواند برای نمایش تصاویر دلخواه در ترمینال \fIkitty\fP استفاده شود. نحوه استفاده از آن بسیار ساده است: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten icat image.jpeg .EE .UNINDENT .UNINDENT .sp این ابزار از تمام انواع تصاویری که توسط ImageMagick \%\& پشتیبانی می‌شوند، پشتیبانی می‌کند. حتی از طریق SSH نیز کار می‌کند. برای جزئیات، به پروتکل گرافیکی kitty در \%<>\& مراجعه کنید. .sp ممکن است بخواهید یک نام مستعار (alias) در فایل‌های پیکربندی پوسته خود ایجاد کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX alias icat=\(dqkitten icat\(dq .EE .UNINDENT .UNINDENT .sp سپس می‌توانید به سادگی با استفاده از \fBicat image.png\fP تصاویر را مشاهده کنید. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای پشتیبانی از تمام انواع فرمت‌های تصویر، ImageMagick \% باید نصب شده باشد. بدون آن، تنها فرمت‌های PNG/JPG/GIF/BMP/TIFF/WEBP پشتیبانی می‌شوند. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 پروتکل نمایش تصویر kitty ممکن است هنگام استفاده درون یک تسهیم‌کننده ترمینال (multiplexer) مانند \fBscreen\fP یا \fBtmux\fP، بسته به اینکه آن تسهیم‌کننده از این پروتکل پشتیبانی می‌کند یا خیر، کار نکند. .UNINDENT .UNINDENT .sp کیتن \fBicat\fP دارای آرگومان‌های خط فرمان گوناگونی است که امکان استفاده از آن را از داخل برنامه‌های دیگر برای نمایش تصاویر فراهم می‌کند؛ به ویژه گزینه‌های \fB\-\-place\fP، \fB\-\-detect\-support\fP و \fB\-\-print\-window\-size\fP\&. .sp اگر در تلاشید تا icat را در برنامه‌ای پیچیده مانند یک مدیر فایل یا یک ویرایشگر ادغام کنید، چند نکته را باید در نظر داشته باشید. برنامه icat معمولاً از طریق ارتباط با دستگاه TTY کار می‌کند؛ یعنی هم روی TTY می‌نویسد و هم از آن می‌خواند. بنابراین بسیار ضروری است که در حین اجرای آن، برنامه میزبان هیچ‌گونه عملیات ورودی/خروجی TTY انجام ندهد. هرگونه فشردن کلید یا ورودی دیگر کاربر روی دستگاه TTY نادیده گرفته و دور ریخته خواهد شد. اگر در عوض می‌خواهید از آن صرفاً به عنوان یک پیشانه (backend) برای تولید کدهای گریز نمایش تصویر استفاده کنید، باید گزینه‌هایی را به آن ارسال کنید که ابعاد پنجره، محل قرارگیری تصویر در پنجره و حالت انتقال را مشخص کند. در صورت انجام این کار، این ابزار اصلاً تلاشی برای برقراری ارتباط با دستگاه TTY نخواهد کرد. گزینه‌های لازم عبارتند از: \fB\-\-use\-window\-size\fP، \fB\-\-place\fP، \fB\-\-transfer\-mode\fP و \fB\-\-stdin=no\fP\&. برای نمونه، به منظور نشان دادن نحوه استفاده بدون دسترسی به TTY: .INDENT 0.0 .INDENT 3.5 .sp .EX zsh \-c \(aqsetsid kitten icat \-\-stdin=no \-\-use\-window\-size $COLUMNS,$LINES,3000,2000 \-\-transfer\-mode=file myimage.png\(aq .EE .UNINDENT .UNINDENT .sp در اینجا، \fBsetsid\fP تضمین می‌کند که icat هیچ‌گونه دسترسی به دستگاه TTY ندارد. مقادیر 3000 و 2000 ساختگی هستند؛ آن‌ها پهنا و ارتفاع پنجره بر حسب پیکسل هستند که به دست آوردن آن‌ها مستلزم دسترسی به TTY است. .sp برای دستیابی به پایداری کامل، بهتر است به جای این کار، پشتیبانی مناسب از پروتکل گرافیکی kitty در \%<> را در برنامه خود پیاده‌سازی کنید. امروزه کتابخانه‌های بسیاری وجود دارند که از آن پشتیبانی می‌کنند. .SH "کد منبع icat (Source code for icat)" .sp کد منبع این کیتن در گیت‌هاب در دسترس است: \%\&. .SH "رابط خط فرمان (Command line interface)" .INDENT 0.0 .INDENT 3.5 .sp .EX kitten icat [options] image\-file\-or\-url\-or\-directory ... .EE .UNINDENT .UNINDENT .sp ابزاری مشابه cat برای نمایش تصاویر در ترمینال. می‌توانید چندین فایل تصویر و/یا دایرکتوری را مشخص کنید. دایرکتوری‌ها به صورت بازگشتی برای یافتن فایل‌های تصویر پویش می‌شوند. اگر ورودی استاندارد (STDIN) یک ترمینال نباشد، داده‌های تصویر از آن نیز خوانده خواهد شد. همچنین می‌توانید نشانی‌های وب HTTP(S) یا FTP را مشخص کنید که به طور خودکار بارگیری و نمایش داده می‌شوند. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-align تراز افقی برای تصویر نمایش داده‌شده. پیش‌فرض: \fBcenter\fP انتخاب‌ها: \fBcenter\fP، \fBleft\fP، \fBright\fP .UNINDENT .INDENT 0.0 .TP .B \-\-place انتخاب محل نمایش تصویر روی صفحه نمایش. اندازه تصویر به گونه‌ای تغییر مقیاس می‌یابد که در مستطیل مشخص‌شده جا بگیرد. نحو مشخص کردن مستطیل‌ها به صورت x@x است. تمامی اندازه‌گیری‌ها بر حسب سلول‌ها (یعنی موقعیت‌های مکان‌نما) با مبدا مختصات (0، 0) در گوشه بالا-چپ صفحه نمایش است. توجه داشته باشید که گزینه \fB\-\-align\fP تصویر را به صورت افقی درون این مستطیل تراز می‌کند. به طور پیش‌فرض، تصویر در مرکز افقی این مستطیل قرار می‌گیرد. استفاده از place باعث می‌شود مکان‌نما به جای قرار گرفتن در خط پس از تصویر، در گوشه بالا-چپ تصویر قرار گیرد. .UNINDENT .INDENT 0.0 .TP .B \-\-scale\-up [=no] باعث می‌شود تصاویری که کوچک‌تر از ناحیه مشخص‌شده هستند بزرگ‌نمایی شوند تا حد امکان بیشترین بخش از ناحیه مشخص‌شده را پر کنند. ناحیه مشخص‌شده به گزینه‌های \fB\-\-place\fP یا \fB\-\-fit\fP بستگی دارد. .UNINDENT .INDENT 0.0 .TP .B \-\-fit هنگامی که از گزینه \fB\-\-place\fP استفاده نمی‌شود، نحوه مقیاس‌بندی تصویر نسبت به صفحه نمایش را کنترل می‌کند. می‌توانید آن را طوری تنظیم کنید که با پهنا، با ارتفاع، با هر دو یا با هیچ‌کدام متناسب شود. پیش‌فرض: \fBwidth\fP انتخاب‌ها: \fBboth\fP، \fBheight\fP، \fBnone\fP، \fBwidth\fP .UNINDENT .INDENT 0.0 .TP .B \-\-background مشخص کردن یک رنگ پس‌زمینه؛ این کار باعث می‌شود تصاویر دارای شفافیت روی رنگ مشخص‌شده ترکیب شوند. پیش‌فرض: \fBnone\fP .UNINDENT .INDENT 0.0 .TP .B \-\-mirror آینه‌ای کردن تصویر حول محور افقی یا عمودی یا هر دو. پیش‌فرض: \fBnone\fP انتخاب‌ها: \fBboth\fP، \fBhorizontal\fP، \fBnone\fP، \fBvertical\fP .UNINDENT .INDENT 0.0 .TP .B \-\-clear [=no] حذف تمام تصاویری که در حال حاضر روی صفحه نمایش نشان داده می‌شوند. توجه داشته باشید که این گزینه با تسهیم‌کننده‌های ترمینال مانند tmux کار نمی‌کند، زیرا تنها تسهیم‌کننده از موقعیت صفحه نمایش مطلع است. .UNINDENT .INDENT 0.0 .TP .B \-\-clear\-all [=no] حذف تمام تصاویر از صفحه نمایش و تاریخچه پیمایش (scrollback). توجه داشته باشید که در تسهیم‌کننده‌های ترمینال مانند tmux، این گزینه تصاویر را از تمامی قاب‌ها (panes) حذف خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-transfer\-mode کدام سازوکار برای انتقال تصاویر به ترمینال استفاده شود. حالت پیش‌فرض، تشخیص خودکار (auto-detect) است. مقدار file به معنای استفاده از فایل موقت، مقدار memory به معنای استفاده از حافظه اشتراکی، و مقدار stream به معنای ارسال داده‌ها از طریق کدهای گریز ترمینال است. توجه داشته باشید که اگر از حالت‌های انتقال file یا memory استفاده کنید و در حال اتصال از طریق یک نشست راه دور باشید، نمایش تصویر کار نخواهد کرد. پیش‌فرض: \fBdetect\fP انتخاب‌ها: \fBdetect\fP، \fBfile\fP، \fBmemory\fP، \fBstream\fP .UNINDENT .INDENT 0.0 .TP .B \-\-detect\-support [=no] تشخیص پشتیبانی از نمایش تصویر در ترمینال. در صورت عدم پشتیبانی، با کد خروج ۱ خارج می‌شود؛ در غیر این صورت با کد ۰ خارج شده و حالت انتقال پشتیبانی‌شده را در خروجی خطای استاندارد (stderr) چاپ می‌کند که می‌توان آن را همراه با گزینه \fB\-\-transfer\-mode\fP به کار برد. .UNINDENT .INDENT 0.0 .TP .B \-\-detection\-timeout مدت زمان (بر حسب ثانیه) برای انتظار جهت دریافت پاسخ از ترمینال، هنگام تشخیص پشتیبانی از نمایش تصویر. پیش‌فرض: \fB10\fP .UNINDENT .INDENT 0.0 .TP .B \-\-use\-window\-size به جای پرس‌وجوی اندازه پنجره از ترمینال، از اندازه مشخص‌شده استفاده می‌کند که باید در قالب width_in_cells,height_in_cells,width_in_pixels,height_in_pixels باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-print\-window\-size [=no] اندازه پنجره را به صورت x (بر حسب پیکسل) چاپ کرده و خارج می‌شود. این روشی مناسب برای پرس‌وجوی اندازه پنجره هنگام استفاده از \fBkitten icat\fP در یک زبان اسکریپت‌نویسی است که نمی‌تواند فراخوانی‌های termios انجام دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-stdin خواندن داده‌های تصویر از ورودی استاندارد (STDIN). به طور پیش‌فرض وقتی STDIN یک ترمینال نباشد، این کار به صورت خودکار انجام می‌شود، اما در صورت نیاز می‌توانید آن را صراحتاً خاموش یا روشن کنید. پیش‌فرض: \fBdetect\fP انتخاب‌ها: \fBdetect\fP، \fBno\fP، \fByes\fP .UNINDENT .INDENT 0.0 .TP .B \-\-silent [=no] استفاده نمی‌شود؛ صرفاً برای سازگاری با نسخه‌های قدیمی وجود دارد. .UNINDENT .INDENT 0.0 .TP .B \-\-engine موتور مورد استفاده برای رمزگشایی و پردازش تصاویر. حالت پیش‌فرض استفاده از مناسب‌ترین موتور است. موتور \fBbuiltin\fP از کتابخانه‌های بومی تصویر زبان Go استفاده می‌کند. موتور \fBmagick\fP از ImageMagick استفاده می‌کند که نیازمند نصب بودن آن بر روی سیستم است. پیش‌فرض: \fBauto\fP انتخاب‌ها: \fBauto\fP، \fBbuiltin\fP، \fBmagick\fP .UNINDENT .INDENT 0.0 .TP .B \-\-z\-index , \-z شاخص Z (Z-index) تصویر. هنگامی که مقدار منفی باشد، متن بر روی تصویر نمایش داده خواهد شد. از علامت منفی دوتایی برای مقادیر زیر آستانه جهت ترسیم تصاویر زیر رنگ پس‌زمینه سلول استفاده کنید. به عنوان مثال، \fB\-\-1\fP به صورت \-1,073,741,825 ارزیابی می‌شود. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-loop , \-l تعداد دفعات تکرار پویانمایی‌ها. مقادیر منفی تا ابد تکرار می‌شوند. مقدار صفر به این معنی است که فقط نخستین فریم از پویانمایی نمایش داده می‌شود. در غیر این صورت، پویانمایی به تعداد دفعات مشخص‌شده تکرار می‌گردد. پیش‌فرض: \fB\-1\fP .UNINDENT .INDENT 0.0 .TP .B \-\-hold [=no] پس از نمایش تصاویر، پیش از خروج منتظر فشردن یک کلید می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-\-unicode\-placeholder [=no] استفاده از روش مکان‌نمای یونیکد (Unicode placeholder) برای نمایش تصاویر. برای نمایش تصاویر از درون برنامه‌های ترمینال تمام‌صفحه که پروتکل گرافیکی kitty را پشتیبانی نمی‌کنند (مانند تسهیم‌کننده‌ها یا ویرایشگرها) کاربرد دارد. برای جزئیات به بخش جایگزین‌های یونیکد در \%<#\:graphics-unicode-placeholders> مراجعه کنید. توجه داشته باشید که هنگام استفاده از این روش، تصاویری که با گزینه \fB\-\-place\fP قرار داده شده و در صفحه جا نمی‌شوند، به جای بریده شدن، در لبه صفحه شکسته و پیچیده می‌شوند. این شکستگی در هر خط صورت می‌گیرد و بنابراین به نظر می‌رسد که تصویر به صورت متناوب با خطوط خالی ترکیب شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-passthrough مشخص می‌کند که آیا دستورات گرافیکی با توالی‌های گریز احاطه شوند تا اجازه عبور مستقیم (passthrough) از برنامه‌هایی مانند tmux را داشته باشند یا خیر. حالت پیش‌فرض، تشخیص اجرای برنامه در داخل tmux و استفاده خودکار از کدهای گریز عبور مستقیم tmux است. توجه داشته باشید که فعال بودن این گزینه به طور ضمنی گزینه \fB\-\-unicode\-placeholder\fP را نیز به همراه دارد. پیش‌فرض: \fBdetect\fP انتخاب‌ها: \fBdetect\fP، \fBnone\fP، \fBtmux\fP .UNINDENT .INDENT 0.0 .TP .B \-\-image\-id شناسه پروتکل گرافیکی برای استفاده در تصویر ایجادشده. معمولاً در صورت نیاز یک شناسه تصادفی ساخته می‌شود. این گزینه امکان کنترل شناسه را فراهم می‌کند. هنگامی که چندین تصویر ارسال می‌شوند، شناسه‌های متوالی با شروع از شناسه مشخص‌شده استفاده می‌شوند. شناسه‌های معتبر از 1 تا 4294967295 هستند. اعداد خارج از این محدوده به طور خودکار بازگردانی می‌شوند. پیش‌فرض: \fB0\fP .UNINDENT .INDENT 0.0 .TP .B \-\-no\-trailing\-newline [=no], \-n [=no] به طور پیش‌فرض، مکان‌نما پس از نمایش تصویر به خط بعدی منتقل می‌شود. این گزینه از این کار جلوگیری می‌کند. نباید هنگام نمایش چندین تصویر متوالی استفاده شود. همچنین در صورت استفاده از گزینه \fB\-\-place\fP هیچ اثری ندارد. .UNINDENT .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.