summary refs log tree commit diff
path: root/pnmmargin.html
blob: 34b98f459adcf7cbb6097a49205ad383eb873164 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
<!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>