<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Pnmmargin User Manual</TITLE></HEAD>
<BODY>
<H1>pnmmargin</H1>
Updated: 12 November 2014
<BR>
<A HREF="#index">Table Of Contents</A>
<H2>NAME</H2>
pnmmargin - add borders to a PNM image
<H2 id="synopsis">SYNOPSIS</H2>
<B>pnmmargin</B>
[<B>-white</B>|<B>-black</B>|<B>-color</B> <I>colorspec</I>] <I>size</I>
[<I>pnmfile</I>]
<H2 id="description">DESCRIPTION</H2>
<p>This program is part of <a href="index.html">Netpbm</a>.
<p><b>pnmmargin</b> adds a border around a PNM image.
<H2 id="arguments">ARGUMENTS</H2>
<p><i>pnmfile</i> is the name of the input file. If you don't specify this
argument, <b>pnmmargin</b> reads the input image from its Standard Input.
<H2 id="options">OPTIONS</H2>
<P>You can specify the border color with the <B>-white</B>,
<B>-black</B>, and <B>-color</B> options. If you don't specify a color, the
program makes a guess.
<p>The value of <b>-color</b> is like the
<a href="libppm.html#colorname">argument of the <b>ppm_parsecolor()</b>
library routine</a>.
<P>To remove a border of a specified size from an image, use
<B>pamcut</B>. <b>pnmcrop</b> also removes borders, but determines by itself
what is border and what is subject.
<P>For lower level control, including to add different size borders to
different sides of the image, look at <b>pnmcat</b>.
<P>If all you're trying to do is get the image up to a certain required
size, <b>pamcut</b> may be what you want.
<p><b>pnmpad</b> does essentially the same thing, but gives you more control
over the individual margins and does only black and white margins.
<H2 id="seealso">SEE ALSO</H2>
<A HREF="pamcut.html">pamcut</A>
<A HREF="pnmcrop.html">pnmcrop</A>
<A HREF="pnmcat.html">pnmcat</A>
<A HREF="pnmpad.html">pnmpad</A>
<A HREF="pnm.html">pnm</A>
<H2 id="author">AUTHOR</H2>
Copyright (C) 1991 by Jef Poskanzer.
<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#arguments">ARGUMENTS</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>