'\" t
.\"     Title: chafa
.\"    Author: Hans Petter Jansson
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/06/2026
.\"    Manual: User Commands
.\"    Source: chafa
.\"  Language: English
.\"
.TH "CHAFA" "1" "" "chafa" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
chafa \- تولیدکننده هنر نویسه‌ای و تصاویر شبیه‌سازی‌شده در ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBchafa\fR\ 'u
\fBchafa\fR [OPTION...] [IMAGE...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBchafa\fR
یک ابزار خط فرمان است که داده‌های تصویری، از جمله تصاویر متحرک GIF را به قالب‌های گرافیکی یا هنر نویسه‌ای ANSI/Unicode مناسب برای نمایش در ترمینال تبدیل می‌کند\&. این ابزار از قابلیت‌های گسترده‌ای پشتیبانی می‌کند که امکان استفاده از آن را روی دستگاه‌های مختلف، از تله‌پرینترهای قدیمی گرفته تا شبیه‌سازهای مدرن ترمینال و هر دستگاهی در این میان، فراهم می‌سازد\&.
.PP
می‌توانید یک یا چند فایل ورودی را مشخص کنید، اما رفتار پیش‌فرض هنگام مشخص کردن چند فایل کمی متفاوت است؛ برای نمونه، زمانی که بیش از یک فایل ورودی وجود داشته باشد، پویانمایی‌ها به صورت بی‌پایان تکرار نخواهند شد\&.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.PP
\fB\-\-files \fR\fB\fIpath\fR\fR
.RS 4
خواندن فهرستی از مسیرها جهت پردازش از
\fIpath\fR، یا \*(Aq\-\*(Aq برای ورودی استاندارد (stdin)\&. مسیرها باید با خط جدید (newline) از یکدیگر جدا شوند\&.
.sp
می‌تواند چندین بار مشخص شود\&. هر مسیر اضافی دیگری در خط فرمان، در انتهای کار پردازش خواهد شد\&.
.RE
.PP
\fB\-\-files0 \fR\fB\fIpath\fR\fR
.RS 4
خواندن فهرستی از مسیرها جهت پردازش از
\fIpath\fR، یا \*(Aq\-\*(Aq برای ورودی استاندارد (stdin)\&. مسیرها باید با بایت‌های NUL از یکدیگر جدا شوند\&. در صورتی که سیستم‌فایل شما اجازه وجود خط جدید در نام فایل‌ها را می‌دهد (مانند POSIX)، این روش پایدارتر و ایمن‌تر است\&. در ترکیب با سایر ابزارهایی که از این قابلیت پشتیبانی می‌کنند مفید است، مانند:\&
.sp
\fBfind \&. \-type f \-print0 | chafa \-\-files0 \-\fR
.sp
می‌تواند چندین بار مشخص شود\&. هر مسیر اضافی دیگری در خط فرمان، در انتهای کار پردازش خواهد شد\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
نمایش متن راهنمای مختصر\&.
.RE
.PP
\fB\-\-probe \fR\fB\fIarg\fR\fR
.RS 4
بررسی قابلیت‌های ترمینال و انتظار برای پاسخ [auto, on, off]\&. یک عدد حقیقی مثبت نشان‌دهنده حداکثر زمان انتظار برای پاسخ به ثانیه است\&. پیش‌فرض 5\&.0 است\&.
.RE
.PP
\fB\-\-probe\-mode \fR\fB\fImode\fR\fR
.RS 4
نحوه بررسی قابلیت‌های ترمینال [any, ctty, stdio]\&. مقدار "any" پیش‌فرض است و با هر روش در دسترسی بررسی را انجام می‌دهد\&. مقدار "ctty" پایانه کنترلی (معمولاً ‎/dev/tty‎) را بررسی می‌کند که در زمان قرار داشتن chafa درون یک خط لوله (پایپ) کاربرد دارد؛ در صورت انجام در پس‌زمینه ممکن است مسدود شود\&. مقدار "stdio" صرفاً ورودی/خروجی استاندارد را در نظر می‌گیرد\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخه، ویژگی‌ها و حق نشر\&.
.RE
.SH "کدگذاری خروجی (OUTPUT ENCODING)"
.PP
\fB\-f, \-\-format \fR\fB\fIformat\fR\fR
.RS 4
تنظیم قالب خروجی؛ یکی از [iterm, kitty, sixels, symbols]\&. مقدار پیش‌فرض در صورت پشتیبانی ترمینال متصل، یکی از iterm، kitty یا sixels است و در غیر این صورت به symbols ("هنر ANSI") بازمی‌گردد\&.
.RE
.PP
\fB\-O \fR\fB\fInum\fR\fR\fB, \-\-optimize \fR\fB\fInum\fR\fR
.RS 4
فشرده‌سازی خروجی با استفاده هوشمندانه از توالی‌های کنترلی [0\-9]\&. مقدار 0 بهینه‌سازی را غیرفعال می‌کند و 9 تمام بهینه‌سازی‌های موجود را فعال می‌سازد\&. مقدار پیش‌فرض 5 است، به جز زمانی که با "\-c none" استفاده شود که در آن حالت پیش‌فرض 0 خواهد بود\&.
.RE
.PP
\fB\-\-relative \fR\fB\fIbool\fR\fR
.RS 4
استفاده از موقعیت‌یابی نسبی مکان‌نما [on, off]\&. هنگام فعال بودن، از توالی‌های کنترلی برای قرار دادن تصاویر نسبت به مکان‌نما استفاده می‌شود\&. هنگام غیرفعال بودن، از خطوط جدید برای جداسازی سطرها استفاده خواهد شد؛ برای نمونه جهت سازگاری با \*(Aqless \-R\*(Aq\&. پیش‌فرض off است\&.
.RE
.PP
\fB\-\-passthrough \fR\fB\fImode\fR\fR
.RS 4
عبور مستقیم پروتکل گرافیکی [auto, none, screen, tmux]\&. برای نمایش گرافیک‌های پیکسلی از درون تسهیم‌کننده‌ها استفاده می‌شود\&. پیش‌فرض auto است که در صورت تشخیص ترمینال Kitty به همراه یکی از تسهیم‌کننده‌های پشتیبانی‌شده، حالت عبور مستقیم را فعال می‌کند\&. سایر ترکیب‌ها باید به صورت دستی فعال شوند؛ همراه با گزینه \-f برای انتخاب پروتکل گرافیکی مناسب استفاده کنید\&.
.RE
.PP
\fB\-\-polite \fR\fB\fIbool\fR\fR
.RS 4
حالت محتاطانه [on, off]\&. توالی‌های کنترلی فرار را که در موارد نادر ممکن است باعث سردرگمی ترمینال یا سایر برنامه‌ها شوند مهار می‌کند\&. پیش‌فرض off است\&.
.RE
.SH "اندازه و چیدمان (SIZE AND LAYOUT)"
.PP
\fB\-\-align \fR\fB\fIALIGN\fR\fR
.RS 4
تراز کردن تصاویر در درگاه دید (viewport)\&. ترازهای زیر پشتیبانی می‌شوند: left، right، top، bottom، hcenter، vcenter، center\&. دو تراز عمود بر هم را می‌توان با کاما جدا کرد، برای نمونه "center,right"\&. معنای "center" به زمینه بستگی دارد و در صورت ابهام، پیش‌فرض آن "hcenter" است\&. مقدار "center,center" در امتداد هر دو محور تصویر را مرکزچین می‌کند\&.
.sp
مرکزچین کردن عمودی زمانی منطقی است که همراه با "\-\-clear" استفاده شود، یا احتمالاً به عنوان بخشی از ساختاری که مکان‌نما از قبل در گوشه بالا-چپ نما قرار گرفته باشد، یا نمای فرعی هنگام استفاده با "\-\-relative on"\&.
.RE
.PP
\fB\-C \fR\fB\fIbool\fR\fR\fB, \-\-center \fR\fB\fIbool\fR\fR
.RS 4
مرکزچین کردن افقی تصاویر در نما [on, off]\&. پیش‌فرض off است\&. این گزینه منسوخ شده است؛ به جای آن از "\-\-align center" استفاده کنید\&.
.RE
.PP
\fB\-\-clear\fR
.RS 4
پاک کردن صفحه قبل از پردازش هر فایل\&.
.RE
.PP
\fB\-\-exact\-size \fR\fB\fImode\fR\fR
.RS 4
تلاش برای تطابق دقیق با اندازه ورودی [auto, on, off]\&. در صورت فعال بودن، این گزینه سایر تنظیمات اندازه را نادیده گرفته و تصاویر خروجی را دقیقاً در ابعاد پیکسلی ورودی‌ها تولید می‌کند\&. در حالت auto، در صورتی که اندازه خروجی برابر یا کمی بزرگتر از ورودی باشد، از مقیاس‌بندی اجتناب شده (به ازای افزودن حاشیه/padding) عمل می‌شود\&. هنگام غیرفعال بودن، هیچ حاشیه‌ای افزوده نمی‌شود و تصویر برای جا گرفتن در گستره خانه متناظر مقیاس‌بندی می‌شود\&. پیش‌فرض auto است\&.
.RE
.PP
\fB\-\-fit\-width\fR
.RS 4
برازش تصویر با عرض نما، با احتمال فراتر رفتن از ارتفاع آن\&.
.RE
.PP
\fB\-\-font\-ratio \fR\fB\fIwidth\fR\fR\fB/\fR\fB\fIheight\fR\fR
.RS 4
نسبت عرض به ارتفاع قلم هدف\&. می‌تواند به عنوان یک عدد حقیقی یا کسر مشخص شود\&. پیش‌فرض 1/2 است\&. این مورد فقط در حالت نماد (symbol mode) اعمال خواهد شد\&.
.RE
.PP
\fB\-\-grid \fR\fB\fIcols\fR\fR\fBx\fR\fB\fIrows\fR\fR
.RS 4
چیدمان تصاویر در یک شبکه با
\fIcols\fR
ستون و
\fIrows\fR
سطر در هر صفحه نمایش\&. هر یک از
\fIcols\fR
یا
\fIrows\fR
می‌تواند حذف شود، برای نمونه ‎\-\-grid 4‎ یا ‎\-\-grid x4‎، که در این حالت تخصیص خانه‌ها تقریباً مربع خواهد بود\&. اگر "auto" مشخص شود، ابعاد به طور خودکار انتخاب می‌شوند\&.
.RE
.PP
\fB\-g\fR
.RS 4
نام مستعار برای "\-\-grid auto"\&.
.RE
.PP
\fB\-\-label \fR\fB\fIbool\fR\fR
.RS 4
برچسب‌گذاری [on, off]\&. در صورت فعال بودن، هر تصویر با نام فایل خود برچسب‌گذاری می‌شود\&. پیش‌فرض off است\&.
.RE
.PP
\fB\-l\fR
.RS 4
نام مستعار برای "\-\-label on"\&.
.RE
.PP
\fB\-\-margin\-bottom \fR\fB\fInum\fR\fR
.RS 4
هنگام تشخیص اندازه ترمینال، حداقل این تعداد سطر را در پایین به عنوان حاشیه ایمنی رزرو می‌کند\&. می‌تواند برای جلوگیری از اسکرول شدن تصاویر به بیرون استفاده شود\&. پیش‌فرض 1 است\&.
.RE
.PP
\fB\-\-margin\-right \fR\fB\fInum\fR\fR
.RS 4
هنگام تشخیص اندازه ترمینال، حداقل این تعداد ستون را در سمت راست به عنوان حاشیه ایمنی رزرو می‌کند\&. پیش‌فرض 0 است\&.
.RE
.PP
\fB\-\-scale \fR\fB\fInum\fR\fR
.RS 4
مقیاس‌بندی تصویر با در نظر گرفتن حداکثر ابعاد ترمینال\&. مقدار 1\&.0 تقریبی از ابعاد پیکسلی اصلی است\&. برای استفاده از تمام فضای موجود، مقدار "max" را مشخص کنید\&. پیش‌فرض برای گرافیک پیکسلی 1\&.0 و برای نمادها 4\&.0 است\&.
.RE
.PP
\fB\-s \fR\fB\fIwidth\fR\fR\fBx\fR\fB\fIheight\fR\fR\fB, \-\-size \fR\fB\fIwidth\fR\fR\fBx\fR\fB\fIheight\fR\fR
.RS 4
تنظیم حداکثر ابعاد تصویر خروجی بر حسب ستون‌ها و سطرها\&. به طور پیش‌فرض این مقدار برابر با اندازه نما خواهد بود (بخش \-\-view\-size را ببینید)\&.
.RE
.PP
\fB\-\-stretch\fR
.RS 4
کشیدن تصویر برای جا گرفتن در ابعاد خروجی؛ نسبت ابعاد نادیده گرفته می‌شود\&. به طور ضمنی شامل \-\-scale max است\&.
.RE
.PP
\fB\-\-view\-size \fR\fB\fIwidth\fR\fR\fBx\fR\fB\fIheight\fR\fR
.RS 4
تنظیم اندازه نما بر حسب ستون‌ها و سطرها\&. به طور پیش‌فرض اندازه ترمینال شما خواهد بود، یا اگر تشخیص اندازه با شکست مواجه شود، 80x25 در نظر گرفته می‌شود\&. اگر یکی از ابعاد حذف شود (مثلاً با ارائه اندازه به صورت 80x یا x25)، به تقریبی معقول از بی‌نهایت تنظیم خواهد شد\&.
.RE
.SH "پویانمایی و زمان‌بندی (ANIMATION AND TIMING)"
.PP
\fB\-\-animate \fR\fB\fIbool\fR\fR
.RS 4
مجاز بودن اجرای پویانمایی [on, off]\&. پیش‌فرض on است\&. هنگام غیرفعال بودن، یک فریم ثابت از هر پویانمایی نمایش داده می‌شود\&.
.RE
.PP
\fB\-d, \-\-duration \fR\fB\fIseconds\fR\fR
.RS 4
مدت زمان نمایش هر فایل به ثانیه\&. پیش‌فرض برای تصاویر ثابت و پویانمایی‌ها هنگام مشخص کردن چندین فایل صفر است\&. اگر یک پویانمایی منفرد مشخص شود، پیش‌فرض بی‌نهایت یا "inf" است\&. پویانمایی‌ها همیشه حداقل یک‌بار به طور کامل پخش می‌شوند، حتی اگر مدت زمان مثلاً صفر باشد\&. برای اطلاعات بیشتر بخش "مدت زمان (DURATION)" را ببینید\&.
.RE
.PP
\fB\-\-speed \fR\fB\fIspeed\fR\fR
.RS 4
تنظیم سرعت پخش پویانمایی‌ها\&. این مقدار می‌تواند یک ضریب بدون واحد باشد (کسرها مجاز هستند)، یا یک عدد حقیقی به همراه پسوند "fps" برای اعمال نرخ فریم خاص\&.
.RE
.PP
\fB\-\-watch\fR
.RS 4
پایش یک فایل ورودی تکی و بازنمایش آن در زمان تغییر محتویات\&. تا زمان توقف دستی توسط کاربر یا در صورت تنظیم \-\-duration تا پایان مهلت زمانی اجرا می‌شود\&.
.RE
.SH "رنگ‌ها و پردازش (COLORS AND PROCESSING)"
.PP
\fB\-\-bg \fR\fB\fIcolor\fR\fR
.RS 4
رنگ پس‌زمینه نمایش (نام رنگ یا کد هگز)\&. ورودی‌های دارای شفافیت جزئی با این رنگ ترکیب می‌شوند\&. نام رنگ‌ها بر اساس نام‌های ارائه‌شده در X\&.Org است\&. پیش‌فرض مشکی (black) است، یا رنگ پس‌زمینه پیش‌فرض ترمینال در زمان فعال بودن قابلیت کاوش (بخش \-\-probe را ببینید)\&.
.RE
.PP
\fB\-c \fR\fB\fImode\fR\fR\fB, \-\-colors \fR\fB\fImode\fR\fR
.RS 4
تنظیم حالت رنگ خروجی؛ یکی از [none, 2, 8, 16/8, 16, 240, 256, full]\&. حالت ۲۴۰ رنگ نسبت به ۲۵۶ رنگ ترجیح داده می‌شود، زیرا ۱۶ رنگ پایین‌تر غیرقابل‌اعتماد هستند و در ترمینال‌های مختلف تفاوت دارند\&. حالت ۱۶ رنگ از افزونه‌های aixterm برای تولید ۱۶ رنگ پیش‌زمینه و پس‌زمینه استفاده می‌کند\&. حالت 16/8 امکان استفاده از ۸ رنگ به علاوه ۸ رنگ "روشن" دیگر در پیش‌زمینه را از طریق توالی اسکیپ "bold" فراهم می‌سازد\&. حالت ۲ رنگ فقط کدهای ANSI را برای رنگ معکوس و بازنشانی ویژگی‌ها ارسال می‌کند، در حالی که "none" هیچ توالی فراری منتشر نخواهد کرد\&.
.sp
در حالت sixel، مقدار "full" به صورت پویا یک پالت ۲۵۶ رنگ برای هر تصویر یا فریم پویانمایی ایجاد می‌کند\&. سایر حالت‌ها به پالت‌های توکار اشاره دارند\&. مقادیر "none" و "2" قابل تعویض با یکدیگر هستند و از رنگ‌های مشخص‌شده پیش‌زمینه/پس‌زمینه استفاده می‌کنند (بخش‌های \-\-fg و \-\-bg را ببینید)\&.
.sp
در صورت مشخص نشدن، یک پیش‌فرض بهینه بر اساس محیط جاری انتخاب خواهد شد\&.
.RE
.PP
\fB\-\-color\-extractor \fR\fB\fIextractor\fR\fR
.RS 4
روش استخراج رنگ از یک ناحیه؛ یکی از [average, median]\&. روش میانه (median) معمولاً خروجی شفاف‌تر و واضح‌تری تولید می‌کند، در حالی که میانگین (average) ممکن است روی تصاویر دارای نویز عملکرد بهتری داشته باشد\&. پیش‌فرض average است\&.
.RE
.PP
\fB\-\-color\-space \fR\fB\fIcs\fR\fR
.RS 4
فضای رنگی استفاده‌شده برای کوانتیزاسیون؛ یکی از [rgb, din99d]\&. پیش‌فرض rgb است که سریع‌تر ولی با دقت کمتر عمل می‌کند\&.
.RE
.PP
\fB\-\-dither \fR\fB\fItype\fR\fR
.RS 4
نوع ترام‌ریزی (dithering) برای اعمال در طول کوانتیزاسیون\&. یکی از [none, ordered, diffusion, noise]\&. مقدار "Bayer" مترادف با "ordered" است و "fs" (Floyd\-Steinberg) مترادف با "diffusion" می‌باشد\&. پیش‌فرض در حالت sixel برابر با "noise" و در سایر حالت‌ها "none" است\&.
.RE
.PP
\fB\-\-dither\-grain \fR\fB\fIwidth\fR\fR\fBx\fR\fB\fIheight\fR\fR
.RS 4
ابعاد دانه‌های ترام‌ریزی\&. به صورت width x height مشخص می‌شود که هر کدام می‌تواند یکی از مقادیر [1, 2, 4, 8] پیکسل باشد\&. یک خانه نویسه بر اساس تعریف در هر دو جهت ۸ پیکسل است\&. مقدار پیش‌فرض 4x4 در حالت نماد و 1x1 در حالت sixel است\&.
.RE
.PP
\fB\-\-dither\-intensity \fR\fB\fIintensity\fR\fR
.RS 4
شدت الگوی ترام‌ریزی\&. دامنه‌ای از 0\&.0 تا بی‌نهایت دارد که مقدار 1\&.0 خنثی تلقی می‌شود\&. مقادیر کمتر تمایل به کاهش میزان ترام‌ریزی دارند، در حالی که مقادیر بالاتر آن را افزایش می‌دهند\&. در عمل، مقادیر بالاتر از 10\&.0 بعید است نتایج مفیدی ایجاد کنند\&.
.RE
.PP
\fB\-\-fg \fR\fB\fIcolor\fR\fR
.RS 4
رنگ پیش‌زمینه نمایش (نام رنگ یا کد هگز)\&. به همراه رنگ پس‌زمینه مشخص‌شده توسط \-\-bg، پالت ترمینال را در حالت‌های رنگی 2 و none تعیین می‌کند\&. نام رنگ‌ها بر اساس نام‌های ارائه‌شده در X\&.Org است\&. پیش‌فرض سفید (white) است، یا رنگ پیش‌زمینه پیش‌فرض ترمینال در زمان فعال بودن قابلیت کاوش (بخش \-\-probe را ببینید)\&.
.RE
.PP
\fB\-\-invert\fR
.RS 4
وارونه‌سازی رنگ‌ها\&. برای نمایش با پس‌زمینه‌های روشن در حالت‌های رنگی 2 و none کاربرد دارد\&. مقادیر \-\-fg و \-\-bg را جابجا می‌کند\&.
.RE
.PP
\fB\-p \fR\fB\fIbool\fR\fR\fB, \-\-preprocess \fR\fB\fIbool\fR\fR
.RS 4
پیش‌پردازش تصویر [on, off]\&. در حالت ۱۶ رنگ یا کمتر به طور پیش‌فرض on است و در غیر این صورت off می‌باشد\&. این گزینه رنگ‌ها و کنتراست را قبل از تبدیل بهبود می‌بخشد که در حالت‌های با تعداد رنگ کم مفید است\&.
.RE
.PP
\fB\-t \fR\fB\fIthreshold\fR\fR\fB, \-\-threshold \fR\fB\fIthreshold\fR\fR
.RS 4
آستانه‌ای که بالاتر از آن شفافیت کامل استفاده خواهد شد [0\&.0 \- 1\&.0]\&. تنظیم روی 0\&.0 یک تصویر خالی رندر می‌کند، در حالی که مقدار 1\&.0 هرگونه شفافیت را با رنگ پس‌زمینه جایگزین می‌کند (قابل تنظیم با \-\-bg)\&.
.RE
.SH "تخصیص منابع (RESOURCE ALLOCATION)"
.PP
\fB\-\-threads \fR\fB\fInum\fR\fR
.RS 4
حداکثر تعداد رشته‌های (threads) پردازنده برای استفاده\&. در صورت مشخص نشدن یا مقادیر منفی، برابر با تعداد هسته‌های در دسترس CPU خواهد بود\&.
.RE
.PP
\fB\-w \fR\fB\fInum\fR\fR\fB, \-\-work \fR\fB\fInum\fR\fR
.RS 4
میزان بار پردازشی از نظر CPU و حافظه [1\-9]\&. مقدار 1 کم‌هزینه‌ترین و 9 دقیق‌ترین است\&. پیش‌فرض 5 است\&.
.RE
.SH "گزینه‌های اضافی برای کدگذاری نمادها (EXTRA OPTIONS FOR SYMBOL ENCODING)"
.PP
\fB\-\-fg\-only\fR
.RS 4
دست‌نخورده باقی گذاشتن رنگ پس‌زمینه\&. این گزینه خروجی خانه نویسه‌ای را فقط با رنگ‌های پیش‌زمینه تولید می‌کند و از بازنشانی یا وارونه‌سازی رنگ‌ها خودداری خواهد کرد\&.
.RE
.PP
\fB\-\-fill \fR\fB\fIsymbols\fR\fR
.RS 4
مشخص کردن نمادهای نویسه‌ای برای پر کردن/گرادیان‌ها\&. پیش‌فرض none است\&. استفاده از آن شبیه به \-\-symbols است؛ بخش زیر را ببینید\&.
.RE
.PP
\fB\-\-glyph\-file \fR\fB\fIfile\fR\fR
.RS 4
بارگذاری اطلاعات گلیف‌ها از فایل، که می‌تواند هر فایل فونت پشتیبانی‌شده توسط FreeType باشد (مانند TTF، PCF و غیره)\&. خطوط پیرامونی گلیف‌ها جایگزین خطوط موجود، از جمله موارد توکار خواهند شد\&. در حالت نماد برای پشتیبانی از فونت‌های سفارشی یا بهبود کیفیت با یک فونت خاص مفید است\&. توجه داشته باشید این مورد تنها زمانی معنا دارد که ترمینال خروجی از یک فونت منطبق استفاده کند\&. می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-symbols \fR\fB\fIsymbols\fR\fR
.RS 4
مشخص کردن نمادهای نویسه‌ای برای به‌کارگیری در خروجی نهایی\&. برای نحوه استفاده کامل و فهرست دسته‌های نماد به بخش زیر مراجعه کنید\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
\fBchafa\fR
در صورت موفقیت مقدار 0، در صورت شکست جزئی مقدار 1 و در صورت شکست کامل مقدار 2 را برمی‌گرداند (از جمله هنگام فراخوانی بدون هیچ آرگومان)\&.
.\" line length increase to cope w/ tbl weirdness
.ll +(\n(LLu * 62u / 100u)
.TS
ll.
\fIوضعیت\fR	\fIمفهوم\fR
T{
0
T}	T{
موفقیت
T}
T{
1
T}	T{
برخی از فایل‌ها در نمایش با شکست مواجه شدند
T}
T{
2
T}	T{
تمام فایل‌ها در نمایش با شکست مواجه شدند
T}
.TE
.\" line length decrease back to previous value
.ll -(\n(LLu * 62u / 100u)
.sp
.SH "نمادها (SYMBOLS)"
.PP
دسته‌های پذیرفته‌شده برای \-\-symbols و \-\-fill عبارتند از: [all, none, space, solid, stipple, block, border, diagonal, dot, quad, half, hhalf, vhalf, inverted, braille, technical, geometric, ascii, legacy, sextant, wedge, wide, narrow]\&. برخی از نمادها به چندین دسته تعلق دارند؛ برای نمونه مورب‌ها (diagonals) کادر (borders) نیز محسوب می‌شوند\&.
.PP
می‌توانید نویسه‌های خاصی را با حرف "u" و به دنبال آن یک نقطه کد هگزادسیمال اضافه کنید، برای نمونه "ue080"، یا محدوده‌ای از نقاط کد را با جدا کردن اندیس اول و آخر با "\&.\&." مشخص کنید، مانند "u100\&.\&.u200"\&.
.PP
مجموعه نمادها همچنین می‌توانند به عنوان رشته‌ای از نویسه‌های UTF\-8 درون کروشه مشخص شوند، مانند [abcd]\&. برای گنجاندن کروشه بسته در مجموعه، آن را با بک‌اسلش اسکیپ کنید\&.
.PP
می‌توانید فهرستی از دسته‌ها را که با کاما از هم جدا شده‌اند مشخص کنید، یا با افزودن پیشوند + و \- نمادهایی را نسبت به مجموعه موجود اضافه یا حذف نمایید\&. ترتیب درج این موارد مهم است\&.
.PP
مجموعه نماد پیش‌فرض برای تمام حالت‌ها block+border+space\-wide\-inverted است به جز حالت "none" که از block+border+space\-wide استفاده می‌کند (شامل نمادهای معکوس)\&.
.SH "مدت زمان (DURATION)"
.PP
برای پاسخگویی به هر دو کاربرد تعاملی و پردازش دسته‌ای، مدت زمان یک پویانمایی بر اساس چند قانون ساده تعیین می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
اگر یک یا چند آرگومان
\fB\-\-duration\fR
وجود داشته باشد، آخرین مورد معتبر شناخته شده و روی تمام فایل‌ها اعمال می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
در غیر این صورت، اگر یک ترمینال کنترلی متصل باشد (که نشان‌دهنده یک نشست تعاملی است) و فقط یک آرگومان فایل ارائه شده باشد و آن فایل یک پویانمایی باشد، مدت زمان نامحدود خواهد داشت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
در غیر این صورت (عدم وجود ترمینال کنترلی، چندین فایل، یا تصویری ثابت بودن فایل)، مدت زمان صفر خواهد بود که باعث می‌شود پویانمایی‌ها یک‌بار پخش شده و سپس متوقف شوند\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBchafa in\&.gif\fR
.RS 4
نمایش یک تصویر GIF احیاناً متحرک در ترمینال\&. اگر این تصویر یک پویانمایی باشد، تا زمانی که کاربر وقفه ایجاد کند (معمولاً با ctrl\-c) اجرا خواهد شد\&. تمام پارامترها بر اساس محیط جاری به طور خودکار شناسایی می‌شوند\&.
.RE
.PP
\fBchafa \-c full \-s 200 in\&.gif\fR
.RS 4
مانند مورد بالا، اما اجبار خروجی تمام‌رنگ (truecolor) با عرض ۲۰۰ نویسه و محاسبه ارتفاع با حفظ نسبت ابعاد تصویر اصلی\&.
.RE
.PP
\fBchafa \-c 16 \-\-color\-space din99d \-\-symbols \-dot in\&.jpg\fR
.RS 4
تولید خروجی ۱۶ رنگ با انتخاب رنگ ادراکی و خودداری از استفاده از نمادهای نقطه‌ای (dot)\&.
.RE
.PP
\fBchafa \-c none \-\-symbols block+border\-solid in\&.png\fR
.RS 4
تولید خروجی بدون رنگ با استفاده از نمادهای بلوکی و کادر، با اجتناب از نماد بلوک یکدست (solid)\&.
.RE
.SH "مطالعه بیشتر (FURTHER READING)"
.PP
برای اطلاعات بیشتر به
\m[blue]\fBوب‌سایت Chafa\fR\m[]\&\s-2\u[1]\d\s+2
مراجعه فرمایید\&.
.SH "نویسنده (AUTHOR)"
.PP
نوشته‌شده توسط
\m[blue]\fBHans Petter Jansson\fR\m[]\&\s-2\u[2]\d\s+2
<hpj@hpjansson\&.org>\&.
.SH "نکات (NOTES)"
.IP " 1." 4
وب‌سایت Chafa
.RS 4
\%https://hpjansson.org/chafa
.RE
.IP " 2." 4
Hans Petter Jansson
.RS 4
\%https://hpjansson.org
.RE