نام (NAME)

img2txt - تبدیل تصاویر به فایل‌های متنی رنگی گوناگون

خلاصه دستور (SYNOPSIS)

img2txt [ -W width ] [ -H height ] [ -x font-width ] [ -y font-height ]

: [ -b brightness ] [ -c contrast ] [ -g gamma ]
: [ -d dither ] [ -f format ] FILE

توضیحات (DESCRIPTION)

دستور img2txt تصاویر را به نویسه‌های رنگی ASCII تبدیل کرده و آن‌ها را در قالب فایل‌های متنی رنگی خروجی می‌دهد.

دستور img2txt می‌تواند متداول‌ترین قالب‌های تصویر را بارگیری کند: PNG، JPEG، GIF، PNG، BMP و غیره (برای جزئیات به بخش نکات (NOTES) مراجعه کنید). به‌طور پیش‌فرض، متن خروجی دارای عرض ۶۰ ستون است و تعداد خطوط متناسب با حفظ نسبت ابعاد فایل اصلی محاسبه می‌شود. قالب خروجی پیش‌فرض، متن رنگی استاندارد ANSI است.

گزینه‌ها (OPTIONS)

-W, --width=<width>: تغییر تعداد ستون‌های خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۶۰ در نظر گرفته می‌شود.
-H, --height=<height>: تغییر تعداد خطوط خروجی. در صورت مشخص نشدن، ارتفاع برای حفظ نسبت ابعاد صحیح محاسبه می‌شود.
-x, --font-width=<width>: تغییر عرض قلم خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۶ است. این مقدار برای محاسبهٔ نسبت ابعاد استفاده خواهد شد.
-y, --font-height=<height>: تغییر ارتفاع قلم خروجی. در صورت مشخص نشدن، مقدار پیش‌فرض ۱۰ است. این مقدار برای محاسبهٔ نسبت ابعاد استفاده خواهد شد.
-b, --brightness=<brightness>: تغییر روشنایی تصویر. مقدار پیش‌فرض 1.0 است.
-c, --contrast=<contrast>: تغییر کنتراست تصویر. مقدار پیش‌فرض 1.0 است.
-g, --gamma=<gamma>: تغییر گامای تصویر. مقدار پیش‌فرض 1.0 است.
-d, --dither=<dither>: تغییر الگوریتم دیترینگ (dithering). این مقدار می‌تواند یکی از موارد زیر باشد (پیش‌فرض fstein است):
none : نزدیک‌ترین رنگ
ordered2 : شبکه‌ای ۲x۲
ordered4 : شبکه‌ای ۴x۴
ordered8 : شبکه‌ای ۸x۸
random : تصادفی
fstein : فلوید اشتاینبرگ
-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
-h, --help: نمایش پیام راهنما و خروج.
-v, --version: نمایش نگارش برنامه و خروج.

مثال‌ها (EXAMPLES)

img2txt hello.jpg > hello.ans

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

نکات (NOTES)

تنظیم هم‌زمان تعداد ستون‌ها و خطوط (با استفاده از --width و --height) به شما امکان می‌دهد بدون در نظر گرفتن نسبت ابعاد تصویر، اندازهٔ دقیق خروجی را مشخص کنید.

برای اینکه بتوانید طیف گسترده‌ای از قالب‌های تصویر را بارگیری کنید، باید بسته libcaca را با پشتیبانی از Imlib2 کامپایل کنید. در غیر این صورت تنها قادر به بارگیری فایل‌های معمول BMP خواهید بود.

همچنین ببینید (SEE ALSO)

cacaview(1)

نویسندگان (AUTHORS)

این صفحهٔ راهنما توسط Sam Hocevar <sam@hocevar.net> و Jean-Yves Lamoureux <jylam@lnxscene.org> نوشته شده است.