1Pnmcat User Manual(0)                                    Pnmcat User Manual(0)
2
3
4

NAME

6       pnmcat - concatenate Netpbm images
7
8

SYNOPSIS

10       pnmcat
11
12       {-leftright | -lr | -topbottom | -tb}
13
14       [-white|-black]
15
16       [-jtop|-jbottom|-jcenter] [-jleft|-jright|-jcenter]
17
18       pnmfile ...
19
20       Minimum  unique abbreviation of option is acceptable.  You may use dou‐
21       ble hyphens instead of single hyphen to denote options.   You  may  use
22       white space in place of the equals sign to separate an option name from
23       its value.
24
25

DESCRIPTION

27       This program is part of Netpbm(1).
28
29       pnmcat reads one or more PNM images as input, concatenates them  either
30       left to right or top to bottom, and produces a single PNM image as out‐
31       put.
32
33       The arguments are names of input files.  Any one of these, but not more
34       than  one, may be "-" to indicate Standard Input.  If you have no argu‐
35       ments, that means a single input image from Standard Input (and that is
36       pointless - the output is the same as the input).
37
38       To assemble a regular grid of images, you can use pamundice.
39
40       To  do  the  reverse,  you  might use pamdice to split an image up into
41       smaller ones of equal size or pamcut to chop off part of  an  image  or
42       extract part of an image.
43
44       pnmtile concatenates a single input image to itself repeatedly.
45
46

OPTIONS

48       In  addition  to  the options common to all programs based on libnetpbm
49       (most notably -quiet, see
50        Common Options ⟨index.html#commonoptions⟩  ),  pnmcat  recognizes  the
51       following command line options:
52
53
54   Direction
55       -topbottom, -tb
56              Combine images vertically, top to bottom.
57
58
59       -leftright, -lr
60              Combine images horizontally, left to right.
61
62              You must specify the direction by specifying one of the above.
63
64
65
66
67   Justification
68       -jtop, -jbottom, -jleft, -jright,
69                  -jcenter
70                If the PNM images are not all the same height when you're con‐
71              catenating left
72                to right or width when you're concatenating top to bottom, the
73              smaller ones
74                have  to  be  justified  with the largest.  By default, pnmcat
75              centers
76                them, but you can specify justification to  one  side  or  the
77              other with one of
78                the -jxxx options.  So, -topbottom -jleft would stack
79                the  PNMs  on  top  of  each  other, flush with the left edge.
80              -leftright
81                -jbottom would line up the images left  to  right  with  their
82              bottom edges
83                aligned as if sitting on a table.
84
85
86
87   Margin Color
88       -white, -black
89              These  options  specify  what  color to use to fill in the extra
90              space when doing the justification.  If  neither  is  specified,
91              pnmcat chooses whichever seems to be right for the images.
92
93
94
95

SEE ALSO

97       pamundice(1), pamdice(1), pnmtile(1), pamcut(1), pnm(1)
98
99

AUTHOR

101       Copyright (C) 1989 by Jef Poskanzer.
102

DOCUMENT SOURCE

104       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
105       source.  The master documentation is at
106
107              http://netpbm.sourceforge.net/doc/pnmcat.html
108
109netpbm documentation              30 May 2011            Pnmcat User Manual(0)