Debian Codegraph @

upstream/debian-unstable/man1/pamtable.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pamtable User Manual" 1 "15 April 2017" "netpbm documentation"
7
8 .SH NAME
9
10 pamtable - print the raster as a table of numerical sample values
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpamtable\fP
16
17 [\fB-tuple\fP]
18 [\fB-hex\fP]
19
20 [\fInetpbmfile\fP]
21
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpamtable\fP prints the raster of a Netpbm image as a table of numerical
31 sample values. For example, a 5-pixel wide, 2-pixel high rainbow (black, red,
32 green, blue, white) PPM image with maxval 255 would appear as follows:
33
34 .nf
35
36
37 0 0 0|255 0 0| 0 255 0| 0 0 255|255 255 255
38 0 0 0|255 0 0| 0 255 0| 0 0 255|255 255 255
39
40
41
42 .fi
43 .PP
44 There are other output formats possible. See the command line options.
45 .PP
46 If you care to see only certain rows or columns, use \fBpamcut\fP to
47 filter the input.
48 .PP
49 If you care to see only certain planes, use \fBpamchannel\fP to filter the
50 input.
51 .PP
52 \fBpamtable\fP prints vertical bars between tuples, unless there is only
53 one sample per tuple, in which case it prints a single space between tuples.
54 .PP
55 \fBpamtable\fP prints a single space between samples within a tuple.
56 .PP
57 For each sample, \fBpamtable\fP prints the numerical value from the Netpbm
58 image, uninterpreted. It prints it in decimal, right justified in the minimum
59 number of spaces required to print the maxval of the image.
60 .PP
61 If you want the samples to print more densely, use \fBpamdepth\fP to
62 reduce the maxval (thus making the decimal numbers for the samples narrower).
63 .PP
64 The \fBless\fP program (not part of Netpbm) is good for browsing through
65 the table. Use its \fB--chop-long-lines\fP option and use cursor movement
66 keys to scroll around in the image.
67
68
69 .UN arguments
70 .SH ARGUMENTS
71 .PP
72 The only possible argument is the name of the file containing the input
73 Netpbm image. This is optional; if you don't specify any arguments, the input
74 comes from Standard Input.
75
76
77 .UN options
78 .SH OPTIONS
79 .PP
80 In addition to the options common to all programs based on libnetpbm (most
81 notably \fB-quiet\fP, see
82 .UR index.html#commonoptions
83 Common Options
84 .UE
85 \&), \fBpamtable\fP recognizes the following command line options:
86
87
88 .TP
89 \fB-tuple\fP
90 Print the tuple values in mathematical tuple notation, like this:
91
92 .nf
93
94
95 (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
96 (0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
97
98
99
100 .fi
101 .sp
102 This option was new in Netpbm 10.11.00 (September 2022).
103
104 .TP
105 \fB-hex\fP
106 Display sample values in hexadecimal instead of decimal.
107 .sp
108 This option is not valid with \fB-tuple\fP.
109 .sp
110 This option was new in Netpbm 10.11.00 (September 2022).
111
112
113 .TP
114 \fB-verbose\fP
115 .sp
116 Print additional messages about the processing.
117
118 .UN seealso
119 .SH SEE ALSO
120 .BR "pamfile" (1)\c
121 \&,
122 .BR "pamcut" (1)\c
123 \&,
124 .BR "pamchannel" (1)\c
125 \&,
126 .BR "pnm" (1)\c
127 \&,
128 .BR "pam" (1)\c
129 \&,
130 .BR "pamslice" (1)\c
131 \&,
132 .BR "ppmtoarbtxt" (1)\c
133 \&,
134 .BR "ppmtoterm" (1)\c
135 \&,
136
137
138 .UN history
139 .SH HISTORY
140 .PP
141 \fBpamtable\fP was new in Netpbm 10.79 (June 2017).
142 .SH DOCUMENT SOURCE
143 This manual page was generated by the Netpbm tool 'makeman' from HTML
144 source. The master documentation is at
145 .IP
146 .B http://netpbm.sourceforge.net/doc/pamtable.html
147 .PP