1Pnmsmooth User Manual(0)                              Pnmsmooth User Manual(0)
2
3
4

NAME

6       pnmsmooth - smooth out an image
7
8

SYNOPSIS

10       pnmsmooth   [-width=cols]   [-height=rows]  [-dump=dumpfile]  [pnmfile]
11       [-size]
12
13       Minimum unique abbreviations of options is  acceptable.   You  may  use
14       double hyphens instead of single hyphen to denote options.  You may use
15       white space in place of the equals sign to separate an option name from
16       its value.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       pnmsmooth  smoothes out an image by replacing each pixel with the aver‐
23       age of its width X height neighbors.  It is  implemented  as  a  progam
24       that generates a PGM convolution matrix and then invokes pnmconvol with
25       it.
26
27

OPTIONS

29       -width=cols
30
31       -height=rows
32              These options specify the dimensions of the convolution  matrix.
33              Default  dimensions  are 3 wide and 3 high.  Each dimension must
34              be odd.  The maximum size of the convolution matrix  is  limited
35              by the maxval of the image such that width * height * 2 must not
36              exceed the maxval.  (use pamdepth to increase the maxval if nec‐
37              essary).
38
39              These  options were new in Netpbm 10.32 (February 2006).  Before
40              that, use -size.
41
42
43       -size  This deprecated option exists in  current  Netpbm  for  backward
44              compatibility.  It was obsoleted by -width and -height in Netpbm
45              10.32 (February 2006).
46
47              When you use this option, the first two  program  arguments  are
48              the  width  and  height, respectively, of the convolution matrix
49              and do the same thing as the -width and -height  option  values.
50              The third (optional) program argument is the input file name.
51
52              In  reality, in old pnmsmooth, the width and height are two val‐
53              ues of the -size option, but the modern  Netpbm  command  syntax
54              paradigm  doesn't  allow  an  option  with  multiple  values, so
55              instead -size is an option with no value and  width  and  height
56              are  program arguments.  That has the fortunate effect of making
57              the following command mean the same in current pnmsmooth  as  in
58              old pnmsmooth:
59                   pnmsmooth -size 5 5 infile.ppm >outfile.ppm
60
61
62       -dump=dumpfile
63              This options makes pnmsmooth only generate and save the convolu‐
64              tion file.  It does not invoke pnmconvol and does not produce an
65              output image.
66
67
68
69
70
71

SEE ALSO

73       pnmconvol(1), pnm(1)
74
75

HISTORY

77       Before  Netpbm  10.32 (February 2006), pnmsmooth did not use the modern
78       Netpbm command line parser, so had an unconventional command line  syn‐
79       tax.   Most  importantly,  you  could  not  use an equal size or double
80       hyphens in the options.
81
82
83
84netpbm documentation            4 December 1994       Pnmsmooth User Manual(0)