pnmpad(1) General Commands Manual pnmpad(1)
NAME
pnmpad - add borders to portable anymap
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.
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 dimen-
sions, 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 conven-
tional Netpbm programs. That syntax is still understood by pnmpad for backward
compatibility, but not documented or supported for future use.
SEE ALSO
pbmmake(1), pnmpaste(1), pnmcut(1), pnmcrop(1), pbm(5)
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.
26 January 2002 pnmpad(1)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-29 20:04 @216.73.216.105 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)