1Pnmpad User Manual(0) Pnmpad User Manual(0)
2
6 pnmpad - add borders to a PNM image
7
10 pnmpad [-verbose] [-white|-black] [-width=pixels] [-halign=ratio]
11 [-left=pixels] [-right=pixels] [-height=pixels] [-valign=ratio]
12 [-top=pixels] [-bottom=pixels] [pnmfile]
13
16 This program is part of Netpbm(1).
17 pnmpad reads a PNM image as input and outputs a PNM image that is the
19 input image plus black or white borders of the sizes specified.
20 If you just need to convert an image to a certain size regardless of
22 the original dimensions, pamcut with the -pad option may be a better
23 choice.
24
27 All options can be abbreviated to their shortest unique prefix. You
28 may use two hyphens instead of one to designate an option. You may use
29 either white space or an equals sign between an option name and its
30 value.
31 -verbose
35 Verbose output.
36 -white
39 -black Set pad color. Default is -black.
41 -left=pixels
45 -right=pixels
47 -width=width
49 -halign=ratio
51 Specify amount of left and right padding in pixels.
52 -left and -right directly specify the amount of padding added to
54 the left and right sides, respectively, of the image.
55 Alternatively, you can specify -width and just one of -left and
57 -right and pnmpad calculates the required padding on the other
58 side based on the width of the input image. If the -width value
59 is less than the width of the image plus the specified padding,
60 the -width values is ignored.
61 If you specify all three of -width, -left, and -right, you must
63 ensure that the -left and -right padding are sufficient to make
64 the image at least as wide as -width specifies. Otherwise, pnm‐
65 pad fails.
66 When you specify -width without -left or -right, and -width is
68 larger than the input image, pnmpad chooses left and right pad‐
69 ding amounts in a certain ratio. That ratio defaults to half,
70 but you can set it to anything (from 0 to 1) with the -halign
71 option. If the input image is already at least as wide as
72 -width specifies, pnmpad adds no padding.
73 Common values for -halign are:
75 0.0 left aligned
78 0.5 center aligned (default)
81 1.0 right aligned
84 Before Netpbm 10.23 (July 2004), pnmpad did not allow the -left
87 or -right option together with -width.
88 -top=pixels
91 -bottom=pixels
93 -height=height
95 -valign=ratio
97 These options determine the vertical padding. They are analo‐
98 gous to the horizontal padding options above.
99
104 Before February 2002, pnmpad had a different option syntax which was
105 less expressive and not like conventional Netpbm programs. That syntax
106 is still understood by pnmpad for backward compatibility, but not docu‐
107 mented or supported for future use.
108
111 pbmmake(1), pnmpaste(1), pamcut(1), pnmcrop(1), pamcomp(1), pbm(1)
112
115 Copyright (C) 2002 by Martin van Beilen
116 Copyright (C) 1990 by Angus Duggan
118 Copyright (C) 1989 by Jef Poskanzer.
120 Permission to use, copy, modify, and distribute this software and its
122 documentation for any purpose and without fee is hereby granted, pro‐
123 vided that the above copyright notice appear in all copies and that
124 both that copyright notice and this permission notice appear in sup‐
125 porting documentation. This software is provided 'as is' without
126 express or implied warranty.
127netpbm documentation 26 January 2002 Pnmpad User Manual(0)