.TL
Pnmcat User Manual
.SH 1
pnmcat
.LP
Updated: 12 March 1989
.br
Table Of Contents
.SH 2
NAME
.LP
pnmcat - concatenate Netpbm images
.SH 2
SYNOPSIS
.LP
\fBpnmcat\fR
{\fB-leftright\fR | \fB-lr\fR | \fB-topbottom\fR | \fB-tb\fR}
[\fB-white\fR|\fB-black\fR]
[\fB-jtop\fR|\fB-jbottom\fR|\fB-jcenter\fR]
\fIpnmfile\fR ...
.LP
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.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpnmcat\fR 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.
.LP
To do the reverse, you might use \fBpamdice\fR to split an image
up into smaller ones of equal size or \fBpamcut\fR to chop off part
of an image or extract part of an image.
.LP
\fBpnmtile\fR concatenates a single input image to itself repeatedly.
.SH 2
OPTIONS
.LP
.LP
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, \fBpnmcat\fR centers them, but you can specify
justification to one side or the other with one of the
\fB-j\fR\fIxxx\fR options.  So, \fB-topbottom -jleft\fR would stack
the PNMs on top of each other, flush with the left edge.
.LP
The \fB-white\fR and \fB-black\fR options specify what color to
use to fill in the extra space when doing this justification.  If
neither is specified, \fBpnmcat\fR chooses whichever seems to be
right for the images.
.SH 2
SEE ALSO
.LP
\fBpamdice\fR,
\fBpnmtile\fR,
\fBpamcut\fR,
\fBpnm\fR
.SH 2
AUTHOR
.LP
Copyright (C) 1989 by Jef Poskanzer.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP