.Dd 2013-02-25
.Dt pngquant 1
.Sh "نام (NAME)"
.Nm pngquant
.Nd مبدل PNG و فشرده‌ساز اتلافی تصاویر
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Aq options
.Op ncolors
.Pa file
.Op Ar
.Nm
.Aq options
.Op ncolors
.Fl
.Cm < Ns Pa file
.Cm > Ns Pa file
.Sh "توضیحات (DESCRIPTION)"
.Nm
تصاویر ۳۲ بیتی RGBA با فرمت PNG را به تصاویر PNG پالت‌دار ۸ بیتی (یا کوچک‌تر) با کانال آلفا (RGBA) تبدیل می‌کند، و به دلخواه می‌تواند از دیترینگ فلوید-اشتاینبرگ (Floyd-Steinberg) استفاده کند.
نام فایل خروجی همانند نام ورودی است، با این تفاوت که به
.Ql -fs8.png
یا
.Ql -or8.png
ختم می‌شود (مگر اینکه ورودی stdin باشد، که در این صورت تصویر کوانتیزه‌شده به stdout فرستاده می‌شود).
رفتار پیش‌فرض در صورت وجود داشتن فایل خروجی، صرف‌نظر کردن از فرایند تبدیل است؛ برای بازنویسی از
.Fl Fl force
استفاده کنید.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width -indent
.It Fl o Ar out.png , Fl Fl output Ar out.png
فایل تبدیل‌شده را در مسیر مشخص‌شده می‌نویسد. هنگامی که از این گزینه استفاده شود، تنها یک فایل ورودی مجاز است.
.It Fl Fl ext Ar new.png
پسوند فایل برای استفاده در فایل‌های خروجی به جای پیش‌فرض
.Ql -fs8.png
یا
.Ql -or8.png .
.It Fl f , Fl Fl force
بازنویسی فایل‌های خروجی موجود.
از
.Do
.Fl Fl ext
.Ar .png
.Fl Fl force
.Dc
می‌توان برای تبدیل فایل‌ها در جا (که ناامن است) استفاده کرد.
.It Fl Fl nofs , Fl Fl ordered
غیرفعال‌سازی دیترینگ فلوید-اشتاینبرگ (Floyd-Steinberg).
.It Fl Fl floyd Op Ar =N
تنظیم سطح دیترینگ با استفاده از یک عدد اعشاری بین
.Cm 0
(بدون دیترینگ) و
.Cm 1
(کامل، مقدار پیش‌فرض).
.It Fl s Ar N , Fl Fl speed Ar N
از
.Cm 1
(جستجوی جامع / brute-force) تا
.Cm 11
(سریع‌ترین). مقدار پیش‌فرض
.Cm 3
است. سرعت
.Cm 10
کیفیت را ۵٪ کاهش می‌دهد، اما حدود ۸ برابر سریع‌تر از حالت پیش‌فرض است. سرعت ۱۱ دیترینگ را غیرفعال کرده و سطح فشرده‌سازی را پایین می‌آورد.
.It Fl Q Ar min-max , Fl Fl quality Ar min-max
.Va min
و
.Va max
عددهایی در بازهٔ
.Cm 0
(بدترین) تا
.Cm 100
(عالی) هستند، مشابه با JPEG.
.Nm
از کمترین تعداد رنگ‌های مورد نیاز برای برآوردن یا فراتر رفتن از کیفیت
.Va max
استفاده خواهد کرد. اگر تبدیل منجر به کیفیتی کمتر از کیفیت
.Va min
شود، تصویر ذخیره نخواهد شد (یا اگر خروجی به stdin هدایت شود، نسخهٔ اصلی ۲۴ بیتی ارسال می‌شود) و pngquant با کد وضعیت
.Er 99
خارج خواهد شد.
.It Fl Fl skip-if-larger
اگر تبدیل منجر به فایلی بزرگ‌تر از فایل اصلی شود، تصویر ذخیره نخواهد شد و pngquant با کد وضعیت
.Er 98
خارج می‌شود. علاوه بر این، سود حاصل از کاهش حجم فایل باید بیشتر از میزان افت کیفیت باشد. اگر کیفیت ۵۰٪ کاهش یابد، انتظار می‌رود اندازهٔ فایل نیز ۵۰٪ کاهش یابد تا عملیات ارزشمند تلقی شود.
.It Fl Fl posterize Ar bits
کوتاه کردن تعداد کم‌ارزش‌ترین بیت‌های رنگ (در هر کانال). هنگامی از این گزینه استفاده کنید که تصویر قرار است در نمایشگرهایی با عمق رنگ کم نمایش داده شود (مانند RGB شانزده بیتی).
.Nm
پیکسل‌های تقریباً کدر را کاملاً کدر کرده و تعداد رنگ‌های نیمه‌شفاف را کاهش می‌دهد. در صورت فعال بودن این گزینه، پسوند پیش‌فرض نام فایل
.Ql -ie-fs8.png
یا
.Ql -ie-or8.png
خواهد بود.
.It Fl Fl strip
حذف بخش‌های اختیاری (متادیتا) از فایل‌های PNG.
.It Fl Fl transbug
راهکاری برای برنامه‌هایی که انتظار دارند رنگ کاملاً شفاف، آخرین مدخل پالت باشد.
.It Fl v , Fl Fl verbose
فعال‌سازی پیام‌های مشروح که پیشرفت کار و اطلاعات مربوط به ورودی/خروجی را نمایش می‌دهند. گزینهٔ معکوس آن
.Fl Fl quiet
است. خطاها صرف‌نظر از این گزینه، در
.Pa stderr
چاپ می‌شوند.
.It Fl V , Fl Fl version
نمایش نسخه در
.Pa stdout
و خروج.
.It Fl h , Fl Fl help
نمایش راهنما و خروج.
.El
.Sh "مثال‌ها (EXAMPLES)"
ایجاد یک تصویر جدید با کاهش تعداد رنگ‌ها به ۶۴:
.Bd -ragged -offset indent
.Nm
.Cm 64 image.png
.Ed
.Pp
تصویر حاصل ۶۴ رنگ خواهد داشت و با نام
.Pa image-fs8.png
ذخیره خواهد شد.
.Pp
بازنویسی در جای فایل تصویر در صورتی که بتوان بدون افت کیفیت شدید اندازهٔ آن را کاهش داد:
.Bd -ragged -offset indent
.Nm
.Cm -f --ext .png --quality 70-95 image.png
.Ed
.Sh "نویسندگان (AUTHORS)"
.Nm
توسط Kornel Lesinski
.Aq Mt kornel@pngquant.org
بر پایهٔ کدهای Greg Roelofs
.Aq Mt newt@pobox.com
توسعه یافته است.
.Pp
.Lk https://pngquant.org "وبگاه pngquant" .