\
.\" 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 "Pamthreshold User Manual" 0 "06 June 2007" "netpbm documentation"

.SH "نام (NAME)"

pamthreshold \- آستانه‌گذاری تصویر در مقیاس خاکستری و تبدیل آن به سیاه و سفید

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

\fBpamthreshold\fP
[\fB-simple\fP]
[\fB-local=\fP\fIwidth\fP\fBx\fP\fIheight\fP]
[\fB-dual=\fP\fIwidth\fP\fBx\fP\fIheight\fP]
[\fB-threshold=\fP\fIthreshold\fP]
[\fB-contrast=\fP\fIthreshold\fP]
[\fIinputpamfile\fP]
.PP
کوتاه‌ترین پیشوند یکتای هر گزینه قابل قبول است. می‌توانید به جای یک
خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به
جای علامت مساوی از نویسه فاصله برای جدا کردن نام یک گزینه از مقدار آن استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamthreshold\fP یک تصویر در مقیاس خاکستری (grayscale) را آستانه‌گذاری می‌کند. آستانه‌گذاری به معنای
تقسیم تصویر به پس‌زمینه و پیش‌زمینه از طریق مقایسه هر پیکسل
با یک مقدار آستانه است.
.PP
ورودی باید یک تصویر PGM یا یک تصویر PAM با نوع چندتایی (tuple type)
GRAYSCALE یا GRAYSCALE_ALPHA باشد. با این حال، pamthreshold این موضوع را بررسی نمی‌کند؛ بلکه
صرفاً کانال نخست را مانند نمونه‌های مقیاس خاکستری آستانه‌گذاری می‌کند و
اگر کانال دومی وجود داشته باشد، آن را مانند یک کانال شفافیت
(آلفا) پردازش می‌نماید. بنابراین اگر به عنوان مثال یک تصویر PPM به آن بدهید،
کار خواهد کرد اما احتمالاً نتایج بی‌استفاده‌ای تولید می‌کند.
.PP
خروجی یک تصویر PAM با نوع چندتایی BLACKANDWHITE یا
BLACKANDWHITE_ALPHA خواهد بود، بسته به اینکه آیا ورودی دارای کانال شفافیت
بوده است یا خیر. می‌توانید با دستور \fBpamtopnm\fP این خروجی را به PBM تبدیل کنید (اگر نیاز دارید از آن در
برنامه‌های قدیمی‌تری استفاده کنید که PAM را پشتیبانی نمی‌کنند، یا نمی‌توانید
فضای ۸ برابری تصویر در فرمت PAM را تأمین کنید).
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
.PP
هنگامی که ورودی دارای کانال شفافیت باشد، \fBpamthreshold\fP یک
کانال شفافیت در خروجی نیز لحاظ می‌کند. از آنجا که خروجی دارای maxval برابر با ۱ است،
کانال شفافیت تنها می‌تواند نشان‌دهنده کاملاً شفاف یا کاملاً کدر باشد.
دستور \fBpamthreshold\fP نقاطی از تصویر را که ورودی در آن‌ها بیش
از نیمه‌شفاف است کاملاً شفاف، و نقاط دیگر را کاملاً کدر می‌سازد.
.PP
قابلیت شفافیت در Netpbm 10.43 (ژوئن ۲۰۰۸) اضافه شد. پیش
از آن، \fBpamthreshold\fP هرگونه کانال شفافیت موجود در ورودی را نادیده می‌گرفت.
.PP
روش دیگر برای تبدیل یک تصویر در مقیاس خاکستری به سیاه و سفید، استفاده از
ترام‌ریزی (dither) است. ترام‌ریزی استفاده از خوشه‌هایی از پیکسل‌های سیاه و سفید است، به‌گونه‌ای
که اگر کمی عقب‌تر بایستید و به تصویر بنگرید، سطوح مختلفی از
خاکستری را مشاهده می‌کنید. دستور \fBpamditherbw\fP عمل ترام‌ریزی را انجام می‌دهد.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمام برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، به 
.UR index.html#commonoptions
 گزینه‌های مشترک
.UE
\& مراجعه کنید)، \fBpamthreshold\fP گزینه‌های
خط فرمان زیر را می‌شناسد:
.PP
بدون تعیین هیچ گزینه‌ای، \fBpamthreshold\fP از روشی مبتنی بر
الگوریتم تکرارشونده‌ای استفاده می‌کند که در
مقاله 
.UR http://www.wikipedia.org
ویکی‌پدیا
.UE
\& با عنوان
.UR http://en.wikipedia.org/wiki/Thresholding_%28image_processing%29
 \fIThresholding (image processing)\fP
.UE
\& برای محاسبه مقدار آستانه‌گذاری
آمده است. (
.UR http://en.wikipedia.org/w/index.php?title=Thresholding_%28image_processing%29&oldid=132306976
این نگارش
.UE
\& از مقاله ویکی‌پدیا در زمان نگارش این متن جاری بود). این برنامه از این آستانه برای آستانه‌گذاری سراسری تصویر استفاده می‌کند.
این روش برای بیشتر تصاویر باید به‌خوبی کار کند. برنامه پیامی صادر می‌کند
که نشان می‌دهد از چه آستانه‌ای استفاده کرده است. (پیام‌های Netpbm به خروجی خطای
استاندارد ارسال می‌شوند و می‌توانید با گزینه عمومی \fB-quiet\fP در Netpbm
آن‌ها را خاموش کنید).
.PP
گزینه‌های \fB-simple\fP، \fB-local\fP و \fB-dual\fP روش‌های دیگر را
انتخاب می‌کنند.



.TP
\fB-simple\fP
این گزینه آستانه‌گذاری ساده یا سراسری (global) را انتخاب می‌کند،
یعنی \fBpamthreshold\fP هر پیکسل را با آستانه‌ای که با
\fB-threshold\fP مشخص کرده‌اید مقایسه می‌کند. پیکسل‌هایی با روشنایی بزرگ‌تر یا
مساوی آستانه سفید می‌شوند و سایر پیکسل‌ها سیاه می‌گردند. این روش برای
صفحات متنی سیاه و سفید اسکن‌شده با اسکنر مسطح به‌خوبی عمل می‌کند
و سریع‌تر از روش پیش‌فرض است که ابتدا مقدار آستانه‌گذاری را به صورت
تکرارشونده محاسبه می‌کند.

.TP
\fB-local=\fP\fIwidth\fP\fBx\fP\fIheight\fP
این گزینه آستانه‌گذاری تطبیقی محلی (که با نام آستانه‌گذاری پویا نیز
شناخته می‌شود) را با استفاده از همسایگی به صورت مربعی با عرض \fIwidth\fP پیکسل
و ارتفاع \fIheight\fP پیکسل به مرکزیت پیکسل مورد نظر انتخاب می‌کند.
دستور \fBpamthreshold\fP مقدار آستانه را به‌طور مجزا برای هر پیکسل از
تصویر محاسبه می‌نماید. این کار می‌تواند شرایط نوری متغیر در تصویر را مدیریت کند.
بسته به اندازه همسایگی، این عملیات می‌تواند بسیار کند باشد.

.TP
\fB-dual=\fP\fIwidth\fP\fBx\fP\fIheight\fP
این گزینه یک الگوریتم آستانه‌گذاری دوگانه را انتخاب می‌کند که از یک آستانه سراسری
برای همسایگی‌های با کنتراست پایین و از آستانه‌گذاری محلی برای سایر همسایگی‌ها استفاده می‌نماید. این
روش می‌تواند نواحی پس‌زمینه و پیش‌زمینه بزرگ‌تری را نسبت به آستانه‌گذاری تطبیقی محلی
حفظ کند. این الگوریتم در مقاله‌ای با عنوان
"An Approach To Licence Plate Recognition" توسط J.R. Parker و Pavol Federl ارائه شد.

.TP
\fB-threshold=\fP\fIthreshold\fP
مقدار آستانه‌گذاری را برای آستانه‌گذاری ساده یا محلی تعیین می‌کند. این
مقدار یک عدد ممیز شناور در بازه [0, 1] است که مستقیماً متناسب با
مقادیر نمونه Netpbm می‌باشد، به‌گونه‌ای که 0 متناظر با سیاه و 1 متناظر با maxval
تصویر است.
.sp
اگر این گزینه را تعیین نکنید، \fBpamthreshold\fP از آستانه
0.5 استفاده می‌کند.
.sp
بدون گزینه‌های \fB-simple\fP، \fB-local\fP یا \fB-dual\fP، این گزینه
بی‌معنی است.
.sp
مفهوم آستانه به نوع آستانه‌گذاری شما (که توسط سایر گزینه‌ها تعیین می‌شود)
بستگی دارد. به‌طور تقریبی، پیکسل‌هایی که روشنایی آن‌ها دست‌کم به اندازه
آستانه باشد در خروجی سفید می‌شوند و سایر پیکسل‌ها
سیاه می‌گردند.

.TP
\fB-contrast=\fP\fIthreshold\fP
این گزینه آستانه را برای تشخیص اینکه آیا یک همسایگی دارای کنتراست پایین
است یا خیر، برای آستانه‌گذاری دوگانه تعیین می‌کند. مقدار یک عدد ممیز شناور در
بازه [0, 1] است.
.sp
اگر این گزینه را تعیین نکنید، \fBpamthreshold\fP از آستانه کنتراست
0.05 استفاده می‌کند. بدون گزینه \fB-dual\fP این گزینه بی‌معنی است.




.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamditherbw" (1)\c
\&,
.BR "ppmtopgm" (1)\c
\&,
.BR "pamtopnm" (1)\c
\&,
.BR "pam" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamthreshold\fP در Netpbm 10.34 (ژوئن ۲۰۰۶) ارائه شد.

.UN author
.SH "نویسنده (AUTHOR)"
.PP
حق نشر \fBpamthreshold\fP متعلق به سال ۲۰۰۶ و Erik Auerswald است و تحت
مجوز
.BR "GPL" (1)\c
\& منتشر شده است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع
HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamthreshold.html
.PP