Provided by: netpbm_10.0-12.2_i386 bug

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 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(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)