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

NAME

6       pamstack - stack planes of multiple PAM images into one PAM image
7
8

SYNOPSIS

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

DESCRIPTION

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       It can also just change the tuple type of a single PAM image.
25
26
27       For  any  one (but not more) of the input files, you may specify "-" to
28       mean Standard Input.  If you specify no arguments at all, the input  is
29       one file: Standard Input.
30
31       The  output is the same dimensions as the inputs, except that the depth
32       is the sum of the depths of the inputs.  It has the same maxval.   pam‐
33       stack  fails if the inputs are not all the same width, height, and max‐
34       val.  The tuple type is a null string unless you specify the -tupletype
35       option.
36
37       pamstack  works  with  multi-image streams.  It stacks the 1st image in
38       all the streams into one output image (the  first  one  in  the  output
39       stream),  then stacks the 2nd image in all the streams into the 2nd im‐
40       age in the output stream, and so on, until one of the streams runs dry.
41       It's like a matrix operation.
42
43       Before Netpbm 10.32 (February 2006), pamstack ignored all but the first
44       image in each input stream.
45
46       pamchannel does the  opposite  of  pamstack:   It  extracts  individual
47       planes from a single PAM.
48
49       Use  pamtopnm(1)  to convert a suitable PAM image to a more traditional
50       PNM (PBM, PGM, or PPM) image.  (But there's  no  need  to  do  that  if
51       you're  going  to  feed  it to a modern Netpbm program -- they all take
52       suitable PAM input directly).
53
54       One example of using pamstack is that some Netpbm  programs  accept  as
55       input  a  PAM  that represents graphic image with transparency informa‐
56       tion.  Taking a color image for example, this would be a PAM with tuple
57       type  "RGB_ALPHA".   In  Netpbm,  such images were traditionally repre‐
58       sented as two images - a PPM for the color and a PGM for the  transpar‐
59       ency.   To  convert a PPM/PGM pair into PAM(RGB_ALPHA) input that newer
60       programs require, do something like this:
61
62       $ pamstack -tupletype=RGB_ALPHA myimage.ppm myalpha.pgm | \
63             pamtouil >myimage.uil
64
65
66

OPTIONS

68       In addition to the options common to all programs  based  on  libnetpbm
69       (most notably -quiet, see
70        Common  Options  ⟨index.html#commonoptions⟩ ), pamstack recognizes the
71       following command line option:
72
73
74
75
76       -tupletype tupletype
77              This specifies the tuple type name to be recorded in the output.
78              You may use any string up to 255 characters.  Some programs rec‐
79              ognize some names.  If you omit this option, the  default  tuple
80              type name is null.
81
82
83

SEE ALSO

85       pam(1) pamchannel(1)
86
87

HISTORY

89       pamstack was new in Netpbm 10.0 (June 2002).
90

DOCUMENT SOURCE

92       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
93       source.  The master documentation is at
94
95              http://netpbm.sourceforge.net/doc/pamstack.html
96
97netpbm documentation            10 January 2006        Pamstack User Manual(0)