summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2022-01-27 02:39:38 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2022-01-27 02:39:38 +0000
commit9c185a3c618cfaff1ba92f3094f1a4e395013916 (patch)
tree7a0057177b22f89a76dfd53e938aa56f260983b5
parent1feb4eb4d9783d530653f6e6ac8bc4264732501d (diff)
downloadnetpbm-mirror-9c185a3c618cfaff1ba92f3094f1a4e395013916.tar.gz
netpbm-mirror-9c185a3c618cfaff1ba92f3094f1a4e395013916.tar.xz
netpbm-mirror-9c185a3c618cfaff1ba92f3094f1a4e395013916.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4264 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--directory.html16
-rw-r--r--pbmnoise.html1
-rw-r--r--pgmmedian.html11
-rw-r--r--pgmtoppm.html10
-rw-r--r--picttoppm.html14
-rw-r--r--ppmtoapplevol.html15
-rw-r--r--ppmtoilbm.html27
7 files changed, 65 insertions, 29 deletions
diff --git a/directory.html b/directory.html
index 23820994..d5db244f 100644
--- a/directory.html
+++ b/directory.html
@@ -404,10 +404,10 @@ convert Palm Pilot Image Viewer format to Netpbm formats.
 <dd>convert Atari Degas .pi3 to PBM
 
 <dt><b><a href="ppmtopict.html">ppmtopict</a></b>
-<dd>convert PPM to Macintosh PICT
+<dd>convert PPM to Macintosh PICT (aka Picture aka Quickdraw)
 
 <dt><b><a href="picttoppm.html">picttoppm</a></b>
-<dd>convert Macintosh PICT to PPM
+<dd>convert Macintosh PICT (aka Picture aka Quickdraw) to PPM
 
 <dt><b><a href="ppmtopj.html">ppmtopj</a></b>
 <dd>convert PPM to HP PaintJet file
@@ -852,12 +852,6 @@ a color map containing all possible colors of given maxval
 <dt><b><a href="pgmbentley.html">pgmbentley</a></b>
 <dd>bentleyize a PGM image
 
-<dt><b><a href="pamoil.html">pamoil</a></b>
-<dd>turn a PNM or PAM image into an oil painting
-
-<dt><b><a href="ppmtv.html">ppmtv</a></b>
-<dd>make an image lined so it looks like an old TV
-
 <dt><b><a href="ppmchange.html">ppmchange</a></b>
 <dd>change all of one color to another in PPM image
 
@@ -957,6 +951,12 @@ a color map containing all possible colors of given maxval
 <dt><b><a href="ppmfade.html">ppmfade</a></b>
 <dd>produce series of images fading from one to another
 
+<dt><b><a href="pamoil.html">pamoil</a></b>
+<dd>turn a PNM or PAM image into an oil painting
+
+<dt><b><a href="ppmtv.html">ppmtv</a></b>
+<dd>make an image lined so it looks like an old TV
+
 </dl>
 
 
diff --git a/pbmnoise.html b/pbmnoise.html
index 19d9be03..1f88927d 100644
--- a/pbmnoise.html
+++ b/pbmnoise.html
@@ -153,7 +153,6 @@ is less efficient.
 <p>
 Akira F Urushibata wrote this program and contributed it to the public domain
 in December 2021.
-<p>
 
 <hr>
 <h2 id="index">Table Of Contents</h2>
diff --git a/pgmmedian.html b/pgmmedian.html
index e0f20b36..3c90f6a7 100644
--- a/pgmmedian.html
+++ b/pgmmedian.html
@@ -2,7 +2,7 @@
 <html><head><title>Pgmmedian User Manual</title></head>
 <body>
 <h1>pgmmedian</h1>
-Updated: 28 August 2005
+Updated: 20 January 2022
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -41,6 +41,11 @@ the output is the median of a certain set of pixels in the neighborhood of the
 corresponding input pixel.  The effect is to eliminate locally extreme values.
 Such pixels typically show up as speckles.
 
+<p>Pixels at the edges of the image, pixels where the convolution kernel would
+go off the edge of the image, are just copied.  For example, if <b>-height</b>
+is 9, the first 4 and last 4 rows of the input image are just copied to the
+output.
+  
 <p>See the <b>-type</b> and <b>-cutoff</b> options for information on
 how <b>pgmmedian</b> chooses between the two methods.
 
@@ -73,12 +78,16 @@ value.
 
 <dd>Width of the median mask to apply.
 
+<p>Maximum allowed is the width of the input image.
+  
 <p>Default is 3.
 
 <dt><b>-height=</b><i>n</i>
 
 <dd>Height of the median mask to apply.
 
+<p>Maximum allowed is the height of the input image.
+  
 <p>Default is 3.
 
 <dt><b>-type</b> <i>median_type</i>
diff --git a/pgmtoppm.html b/pgmtoppm.html
index 0aa4f1ff..3f5958d1 100644
--- a/pgmtoppm.html
+++ b/pgmtoppm.html
@@ -36,6 +36,11 @@ space in place of the equals sign to separate an option name from its value.
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
+<p>If all you want to do is convert PGM to PPM, keeping the same gray pixels,
+  you may not need to.  All Netpbm programs that expect PPM input also
+  recognize PGM.  And if you must have a PPM file, use <b>ppmtoppm</b>
+  instead.  It is more efficient and easier to use.
+
 <p><b>pgmtoppm</b> reads a PGM as input and produces a PPM file as
 output with a specific color assigned to each gray value in the input.
 
@@ -63,11 +68,6 @@ option.
 particular gray level is to use <b>pamlookup</b>.  You make an index
 file that explicitly associates a color with each possible gray level.
 
-<p>If all you want to do is convert PGM to PPM, keeping the same gray pixels,
-  you may not need to.  All Netpbm programs that expect PPM input also
-  recognize PGM.  And if you must have a PPM file, use <b>ppmtoppm</b>
-  instead.  It is more efficient and easier to use.
-
   
 <h2 id="options">OPTIONS</h2>
 
diff --git a/picttoppm.html b/picttoppm.html
index 6564e22f..4d472ca7 100644
--- a/picttoppm.html
+++ b/picttoppm.html
@@ -13,7 +13,7 @@ picttoppm - convert a Macintosh PICT file to a PPM
 
 <b>picttoppm</b>
 
-[<b>-verbose</b>]
+[<b>-verbose=</b><i>n</i>]
 
 [<b>-fullres</b>]
 
@@ -79,11 +79,15 @@ not stored in the data fork of a PICT file.
 <dd>Execute only pure quickdraw operations.  In particular, turn off
 the interpretation of special PostScript printer operations.
 
-<dt><b>-verbose</b>
+<dt><b>-verbose=</b><i>n</i>
 
-<dd>Print a whole bunch of information about the PICT file and the
-conversion process that only <b>picttoppm</b> hackers really care
-about.
+<dd>Print a whole bunch of information about the PICT file and the conversion
+process that only <b>picttoppm</b> hackers really care about.
+
+<p><i>n</i> is the verbosity level, 0-2.
+
+<p>Before Netpbm 10.98 (March 2022), this option is a flag option that you
+specify multiple times to specify increasing verbosity.
 
 </dl>
 
diff --git a/ppmtoapplevol.html b/ppmtoapplevol.html
index a67e5b24..96ab769e 100644
--- a/ppmtoapplevol.html
+++ b/ppmtoapplevol.html
@@ -2,7 +2,7 @@
 <html><head><title>Ppmtoapplevol User Manual</title></head>
 <body>
 <h1>ppmtoapplevol</h1>
-Updated: 08 January 2010
+Updated: 27 January 2022
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -26,12 +26,18 @@ volume label image as output.
 <p>EFI-based Apple systems use a simple image format to provide textual labels
 for devices.  This program generates that format.
 
-<p>The input image must be exactly 12 rows tall.  Use <b>pamfile</b> to
-see how tall your image is and <b>pamscale</b> or <b>pamcut</b> to make
-it 12 rows if it isn't.
+<p>The input image must be exactly 12 rows tall and up to 255 columns wide.
+  The program fails if it is not.  Use <b>pamfile</b> to see the dimensions of
+  your image and <b>pamscale</b> or <b>pamcut</b> to make it 12 rows and less
+  than 256 columns if it isn't.
 
 <p>Netpbm does not have a converter for the other direction.
 
+<h2 id="arguments">ARGUMENTS</h2>
+
+<p>The optional <i>ppmfile</i> argument is the name of the input file.
+  The default is to read the input image from Standard Input.
+
 <h2 id="options">OPTIONS</h2>
 
 <p>There are no command line options defined specifically
@@ -54,6 +60,7 @@ Common Options</a>.)
 <ul>
 <li><a href="#synopsis">SYNOPSIS</a>
 <li><a href="#description">DESCRIPTION</a>
+<li><a href="#arguments">ARGUMENTS</a>
 <li><a href="#options">OPTIONS</a>
 <li><a href="#seealso">SEE ALSO</a>
 <li><a href="#history">HISTORY</a>
diff --git a/ppmtoilbm.html b/ppmtoilbm.html
index b94c31a8..c6144e96 100644
--- a/ppmtoilbm.html
+++ b/ppmtoilbm.html
@@ -2,7 +2,7 @@
 <html><head><title>Ppmtoilbm User Manual</title></head>
 <body>
 <h1>ppmtoilbm</h1>
-Updated: 28 June 2015
+Updated: 15 January 2022
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -156,8 +156,8 @@ compression at a minimum, but is very slow.
 <dt><b>-map</b> <i>ppmfile</i>
 
 <dd>Write a normal ILBM using the colors in &lt;ppmfile&gt; as the
-colormap.  The colormap file also determines the number of planes, a
-<b>-maxplanes</b> or <b>-fixplanes</b> option is ignored.
+colormap.  The colormap file also determines the number of planes;
+<b>-maxplanes</b> and <b>-fixplanes</b> are ignored.
 
 <dt><b>-cmaponly</b>
 
@@ -179,7 +179,6 @@ this allows row-by-row operation on HAM images, and all HAM images of
 the same depth (no. of planes) share a common colormap, which is
 useful for building HAM animations.
 
-
 <h2 id="references">REFERENCES</h2>
 
 Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
@@ -197,7 +196,25 @@ Addison Wesley, ISBN 0-201-56775-X
 
 <p>For about a year in 1993-1994, there was a <b>-savemem</b> option.
 
-
+<p>There used to be a <b>-floyd</b> (aka <b>-fs</b>) option that was supposed
+  to cause images to be dithered so that a larger number of colors in the PPM
+  input could be represented in a smaller number of colors in the ILBM output.
+  But it was never documented.  Furthermore, developers discovered in January
+  2022 that the code for this was nonfunctional because of defects, and had
+  been for a very long time and maybe always.  Finally,, this functions is not
+  appropriate in the Netpbm philosophy, because dithering should be done by a
+  separate dithering program, not a format conversion program.  Indeed,
+  the programs <b>ppmdither</b>, <b>pnmquant</b>, and <b>pnmremap</b> can do
+  this.
+
+<p>Therefore, since Netpbm 10.98 (March 2022), the dithering code has not been
+  in the program and any attempt to use the options fails with a simple
+  invalid option message.  But the <b>-nofloyd</b> and <b>-nofs</b> options
+  remain, doing nothing as they were designed to do, and still not documented.
+  This is just in case something uses those options, since the cost of
+  maintaining them is so small.
+
+  
 <h2 id="authors">AUTHORS</h2>
 
 <p>Copyright (C) 1989 by Jef Poskanzer.