summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/pnmquantall.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man1/pnmquantall.1')
-rw-r--r--upstream/debian-unstable/man1/pnmquantall.193
1 files changed, 93 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/pnmquantall.1 b/upstream/debian-unstable/man1/pnmquantall.1
new file mode 100644
index 00000000..a470536b
--- /dev/null
+++ b/upstream/debian-unstable/man1/pnmquantall.1
@@ -0,0 +1,93 @@
+\
+.\" 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 "Pnmquantall User Manual" 1 "05 March 2012" "netpbm documentation"
+
+.SH NAME
+
+pnmquantall - run Pnmquant on a bunch of files all at once, so they
+share a common colormap
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmquantall\fP
+
+[\fB-ext\fP \fIextension\fP] \fIncolors\fP \fInetpbm_file\fP...
+.PP
+Note that the usual syntax rules for Netpbm programs \fIdon't apply\fP
+to this program. For example, you can't abbreviate -ext and you can't put
+it anywhere on the line you want.
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmquantall\fP takes a bunch of Netpbm image files as input, chooses
+\fIncolors\fP colors to best represent all of the images, maps the
+existing colors to the new ones, and \fBoverwrites the input
+files\fP with the new quantized versions.
+.PP
+If you don't want to overwrite your input files, use the
+\fB-ext\fP option. The output files are then named the same as the
+input files, plus a period and the extension text you specify.
+.PP
+The purpose is this: Let's say you've got a dozen PPMs that you want to
+display on the screen all at the same time. Your screen can only display 256
+different colors, but the PPMs have a total of a thousand or so different
+colors. For a single image you solve this problem
+with \fBpnmquant\fP; \fBpnmquantall\fP solves it for multiple images.
+.PP
+Note that another approach to this problem is to pre-select a set
+of colors and then use \fBpnmremap\fP to separately quantize each PPM
+to that set.)
+.PP
+This is a rather simple program that runs \fBpnmcolormap\fP and
+\fBpnmremap\fP. If you are considering using it in a program of any
+sophistication, you should probably just run those programs directly.
+Even if you are typing it, you may want to do the steps manually because
+it gives you access to the various options of \fBpnmcolormap\fP and
+\fBpnmremap\fP for doing the quantization differently.
+
+
+.UN options
+.SH OPTIONS
+.PP
+\fBpnmquantall\fP recognizes the following command line option:
+
+
+.TP
+\fB-ext\fP \fIextension\fP
+Specify an extension for the output files. By default the input files
+are overwritten.
+
+.PP
+\fBpnmquantall\fP does not recognize the options common to all
+programs based on libnetpbm (See
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.) However, the \fB-version\fP option works.
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmquant" (1)\c
+\&,
+.BR "pnmremap" (1)\c
+\&,
+.BR "pnmcolormap" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&
+.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/pnmquantall.html
+.PP \ No newline at end of file