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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pnmcat User Manual</title></head>
<body>
<h1>pnmcat</h1>
Updated: 30 May 2011
<br>
<a href="#index">Table Of Contents</a>
<h2>NAME</h2>
pnmcat - concatenate Netpbm images
<h2 id="synopsis">SYNOPSIS</h2>
<b>pnmcat</b>
{<b>-leftright</b> | <b>-lr</b> | <b>-topbottom</b> | <b>-tb</b>}
[<b>-white</b>|<b>-black</b>]
[<b>-jtop</b>|<b>-jbottom</b>|<b>-jcenter</b>]
[<b>-jleft</b>|<b>-jright</b>|<b>-jcenter</b>]
<i>pnmfile</i> ...
<p>Minimum unique abbreviation of option is acceptable. You may use
double hyphens instead of single hyphen to denote options. You may
use white space in place of the equals sign to separate an option name
from its value.
<h2 id="description">DESCRIPTION</h2>
<p>This program is part of <a href="index.html">Netpbm</a>.
<p><b>pnmcat</b> reads one or more PNM images as input, concatenates them
either left to right or top to bottom, and produces a single PNM image
as output.
<p>The arguments are names of input files. Any one of these, but not more
than one, may be "-" to indicate Standard Input. If you have no
arguments, that means a single input image from Standard Input (and that is
pointless - the output is the same as the input).
<p>To assemble a regular grid of images, you can use <b>pamundice</b>.
<p>To do the reverse, you might use <b>pamdice</b> to split an image
up into smaller ones of equal size or <b>pamcut</b> to chop off part
of an image or extract part of an image.
<p><b>pnmtile</b> concatenates a single input image to itself repeatedly.
<h2 id="options">OPTIONS</h2>
<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pnmcat</b> recognizes the following
command line options:
<h3 id="direction">Direction</h3>
<dl compact>
<dt><b>-topbottom</b>, <b>-tb</b>
<dd>Combine images vertically, top to bottom.
<dt><b>-leftright</b>, <b>-lr</b>
<dd>Combine images horizontally, left to right.
<p>You must specify the direction by specifying one of the above.
</dl>
<h3 id="justification">Justification</h3>
<dl compact>
<dt><b>jtop</b>, <b>jbottom</b>, <b>-jleft</b>, <b>-jright</b>,
<b>-jcenter</b>,
<dd>
If the PNM images are not all the same height when you're concatenating left
to right or width when you're concatenating top to bottom, the smaller ones
have to be justified with the largest. By default, <b>pnmcat</b> centers
them, but you can specify justification to one side or the other with one of
the <b>-j</b><i>xxx</i> options. So, <b>-topbottom -jleft</b> would stack
the PNMs on top of each other, flush with the left edge. <b>-leftright
-jbottom</b> would line up the images left to right with their bottom edges
aligned as if sitting on a table.
</dl>
<h3 id="margincolor">Margin Color</h3>
<dl compact>
<dt><b>-white</b>, <b>-black</b>
<dd>These options specify what color to use to fill in the extra space
when doing the justification. If neither is specified, <b>pnmcat</b>
chooses whichever seems to be right for the images.
</dl>
<h2 id="seealso">SEE ALSO</h2>
<b><a href="pamundice.html">pamundice</a></b>,
<b><a href="pamdice.html">pamdice</a></b>,
<b><a href="pnmtile.html">pnmtile</a></b>,
<b><a href="pamcut.html">pamcut</a></b>,
<b><a href="pnm.html">pnm</a></b>
<h2 id="author">AUTHOR</h2>
Copyright (C) 1989 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="#options">OPTIONS</a>
<ul>
<li><a href="#direction">Direction</a>
<li><a href="#justification">Justification</a>
<li><a href="#margincolor">Margin Color</a>
</ul>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>
|
