pamseq(1)

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

NAME

6       pamseq - generate PAM image of a numerical sequence of tuple values
7
8

SYNOPSIS

10       pamseq     [-tupletype=tupletype]     depth    maxval    [-min=n,n,...]
11       [-max=n,n,...]  [-step=n,n,...]
12
13       All options can be abbreviated to their shortest  unique  prefix.   You
14       may use two hyphens instead of one to designate an option.  You may use
15       either white space or an equals sign between an  option  name  and  its
16       value.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       pamseq generates a PAM image of a specified depth and specified
23         maxval that consists of a single row.  The row consists of tuples
24         containing sample values in a numerical sequence.
25
26       For example
27
28           pamseq 1 4
29
30
31         generates  a 5 pixel wide image of 1 row with depth 1 tuples contain‐
32       ing these
33         samples, in order from left to right:
34
35           0 1 2 3 4
36
37
38         The following example uses depth 2:
39
40           pamseq 2 2
41
42
43         The resulting image is a 9 pixel wide image of 1  row  with  depth  2
44       containing
45         these samples, in order from left to right;
46
47           (0,0) (0,1) (0,2) (1,0) (1,1) (1,2) (2,0) (2,1) 2,2)
48
49
50         You can choose the starting and ending sample values and the step for
51       each
52         plane:  Here is an example of that:
53
54           pamseq 1 255 -min=4 -max=8 -step=2
55
56
57       This generates
58
59           4 6 8
60
61
62       In two dimensions:
63
64           pamseq 2 255 -min=0,4 -max=2,8 -step=1,2
65
66
67           (0,4) (0,6) (0,8) (1,4) (1,6) (1,8) (2,4) (2,6) (2,8)
68
69
70         pamseq varies first the highest numbered plane, then the next lower
71         numbered plane, etc.  Within each plane, the program varies from  low
72       sample
73         value to high.
74
75
76

OPTIONS

78       In  addition  to  the options common to all programs based on libnetpbm
79       (most notably -quiet, see
80        Common Options ⟨index.html#commonoptions⟩  ),  pamseq  recognizes  the
81       following command line options:
82
83
84
85       -tupletype
86              This  is  the value of the "tuple_type" attribute of the created
87              PAM image.  It can be any string up to 255 characters.
88
89
90       -min=n,n,...
91                This gives the starting value for the sequence in each  plane.
92              The number
93                of  comma-separated  numbers  must  be  equal to the number of
94              planes in the
95                image (its depth).  Each number must  be  a  whole  number  no
96              greater than
97                the maxval of the image.  The first number is for Plane 0, the
98              second for
99                Plane 1, etc.
100
101              The default is 0 in every plane.
102
103              This option was new in Netpbm 10.99 (June 2022).
104
105
106       -max=n,n,...
107
108              This is analogous to -min, giving the ending value for the
109                  sequence.
110
111              Each value must be at least as great as the corresponding -min
112                  value.
113
114              The default is the maxval in every plane.
115
116              This option was new in Netpbm 10.99 (June 2022).
117
118
119       -step=n,n,...
120
121              This is analogous to -min, giving the step value for the
122                  sequence (difference between two consecutive numbers).
123
124              Each value must be positive and no greater than the maxval.
125
126              The default is 1.
127
128              This option was new in Netpbm 10.99 (June 2022).
129
130
131
132

USAGE

134       To create a simple ramp of the values 0..255, for input to various  ma‐
135       trix calculations, try
136         pamseq 1 255
137
138       (Before  pamseq  existed,  pgmramp  was  often pressed into service for
139       this).
140
141       To create a PPM color map of all the possible colors representable with
142       a maxval of 5, do
143         pamseq 3 5 -tupletype=RGB | pamtopnm
144
145
146       Again,  with  a  modern  program based on the Netpbm library, you don't
147       need the pamtopnm because a PAM RGB image is equivalent to a PPM image.
148
149       You can use such a color map with pnmremap(1) to quantize the colors in
150       an  image.   With the maxval of 5 given in the example, you get a color
151       map of the set of "web safe" colors as defined by Netscape.   Most  web
152       browsers guarantee that they can produce at least these 216 colors (215
153       plus black).
154
155       pamrestack can often produce a useful two-dimensional image  from  pam‐
156       seq's single row.
157
158           pamseq 2 255 -min=0,4 -max=2,8 -step=1,2 | pamrestack -width=3
159
160
161           (0,4) (0,6) (0,8)
162           (1,4) (1,6) (1,8)
163           (2,4) (2,6) (2,8)
164
165
166
167
168

HISTORY

174       pamseq was added to Netpbm in June 2002.
175

DOCUMENT SOURCE

177       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
178       source.  The master documentation is at
179
180              http://netpbm.sourceforge.net/doc/pamseq.html
181
182netpbm documentation             30 April 2022           Pamseq User Manual(0)