.\" 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 "Pnmsmooth User Manual" 0 "19 December 2009" "netpbm documentation"

.SH "نام (NAME)"
pnmsmooth \- هموارسازی یک تصویر

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

\fBpnmsmooth\fP
[\fB-width=\fP\fIcols\fP] [\fB-height=\fP\fIrows\fP]
[\fIpnmfile\fP] [\fB-size\fP]
.PP
کوتاه‌ترین شکل یکتای اختصاری گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی از فاصله خالی (whitespace) برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmsmooth\fP با جایگزین کردن هر پیکسل با میانگین همسایه‌های عرض در ارتفاع (width X height) آن، تصویر را هموار می‌کند. این دستور به صورت برنامه‌ای پیاده‌سازی شده است که \fBpnmconvol\fP را با یک ماتریس کانولوشن مناسب فراخوانی می‌کند.

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


.TP
\fB-width=\fP\fIcols\fP
.TP
\fB-height=\fP\fIrows\fP
این گزینه‌ها ابعاد ماتریس کانولوشن را مشخص می‌کنند.
ابعاد پیش‌فرض ۳ در عرض و ۳ در ارتفاع است.
.sp
پیش از Netpbm 10.49 (دسامبر ۲۰۰۹)، بیشینه اندازه ماتریس کانولوشن توسط maxval تصویر محدود می‌شد؛ به طوری که حاصل‌ضرب width * height * 2 نباید از maxval تجاوز می‌کرد (در صورت نیاز از \fBpamdepth\fP برای افزایش maxval استفاده کنید).
.sp
این گزینه‌ها در Netpbm 10.32 (فوریه ۲۰۰۶) جدید بودند. پیش از آن، از \fB-size\fP استفاده می‌شد.

.TP
\fB-size\fP
این گزینه منسوخ‌شده برای حفظ سازگاری عقبرو در نسخه کنونی Netpbm وجود دارد. این گزینه در Netpbm 10.32 (فوریه ۲۰۰۶) توسط \fB-width\fP و \fB-height\fP منسوخ شد.
.sp
هنگامی که از این گزینه استفاده می‌کنید، دو آرگومان نخست برنامه به ترتیب عرض و ارتفاع ماتریس کانولوشن خواهند بود و کاری مشابه مقادیر گزینه‌های \fB-width\fP و \fB-height\fP انجام می‌دهند. آرگومان سوم برنامه (اختیاری) نام فایل ورودی است.
.sp
در واقع، در نسخه‌های قدیمی \fBpnmsmooth\fP، عرض و ارتفاع دو مقدار برای گزینه \fB-size\fP بودند، اما پارادایم نوین نحو دستورهای Netpbm گزینه‌ای با چند مقدار را مجاز نمی‌داند؛ بنابراین \fB-size\fP به گزینه‌ای بدون مقدار تبدیل شده و عرض و ارتفاع به صورت آرگومان‌های برنامه دریافت می‌شوند. این تغییر خوشبختانه باعث شده تا دستور زیر در نسخه کنونی \fBpnmsmooth\fP همان معنای نسخه قدیمی \fBpnmsmooth\fP را داشته باشد:
.nf
\f(CW
     pnmsmooth -size 5 5 infile.ppm >outfile.ppm
\fP
.fi

.TP
\fB-dump=\fP\fIdumpfile\fP
این گزینه باعث می‌شود \fBpnmsmooth\fP فقط ماتریس کانولوشن را نمایش دهد. این دستور مقداری برای گزینه \fB-matrix\fP در \fBpnmconvol\fP را که ماتریس را بازنمایی می‌کند در خروجی استاندارد می‌نویسد. این گزینه \fBpnmconvol\fP را فراخوانی نمی‌کند و هیچ تصویر خروجی‌ای تولید نمی‌کند.
.sp
پیش از Netpbm 10.49 (دسامبر ۲۰۰۹)، عملکرد این گزینه کاملاً متفاوت بود. این گزینه یک نام فایل را به عنوان مقدار می‌گرفت و ماتریس کانولوشن را به صورت یک فایل PGM (که ورودی معمول برای \fBpnmconvol\fP به شمار می‌رفت) در آن فایل می‌نوشت.





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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
پیش از Netpbm 10.32 (فوریه ۲۰۰۶)، \fBpnmsmooth\fP از تجزیه‌کننده نوین خط فرمان Netpbm استفاده نمی‌کرد و نحو خط فرمان نامتعارفی داشت. مهم‌تر از همه، نمی‌توانستید از علامت مساوی یا دو خط تیره در گزینه‌ها استفاده کنید.
.PP
پیش از Netpbm 10.49 (دسامبر ۲۰۰۹)، گزینه \fB-dump\fP وجود داشت. این گزینه نامتعارف باعث می‌شد \fBpnmsmooth\fP هیچ هموارسازی انجام ندهد و هیچ تصویر خروجی تولید نکند، بلکه ماتریس کانولوشنی را که قصد داشت استفاده کند، به صورت یک فایل PGM (مشابه آنچه \fBpnmconvol\fP استفاده می‌کرد) در فایلی که تعیین می‌کردید بنویسد. ایده این بود که سپس بتوانید از آن فایل در فراخوانی جداگانه‌ای از \fBpnmconvol\fP استفاده کنید.
.PP
سپس در Netpbm 10.49، گزینه \fB-dump\fP با عملکردی نسبتاً متفاوت اما هدفی مشابه ارائه شد: این گزینه باعث می‌شد \fBpnmsmooth\fP رشته‌ای مناسب به عنوان مقدار برای گزینه \fB-matrix\fP در \fBpnmconvol\fP (گزینه‌ای که در Netpbm 10.49 اضافه شده بود) در خطای استاندارد بنویسد.
.PP
اما در Netpbm 10.51 (ژوئن ۲۰۱۰)، \fBpnmconvol\fP استفاده از گزینه باز هم جدیدتر \fBpnmconvol\fP یعنی \fB-normalize\fP (معرفی‌شده در 10.50) را آغاز کرد؛ گزینه‌ای که تعیین ماتریس کانولوشن را برای نوع هموارسازی \fBpnmsmooth\fP بسیار ساده کرد، بنابراین گزینه \fB-dump\fP از \fBpnmsmooth\fP حذف شد.
.PP
(همچنین مسائل مربوط به سادگی پیاده‌سازی مانع از آن شد که بتوان گزینه اصلی \fB-dump\fP را صرفاً برای سازگاری عقبرو حفظ کرد: با اعمال تغییرات در \fBpnmsmooth\fP برای بهره‌گیری از ویژگی‌های جدید \fBpnmconvol\fP — که \fBpnmsmooth\fP در داخل خود از آن استفاده می‌کند — اطلاعات مورد نیاز برای پیاده‌سازی \fB-dump\fP دیگر در برنامه موجود نبود).
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' متعلق به Netpbm از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر در دسترس است:
.IP
.B http://netpbm.sourceforge.net/doc/pnmsmooth.html
.PP