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

DESCRIPTION

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

OPTIONS

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

SEE ALSO

75       pnmconvol(1), pnm(1)
76
77

HISTORY

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