pnmpad
add borders to portable anymap
see also :
pbmmake - pnmpaste - pnmcut - pnmcrop
Synopsis
pnmpad
[-verbose] [-white|-black]
[[[-width=width [-halign=ratio]]
|
[-left=leftpad]
[-right=rightpad]]]
[[[-height=height
[-valign=ratio]] |
[-top=toppad] [-bottom=botpad]]]
[pnmfile]
All options can
be abbreviated to their shortest unique prefix. You may use
two hyphens instead of one to designate an option. You may
use either white space or an equals sign between an option
name and its value.
add an example, a script, a trick and tips
examples
source
pnmpad -width=$w -height=$h |
pnmtojpeg --quality=100 > "$dst_file"
fi
done # file
description
Reads a PNM
image as input. Outputs a PNM image that is the input image
plus black or white borders of the sizes specified.
If you just
need to convert an image to a certain size regardless of the
original dimensions, pnmcut with the -pad
option may be a better choice.
options
-verbose
Verbose output.
-white
-black (default)
Set pad color.
-left
leftpad
-right rightpad
-top toppad
-bottom bottompad
Specify amount of padding in
pixels.
-width
width
Set desired width of image.
Overrides -left and -right if specified. If
width is less than the actual image width, it is
ignored. Use pnmcut(1) to cut off parts of
images.
-height
height
Set desired height of image.
Overrides -top and -bottom if specified. If
height is less than the actual image height, it is
ignored. Use pnmcut(1) to cut off parts of
images.
-halign
ratio
A real number between 0 and 1.
Used in conjunction with -width, sets the alignment
ratio between left padding and right padding.
Useful
values:
0.0
- left aligned;
0.5
- center aligned (default);
1.0
- right aligned.
-valign
ratio
A real number between 0 and 1.
Used in conjunction with -height, sets the alignment
ratio between bottom padding and top padding.
Useful
values:
0.0
- bottom aligned;
0.5
- center aligned (default);
1.0
- top aligned.
history
Before February
2002,
pnmpad had a different
option syntax which was less expressive and not like
conventional Netpbm programs. That syntax is still
understood by pnmpad for backward compatibility, but
not documented or supported for future use.
see also
pbmmake ,
pnmpaste , pnmcut , pnmcrop ,
pbm
author
Copyright (C)
2002 by Martin van Beilen
Copyright (C) 1990 by Angus Duggan
Copyright (C) 1989 by Jef Poskanzer.
Permission to
use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in
all copies and that both that copyright notice and this
permission notice appear in supporting documentation. This
software is provided "as is" without express or
implied warranty.