SYNOPSIS
pnmpad [-verbose] [-white|-black] [-width=pixels] [-halign=ratio]
[-left=pixels] [-right=pixels] [-height=pixels] [-valign=ratio]
[-top=pixels] [-bottom=pixels] [pnmfile]


DESCRIPTION
This program is part of Netpbm.

pnmpad reads a PNM image as input and 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, pamcut with the -pad option may be a better
choice.


OPTIONS
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.



-verbose


-white

-black Set pad color. Default is -black.



-left=pixels

-right=pixels

-width=width

-halign=ratio







0.0 left aligned


0.5 center aligned (default)


1.0 right aligned




-top=pixels

-bottom=pixels

-height=height

-valign=ratio




HISTORY
Before February 2002, pnmpad had a different option syntax which was
less expressive and not like conventional Netpbm programs. That syn-
tax is still understood by pnmpad for backward compatibility, but not
documented or supported for future use.


SEE ALSO
pbmmake, pnmpaste, pamcut, pnmcrop, pamcomp, 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, pro-
vided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in sup-
porting documentation. This software is provided 'as is' without
express or implied warranty.



netpbm documentation 26 January 2002 Pnmpad User Manual(0)