summary refs log tree commit diff
path: root/pnmcat.html
blob: d129f774a0f9a7dacd0fa78a057c1c35cc7129ff (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
80
81
82
83
84
85
86
87
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Pnmcat User Manual</TITLE></HEAD>
<BODY>
<H1>pnmcat</H1>
Updated: 01 April 2007
<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>]

<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>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>If the PNM images are not all the same height (left-right) or width
(top-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.

<P>The <B>-white</B> and <B>-black</B> options specify what color to
use to fill in the extra space when doing this justification.  If
neither is specified, <b>pnmcat</b> chooses whichever seems to be
right for the images.

<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>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>