diff options
Diffstat (limited to 'upstream/fedora-40/man1/pamtable.1')
-rw-r--r-- | upstream/fedora-40/man1/pamtable.1 | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pamtable.1 b/upstream/fedora-40/man1/pamtable.1 new file mode 100644 index 00000000..d151ab89 --- /dev/null +++ b/upstream/fedora-40/man1/pamtable.1 @@ -0,0 +1,147 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Pamtable User Manual" 0 "15 April 2017" "netpbm documentation" + +.SH NAME + +pamtable - print the raster as a table of numerical sample values + +.UN synopsis +.SH SYNOPSIS + +\fBpamtable\fP + +[\fB-tuple\fP] +[\fB-hex\fP] + +[\fInetpbmfile\fP] + + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamtable\fP 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: + +.nf + + + 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 + + + +.fi +.PP +There are other output formats possible. See the command line options. +.PP +If you care to see only certain rows or columns, use \fBpamcut\fP to +filter the input. +.PP +If you care to see only certain planes, use \fBpamchannel\fP to filter the +input. +.PP +\fBpamtable\fP prints vertical bars between tuples, unless there is only +one sample per tuple, in which case it prints a single space between tuples. +.PP +\fBpamtable\fP prints a single space between samples within a tuple. +.PP +For each sample, \fBpamtable\fP 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. +.PP +If you want the samples to print more densely, use \fBpamdepth\fP to +reduce the maxval (thus making the decimal numbers for the samples narrower). +.PP +The \fBless\fP program (not part of Netpbm) is good for browsing through +the table. Use its \fB--chop-long-lines\fP option and use cursor movement +keys to scroll around in the image. + + +.UN arguments +.SH ARGUMENTS +.PP +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. + + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm (most +notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBpamtable\fP recognizes the following command line options: + + +.TP +\fB-tuple\fP +Print the tuple values in mathematical tuple notation, like this: + +.nf + + + (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) + + + +.fi +.sp +This option was new in Netpbm 10.11.00 (September 2022). + +.TP +\fB-hex\fP +Display sample values in hexadecimal instead of decimal. +.sp +This option is not valid with \fB-tuple\fP. +.sp +This option was new in Netpbm 10.11.00 (September 2022). + + +.TP +\fB-verbose\fP +.sp +Print additional messages about the processing. + +.UN seealso +.SH SEE ALSO +.BR "pamfile" (1)\c +\&, +.BR "pamcut" (1)\c +\&, +.BR "pamchannel" (1)\c +\&, +.BR "pnm" (1)\c +\&, +.BR "pam" (1)\c +\&, +.BR "pamslice" (1)\c +\&, +.BR "ppmtoarbtxt" (1)\c +\&, +.BR "ppmtoterm" (1)\c +\&, + + +.UN history +.SH HISTORY +.PP +\fBpamtable\fP was new in Netpbm 10.79 (June 2017). +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/pamtable.html +.PP
\ No newline at end of file |