pnmpad Man page

pnmpad General Commands Manual pnmpad

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 speci‐
fied. If width is less than the actual image width, it is
ignored. Use pnmcut to cut off parts of images.

-height height
Set desired height of image. Overrides -top and -bottom if spec‐
ified. If height is less than the actual image height, it is
ignored. Use pnmcut 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 docu‐
mented or supported for future use.

SEE ALSO

pbmmake, pnmpaste, pnmcut, pnmcrop, 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, 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.

26 January 2002 pnmpad