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       -jleft, -jcenter, -jright
69              If  the  PNM  images are not all the same height (left-right) or
70              width (top-bottom), the smaller ones have to be  justified  with
71              the largest.  By default, pnmcat centers them, but you can spec‐
72              ify justification to one side or the other with one of the -jxxx
73              options.   So,  -topbottom -jleft would stack the PNMs on top of
74              each other, flush with the left edge.  -leftright -jbottom would
75              line up the images left to right with their bottom edges aligned
76              as if sitting on a table.
77
78
79
80   Margin Color
81       -white, -black
82              These options specify what color to use to  fill  in  the  extra
83              space  when  doing  the justification.  If neither is specified,
84              pnmcat chooses whichever seems to be right for the images.
85
86
87
88

SEE ALSO

90       pamundice(1), pamdice(1), pnmtile(1), pamcut(1), pnm(1)
91
92

AUTHOR

94       Copyright (C) 1989 by Jef Poskanzer.
95

DOCUMENT SOURCE

97       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
98       source.  The master documentation is at
99
100              http://netpbm.sourceforge.net/doc/pnmcat.html
101
102netpbm documentation              30 May 2011            Pnmcat User Manual(0)
Impressum