\
.\" 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" 1 "12 November 2014" "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)\c
\&.
.PP
\fBpnmmargin\fP adds a border around a PNM image.


.UN arguments
.SH ARGUMENTS
.PP
\fIpnmfile\fP is the name of the input file.  If you don't specify this
argument, \fBpnmmargin\fP reads the input image from its Standard Input.


.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-plain\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpnmmargin\fP recognizes the following
command line options:
.PP
You can specify the border color with the \fB-white\fP,
\fB-black\fP, and \fB-color\fP options.  If you don't specify a color, the
program makes a guess.
.PP
The value of \fB-color\fP is like the
.UR libnetpbm_image.html#colorname
argument of the \fBpnm_parsecolor()\fP library routine
.UE
\&.
.PP
The \fB-plain\fP common option was implemented beginning with Netpbm
version 10.40 (September 2007).
.PP
The \fB-quiet\fP common option is not implemented.

.UN notes
.SH NOTES
.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 \fBpamcat\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


.IP \(bu

.BR "pamcut" (1)\c
\&
.IP \(bu

.BR "pnmcrop" (1)\c
\&
.IP \(bu

.BR "pamcat" (1)\c
\&
.IP \(bu

.BR "pnmpad" (1)\c
\&
.IP \(bu

.BR "pnm" (1)\c
\&


.UN author
.SH AUTHOR

Copyright (C) 1991 by Jef Poskanzer.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pnmmargin.html
.PP