.\" vi:set wm=5 .TH IMG2SIXEL 1 "Aug 2016" .if n .ds Q \&" .if n .ds U \&" .if t .ds Q `` .if t .ds U '' .UC 4 .SH "نام (NAME)" img2sixel \- مبدل تصویر به قالب گرافیکی DEC SIXEL .SH "خلاصه دستور (SYNOPSIS)" .B img2sixel [ \-\fIoptions\fP ] \fIimagefiles\fP .br .B img2sixel [ \-\fIoptions\fP ] < \fIimagefiles\fP .ta .5i 1.8i .SH "توضیحات (DESCRIPTION)" دستور \fIimg2sixel\fP تصاویر مختلف را به قالب تصویر باکیفیت DEC SIXEL تبدیل می‌کند. .SH "گزینه‌های خط فرمان (COMMAND-LINE OPTIONS)" دستور \fIimg2sixel\fP دارای گزینه‌های خط فرمان زیر است: .TP 5 .B \-o, \-\-outfile مشخص کردن نام فایل خروجی (پیش‌فرض: stdout). .TP 5 .B \-7, \-\-7bit-mode تولید یک تصویر sixel برای پایانه‌ها یا چاپگرهای ۷ بیتی (پیش‌فرض). .TP 5 .B \-8, \-\-8bit-mode تولید یک تصویر sixel برای پایانه‌ها یا چاپگرهای ۸ بیتی. .TP 5 .B \-R, \-\-gri-limit محدود کردن آرگومان‌های DECGRI(\(aq!\(aq) به ۲۵۵. .TP 5 .B \-p \fICOLORS\fP, \-\-colors=\fICOLORS\fP مشخص کردن تعداد رنگ‌ها جهت کاهش رنگ تصویر به آن (پیش‌فرض=۲۵۶). .TP 5 .B \-m \fIFILE\fP, \-\-mapfile=\fIFILE\fP تبدیل رنگ‌های تصویر برای مطابقت با این نگاشت رنگ‌های مشخص‌شده. .TP 5 .B \-e, \-\-monochrome خروجی تصویر sixel به صورت تک‌رنگ (سیاه‌وسفید). این گزینه فرض می‌کند که رنگ پس‌زمینه پایانه مشکی است. .TP 5 .B \-k, \-\-insecure اجازه اتصال به سایت‌های SSL بدون بررسی گواهی‌ها (تنها در صورتی فعال است که با --with-libcurl پیکربندی شده باشد) .TP 5 .B \-i, \-\-invert فرض کردن اینکه رنگ پس‌زمینه پایانه سفید است. تنها زمانی موثر است که گزینه \-e مشخص شده باشد. .TP 5 .B \-I, \-\-high-color خروجی تصویر sixel با عمق رنگ 15bpp .TP 5 .B \-u, \-\-use-macro استفاده از توالی‌های DECDMAC و DEVINVM برای بهینه‌سازی رندر پویانمایی GIF. .TP 5 .B \-n \fIMACRONO\fP, \-\-macro-number=\fIMACRONO\fP مشخص کردن یک آرگومان عددی برای DECDMAC و وادار کردن پایانه به ذخیره تصویر SIXEL در حافظه. در صورت مشخص شدن این گزینه هیچ تصویری نمایش داده نمی‌شود. .TP 5 .B \-C \fICOMPLEXIONSCORE\fP, \-\-complexion-score=\fICOMPLEXIONSCORE\fP مشخص کردن یک آرگومان عددی برای امتیاز تصحیح رنگ چهره. \fICOMPLEXIONSCORE\fP باید ۱ یا بیشتر باشد. .TP 5 .B \-g, \-\-ignore-delay رندر پویانمایی GIF بدون تاخیر. .TP 5 .B \-S, \-\-static رندر پویانمایی GIF به عنوان یک تصویر ایستا. .TP 5 .B \-d \fIDIFFUSIONTYPE\fP, \-\-diffusion=\fIDIFFUSIONTYPE\fP انتخاب روش دیفیوژن (پخش خطا) که همراه با کاهش رنگ استفاده می‌شود. .br \fIDIFFUSIONTYPE\fP یکی از این موارد است: .br auto -> انتخاب خودکار نوع دیفیوژن (پیش‌فرض) .br none -> بدون دیفیوژن .br fs -> روش Floyd-Steinberg .br atkinson -> روش Bill Atkinson .br jajuni -> روش Jarvis, Judice & Ninke .br stucki -> روش Stucki .br burkes -> روش Burkes .br a_dither -> خطاته‌رنگی (dither) حسابی پایدار از نظر موقعیت .br x_dither -> خطاته‌رنگی حسابی مبتنی بر xor پایدار از نظر موقعیت .TP 5 .B \-f \fIFINDTYPE\fP, \-\-find\-largest=\fIFINDTYPE\fP انتخاب روش برای یافتن بزرگ‌ترین بُعد جعبه‌های median cut جهت تقسیم؛ تنها زمانی موثر است که گزینه \-p (کاهش رنگ) مشخص شده باشد. .br \fIFINDTYPE\fP یکی از این موارد است: .br auto -> انتخاب خودکار روش جستجو (پیش‌فرض) .br norm -> مقایسه ساده بازه در فضای RGB .br lum -> تبدیل به درخشندگی‌ها پیش از مقایسه .TP 5 .B \-s \fISELECTTYPE\fP, \-\-select\-color=\fISELECTTYPE\fP انتخاب روش برای برگزیدن رنگ نماینده از هر جعبه median-cut؛ تنها زمانی موثر است که گزینه \-p (کاهش رنگ) مشخص شده باشد. .br \fISELECTTYPE\fP یکی از این موارد است: .br auto -> انتخاب خودکار روش گزینش (پیش‌فرض) .br center -> انتخاب مرکز جعبه .br average -> محاسبه میانگین رنگ درون جعبه .br histogram -> مشابه میانگین اما با در نظر گرفتن هیستوگرام رنگ .TP 5 .B \-c \fIREGION\fP, \-\-crop=\fIREGION\fP بریدن تصویر مبدا متناسب با هندسه مشخص‌شده. .br محدوده (REGION) باید در قالب \(aq%dx%d+%d+%d\(aq باشد. .TP 5 .B \-w \fIWIDTH\fP, \-\-width=\fIWIDTH\fP تغییر اندازه تصویر به عرض مشخص‌شده. .br \fIWIDTH\fP با ساختار دستوری زیر مشخص می‌شود: .br auto -> حفظ نسبت ابعاد (پیش‌فرض) .br % -> مقیاس‌بندی عرض با درصد مشخص‌شده .br -> مقیاس‌بندی عرض با تعداد پیکسل .br px -> مقیاس‌بندی عرض با تعداد پیکسل .TP 5 .B \-h \fIHEIGHT\fP, \-\-height=\fIHEIGHT\fP تغییر اندازه تصویر به ارتفاع مشخص‌شده. .br \fIHEIGHT\fP با ساختار دستوری زیر مشخص می‌شود: .br auto -> حفظ نسبت ابعاد (پیش‌فرض) .br % -> مقیاس‌بندی ارتفاع با درصد مشخص‌شده .br -> مقیاس‌بندی ارتفاع با تعداد پیکسل .br px -> مقیاس‌بندی ارتفاع با تعداد پیکسل .TP 5 .B \-r \fIRESAMPLINGTYPE\fP, \-\-resampling=\fIRESAMPLINGTYPE\fP انتخاب روش بازنمونه‌برداری (resampling) مورداستفاده با گزینه‌های \-w یا \-h (تغییر مقیاس). .br \fIRESAMPLINGTYPE\fP یکی از این موارد است: .br nearest -> روش Nearest-Neighbor .br gaussian -> فیلتر Gaussian .br hanning -> فیلتر Hanning .br hamming -> فیلتر Hamming .br bilinear -> فیلتر Bilinear (پیش‌فرض) .br welsh -> فیلتر Welsh .br bicubic -> فیلتر Bicubic .br lanczos2 -> فیلتر Lanczos-2 .br lanczos3 -> فیلتر Lanczos-3 .br lanczos4 -> فیلتر Lanczos-4 .TP 5 .B \-q \fIQUALITYMODE\fP, \-\-quality=\fIQUALITYMODE\fP انتخاب کیفیت کوانتش رنگ (color quantization). .br \fIQUALITYMODE\fP یکی از این موارد است: .br auto -> تعیین خودکار حالت کیفیت (پیش‌فرض) .br high -> حالت کیفیت بالا و سرعت پایین .br low -> حالت کیفیت پایین و سرعت بالا .br full -> حالت باکیفیت و سرعت دقیق .TP 5 .B \-l \fILOOPMODE\fP, \-\-loop\-control=\fILOOPMODE\fP انتخاب حالت کنترل تکرار (loop) برای پویانمایی GIF. .br auto -> رعایت تنظیمات سرآیند GIF (پیش‌فرض) .br force -> همیشه فعال کردن تکرار .br disable -> همیشه غیرفعال کردن تکرار.TP 5 .B \-t \fIPALETTETYPE\fP, \-\-palette\-type=\fIPALETTETYPE\fP انتخاب نوع فضای رنگی پالت. .br auto -> انتخاب نوع پالت به‌صورت خودکار (پیش‌فرض) .br hls -> استفاده از فضای رنگی HLS .br rgb -> استفاده از فضای رنگی RGB .TP 5 .B \-b \fIBUILTINPALETTE\fP, \-\-builtin\-palette=\fIBUILTINPALETTE\fP انتخاب نوع پالت توکار .br xterm16 -> نگاشت ۱۶ رنگ پیش‌فرض X .br xterm256 -> نگاشت ۲۵۶ رنگ پیش‌فرض X .br vt340mono -> نگاشت تک‌رنگ VT340 .br vt340color -> نگاشت رنگی VT340 .TP 5 .B \-E \fIENCODEPOLICY\fP, \-\-encode\-policy=\fIENCODEPOLICY\fP انتخاب سیاست کدگذاری .br auto -> انتخاب خودکار سیاست کدگذاری (پیش‌فرض) .br fast -> کدگذاری در سریع‌ترین زمان ممکن .br size -> کدگذاری به کوچک‌ترین دنباله sixel ممکن .TP 5 .B \-B \fIBGCOLOR\fP, \-\-bgcolor=\fIBGCOLOR\fP .br تعیین رنگ پس‌زمینه .br \fIBGCOLOR\fP با نحو زیر مشخص می‌شود: .br #rgb .br #rrggbb .br #rrrgggbbb .br #rrrrggggbbbb .br rgb:r/g/b .br rgb:rr/gg/bb .br rgb:rrr/ggg/bbb .br rgb:rrrr/gggg/bbbb .TP 5 .B \-P, \-\-penetrate گذر از GNU Screen با استفاده از توالی عبور مستقیم (pass-through) DCS. .TP 5 .B \-D, \-\-pipe\-mode [[منسوخ‌شده]] خواندن پیوسته تصاویر مبدأ از stdin. .TP 5 .B \-v, \-\-verbose نمایش اطلاعات اشکال‌زدایی. .TP 5 .B \-V, \-\-version نمایش اطلاعات نسخه و مجوز انتشار. .TP 5 .B \-H, \-\-help نمایش راهنما. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" \fIimg2sixel\fP گزینه‌های خط فرمان زیر را دارد: .TP 5 .B SIXEL_BGCOLOR .br تعیین رنگ پس‌زمینه. .br توسط گزینه -B (--bgcolor) لغو می‌شود. .br با نحو زیر مشخص می‌شود: .br #rgb .br #rrggbb .br #rrrgggbbb .br #rrrrggggbbbb .br rgb:r/g/b .br rgb:rr/gg/bb .br rgb:rrr/ggg/bbb .br rgb:rrrr/gggg/bbbb .br .TP 5 .B SIXEL_NCOLORS .br تعیین تعداد رنگ‌ها برای کاهش رنگ‌های تصویر (پیش‌فرض=۲۵۶). .br توسط گزینه -p (--colors) لغو می‌شود. .br .SH "بارگذارنده‌های تصویر (IMAGE LOADERS)" \fIimg2sixel\fP شامل دو یا چند مؤلفه رمزگشای تصویر است. .TP 5 .B stb_image \fIlibsixel\fP شامل \fIstb_image\fP است، یک بارگذارنده تصویر در مالکیت عمومی (public domain). .br \fIimg2sixel\fP از آن به‌عنوان رمزگشای توکار پیش‌فرض تصویر استفاده می‌کند. این مؤلفه می‌تواند تقریباً تمام تصاویر را رمزگشایی کند، اما تعداد اندکی از تصاویر به دلیل محدودیت‌های آن قابل رمزگشایی نیستند. .B قالب‌های مبدأ پشتیبانی‌شده: JPEG baseline و progressive (عدم پشتیبانی از 12 bpc/کدگذاری حسابی، مشابه کتابخانه پیش‌فرض IJG) PNG به‌صورت ۱/۲/۴/۸/۱۶ بیت بر کانال TGA (مشخص نیست کدام زیرمجموعه، در صورت وجود زیرمجموعه) BMP غیر 1bpp، غیر RLE PSD (فقط نمای ترکیبی، بدون کانال‌های اضافی) PIC (Softimage PIC) PNM (فقط PPM و PGM دودویی) .B محدودیت‌ها: عدم پشتیبانی از JPEG با ۱۲ بیت در هر کانال عدم پشتیبانی از JPEG با کدگذاری حسابی (arithmetic) / JPEG 2000 عدم پشتیبانی از BMP تک‌بیتی (1-bit) .TP 5 .B libpng اگر کتابخانه \fIlibpng\fP در زمان کامپایل پیوند داده شده باشد، \fIimg2sixel\fP از آن برای رمزگشایی تصویر PNG استفاده می‌کند. .TP 5 .B libjpeg اگر کتابخانه \fIlibjpeg\fP در زمان کامپایل پیوند داده شده باشد، \fIimg2sixel\fP از آن برای رمزگشایی تصویر JPEG استفاده می‌کند. .TP 5 .B gdk-pixbuf2 اگر کتابخانه \fIgdk-pixbuf2\fP در زمان کامپایل پیوند داده شده باشد، \fIimg2sixel\fP در برخی موارد به‌طور خودکار از آن استفاده می‌کند. .TP 5 .B GD اگر کتابخانه \fIGD\fP در زمان کامپایل پیوند داده شده باشد، \fIimg2sixel\fP در برخی موارد به‌طور خودکار از آن استفاده می‌کند. .TP 5 .B libsixel \fIimg2sixel\fP می‌تواند SIXEL را به‌عنوان قالب تصویر مبدأ بارگذاری کند، زیرا از \fIlibsixel\fP به‌عنوان رمزگشای تصویر SIXEL استفاده می‌کند..SH "تاریخچه (HISTORY)" کدگذارهای پیشین SIXEL (مانند \fIppmtosixel\fP) عمدتاً برای چاپگرهای سوزنی (dot-matrix) طراحی شده بودند. آن‌ها میزان مسافت حرکت هد چاپگر را به حداقل می‌رساندند. اما امروزه این روش بهترین کارایی را برای نمایش داده‌های sixel در شبیه‌سازهای ترمینال ارائه نمی‌دهد. داده‌های SIXEL کدگذاری‌شده برای ترمینال‌های VT-2xx/VT-3xx در Usenet دهه ۱۹۸۰ یافت شدند، اما به نظر می‌رسد فناوری نحوه ایجاد آن‌ها از بین رفته باشد. \fBkmiya's sixel\fP (kmiya، ۲۰۱۴) روش کدگذاری کارآمدی را معرفی می‌کند که برای شبیه‌سازهای ترمینال بازطراحی شده است تا سربار انتقال SIXEL را با حفظ سازگاری با ترمینال‌های پیشین SIXEL بهینه‌سازی کند. اکنون \fIlibsixel\fP و کدگذار sixel متعلق به \fIImageMagick\fP از آن پیروی می‌کنند. \fBAraki Ken\fP، که به عنوان نگه‌دارنده‌ی mlterm شناخته می‌شود، روشی را برای کدگذاری فشرده‌تر SIXEL پیشنهاد داد. اکنون \fIlibsixel\fP آن روش را به کار گرفته است. \fBAraki Ken\fP نحوه تولید SIXEL با کیفیت بالا را شرح می‌دهد. ببینید: http://mlterm.sourceforge.net/libsixel.pdf (به زبان ژاپنی). .SH "همچنین ببینید (SEE ALSO)" sixel(5) sixel2png(1) .SH "نویسندگان (AUTHORS)" نگه‌داری \fIimg2sixel\fP بر عهده Hayaki Saito است. ما کل کد \fIstb_image v2.12\fP، نوشته‌شده توسط Sean Barrett و مشارکت‌کنندگان آن را برای بارگذاری تصاویر گوناگون، و بخش‌هایی از کد \fIpnmquant.c (netpbm library)\fP را برای کوانتیزاسیون تصویر وارد کرده‌ایم. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" Copyright (c) 2014-2016 Hayaki Saito .PP بدین‌وسیله به هر شخصی که نسخه‌ای از این نرم‌افزار و پرونده‌های مستندات مرتبط («نرم‌افزار») را دریافت می‌کند، به رایگان اجازه داده می‌شود که بدون هیچ محدودیتی با نرم‌افزار رفتار کند، از جمله بدون محدودیت، حقوق استفاده، کپی، تغییر، ادغام، انتشار، توزیع، اعطای مجوز فرعی و/یا فروش نسخه‌های نرم‌افزار، و اجازه دادن به افرادی که نرم‌افزار در اختیار آن‌ها قرار می‌گیرد تا با رعایت شرایط زیر چنین کنند: .PP اعلان حق نشر بالا و این اعلان مجوز باید در تمام نسخه‌ها یا بخش‌های عمده نرم‌افزار گنجانده شود. .PP این نرم‌افزار «همان‌گونه که هست»، بدون هیچ‌گونه ضمانت صریح یا ضمنی، شامل اما نه محدود به ضمانت‌های تجاری بودن، مناسب بودن برای یک هدف خاص و عدم نقض حق دیگران ارائه می‌شود. در هیچ حالتی نویسندگان یا دارندگان حق نشر در قبال هرگونه ادعا، خسارت یا مسئولیت دیگر، خواه در یک دعوای قراردادی، شبه‌جرم یا غیر آن، که ناشی از یا در ارتباط با نرم‌افزار یا استفاده از آن یا سایر تعاملات با نرم‌افزار باشد، مسئولیتی نخواهند داشت. .SH "تشکر و قدردانی (THANKS)" این نرم‌افزار از پیاده‌سازی‌های زیر مشتق شده است. .br .TP 5 .B stb_image-v2.12 این نرم‌افزار شامل \fIstb_image-v2.12\fP (stb_image.h) است، یک خواننده‌ی JPEG/PNG در مالکیت عمومی (public domain). .br .B https://github.com/nothings/stb .TP 5 .B pnmquant.c (netpbm library) پیاده‌سازی الگوریتم median cut برای کوانتیزاسیون رنگ در quant.c از \fIpnmcolormap\fP موجود در \fInetpbm library\fP وارد شده است. .br http://netpbm.sourceforge.net .br \fIpnmcolormap\fP از \fIppmquant\fP مشتق شده که در اصل توسط Jef Poskanzer نوشته شده است. .br \fB .br Copyright (C) 1989, 1991 by Jef Poskanzer. .br .br Copyright (C) 2001 by Bryan Henderson. .br .br بدین‌وسیله مجوز استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر مقصودی و بدون پرداخت هزینه اعطا می‌شود، مشروط بر اینکه اطلاعیه حق نشر بالا در تمامی نسخه‌ها ذکر شود و هر دوی آن اطلاعیه حق نشر و این اطلاعیه مجوز در مستندات پشتیبان قید گردند. این نرم‌افزار «همان‌گونه که هست» بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود. \fP .TP 5 .B sixel 2014-3-2 بخش‌هایی از converters/loader.c از نسخه اصلی «sixel» اثر kmiya (2014-3-2) مشتق شده است. .br .br http://nanno.dip.jp/softlib/man/rlogin/sixel.tar.gz .br .br این بخش توسط kmiya@culti نوشته شده است. .br .br او آن را تحت مجوزی بسیار آسان‌گیر توزیع می‌کند که استفاده، کپی، تغییر، بازتوزیع و تمامی فعالیت‌های عمومی دیگر را بدون هرگونه محدودیتی مجاز می‌داند. .br .br او اعلام کرده است که این مجوز با MIT/BSD/GPL سازگار است. .SH "مراجع (REFERENCES)" .TP 5 .B resize.c (ImageMagick) ما چند فیلتر نمونه‌برداری مجدد (resampling) را با ارجاع به مجموعه‌ی فیلترهای resize.c در MagickCore اضافه کرده‌ایم. .br .B http://www.imagemagick.org/api/MagickCore/resize_8c_source.html .SH "مشارکت‌کنندگان (CONTRIBUTORS)" .nf Araki Ken (@arakiken) Markus Elfring (@elfring) Akinori Hattori (@hattya) isaki (@isaki68k) NOKUBI Takatsugu (@knok) Yasuhiro MATSUMOTO (@mattn) Masami HIRATA(@msmhrt) OBATA Akio (@obache) Izumi Tsutsui (@tsutsui) Iwamoto Kouichi (@ttdoda) haru (@uobikiemukot) Vertis Sidus (@vrtsds) Bruce Mitchener (@waywardmonkeys) Kazuhiro YOSHIKAWA (@yoshikaw) Turenar Yusuke Endoh mattn Akinori Hattori Øyvind Kolås Henri Salo (@fgeek) hongxu (@HongxuChen) pwd (@YourButterfly) Nicholas Luedtke (@nluedtke) cool-tomato (@cool-tomato) .fi.SH "گزارش باگ‌ها (BUGS)" .PD .IP \(bu گزارش‌های باگ، اصلاحات و بهبودها را به .BR saitoha@me.com ارسال کنید. .\" end of man page