\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pnmquant User Manual" 0 "09 February 2019" "netpbm documentation"

.SH "نام (NAME)"
pnmquant \- کوانتیزه کردن رنگ‌ها در یک تصویر Netpbm به یک مجموعه کوچک‌تر

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpnmquant\fP
[\fB-center\fP|\fB-meancolor\fP|\fB-meanpixel\fP]
[\fB-floyd\fP|\fB-fs\fP]
[\fB-nofloyd\fP|\fB-nofs\fP]
[\fB-spreadbrightness\fP|\fB-spreadluminosity\fP]
{[\fB-norandom\fP]|[\fB-randomseed=\fP\fIn\fP]}
\fIncolors\fP [\fIpnmfile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به‌جای یک خط تیره از دو خط تیره برای مشخص کردن یک گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن از فاصله یا علامت مساوی استفاده کنید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmquant\fP یک تصویر PNM را به عنوان ورودی می‌خواند. این دستور \fIncolors\fP رنگ را برای بهترین بازنمایی تصویر انتخاب می‌کند، رنگ‌های موجود را به رنگ‌های جدید نگاشت می‌نماید و یک تصویر PNM را به عنوان خروجی می‌نویسد.
.PP
این برنامه صرفاً ترکیبی از \fBpnmcolormap\fP و \fBpnmremap\fP است، به‌طوری که رنگ‌های ورودی با استفاده از یک نقشه رنگ که از روی رنگ‌های همان تصویر ورودی تولید شده است، بازنگاشت می‌شوند. گزینه‌ها همان معانی موجود در آن برنامه‌ها را دارند. برای درک عملکرد \fBpnmquant\fP به مستندات آن‌ها مراجعه کنید.
.PP
شاید در عمل کمتر از \fBncolors\fP رنگ در خروجی دریافت کنید؛ چرا که روشی که \fBpnmcolormap\fP برای انتخاب بهترین مجموعه رنگ‌ها برای تصویر به کار می‌برد با روشی که \fBpnmremap\fP برای تعیین بهترین رنگ از آن مجموعه جهت بازنمایی یک رنگ خاص استفاده می‌کند یکسان نیست. برای مثال، ممکن است \fBpnmcolormap\fP رنگ سالمون (salmon) را به عنوان بهترین نماینده برای یک پیکسل صورتی در ورودی در نقشه رنگ بگنجاند و رنگ مرجانی (coral) را به عنوان بهترین نماینده برای یک پیکسل مرجانی واقعی در ورودی در نقشه رنگ قرار دهد. اما \fBpnmremap\fP آزاد است که از هر رنگی در نقشه رنگ برای بازنمایی آن پیکسل صورتی استفاده کند و چه بسا تشخیص دهد که مرجانی تطابق نزدیک‌تری با صورتی دارد تا سالمون، و در نتیجه از مرجانی برای صورتی استفاده کند. در این صورت ممکن است \fBpnmremap\fP برای \fIهیچ\fP پیکسلی از سالمون استفاده نکند.
.PP
این هدررفتِ یک جایگاه در نقشه رنگ، پیامد روش تقریبی است که \fBpnmcolormap\fP به منظور محاسبه نقشه رنگ با حجم محاسبات عملی و معقول به کار می‌گیرد.


.UN separate
.SS اجرای جداگانه \fBpnmcolormap\fP و \fBpnmremap\fP

.PP
فراخوانی مستقیم \fBpnmcolormap\fP و \fBpnmremap\fP بسیار سریع‌تر از اجرای \fBpnmquant\fP است؛ زیرا بار پردازشی اضافی مفسر Perl و ایجاد دو فرایند اضافه را حذف می‌کنید. دستور \fBpnmquant\fP صرفاً جهت تسهیل کار است.
.PP
در اینجا نمونه‌ای از ارتباط میان این برنامه‌ها آورده شده است:
.PP
این دستور:

.nf
\f(CW
    $ pnmquant 256 myimage.pnm >/tmp/colormap.pnm >myimage256.pnm
\fP
.fi
.PP
اساساً معادل این عملیات است:

.nf
\f(CW
    $ pnmcolormap 256 myimage.pnm >/tmp/colormap.pnm
    $ pnmremap -mapfile=/tmp/colormap.pnm myimage.pnm >myimage256.pnm
\fP
.fi

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمام برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، به 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
مراجعه کنید)، \fBpnmquant\fP گزینه‌های خط فرمان زیر را به رسمیت می‌شناسد:

.UN pnmcolormapopt
.SS گزینه‌های ارسال‌شده به \fBpnmcolormap\fP

  
.PP
این گزینه‌ها انتخاب پالت رنگ را کنترل می‌کنند. این موارد گزینه‌های دستور
.BR "\fBpnmcolormap\fP" (1)\c
\& هستند.


.TP
\fB-center\fP
.TP
\fB-meancolor\fP
.TP
\fB-meanpixel\fP
.TP
\fB-spreadbrightness\fP
.TP
\fB-spreadluminosity\fP


.UN pnmremapopt
.SS گزینه‌های ارسال‌شده به \fBpnmremap\fP

  
.PP
این گزینه‌ها کنترل می‌کنند که برنامه از کدام رنگ پالت برای جایگزینی پیکسلی با رنگ مشخص از ورودی استفاده کند. این موارد گزینه‌های دستور
.BR "\fBpnmremap\fP" (1)\c
\& هستند.


.TP
\fB-floyd\fP
.TP
\fB-fs\fP
.TP
\fB-nofloyd\fP
.TP
\fB-nofs\fP
.TP
\fB-norandom\fP
.TP
\fB-randomseed\fP
.TP
\fB-norandom\fP


.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpnmquant\fP پیش از Netpbm 9.21 (ژانویه ۲۰۰۱) وجود نداشت.
پیش از آن، \fBppmquant\fP همین کار را انجام می‌داد، اما فقط روی تصاویر PPM کار می‌کرد.
دستور \fBppmquant\fP همچنان وجود دارد، اما صرفاً یک رابط فرانت‌اند (برای سازگاری نام) به \fBpnmquant\fP است.
.PP
گزینه \fB-version\fP پیش از Netpbm 10.75 (ژوئن ۲۰۱۶) وجود نداشت.
  
.PP
گزینه \fB-norandom\fP پیش از Netpbm 10.82 (مارس ۲۰۱۸) وجود نداشت.
  
.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmcolormap" (1)\c
\&,
.BR "pnmremap" (1)\c
\&,
.BR "pnmquantall" (1)\c
\&,
.BR "pamdepth" (1)\c
\&,
.BR "ppmdither" (1)\c
\&,
.BR "ppmquant" (1)\c
\&,
.BR "pnm" (1)\c
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmquant.html
.PP