diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/pamdepth.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/pamdepth.1 | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/pamdepth.1 b/upstream/opensuse-leap-15-6/man1/pamdepth.1 new file mode 100644 index 00000000..6493b157 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/pamdepth.1 @@ -0,0 +1,78 @@ +\ +.\" 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 "Pamdepth User Manual" 0 "19 December 2013" "netpbm documentation" + +.SH NAME + +pamdepth - change the depth (color resolution) in a Netpbm image + +.UN synopsis +.SH SYNOPSIS + +\fBpamdepth\fP \fInewmaxval\fP [\fInetpbmfile\fP] + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamdepth\fP reads a Netpbm image as input, changes its depth (color +resolution), and writes out the resulting Netpbm image. I.e. the output has a +different maxval from the input, but all the same colors (apart from rounding +error). +.PP +Reducing the depth results in some loss of information. +.PP +Here is an example of the effect at the image format level: Assume you +start with an image with maxval 100 and sample values of 50 and 100. You +tell \fBpamdepth\fP to change it to depth 150. The output has maxval +200 and sample values 75 and 150. +.PP +This program works on multi-image streams. +.PP +Be careful of off-by-one errors when choosing the new maxval. For +instance, if you want the color values to be five bits wide, use a +maxval of 31, not 32. +.PP +One important use of \fBpamdepth\fP is to convert a new format +2-byte-per-sample PNM file to the older 1-byte-per-sample format. +Before April 2000, essentially all raw (binary) format PNM files had a +maxval less than 256 and one byte per sample, and many programs may +rely on that. If you specify a \fInewmaxval\fP less than 256, the +resulting file should be readable by any program that worked with PNM +files before April 2000. + +.UN seealso +.SH SEE ALSO +.BR "pnm" (5)\c +\&, +.BR "pam" (5)\c +\&, +.BR "pnmquant" (1)\c +\&, +.BR "ppmdither" (1)\c +\& +.BR "ppmbrighten" (1)\c +\& +.BR "pamfunc" (1)\c +\& + +.UN history +.SH HISTORY +.PP +\fBpamdepth\fP was new in Netpbm 10.32 (February 2006). It replaced +\fBpnmdepth\fP, by Jef Poskanzer. \fBpamdepth\fP is backward compatible +with \fBpnmdepth\fP and adds the ability to process arbitrary PAM images +and the ability to process multi-image input streams. \fBpnmdepth\fP +handled only PNM images and ignored all but the first in any stream. +.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/pamdepth.html +.PP
\ No newline at end of file |