نام (NAME)

artem - تبدیل تصاویر به هنر اسکی (ASCII Art) در ترمینال

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

artem [-c|--characters] [-s|--size] [--height] [-w|--width] [--ratio] [--flipX] [--flipY] [--centerX] [--centerY] [-o|--output] [--invert] [--background] [--border] [--no-color] [--outline] [--hysteresis] [--verbose] [-h|--help] [-V|--version] <INPUT>

توضیحات (DESCRIPTION)

تبدیل تصاویر از فرمت‌های مختلف (jpg، png، webp و غیره) به هنر اسکی (ASCII art).

گزینه‌ها (OPTIONS)

-c, --characters: تغییر نویسه‌های مورد استفاده برای نمایش تصویر. اولین نویسه باید بالاترین میزان «تیرگی» ('darkness') و آخرین نویسه باید کمترین میزان تیرگی را داشته باشد (توصیه می‌شود یک فاصله ' ' باشد). برای تصاویر کوچک‌تر، یک نگاشت با جزئیات کمتر پیشنهاد می‌شود. نویسه‌های از پیش گنجانده‌شده را می‌توان با آرگومان‌های 0 | 1 | 2 استفاده کرد. اگر هیچ نویسه‌ای مشخص نشود، از مجموعه پیش‌فرض استفاده خواهد شد.
-s, --size [پیش‌فرض: 80]: تغییر اندازه تصویر خروجی. حداقل اندازه ۲۰ است. مقادیر کمتر نادیده گرفته شده و به ۲۰ تغییر می‌یابند. این آرگومان با --width و --height تداخل دارد.
--height: استفاده از حداکثر ارتفاع ترمینال برای نمایش تصویر. این آرگومان با --size و --width تداخل دارد.
-w, --width: استفاده از حداکثر پهنای ترمینال برای نمایش تصویر. این آرگومان با --size و --height تداخل دارد.
--ratio [پیش‌فرض: 0.42]: تغییر نسبت بین ارتفاع و پهنا، از آنجا که نویسه‌های اسکی کمی بلندتر از پهنایشان هستند. مقدار باید بین 0.1 و 1.0 باشد. تغییر دادن این تنظیم توصیه نمی‌شود.
--flipX: قرینه‌سازی (معکوس کردن) تصویر در راستای محور X / به صورت افقی.
--flipY: قرینه‌سازی (معکوس کردن) تصویر در راستای محور Y / به صورت عمودی.
--centerX: قرار دادن تصویر در مرکز در راستای محور X / به صورت افقی در ترمینال.
--centerY: قرار دادن تصویر در مرکز در راستای محور Y / به صورت عمودی در ترمینال.
-o, --output: فایل خروجی برای اسکی بدون رنگ. اگر فایل خروجی یک فایل متن ساده (plaintext) باشد، از هیچ رنگی استفاده نخواهد شد. برای استفاده از رنگ، یا از فایلی با پسوند .ansi یا از یک فایل .svg/.html استفاده کنید تا خروجی به فرمت مربوطه تبدیل شود. فایل‌های .ansi هنگام ایجاد خروجی رنگی متغیرهای محیطی را در نظر می‌گیرند؛ به عنوان مثال، اگر متغیر COLORTERM روی truecolor تنظیم نشده باشد، فایل حاصل به رنگ‌های ۸ بیتی بازمی‌گردد.
--invert: معکوس کردن نویسه‌های استفاده‌شده برای تصویر، به طوری که نویسه‌های روشن مانند نویسه‌های تیره عمل کنند. اگر تصویر دارای پس‌زمینه تیره باشد، می‌تواند مفید باشد.
--background: تنظیم پس‌زمینه اسکی به عنوان رنگ. اگر ترمینال از truecolor پشتیبانی نکند، این مورد نادیده گرفته خواهد شد. این آرگومان با آرگومان --no-color ناسازگار و مانعة‌الجمع است.
--border: افزودن یک کادر تزیینی در اطراف تصویر اسکی. این کار به دلیل رعایت اندازه مشخص‌شده توسط کاربر، اندازه کلی تصویر را کمی کوچک‌تر می‌کند.
--no-color: عدم استفاده از رنگ هنگام چاپ تصویر در ترمینال.
--outline: فقط ایجاد یک طرح کلی (خطوط پیرامونی / Outline) از تصویر. این گزینه از فیلترها استفاده می‌کند، بنابراین به‌ویژه در تصاویر بزرگ‌تر، منابع و زمان بیشتری برای تکمیل نیاز دارد. ممکن است خروجی مطلوب را تولید نکند؛ توصیه می‌شود از این گزینه فقط برای تصاویری استفاده شود که تمایز واضحی بین پیش‌زمینه و پس‌زمینه دارند.
--hysteresis: هنگام ایجاد طرح کلی از روش پسماند (Hysteresis) استفاده می‌کند که نواقص را برطرف می‌سازد، اما ممکن است در قالب اسکی چندان جذاب به نظر نرسد. این گزینه نیازمند حضور آرگومان --outline نیز می‌باشد.
--verbose [پیش‌فرض: warn]: انتخاب سطح پرگویی لاگ‌ها (Logging). هشدارها و خطاها همیشه به صورت پیش‌فرض نمایش داده می‌شوند. برای غیرفعال کردن کامل آن‌ها، از مقدار off استفاده کنید.
مقادیر ممکن:

off: عدم نمایش لاگ‌ها
error: تنها نمایش خطاها
warn: نمایش خطاها و هشدارها
info: نمایش لاگ‌های اطلاعاتی (Info)
debug: نمایش لاگ‌های اشکال‌زدایی (Debug)
trace: نمایش لاگ‌های ردیابی دقیق (Trace)

-h, --help: نمایش راهنما (مشاهده خلاصه با '-h')
-V, --version: نمایش نسخه
<INPUT>: مسیرها یا آدرس‌های اینترنتی (URL) به تصویر هدف. اگر ورودی یک URL باشد، تصویر ابتدا دانلود شده و سپس تبدیل می‌شود. تصویر اصلی تغییر داده نمی‌شود.

نسخه (VERSION)

v3.0.0

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

@FineFindus