1Pamstack User Manual(0) Pamstack User Manual(0)
2
3
4
6 pamstack - stack planes of multiple PAM images into one PAM image
7
8
10 pamstack [-tupletype tupletype] [inputfilespec ...]
11
12 All options may be abbreviated to the shortest unique prefix. You may
13 use two hyphens instead of one. You may separate an option from its
14 value with a space instead of =.
15
16
18 This program is part of Netpbm(1).
19
20 pamstack reads multiple PAM or PNM images as input and produces a PAM
21 image as output, consisting of all the planes (channels) of the inputs,
22 stacked in the order specified.
23
24 For any one (but not more) of the input files, you may specify "-" to
25 mean Standard Input. If you specify no arguments at all, the input is
26 one file: Standard Input.
27
28 The output is the same dimensions as the inputs, except that the depth
29 is the sum of the depths of the inputs. It has the same maxval. pam‐
30 stack fails if the inputs are not all the same width, height, and max‐
31 val. The tuple type is a null string unless you specify the -tupletype
32 option.
33
34 pamstack works with multi-image streams. It stacks the 1st image in
35 all the streams into one output image (the first one in the output
36 stream), then stacks the 2nd image in all the streams into the 2nd
37 image in the output stream, and so on, until one of the streams runs
38 dry. It's like a matrix operation.
39
40 Before Netpbm 10.32 (February 2006), pamstack ignored all but the first
41 image in each input stream.
42
43 pamchannel does the opposite of pamstack: It extracts individual
44 planes from a single PAM.
45
46 Use pamtopnm(1) to convert a suitable PAM image to a more traditional
47 PNM (PBM, PGM, or PPM) image. (But there's no need to do that if
48 you're going to feed it to a modern Netpbm program -- they all take
49 suitable PAM input directly).
50
51 One example of using pamstack is that some Netpbm programs accept as
52 input a PAM that represents graphic image with transparency informa‐
53 tion. Taking a color image for example, this would be a PAM with tuple
54 type "RGB_ALPHA". In Netpbm, such images were traditionally repre‐
55 sented as two images - a PPM for the color and a PGM for the trans‐
56 parency. To convert a PPM/PGM pair into PAM(RGB_ALPHA) input that
57 newer programs require, do something like this:
58
59 $ pamstack -tupletype=RGB_ALPHA myimage.ppm myalpha.pgm | \
60 pamtouil >myimage.uil
61
62
64 -tupletype tupletype
65 This specifies the tuple type name to be recorded in the output.
66 You may use any string up to 255 characters. Some programs rec‐
67 ognize some names. If you omit this option, the default tuple
68 type name is null.
69
70
71
73 pam(1) pamchannel(1)
74
75
77 pamstack was new in Netpbm 10.0 (June 2002).
78
80 This manual page was generated by the Netpbm tool 'makeman' from HTML
81 source. The master documentation is at
82
83 http://netpbm.sourceforge.net/doc/pamstack.html
84
85netpbm documentation 10 January 2006 Pamstack User Manual(0)