.\" 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 "Ppmcolormask User Manual" 0 "01 May 2006" "netpbm documentation"

.SH "نام (NAME)"
ppmcolormask \- تولید ماسک از نواحی دارای رنگی خاص در یک فایل PPM

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

\fBppmcolormask\fP \fB-color=\fP\fIcolor_list\fP [\fIppmfile\fP]
.PP
\fBppmcolormask\fP \fIcolor\fP [\fIppmfile\fP]

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

.nf
\f(CW
    ppmcolormask -color red testimg.ppm >redmask.pbm
    pamcomp background.ppm testimg.ppm -alpha=redmask.pbm >test.ppm

    ppmcolormask -color=red,pink,salmon testimg.ppm >reddishmask.pbm

    ppmcolormask -color=bk:red,bk:orange,bk:yellow testimg.ppm >firemask.pbm

\fP
.fi

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmcolormask\fP یک فایل PPM را به عنوان ورودی خوانده و یک فایل PBM
(بیت‌مپ) به عنوان خروجی تولید می‌کند. فایل خروجی دارای ابعادی یکسان با
فایل ورودی است و در تمام نقاطی که رنگ فایل ورودی با رنگ مشخص‌شده در
گزینهٔ \fB-color\fP مطابقت داشته باشد، سیاه و در سایر نقاط سفید خواهد بود.
.PP
خروجی \fBppmcolormask\fP به عنوان یک ورودی ماسک شفافیت (transparency mask) برای
\fBpamcomp\fP مفید است. توجه داشته باشید که اگر در نهایت قصد تبدیل به PNG با
استفاده از \fBpnmtopng\fP را دارید، نیازی به \fBppmcolormask\fP و \fBpamcomp\fP
ندارید؛ زیرا گزینهٔ \fB-transparent\fP در \fBpnmtopng\fP همین کار را انجام می‌دهد.
.PP
\fIppmfile\fP فایل ورودی است. اگر \fIppmfile\fP را مشخص نکنید،
ورودی از ورودی استاندارد (Standard Input) دریافت می‌شود.
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
.PP
در نحو قدیمی و منسوخ‌شده، مشخص کردن \fIcolor\fP
تنها یک رنگ دقیق را برای ماسک شدن تعیین می‌کند.
.PP
دستور \fBppmchange\fP کار مشابهی انجام می‌دهد: با تغییر رنگ‌های تعیین‌شده توسط شما
به رنگ‌های دیگری که مشخص می‌کنید، تصویر را اصلاح می‌کند. این دو برنامه روش‌های
متفاوتی برای تعیین رنگ‌ها در تصویر ورودی فراهم می‌آورند.
.PP
برای ایجاد ماسک از پس‌زمینهٔ یک تصویر، بدون نیاز به تعیین رنگ آن،
از \fBpambackground\fP استفاده کنید.

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


.TP
\fB-color=\fP\fIcolor_list\fP
این گزینهٔ اجباری رنگ‌هایی را مشخص می‌کند که باید ماسک شوند
(هر جا که تصویر یکی از این رنگ‌ها باشد، ماسک خروجی سیاه خواهد بود).
.sp
مثال‌ها:


.IP \(bu
\fB-color=red\fP
.IP \(bu
\fB-color=red,pink,salmon\fP
.IP \(bu
\fB-color=rgb:80/80/ff\fP
.IP \(bu
\fB-color=bk:red,bk:orange,bk:yellow\fP

.sp
\fIcolor_list\fP فهرستی از رنگ‌ها است که با کاما از یکدیگر جدا شده‌اند. هر
رنگ یا یک نام دقیق رنگ است، همان‌طور که برای
.UR libnetpbm_image.html#colorname
آرگومان روتین کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& شرح داده شده است، یا یکی از
.UR libppm.html#berlinkay
نام‌های رنگ Berlin-Kay
.UE
\& است. در حالت دوم، تمام رنگ‌هایی که با آن نام رنگ Berlin-Kay نسبت به هر
رنگ دیگری بهتر توصیف می‌شوند، در مجموعهٔ ماسک قرار می‌گیرند.
.sp
الگوریتمی که \fBppmcolormask\fP برای تطبیق نام رنگ Berlin-Kay با رنگ‌ها استفاده
می‌کند، مبتنی بر یک سیستم استنتاج فازی نوع سوگنو (Sugeno) است که توسط \fIKenan Kalajdzic\fP
در سال ۲۰۰۶ توسعه یافته است. این مدل فازی شامل توابع عضویت پاره‌خطی تعریف‌شده
در فضای رنگی HSV است. اگرچه الگوریتم‌های پیچیده‌تری برای تطبیق رنگ فازی وجود دارند،
این الگوریتم عمداً ساده‌سازی شده است تا با کدی نسبتاً فشرده به سرعتی رضایت‌بخش دست یابد.
.sp
این گزینه در Netpbm 10.34 (ژوئن ۲۰۰۶) معرفی شد. پیش از آن،
باید از آرگومان \fIcolor\fP استفاده می‌کردید و امکان تعیین رنگ‌های Berlin-Kay وجود نداشت.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamfind" (1)\c
\&,
.BR "pambackground" (1)\c
\&,
.BR "ppmchange" (1)\c
\&,
.BR "pgmtoppm" (1)\c
\&,
.BR "pamcomp" (1)\c
\&,
.BR "pbmmask" (1)\c
\&,
.BR "pnmtopng" (1)\c
\&,
.BR "ppm" (1)\c
\&
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML
تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmcolormask.html
.PP