diff options
Diffstat (limited to 'upstream/fedora-40/man1/pamsummcol.1')
-rw-r--r-- | upstream/fedora-40/man1/pamsummcol.1 | 142 |
1 files changed, 142 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pamsummcol.1 b/upstream/fedora-40/man1/pamsummcol.1 new file mode 100644 index 00000000..92455eda --- /dev/null +++ b/upstream/fedora-40/man1/pamsummcol.1 @@ -0,0 +1,142 @@ +\ +.\" 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 - summarize (sum, average, etc) a Netpbm image by column + +.UN synopsis +.SH SYNOPSIS +\fBpamsummcol\fP +{ +\fB-sum\fP | +\fB-mean\fP | +\fB-min\fP | +\fB-max\fP +} +[\fIimagefile\fP] +.PP +All options can be abbreviated to their shortest unique prefix. +You may use two hyphens instead of one. You may separate an option +name and its value with white space instead of an equals sign. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamsummcol\fP reads a Netpbm image (PNM or PAM) and performs a +summary function over all the rows in each column (sum, mean, etc.). +It produces an image of the same kind that the same width and depth as +the input, and one row high. Its sample values are the result of the +summary. +.PP +\fBpamsummcol\fP performs the summary operation on each plane +independently. +.PP +\fBpamsummcol\fP performs the operation on the actual sample values, +not on the light intensities represented by them in the case that the +image is a PGM or PPM image. +.PP +If you want to summarize by row instead of by column, run the input +through \fBpamflip\fP first (and if you want the output to be a single +column instead of a single row, use \fBpamflip\fP again). +.PP +If you want to summarize over the entire image (getting a one-tuple +output image), use \fBpamsumm\fP to get a summary row, \fBpamflip\fP +to turn that into a column, the \fBpamsumm\fP again to summarize the +column. +.PP +If you want to summarize the individual samples in an entire image, +instead of by tuple, use \fBpamsumm\fP. +.PP +\fBpamsummcol\fP performs the operation on the actual sample values, +not on the light intensities represented by them in the case that the +image is a PGM or PPM image or PAM equivalent. You can use +\fBpnmgamma\fP to convert such an image to one with samples proportional +to light intensity, and then use \fBpamsummcol\fP on the result. +.PP +You can achieve the same thing as \fBpamsummcol -mean\fP with +\fBpamscale\fP. Just scale vertically to a single row, without scaling +horizontally at all. Use the pixel mixing method. + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBpamsummcol\fP recognizes the following +command line options: +.PP +You must specify exactly one of \fB-sum\fP, \fB-mean\fP, +\fB-min\fP, or \fB-max\fP. + + +.TP +\fB-sum\fP +.sp +This option makes the summary function addition. + In each column and plane of the output row, the sample value is the + sum of all the samples values in the same column and plane of the input. + If a result is greater than the image maxval, it is clipped to + the maxval. + +.TP +\fB-mean\fP +.sp +This option makes the summary function arithmetic mean. + In each column and plane of the output row, the sample value is the + mean of all the samples values in the same column and plane of the input. + +.TP +\fB-min\fP +.sp +This option makes the summary function arithmetic minimum. + In each column and plane of the output row, the sample value is the + minimum of all the samples values in the same column and plane of + the input. + +.TP +\fB-max\fP +.sp +This option makes the summary function arithmetic maximum. + In each column and plane of the output row, the sample value is + the maximum of all the samples values in the same column and + plane of the input. + + + +.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 was added to Netpbm in Release 10.21 (March +2004). +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/pamsummcol.html +.PP
\ No newline at end of file |