summary refs log tree commit diff
path: root/pamtable.html
blob: ea79f82eae68cd9ad9e302e97c4e07ecbbab7471 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pamtable User Manual</title></head>
<body>
<h1>pamtable</h1>
Updated: 15 April 2017
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

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

<h2 id="synopsis">SYNOPSIS</h2>

<b>pamtable</b>

[<b>-tuple</b>]
[<b>-hex</b>]

[<i>netpbmfile</i>]


<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>pamtable</b> prints the raster of a Netpbm image as a table of numerical
sample values.  For example, a 5-pixel wide, 2-pixel high rainbow (black, red,
green, blue, white) PPM image with maxval 255 would appear as follows:

<pre>
<span style="font-family: monospace">

        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255

</span>
</pre>

<p>There are other output formats possible.  See the command line options.

<p>If you care to see only certain rows or columns, use <b>pamcut</b> to
filter the input.

<p>If you care to see only certain planes, use <b>pamchannel</b> to filter the
input.

<p><b>pamtable</b> prints vertical bars between tuples, unless there is only
one sample per tuple, in which case it prints a single space between tuples.

<p><b>pamtable</b> prints a single space between samples within a tuple.

<p>For each sample, <b>pamtable</b> prints the numerical value from the Netpbm
image, uninterpreted.  It prints it in decimal, right justified in the minimum
number of spaces required to print the maxval of the image.

<p>If you want the samples to print more densely, use <b>pamdepth</b> to
reduce the maxval (thus making the decimal numbers for the samples narrower).

<p>The <b>less</b> program (not part of Netpbm) is good for browsing through
the table.  Use its <b>--chop-long-lines</b> option and use cursor movement
keys to scroll around in the image.


<h2 id="arguments">ARGUMENTS</h2>

<p>The only possible argument is the name of the file containing the input
Netpbm image.  This is optional; if you don't specify any arguments, the input
comes from Standard Input.


<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm (most
notably <b>-quiet</b>, see <a href="index.html#commonoptions"> Common
Options</a>), <b>pamtable</b> recognizes the following command line options:

<dl compact>
<dt><b>-tuple</b>

<dd>Print the tuple values in mathematical tuple notation, like this:

<pre>
<span style="font-family: monospace">

        (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
        (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)

</span>
</pre>
    
<p>This option was new in Netpbm 10.11.00 (September 2022).

<dt><b>-hex</b>

<dd>Display sample values in hexadecimal instead of decimal.

<p>This option is not valid with <b>-tuple</b>.

<p>This option was new in Netpbm 10.11.00 (September 2022).

  
<dt><b>-verbose</b>

<p>Print additional messages about the processing.
  
<dd>

</dl>


<h2 id="seealso">SEE ALSO</h2>

<a href="pamfile.html">pamfile</a>,
<a href="pamcut.html">pamcut</a>,
<a href="pamchannel.html">pamchannel</a>,
<a href="pnm.html">pnm</a>,
<a href="pam.html">pam</a>,
<a href="pamslice.html">pamslice</a>,
<a href="ppmtoarbtxt.html">ppmtoarbtxt</a>,
<a href="ppmtoterm.html">ppmtoterm</a>,


<h2 id="history">HISTORY</h2>

<p><b>pamtable</b> was new in Netpbm 10.79 (June 2017).

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#arguments">ARGUMENTS</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#history">HISTORY</a>
</ul>
</body>
</html>