From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/opensuse-leap-15-6/man1/pnmsmooth.1 | 135 +++++++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 upstream/opensuse-leap-15-6/man1/pnmsmooth.1 (limited to 'upstream/opensuse-leap-15-6/man1/pnmsmooth.1') diff --git a/upstream/opensuse-leap-15-6/man1/pnmsmooth.1 b/upstream/opensuse-leap-15-6/man1/pnmsmooth.1 new file mode 100644 index 00000000..bc73c869 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/pnmsmooth.1 @@ -0,0 +1,135 @@ +\ +.\" 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 - smooth out an image + +.UN synopsis +.SH SYNOPSIS + +\fBpnmsmooth\fP +[\fB-width=\fP\fIcols\fP] [\fB-height=\fP\fIrows\fP] +[\fIpnmfile\fP] [\fB-size\fP] +.PP +Minimum unique abbreviations of options is acceptable. You may use double +hyphens instead of single hyphen to denote options. You may use white +space in place of the equals sign to separate an option name from its value. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpnmsmooth\fP smoothes out an image by replacing each pixel with the +average of its width X height neighbors. It is implemented as a progam that +invokes \fBpnmconvol\fP with an appropriate convolution matrix. + +.UN options +.SH OPTIONS + + +.TP +\fB-width=\fP\fIcols\fP +.TP +\fB-height=\fP\fIrows\fP +These options specify the dimensions of the convolution matrix. +Default dimensions are 3 wide and 3 high. +.sp +Before Netpbm 10.49 (December 2009), the maximum size of the convolution +matrix is limited by the maxval of the image such that width * height * 2 must +not exceed the maxval. (use \fBpamdepth\fP to increase the maxval if +necessary). +.sp +These options were new in Netpbm 10.32 (February 2006). Before that, +use \fB-size\fP. + +.TP +\fB-size\fP +This deprecated option exists in current Netpbm for backward +compatibility. It was obsoleted by \fB-width\fP and \fB-height\fP +in Netpbm 10.32 (February 2006). +.sp +When you use this option, the first two program arguments are the width +and height, respectively, of the convolution matrix and do the same thing +as the \fB-width\fP and \fB-height\fP option values. The third +(optional) program argument is the input file name. +.sp +In reality, in old \fBpnmsmooth\fP, the width and height are two +values of the \fB-size\fP option, but the modern Netpbm command syntax +paradigm doesn't allow an option with multiple values, so instead +\fB-size\fP is an option with no value and width and height are program +arguments. That has the fortunate effect of making the following command +mean the same in current \fBpnmsmooth\fP as in old \fBpnmsmooth\fP: +.nf +\f(CW + pnmsmooth -size 5 5 infile.ppm >outfile.ppm +\fP +.fi + +.TP +\fB-dump=\fP\fIdumpfile\fP +This options makes \fBpnmsmooth\fP only show you the +convolution matrix. It writes to Standard Output a \fBpnmconvol\fP +\fB-matrix\fP option value that represents the matrix. It does not +invoke \fBpnmconvol\fP and does not produce an output image. +.sp +Before Netpbm 10.49 (December 2009), this option is rather different. +It takes a file name as a value, and it writes to that file the +convolution matrix as a PGM file (as used to be the normal input for +\fBpnmconvol\fP). + + + + + +.UN seealso +.SH SEE ALSO +.BR "pnmconvol" (1)\c +\&, +.BR "pnm" (5)\c +\& + +.UN history +.SH HISTORY +.PP +Before Netpbm 10.32 (February 2006), \fBpnmsmooth\fP did not use +the modern Netpbm command line parser, so had an unconventional command line +syntax. Most importantly, you could not use an equal sign or double +hyphens in the options. +.PP +Before Netpbm 10.49 (December 2009), there was a \fB-dump\fP option. +This strange option caused \fBpnmsmooth\fP not to do any smoothing or +produce any output image but instead write the convolution matrix it +would have used, as PGM file such as \fBpnmconvol\fP used to use, to +a file you specify. The idea was you could then use that file with a +separate invocation of \fBpnmconvol\fP. +.PP +Then, in Netpbm 10.49, there was a rather different \fB-dump\fP +option with a similar purpose: It caused \fBpnmsmooth\fP to write to +Standard Error a string suitable as a value for the \fBpnmconvol\fP +\fB-matrix\fP option (an option that was new in Netpbm 10.49). +.PP +But in Netpbm 10.51 (June 2010), \fBpnmconvol\fP started using the even +newer \fBpnmconvol\fP \fB-normalize\fP option (new in 10.50), which made +specifying the convolution matrix for the kind of smoothing that +\fBpnmsmooth\fP does trivial, so \fB-dump\fP disappeared from +\fBpnmsmooth\fP. +.PP +(There were also ease of implementation issues that kept us from simply +keeping the original \fB-dump\fP around for backward compatibility: As we +modified \fBpnmsmooth\fP to take advantage of the new features of +\fBpnmconvol\fP, which \fBpnmsmooth\fP uses internally, the information +needed to implement \fB-dump\fP was no longer available in the program). +.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/pnmsmooth.html +.PP \ No newline at end of file -- cgit v1.2.3