xenial (1) pnmpad.1.gz

Provided by: netpbm_10.0-15.3_amd64 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)