\
.\" 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 "Pbmclean User Manual" 0 "19 November 2011" "netpbm documentation"

.SH "نام (NAME)"
pbmclean \- پاک‌سازی لکه‌ها و نویزهای پراکنده از تصویر PBM

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

\fBpbmclean\fP
[\fB-minneighbors=\fP\fIN\fP]
[\fB-black\fP|\fB-white\fP]
[\fB-extended\fP]
[\fIpbmfile\fP]

.SH "نحوه استفاده از گزینه‌ها (OPTION USAGE)"
.PP
می‌توانید از کوتاه‌ترین پیشوند یکتای گزینه‌ها استفاده کنید. می‌توانید
به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید نام گزینه
را با فاصله به جای علامت مساوی از مقدار آن جدا نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBpbmclean\fP
لکه‌ها و نویزهای پراکنده (specks) را از تصویر PBM پاک می‌کند. این برنامه یک تصویر PBM را به عنوان ورودی خوانده و تصویر PBMای تولید می‌کند که مشابه ورودی است، با این تفاوت که پیکسل‌های ایزوله (تنها) در آن معکوس شده‌اند.
.PP
می‌توانید از
\fBpbmclean\fP
برای پاک‌سازی "برفک" (snow) روی تصاویر بیت‌مپ استفاده کنید.
.PP
دو روش وجود دارد که
\fBpbmclean\fP
می‌تواند پیکسل‌های "ایزوله" را تعریف کند:
ساده (basic) و گسترش‌یافته (extended). هنگامی که گزینه
\fB-extended\fP
را مشخص می‌کنید،
\fBpbmclean\fP
از حالت گسترش‌یافته استفاده می‌کند؛ در غیر این صورت از حالت پایه (basic) بهره می‌برد.

.UN basic
.SS "حالت پایه (Basic Mode)"
.PP
در حالت پایه،
\fBpbmclean\fP
هر پیکسل را به صورت جداگانه بررسی می‌کند، و هر پیکسلی که حداقل تعداد مشخصی پیکسل هم‌رنگ چسبیده به خود نداشته باشد، ایزوله تلقی شده و
\fBpbmclean\fP
آن را پاک (معکوس) می‌کند.
.PP
گزینه
\fB-minneighbors\fP
حداقل تعداد پیکسل‌های مجاور هم‌رنگ را مشخص می‌کند تا یک پیکسل ایزوله در نظر گرفته
\fIنشود\fP\fR.
.PP
برای مثال، اگر
\fB-minneighbors\fP
برابر با ۲ باشد و دو پیکسل سیاه پیوسته در یک پس‌زمینه سفید قرار داشته باشند، هر یک از این دو پیکسل ایزوله محسوب می‌شوند، بنابراین
\fBpbmclean\fP
آن‌ها را پاک می‌کند — یعنی هر دو را سفید می‌کند.
.PP
مقدار حداقل پیش‌فرض ۱ پیکسل است —
\fBpbmclean\fP
تنها پیکسل‌های کاملاً ایزوله را معکوس می‌کند.
.PP
(مقدار
\fB-minneighbors\fP
بزرگ‌تر از ۸ تصویری کاملاً معکوس تولید می‌کند (البته برای این کار از
\fBpnminvert\fP
استفاده کنید) — یا در صورت استفاده از گزینه
\fB-black\fP
یا
\fB-white\fP\fR،
تصویری کاملاً سفید یا کاملاً سیاه تولید می‌نماید).
.PP
برنامه
\fBpbmclean\fP
محدوده فراتر از لبه‌های تصویر را سفید فرض می‌کند. (این موضوع هنگام بررسی پیکسل‌های روی لبه‌های تصویر اهمیت دارد).
.PP
برنامه
\fBpbmclean\fP
تفاوتی میان پیش‌زمینه و پس‌زمینه قائل نمی‌شود؛ به صورت پیش‌فرض، پیکسل‌های ایزوله هر دو رنگ را معکوس می‌کند. اما می‌توانید با مشخص کردن
\fB-black\fP
یا
\fB-white\fP
تنظیم کنید که تنها پیکسل‌های یک رنگ را معکوس نماید.

.UN extended
.SS "حالت گسترش‌یافته (Extended Mode)"
.PP
در حالت گسترش‌یافته،
\fBpbmclean\fP
تمامی لکه‌ها (blobs) که حداقل تعداد پیکسل مشخص‌شده را ندارند پاک می‌کند. یک لکه، مجموعه‌ای از پیکسل‌های متصل به هم از رنگ پیش‌زمینه است. حداقل تعداد پیکسل‌ها برابر است با یک به علاوه مقدار
\fB-minneighbors\fP\fR.
شما رنگ پیش‌زمینه را با
\fB-black\fP
و
\fB-white\fP
مشخص می‌کنید (پیش‌فرض سیاه است).
.PP
به عنوان مثال، اگر
\fB-minneighbors\fP
برابر با ۲ باشد و رنگ پیش‌زمینه سیاه باشد، و تصویر حاوی یک خط مستقیم به طول ۴ پیکسل باشد،
\fBpbmclean\fP
آن را پاک می‌کند — یعنی هر چهار پیکسل را سفید می‌کند. همچنین
\fBpbmclean\fP
۴ پیکسل به شکل مربع یا L شکل را نیز پاک خواهد کرد.
.PP
مقدار پیش‌فرض
\fB-minneighbors\fP
برابر با ۴ است، بنابراین یک لکه باید حداقل ۵ پیکسل داشته باشد تا از پاک‌سازی
\fBpbmclean\fP
نجات یابد.
.PP
حالت گسترش‌یافته در Netpbm 10.56 (سپتامبر 2011) اضافه شد.


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


.TP
\fB-black\fP

.TP
\fB-white\fP
معکوس کردن پیکسل‌های با رنگ مشخص‌شده. به طور پیش‌فرض، اگر نه
\fB-black\fP
و نه
\fB-white\fP
را مشخص کنید،
\fBpbmclean\fP
هر دو پیکسل‌های سیاه و سفید را که تعداد کافی همسایه هم‌رنگ ندارند معکوس می‌کند. اگر
\fB-black\fP
را مشخص کنید،
\fBpbmclean\fP
پیکسل‌های سفید را دست‌نخورده باقی گذاشته و فقط پیکسل‌های سیاه ایزوله را پاک می‌کند. برعکس آن برای
\fB-white\fP
صادق است. می‌توانید هر دوی
\fB-black\fP
و
\fB-white\fP
را تعیین کنید تا رفتاری مشابه حالت پیش‌فرض داشته باشد.

.TP
\fB-minneighbors=\fP\fIN\fP
این گزینه مشخص می‌کند که چند پیکسل باید در یک خوشه حضور داشته باشند تا
\fBpbmclean\fP
آن‌ها را معتبر دانسته و از تصویر پاک نکند. به بخش
.UR #description
توضیحات
.UE
مراجعه کنید.
.sp
پیش از دسامبر 2001،
\fBpbmclean\fP
به جای
\fB-minneighbors\fP
مقدار
\fB-\fP\fIN\fP
را می‌پذیرفت. پیش از Netpbm 10.27 (مارس 2005)،
\fB-minneighbors\fP
به صورت
\fB-minneighbor\fP
بود.

.TP
\fB-extended\fP
برنامه
\fBpbmclean\fP
به جای روش پایه، از تشخیص گسترش‌یافته پیکسل‌های ایزوله استفاده می‌کند.
.sp
این گزینه در Netpbm 10.56 (سپتامبر 2011) جدید بود.



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

.UN author
.SH "نویسنده (AUTHOR)"

حق نشر (C) 1990 متعلق به Angus Duggan
حق نشر (C) 1989 متعلق به Jef Poskanzer.
حق نشر (C) 2001 متعلق به Michael Sternberg.
.PP
اجازه استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر مقصودی و بدون پرداخت هزینه بدین‌وسیله اعطا می‌شود، مشروط بر اینکه اطلاعیه حق نشر بالا در کلیه نسخه‌ها درج شده و هم این اطلاعیه حق نشر و هم این مجوز در مستندات پشتیبان قید شوند. این نرم‌افزار "همان‌طور که هست" (as is) و بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pbmclean.html
.PP