1Pamseq User Manual(0) Pamseq User Manual(0)
2
3
4
6 pamseq - generate PAM image of all possible tuple values, in sequence
7
8
10 pamseq [-tupletype tupletype] depth maxval
11
12
14 This program is part of Netpbm(1).
15
16 pamseq generates a PAM image of a specified depth and specified maxval
17 that consists of a single row. The row consists of one tuple of every
18 possible value, in order.
19
20 For a depth of one, the order is simple: From 0 to maxval, going from
21 left to right. For higher depths, the highest numbered plane goes from
22 0 to maxval (going left to right) while all the other planes have value
23 0. Then the sequence repeats except with the next highest plane set to
24 a value of 1, then 2, etc.
25
26
28 All options can be abbreviated to their shortest unique prefix. You
29 may use two hyphens instead of one to designate an option. You may use
30 either white space or an equals sign between an option name and its
31 value.
32
33
34
35 -tupletype
36 This is the value of the "tuple_type" attribute of the created
37 PAM image. It can be any string up to 255 characters.
38
39
40
41
43 To create a simple ramp of the values 0..255, for input to various
44 matrix calculations, try
45 pamseq 1 255
46 (Before pamseq existed, pgmramp was often pressed into service for
47 this).
48
49 To create a PPM color map of all the possible colors representable with
50 a maxval of 5, do
51 pamseq 3 5 -tupletype=RGB | pamtopnm
52
53 Again, with a modern program based on the Netpbm library, you don't
54 need the pamtopnm because a PAM RGB image is equivalent to a PPM image.
55
56 You can use such a color map with pnmremap(1)toquantizethecolorsinan
57 image. With the maxval of 5 given in the example, you get a color map
58 of the set of "web safe" colors as defined by Netscape. Most web
59 browsers guarantee that they can produce at least these 216 colors (215
60 plus black).
61
62
64 pnmremap(1), pamtopnm(1), pam(1)
65
66
68 pamseq was added to Netpbm in June 2002.
69
70
71
72netpbm documentation 8 May 2002 Pamseq User Manual(0)