\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pnmmargin User Manual" 0 "20 March 2009" "netpbm documentation"

.SH NAME

pnmmargin - add borders to a PNM image

.UN synopsis
.SH SYNOPSIS

\fBpnmmargin\fP
[\fB-white\fP|\fB-black\fP|\fB-color\fP \fIcolorspec\fP] \fIsize\fP
[\fIpnmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpnmmargin\fP adds a border around a PNM image.

.UN options
.SH OPTIONS
.PP
You can specify the border color with the \fB-white\fP,
\fB-black\fP, and \fB-color\fP options.  If no color is specified,
the program makes a guess.
.PP
To remove a border of a specified size from an image, use
\fBpamcut\fP.  \fBpnmcrop\fP also removes borders, but determines by itself
what is border and what is subject.
.PP
For lower level control, including to add different size borders to
different sides of the image, look at \fBpnmcat\fP.
.PP
If all you're trying to do is get the image up to a certain required
size, \fBpamcut\fP may be what you want.
.PP
\fBpnmpad\fP does essentially the same thing, but gives you more control
over the individual margins and does only black and white margins.

.UN seealso
.SH SEE ALSO
.BR pamcut (1)

.BR pnmcrop (1)

.BR pnmcat (1)

.BR pnmpad (1)

.BR pnm (5)


.UN author
.SH AUTHOR

Copyright (C) 1991 by Jef Poskanzer.