\
.\" 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 "Pamsummcol User Manual" 0 "25 January 2009" "netpbm documentation"

.SH "نام (NAME)"
pamsummcol \- خلاصه‌سازی (مجموع، میانگین و غیره) یک تصویر Netpbm بر اساس ستون

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
\fBpamsummcol\fP
{
\fB-sum\fP |
\fB-mean\fP |
\fB-min\fP |
\fB-max\fP
}
[\fIimagefile\fP]
.PP
همهٔ گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید نام یک گزینه
و مقدار آن را به جای علامت مساوی با فاصله از هم جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
\fBpamsummcol\fP یک تصویر Netpbm (از نوع PNM یا PAM) را می‌خواند و یک تابع
خلاصه‌سازی را روی تمام سطرها در هر ستون (مجموع، میانگین و غیره) اجرا می‌کند.
این برنامه تصویری از همان نوع، با همان عرض و عمق (depth) تصویر ورودی،
و به ارتفاع یک سطر تولید می‌کند. مقادیر نمونه‌های (sample) خروجی نتیجهٔ این
خلاصه‌سازی هستند.
.PP
\fBpamsummcol\fP عملیات خلاصه‌سازی را روی هر plane به‌طور مستقل
انجام می‌دهد.
.PP
\fBpamsummcol\fP عملیات را بر روی مقادیر واقعی sample انجام می‌دهد،
نه بر روی شدت نوری که توسط آن‌ها نشان داده می‌شود در صورتی که تصویر
از نوع PGM یا PPM باشد.
.PP
اگر می‌خواهید به جای ستون، خلاصه‌سازی را بر اساس سطر انجام دهید، ابتدا ورودی را
به \fBpamflip\fP بدهید (و اگر می‌خواهید خروجی به جای یک سطر، یک تک‌ستون
باشد، مجدداً از \fBpamflip\fP استفاده کنید).
.PP
اگر می‌خواهید روی کل تصویر خلاصه‌سازی انجام دهید (و تصویری با یک تک‌تاپل یا one-tuple در
خروجی دریافت کنید)، از \fBpamsumm\fP برای دریافت یک سطر خلاصه استفاده کنید، با \fBpamflip\fP
آن را به یک ستون تبدیل کنید، و سپس دوباره از \fBpamsumm\fP برای خلاصه‌سازی ستون
استفاده نمایید.
.PP
اگر می‌خواهید نمونه‌های تکی در یک تصویر کامل را خلاصه کنید،
به جای تاپل (tuple)، از \fBpamsumm\fP استفاده کنید.
.PP
\fBpamsummcol\fP عملیات را بر روی مقادیر واقعی نمونه‌ها انجام می‌دهد،
نه بر روی شدت نوری که توسط آن‌ها نشان داده می‌شود در صورتی که
تصویر PGM یا PPM یا معادل PAM باشد. می‌توانید از
\fBpnmgamma\fP برای تبدیل چنین تصویری به تصویری با مقادیر متناسب
با شدت نور استفاده کنید و سپس \fBpamsummcol\fP را روی نتیجه اعمال نمایید.
.PP
می‌توانید به نتیجه‌ای مشابه \fBpamsummcol -mean\fP با استفاده از
\fBpamscale\fP برسید. فقط کافی است مقیاس تصویر را به‌صورت عمودی و بدون هیچ‌گونه
تغییر مقیاس افقی، به یک تک‌سطر تغییر دهید. از روش ترکیب پیکسل‌ها (pixel mixing) استفاده کنید.

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


.TP
\fB-sum\fP
.sp
این گزینه تابع خلاصه‌سازی را جمع قرار می‌دهد.
در هر ستون و plane از سطر خروجی، مقدار sample مجموع تمام
مقادیر sample در همان ستون و plane از ورودی است.
اگر نتیجه‌ای بزرگ‌تر از maxval تصویر باشد، به مقدار maxval
محدود (clip) می‌شود.

.TP
\fB-mean\fP
.sp
این گزینه تابع خلاصه‌سازی را میانگین حسابی قرار می‌دهد.
در هر ستون و plane از سطر خروجی، مقدار sample میانگین تمام
مقادیر sample در همان ستون و plane از ورودی است.

.TP
\fB-min\fP
.sp
این گزینه تابع خلاصه‌سازی را کمینهٔ حسابی قرار می‌دهد.
در هر ستون و plane از سطر خروجی، مقدار sample کمترین مقدار
از بین تمام مقادیر sample در همان ستون و plane از
ورودی است.

.TP
\fB-max\fP
.sp
این گزینه تابع خلاصه‌سازی را بیشینهٔ حسابی قرار می‌دهد.
در هر ستون و plane از سطر خروجی، مقدار sample بیشترین مقدار
از بین تمام مقادیر sample در همان ستون و
plane از ورودی است.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamsumm" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pamfunc" (1)\c
\&,
.BR "pamarith" (1)\c
\&,
.BR "pamscale" (1)\c
\&,
.BR "pam" (1)\c
\&,

.UN history
.SH "تاریخچه (HISTORY)"
.PP
\fBpamsummcol\fP در نسخهٔ ۱۰.۲۱ Netpbm (مارس ۲۰۰۴) اضافه شد.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' از Netpbm، از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamsummcol.html
.PP