.\" 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 "Ppmchange User Manual" 0 "December 2016" "netpbm documentation"

.SH "نام (NAME)"
ppmchange \- تغییر تمام پیکسل‌های یک رنگ به رنگی دیگر در یک تصویر PPM

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

\fBppmchange\fP

[\fB-closeness=\fP\fIcloseness_percent\fP]
[\fB-remainder=\fP\fIremainder_color\fP]
[\fB-closeok\fP]
[\fIoldcolor newcolor\fP] ...
[\fIppmfile\fP]

.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
\fBppmchange red blue redimage.ppm >blueimage.ppm\fP

\fBppmchange red red -remainder=black myimage.ppm >redblack.ppm\fP

\fBppmchange -closeness=10 white white black black\fP

.fi

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmchange\fP یک تصویر PPM را به عنوان ورودی می‌خواند و تمام پیکسل‌های به رنگ \fIoldcolor\fP را به رنگ \fInewcolor\fP تغییر می‌دهد.

شما می‌توانید تا ۲۵۶ جفت oldcolor/newcolor را در خط فرمان مشخص کنید. \fBppmchange\fP تمام رنگ‌هایی را که ذکر نشده‌اند بدون تغییر باقی می‌گذارد، مگر اینکه گزینهٔ \fB-remainder\fP را تعیین کنید که در این صورت همهٔ آن‌ها به همان تک‌رنگِ مشخص‌شده تغییر می‌یابند.
.PP
شما می‌توانید با تعیین یک ضریب «نزدیکی» (closeness)، مشخص کنید که رنگ‌های مشابه (اما نه لزوماً یکسان) با رنگ‌های تعیین‌شده نیز جایگزین شوند.
.PP
رنگ‌ها را همان‌گونه که برای آرگومان
.UR libnetpbm_image.html#colorname
روتین کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& شرح داده شده است مشخص کنید.
.PP
اگر یک پیکسل با دو \fIoldcolor\fP متفاوت مطابقت داشته باشد، \fBppmchange\fP آن را با \fInewcolor\fP مربوط به موردی که در سمت چپ‌تر قرار دارد جایگزین می‌کند.
.PP
مقدار maxval در تصویر خروجی همانند تصویر ورودی است. اگر یک \fInewcolor\fP تعیین‌شده نتواند دقیقاً در آن maxval بازنمایی شود، \fBppmchange\fP رنگی را در نظر می‌گیرد که تا جای ممکن به آنچه مشخص کرده‌اید نزدیک باشد اما در آن maxval قابل نمایش باشد. مگر اینکه گزینهٔ \fB-closeok\fP را مشخص کنید، در غیر این صورت \fBppmchange\fP هشداری مبنی بر استفاده از تقریب صادر می‌کند.
.PP
یک حالت معمول که ممکن است با این مشکل maxval مواجه شوید (جایی که رنگ مشخص‌شده قابل نمایش با maxval شما نیست)، زمانی است که ورودی شما یک تصویر PBM (سیاه و سفید) باشد که قصد رنگ‌آمیزی آن را دارید. مقدار maxval در این حالت ۱ است که شدیداً رنگ‌هایی را که می‌توانید به آن‌ها تغییر دهید محدود می‌کند. برای رفع این مشکل، از \fBpamdepth\fP استفاده کنید تا maxval ورودی خود را به مقداری سازگار با رنگ‌هایتان تبدیل کنید. مقدار ۲۵۵ معمولاً یک انتخاب مناسب است.
.PP
پیش از Netpbm 10.22 (آوریل ۲۰۰۴)، \fBppmchange\fP همواره به‌گونه‌ای رفتار می‌کرد که گویی کاربر \fB-closeok\fP را مشخص کرده است، و گزینه‌ای به نام \fB-closeok\fP وجود نداشت.


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


.TP
\fB-closeness \fP\fIcloseness_percent\fP
مقدار \fIcloseness\fP یک درصد است که نشان می‌دهد یک پیکسل تا چه اندازه باید به رنگ مشخص‌شده نزدیک باشد تا جایگزین شود. به‌طور پیش‌فرض، مقدار آن ۰ است؛ به این معنی که پیکسل باید دقیقاً همان رنگ مشخص‌شده باشد.
.sp
یک پیکسل زمانی جایگزین می‌شود که فاصلهٔ رنگی بین آن و رنگ مشخص‌شده، کمتر یا مساوی با \fIcloseness\fP درصد از maxval باشد.
.sp
«فاصله» در رنگ به عنوان مجموع دکارتی تفاوت‌های منفرد در شدت‌های قرمز، سبز و آبی بین دو پیکسل تعریف می‌شود که به‌گونه‌ای نرمال‌سازی شده است که تفاوت بین سیاه و سفید ۱۰۰٪ باشد.
.sp
این احتمالاً ساده‌تر از چیزی است که بیشتر اوقات مد نظر شماست. شما احتمالاً ترجیح می‌دهید رنگ‌هایی را که فام (chrominance) مشابهی دارند، صرف‌نظر از شدت روشنایی‌شان تغییر دهید. بنابراین اگر یک انبار قرمز رنگ وجود دارد که سایه‌های مختلفی روی آن افتاده، شما می‌خواهید کل انبار تغییر کند. اما از آنجا که سایه‌ها رنگ را طبق فرمول فاصلهٔ \fBppmchange\fP به‌طور چشمگیری تغییر می‌دهند، بخش‌هایی از انبار احتمالاً از لحاظ فاصلهٔ رنگی به همان اندازه که از چمن سبز کنار انبار فاصله دارند، از بخش‌های دیگر انبار نیز فاصله خواهند داشت.
.sp
شاید روزی \fBppmchange\fP برای انجام تحلیل فام ارتقا یابد.
.sp
این گزینه در Netpbm 9.8 (سپتامبر ۲۰۰۰) اضافه شد.

.TP
\fB-closeok\fP
این گزینه بر نحوهٔ تفسیر رنگی که در آرگومان‌ها مشخص می‌کنید توسط \fBppmchange\fP تأثیر می‌گذارد. هنگامی که این گزینه را مشخص کنید، \fBppmchange\fP ممکن است از رنگی نزدیک به رنگ مشخص‌شده (اما نه دقیقاً همان) استفاده کند. برای جزئیات به
.UR #description
بخش توضیحات
.UE
\& مراجعه کنید.
.sp
این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد. پیش از آن، \fBppmchange\fP همواره به‌گونه‌ای رفتار می‌کرد که گویی این گزینه مشخص شده است.
     
.TP
\fB-remainder \fP\fIcolor\fP
برنامهٔ \fBppmchange\fP تمام پیکسل‌هایی را که رنگ آن‌ها برابر با رنگی نیست که برای آن یک رنگ جایگزین صریح در خط فرمان تعیین کرده‌اید، به رنگ \fIcolor\fP تغییر می‌دهد.
.sp
یک کاربرد نمونه از این گزینه:

.nf
\fBppmchange -remainder=black red red\fP
.fi

برای استخراج تنها بخش‌های قرمز از یک تصویر است، یا
.nf
\fBppmchange -remainder=black red white | ppmtopgm\fP
.fi

برای ایجاد یک فایل ماسک (mask) برای بخش‌های قرمز تصویر.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pgmtoppm" (1)\c
\&،
.BR "ppmcolormask" (1)\c
\&،
.BR "ppm" (1)\c
\&

.UN author
.SH "نویسندگان (AUTHORS)"

Wilson H. Bent. Jr. (\fIwhb@usc.edu\fP)
با اعمال تغییرات توسط Alberto Accomazzi (\fIalberto@cfa.harvard.edu\fP)
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار Netpbm به نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmchange.html
.PP