.\" 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 "Pbmmask User Manual" 0 "28 September 2021" "netpbm documentation"

.SH "نام (NAME)"

pbmmask \- ایجاد یک بیت‌مپ ماسک از یک بیت‌مپ معمولی

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

\fBpbmmask\fP
[\fB-expand\fP]
[\fIpbmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpbmmask\fP یک تصویر PBM را به عنوان ورودی خوانده و یک ماسک متناظر از نواحی پیش‌زمینه را به صورت یک تصویر PBM دیگر تولید می‌کند.
.PP
این دستور احتمالاً توسط \fBpambackground\fP منسوخ شده است.
  
.PP
رنگی که باید به عنوان «پس‌زمینه» تفسیر شود، به طور خودکار تعیین می‌شود. صرف‌نظر از اینکه چه رنگی پس‌زمینه است، ماسک در جایی که پس‌زمینه قرار دارد سفید و در جایی که شکل (سوژه) قرار دارد سیاه خواهد بود.
.PP
این قابلیت به شما اجازه می‌دهد تا برای اشیائی با پس‌زمینه سیاه، یک چسباندن ماسک‌شده (masked paste) مانند این انجام دهید:

.nf
    pbmmask obj > objmask
    pnmpaste < dest -and objmask <x> <y> | pnmpaste -or obj <x> <y>
.fi

برای اشیائی با پس‌زمینه سفید، می‌توانید آن‌ها را معکوس کنید یا یک مرحله اضافه نمایید:
.nf
    pbmmask obj > objmask
    pnminvert objmask | pnmpaste -and obj 0 0 > blackback
    pnmpaste < dest -and objmask <x> <y> | pnmpaste -or blackback <x> <y>
.fi

توجه داشته باشید که اگر اتلاف زمان برایتان اهمیتی ندارد، این نسخه سه‌مرحله‌ای برای اشیایی با پس‌زمینه سیاه نیز کار می‌کند.
.PP
همچنین می‌توانید با استفاده از ابزار \fIpnmarith\fP، از ماسک‌ها برای تصاویر در مقیاس خاکستری و رنگی نیز استفاده کنید. برای مثال:

.nf
    ppmtopgm obj.ppm | pamditherbw -threshold | pbmmask > objmask.pbm
    pnmarith -multiply dest.ppm objmask.pbm > t1.ppm
    pnminvert objmask.pbm | pnmarith -multiply obj.ppm - > t2.ppm
    pnmarith -add t1.ppm t2.ppm
.fi

یک حالت جالب دیگر این است که ماسک را پیش از استفاده، از طریق لوله (pipe) به \fIpnmsmooth\fP بفرستید. این کار مرز بین دو تصویر را نرم‌تر و ملایم‌تر می‌کند.

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


.TP
\fB-expand\fP
ماسک را به اندازه یک پیکسل به سمت خارج تصویر گسترش می‌دهد. این ویژگی زمانی مفید است که بخواهید یک حاشیه سفید کوچک در اطراف تصویر خود داشته باشید. (شاید یک راهکار بهتر این باشد که برنامه \fBpbmlife\fP به یک ابزار اتوماتای سلولی عمومی تبدیل شود...)



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pambackground" (1)\c
\&
.BR "ppmcolormask" (1)\c
\&،
.BR "pnmpaste" (1)\c
\&،
.BR "pnminvert" (1)\c
\&،
.BR "pnmarith" (1)\c
\&،
.BR "pnmsmooth" (1)\c
\&
.BR "pbm" (1)\c
\&،

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

حق نشر (C) ۱۹۸۸ متعلق به Jef Poskanzer است.

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpbmmask\fP یکی از قدیمی‌ترین برنامه‌ها در Netpbm است. در سپتامبر ۲۰۲۱، تاریخ درج‌شده روی این دفترچه راهنما ۸ اوت ۱۹۸۹ بود (که تاریخ آخرین به‌روزرسانی اساسی آن محسوب می‌شد). ما این صفحه را در آن زمان به‌روزرسانی کردیم تا صرفاً این اطلاعات تاریخی را اضافه کرده و استفاده از \fBpambackground\fP را توصیه نماییم.
.PP
به احتمال زیاد هنگامی که Bryan در سال ۲۰۰۶ برنامه \fBpambackground\fP را می‌نوشت، از وجود \fBpbmmask\fP بی‌اطلاع بوده است. در غیر این صورت، احتمالاً \fBpbmmask\fP را با یک پوسته واسط (wrapper) حول \fBpambackground\fP جایگزین می‌کرد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از منبع HTML تولید شده است. مستند اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pbmmask.html
.PP