diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2012-03-05 18:40:06 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2012-03-05 18:40:06 +0000 |
commit | 957c8c367c8b8763479963ab0b106a625fa8a7c3 (patch) | |
tree | 1bae71d89ba7f7384317c6ee78e5984711424b2d | |
parent | c66acd4437d9554996fca9e87f9dff946e143654 (diff) | |
download | netpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.tar.gz netpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.tar.xz netpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.zip |
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@1659 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r-- | directory.html | 3 | ||||
-rw-r--r-- | pnmquantall.html | 72 | ||||
-rw-r--r-- | ppmquantall.html | 65 | ||||
-rw-r--r-- | xpmtoppm.html | 5 |
4 files changed, 90 insertions, 55 deletions
diff --git a/directory.html b/directory.html index 8efbe137..0ad7e9ff 100644 --- a/directory.html +++ b/directory.html @@ -752,7 +752,7 @@ All of these generate Netpbm format output. <DT><B><a href=pnmquant.html>pnmquant</a> </B> <DD>quantize colors/shades in a color or grayscale image down to fewer -<DT><B><a href=ppmquantall.html>ppmquantall</a> </B> +<DT><B><a href=pnmquantall.html>pnmquantall</a> </B> <DD>quantize colors on many files <DT><B><a href=ppmrelief.html>ppmrelief</a> </B> @@ -1094,6 +1094,7 @@ programs: <LI><B><a href=icontopbm.html>icontopbm</a> </B> <LI><B><a href=pbmtoicon.html>pbmtoicon</a> </B> <LI><B><a href=ppmquant.html>ppmquant</a> </B> +<LI><B><a href=ppmquantall.html>ppmquantall</a> </B> </UL> diff --git a/pnmquantall.html b/pnmquantall.html new file mode 100644 index 00000000..be8ef33e --- /dev/null +++ b/pnmquantall.html @@ -0,0 +1,72 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Pnmquantall User Manual</TITLE></HEAD> +<BODY> +<H1>pnmquantall</H1> +Updated: 05 March 2012 +<BR> +<A HREF="#index">Table Of Contents</A> + +<H2>NAME</H2> + +pnmquantall - run Pnmquant on a bunch of files all at once, so they +share a common colormap + +<H2 id="synopsis">SYNOPSIS</H2> + +<B>pnmquantall</B> + +[<B>-ext</B> <I>extension</I>] <I>ncolors</i> <i>netpbm_file</I>... + +<p>Note that the usual syntax rules for Netpbm programs <em>don't apply</em> +to this program. For example, you can't abbreviation -ext and you can't put +it anywhere on the line you want. + + +<H2 id="description">DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pnmquantall</b> takes a bunch of Netpbm image files as input, chooses +<I>ncolors</I> colors to best represent all of the images, maps the +existing colors to the new ones, and <strong>overwrites the input +files</strong> with the new quantized versions. + +<P>If you don't want to overwrite your input files, use the +<B>-ext</B> option. The output files are then named the same as the +input files, plus a period and the extension text you specify. + +<P>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 <b>pnmquant</b>; <b>pnmquantall</b> solves it for multiple images. + +<P>Note that another approach to this problem is to pre-select a set +of colors and then use <b>pnmremap</b> to separately quantize each PPM +to that set.) + +<p>This is a rather simple program that runs <b>pnmcolormap</b> and +<b>pnmremap</b>. 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 <b>pnmcolormap</b> and +<b>pnmremap</b> for doing the quantization differently. + + +<H2 id="seealso">SEE ALSO</H2> + +<B><A HREF="pnmquant.html">pnmquant</A></B>, +<B><A HREF="pnmremap.html">pnmremap</A></B>, +<B><A HREF="pnmcolormap.html">pnmcolormap</A></B>, +<B><A HREF="pnm.html">pnm</A></B> + +<HR> +<A NAME="index"> </A> +<H2>Table Of Contents</H2> +<UL> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#seealso">SEE ALSO</A> +</UL> +</BODY> +</HTML> diff --git a/ppmquantall.html b/ppmquantall.html index cdb7e674..fc7fc209 100644 --- a/ppmquantall.html +++ b/ppmquantall.html @@ -2,72 +2,31 @@ <HTML><HEAD><TITLE>Ppmquantall User Manual</TITLE></HEAD> <BODY> <H1>ppmquantall</H1> -Updated: 27 July 1990 +Updated: 05 March 2012 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> -ppmquantall - run Pnmquant on a bunch of files all at once, so they -share a common colormap +<B>ppmquantall</B> - replaced by pnmquantall -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> -<B>ppmquantall</B> - -[<B>-ext</B> <I>extension</I>] <I>ncolors</i> <i>ppmfile</I>... - -<A NAME="lbAD"> </A> <H2>DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. -<p><b>ppmquantall</b> takes a bunch of PPM images as input, chooses -<I>ncolors</I> colors to best represent all of the images, maps the -existing colors to the new ones, and <strong>overwrites the input -files</strong> with the new quantized versions. - -<P>If you don't want to overwrite your input files, use the -<B>-ext</B> option. The output files are then named the same as the -input files, plus a period and the extension text you specify. - -<P>Verbose explanation: 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 PPM you solve this -problem with <b>pnmquant</b>; <b>ppmquantall</b> solves it for -multiple PPMs. All it does is concatenate them together into one big -PPM, run <b>pnmquant</b> on that, and then split it up into little -PPMs again. - -<P>(Note that another way to solve this problem is to pre-select a set -of colors and then use <b>pnmremap</b> to separately quantize each PPM -to that set.) +<p><b>ppmquantall</b> was obsoleted by <a +href="pnmquantall.html"><b>pnmquantall</b></a>, introduced with Netpbm 10.58 +(March 2012). <b>pnmquantall</b> is just a renaming to reflect the fact +that the program handles all kinds of Netpbm input files, not just +PPM. Though this was not always the case, it had been for many years +before the renaming. -<A NAME="lbAE"> </A> -<H2>SEE ALSO</H2> +<p>For Netpbm before 10.58, where the program is still named +<b>ppmquantall</b>, just use the <b>pnmquantall</b> manual. -<B><A HREF="pnmquant.html">pnmquant</A></B>, -<B><A HREF="pnmremap.html">pnmremap</A></B>, -<B><A HREF="pnmcolormap.html">pnmcolormap</A></B>, -<B><A HREF="ppm.html">ppm</A></B> +</BODY> +</HTML> -<A NAME="lbAG"> </A> -<H2>AUTHOR</H2> -Copyright (C) 1991 by Jef Poskanzer. -<HR> -<A NAME="index"> </A> -<H2>Table Of Contents</H2> -<UL> -<LI><A HREF="#lbAB">NAME</A> -<LI><A HREF="#lbAC">SYNOPSIS</A> -<LI><A HREF="#lbAD">DESCRIPTION</A> -<LI><A HREF="#lbAE">SEE ALSO</A> -<LI><A HREF="#lbAG">AUTHOR</A> -</UL> -</BODY> -</HTML> diff --git a/xpmtoppm.html b/xpmtoppm.html index dad8dfdc..c7c857bc 100644 --- a/xpmtoppm.html +++ b/xpmtoppm.html @@ -2,7 +2,7 @@ <HTML><HEAD><TITLE>Xpmtoppm User Manual</TITLE></HEAD> <BODY> <H1>xpmtoppm</H1> -Updated: 30 December 2011 +Updated: 31 December 2011 <BR> <A HREF="#index">Table Of Contents</A> @@ -70,6 +70,9 @@ comment that begins in Column 1 in the color table part of the file. <p>There must be for every pixel a default colorname for a color type visual. +<p>Before Netpbm 10.58 (March 2012), zero bytes per pixel causes the program +to fail with a message about premature EOF on input. + <H2 id="seealso">SEE ALSO</H2> <B><A HREF="ppmtoxpm.html">ppmtoxpm</A></B>, |