\
.\" 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 "26 December 2025" "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.

\fB-white\fP and \fB-black\fP are the same as \fB-color=white\fP
and \fB-color=black\fP respectively (except that the latter fail if you
don't have a color dictionary set up in your environment, so they are
really more like \fB-color=rgbi:0/0/0\fP and
\fB-color=rgbi:1/1/1\fP.
.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
\fBpnmpad\fP does essentially the same thing, but gives you more control
over the individual margins and does only black and white margins.
.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
If you want to make the image a certain required size, adding borders
or cropping as necessary, \fBpamcut\fP may be what you want.


.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