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

NAME

6       pamtable - print the raster as a table of numerical sample values
7
8

SYNOPSIS

10       pamtable
11
12       [-tuple] [-hex]
13
14       [netpbmfile]
15
16
17

DESCRIPTION

19       This program is part of Netpbm(1).
20
21       pamtable  prints  the  raster of a Netpbm image as a table of numerical
22       sample values.  For example,  a  5-pixel  wide,  2-pixel  high  rainbow
23       (black, red, green, blue, white) PPM image with maxval 255 would appear
24       as follows:
25
26
27
28               0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
29               0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
30
31
32
33
34       There are other output formats possible.  See the command line options.
35
36       If you care to see only certain rows or columns, use pamcut  to  filter
37       the input.
38
39       If  you  care  to see only certain planes, use pamchannel to filter the
40       input.
41
42       pamtable prints vertical bars between tuples, unless there is only  one
43       sample  per  tuple,  in which case it prints a single space between tu‐
44       ples.
45
46       pamtable prints a single space between samples within a tuple.
47
48       For each sample, pamtable prints the numerical value  from  the  Netpbm
49       image,  uninterpreted.  It prints it in decimal, right justified in the
50       minimum number of spaces required to print the maxval of the image.
51
52       If you want the samples to print more densely, use pamdepth  to  reduce
53       the maxval (thus making the decimal numbers for the samples narrower).
54
55       The  less program (not part of Netpbm) is good for browsing through the
56       table.  Use its --chop-long-lines option and use cursor  movement  keys
57       to scroll around in the image.
58
59
60

ARGUMENTS

62       The only possible argument is the name of the file containing the input
63       Netpbm image.  This is optional; if you don't  specify  any  arguments,
64       the input comes from Standard Input.
65
66
67

OPTIONS

69       In  addition  to  the options common to all programs based on libnetpbm
70       (most notably -quiet, see
71        Common Options ⟨index.html#commonoptions⟩ ), pamtable  recognizes  the
72       following command line options:
73
74
75
76       -tuple Print  the  tuple  values  in  mathematical tuple notation, like
77              this:
78
79
80
81                      (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
82                      (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
83
84
85
86
87              This option was new in Netpbm 10.11.00 (September 2022).
88
89
90       -hex   Display sample values in hexadecimal instead of decimal.
91
92              This option is not valid with -tuple.
93
94              This option was new in Netpbm 10.11.00 (September 2022).
95
96
97
98       -verbose
99
100              Print additional messages about the processing.
101
102

SEE ALSO

104       pamfile(1), pamcut(1), pamchannel(1), pnm(1), pam(1), pamslice(1), ppm‐
105       toarbtxt(1), ppmtoterm(1),
106
107
108

HISTORY

110       pamtable was new in Netpbm 10.79 (June 2017).
111

DOCUMENT SOURCE

113       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
114       source.  The master documentation is at
115
116              http://netpbm.sourceforge.net/doc/pamtable.html
117
118netpbm documentation             15 April 2017         Pamtable User Manual(0)
Impressum