.TH img2txt 1 "2007-11-07" "libcaca"
.SH "نام (NAME)"
img2txt \- تبدیل تصاویر به فایل‌های متنی رنگی گوناگون
.SH "خلاصه دستور (SYNOPSIS)"
.B img2txt 
[
.B \-W
.I width
]
[
.B \-H
.I height
]
[
.B \-x
.I font-width
]
[
.B \-y
.I font-height
]
.PD 0
.IP
.PD
 [
.B \-b
.I brightness
]
[
.B \-c
.I contrast
]
[
.B \-g
.I gamma
]
.PD 0
.IP
.PD
 [
.B \-d
.I dither
]
[
.B \-f
.I format
] 
.I FILE
.RI
.SH "توضیحات (DESCRIPTION)"
دستور
.B img2txt
تصاویر را به نویسه‌های رنگی ASCII تبدیل کرده و آن‌ها را در قالب فایل‌های متنی رنگی خروجی می‌دهد.
.PP
دستور
.B img2txt
می‌تواند متداول‌ترین قالب‌های تصویر را بارگیری کند: PNG، JPEG، GIF، PNG، BMP و غیره (برای جزئیات به بخش
.B "نکات (NOTES)"
مراجعه کنید).
به‌طور پیش‌فرض، متن خروجی دارای عرض ۶۰ ستون است و تعداد خطوط متناسب با حفظ نسبت ابعاد فایل اصلی محاسبه می‌شود.
قالب خروجی پیش‌فرض، متن رنگی استاندارد ANSI است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-W, \-\-width=<width>
تغییر تعداد ستون‌های خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۶۰ در نظر گرفته می‌شود.
.TP
.B \-H, \-\-height=<height>
تغییر تعداد خطوط خروجی. در صورت مشخص نشدن، ارتفاع برای حفظ نسبت ابعاد صحیح محاسبه می‌شود.
.TP
.B \-x, \-\-font-width=<width>
تغییر عرض قلم خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۶ است. این مقدار برای محاسبهٔ نسبت ابعاد استفاده خواهد شد.
.TP
.B \-y, \-\-font-height=<height>
تغییر ارتفاع قلم خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۱۰ است. این مقدار برای محاسبهٔ نسبت ابعاد استفاده خواهد شد.
.TP
.B \-b, \-\-brightness=<brightness>
تغییر روشنایی تصویر. مقدار پیش‌فرض 1.0 است.
.TP
.B \-c, \-\-contrast=<contrast>
تغییر کنتراست تصویر. مقدار پیش‌فرض 1.0 است.
.TP
.B \-g, \-\-gamma=<gamma>
تغییر گامای تصویر. مقدار پیش‌فرض 1.0 است.
.TP
.B \-d, \-\-dither=<dither>
تغییر الگوریتم دیترینگ (dithering). این مقدار می‌تواند یکی از موارد زیر باشد (پیش‌فرض fstein است):
  none     : نزدیک‌ترین رنگ
  ordered2 : شبکه‌ای ۲x۲
  ordered4 : شبکه‌ای ۴x۴
  ordered8 : شبکه‌ای ۸x۸
  random   : تصادفی
  fstein   : فلوید اشتاینبرگ
.TP
.B \-f, \-\-format=<format>
تغییر قالب خروجی. این مقدار می‌تواند یکی از موارد زیر باشد (پیش‌فرض ansi است):
  ansi   : کد ANSI رنگی
  caca   : قالب داخلی libcaca
  utf8   : قالب UTF8 با CR
  utf8cr : قالب UTF8 با CRLF (مخصوص MS Windows)
  html   : کد HTML با پشتیبانی از CSS و DIV
  html3  : کد خالص HTML3 با جدول‌ها
  irc    : قالب IRC با کدهای ctrl-k
  bbfr   : کدهای BBCode (فرانسوی)
  ps     : فرمت Postscript
  svg    : گرافیک برداری مقیاس‌پذیر (SVG)
  tga    : تصویر Targa
.TP
.B \-h, \-\-help
نمایش پیام راهنما و خروج.
.TP
.B \-v, \-\-version
نمایش نگارش برنامه و خروج.

.SH "مثال‌ها (EXAMPLES)"
img2txt hello.jpg > hello.ans

img2txt \-\-width=40 \-\-format=svg hello.jpg > tinyhello.svg

.SH "نکات (NOTES)"
تنظیم هم‌زمان تعداد ستون‌ها و خطوط (با استفاده از 
\-\-width
و
\-\-height)
به شما امکان می‌دهد بدون در نظر گرفتن نسبت ابعاد تصویر، اندازهٔ دقیق خروجی را مشخص کنید.
.PP
برای اینکه بتوانید طیف گسترده‌ای از قالب‌های تصویر را بارگیری کنید، باید بسته libcaca را با پشتیبانی از
.I Imlib2
کامپایل کنید. در غیر این صورت تنها قادر به بارگیری فایل‌های معمول BMP خواهید بود.

.SH "همچنین ببینید (SEE ALSO)"
cacaview(1)
.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما توسط Sam Hocevar <sam@hocevar.net> و Jean-Yves Lamoureux <jylam@lnxscene.org> نوشته شده است.