about summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2010-02-09 03:45:35 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2010-02-09 03:45:35 +0000
commita0dcd0fdec1283dd7e41063098ee6bb63e97abf6 (patch)
tree49052e4e60cd494ed826a8566129d3cffcf3214c
parent8bb2dba8170bf75940143c1cf2933230e9329551 (diff)
downloadnetpbm-mirror-a0dcd0fdec1283dd7e41063098ee6bb63e97abf6.tar.gz
netpbm-mirror-a0dcd0fdec1283dd7e41063098ee6bb63e97abf6.tar.xz
netpbm-mirror-a0dcd0fdec1283dd7e41063098ee6bb63e97abf6.zip
"miscellaneous update"
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@1121 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--avstopam.html63
-rw-r--r--directory.html6
-rw-r--r--pampaintspill.html143
-rw-r--r--pamslice.html35
-rw-r--r--pamtoavs.html76
5 files changed, 301 insertions, 22 deletions
diff --git a/avstopam.html b/avstopam.html
new file mode 100644
index 00000000..5b359ad4
--- /dev/null
+++ b/avstopam.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<title>Avstopam User Manual</title>
+<meta http-equiv="content-type" content="text/html; charset=us-ascii" />
+</head>
+
+<body>
+
+<h1>avstopam</h1>
+
+<p>Updated: 7 February 2010</p>
+
+<p><a href="#index">Table Of Contents</a></p>
+
+
+<h2>NAME</h2>
+
+<p>avstopam - convert an AVS X image to a Netpbm image</p>
+
+
+<h2><a id="synopsis">SYNOPSIS</a></h2>
+
+<p><b>avstopam</b>
+[<i>avsfile</i>]
+
+
+<h2><a id="description">DESCRIPTION</a></h2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
+
+<p><b>avstopam</b> reads a Stardent <acronym xml:lang="en" title="Application
+Visualization System">AVS</acronym> X image as input and produces a Netpbm
+image as output.</p>
+
+<p><i>avsfile</i> is the input file, which defaults to Standard Input.
+Output is always on Standard Output.
+
+<h2><a id="author">AUTHOR</a></h2>
+
+<p>Copyright&nbsp;&copy; 2010 Scott Pakin,
+<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
+
+
+<h2><a id="see_also">SEE ALSO</a></h2>
+
+<p><a href="pamtoavs.html">pamtoavs</a>, <a href="pam.html">pam</a></p>
+
+
+<hr />
+
+<h2 id="index">Table Of Contents</h2>
+
+<ul>
+<li><a href="#synopsis">SYNOPSIS</a></li>
+<li><a href="#description">DESCRIPTION</a></li>
+<li><a href="#author">AUTHOR</a></li>
+<li><a href="#see_also">SEE ALSO</a></li>
+</ul>
+
+</body>
+</html>
+
diff --git a/directory.html b/directory.html
index 090e7220..1543d9ef 100644
--- a/directory.html
+++ b/directory.html
@@ -151,6 +151,12 @@ convert JBIG BIE (compressed bitmap) to PNM
 <DT><B><a href=pfmtopam.html>pfmtopam</a>  </B>
 <DD>convert HDRshop PFM (Portable Float Map) to PAM
      
+<DT><B><a href=pamtoavs.html>pamtoavs</a>  </B>
+<DD>convert Netpbm image to Stardent AVS
+
+<DT><B><a href=avstopam.html>avstopam</a>  </B>
+<DD>convert Stardent AVS image to PAM
+
 <DT><B><a href=pbmtomrf.html>pbmtomrf</a>  </B>
 <DD>convert PBM image to MRF (compressed bitmap)
 
diff --git a/pampaintspill.html b/pampaintspill.html
new file mode 100644
index 00000000..60df8676
--- /dev/null
+++ b/pampaintspill.html
@@ -0,0 +1,143 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Pampaintspill User Manual</title>
+<meta http-equiv="content-type" content="text/html; charset=us-ascii" />
+</head>
+
+<body>
+
+<h1>pampaintspill</h1>
+
+<p><a href="#index">Table Of Contents</a></p>
+
+<p>pampaintspill - smoothly spill colors into the background</p>
+
+<h2><a name="synopsis">SYNOPSIS</a></h2>
+
+<p>
+<b>pampaintspill</b>
+[<b>--bgcolor</b>=<i>color</i>]
+[<b>--wrap</b>] [<b>--all</b>]
+[<b>--downsample</b>=<i>number</i>]
+[<b>--power</b>=<i>number</i>] [<i>filename</i>]</p>
+
+<P>Minimum unique abbreviations of option are acceptable.  You may use
+double hyphens instead of single hyphen to denote options.  You may use
+white space in place of the equals sign to separate an option name
+from its value.
+
+<h2 id="description">DESCRIPTION</h2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
+
+<p><b>pampaintspill</b> produces a smooth color gradient from all of the
+non-background-colored pixels in an input image, effectively <q>spilling
+paint</q> onto the background.  <b>pampaintspill</b> is similar to
+<b>pamgradient</b> but differs in the following characteristics:</p>
+
+<ul>
+  <li><b>pampaintspill</b> accepts any number of paint
+      sources (non-background-colored pixels), which can lie anywhere
+      on the canvas.  <b>pamgradient</b> accepts exactly
+      four paint sources, one in each corner of the image.</li>
+
+  <li><b>pampaintspill</b> requires an input image while
+      <b>pamgradient</b> generates a new image from
+      scratch.</li>
+
+  <li><b>pampaintspill</b> can produce tileable output and
+      can control how tightly the gradient colors bind to their source
+      pixels.
+</ul>
+
+<p>Results are generally best when the input image contains just a few, crisp
+spots of color. Use your drawing program's pencil tool &mdash; as opposed to a
+paintbrush or airbrush tool &mdash; with a small nib.</p>
+
+<h2 id="options">OPTIONS</h2>
+
+<dl>
+  <dt><b>--bgcolor</b>=<i>color</i></dt>
+  <dd>Explicitly specify the background color. <i>color</i> can be
+      specified using any of the formats accepted by the <a
+      href="libppm.html#colorname"><code>ppm_parsecolor()</code> library
+      routine</a> such as <code>red</code> or <code>#ff0000</code>.  If
+      <b>--bgcolor</b> is not specified, <b>pampaintspill</b> makes an
+      educated guess about the background color based on the colors in the
+      image's corners.</dd>
+
+  <dt><b>--wrap</b></dt>
+  <dd>Allow gradients to wrap around image borders. That is, colors
+      that spill off the right side of the image reappear on the left side of
+      the image and likewise for left/right, top/bottom, and
+      bottom/top. <b>--wrap</b> makes images tileable, which is nice for
+      producing desktop backgrounds.</dd>
+
+  <dt><b>--all</b></dt>
+  <dd>Recolor all pixels, not just background pixels. Normally,
+      non-background-colored pixels in the input image appear unmodified in
+      the output image. With <b>--all</b>, <em>all</em> pixels are colored
+      based on their distance from all of the (other) non-background-colored
+      pixels.</dd>
+
+  <dt><b>--downsample</b>=<i>number</i></dt>
+  <dd>Ignore all but <i>number</i> non-background-colored pixels.
+      When a large number of pixels in the input image differ in color from
+      the background, <b>pampaintspill</b> runs very slowly. The
+      <b>--downsample</b> option randomly selects a given number of colored
+      pixels to use as paint sources for the gradients and ignores the rest,
+      thereby trading off image quality for speed of execution.</dd>
+
+  <dt><b>--power</b>=<i>number</i></dt>
+  <dd>Control how color intensity changes as a function of the
+      distance from a paint source. The default value for <i>number</i> is
+      -2.0, which means that intensity drops (because of the minus sign) with
+      the square (because of the 2.0) of the distance from each paint
+      source. -2.0 generally works well in practice, but other values can be
+      specified for various special effects. With very small numbers of paint
+      sources, -1.0 may produce subtler gradients, but these get muddier as
+      the number of paint sources increases. Positive numbers (e.g., 1.0 and
+      2.0) make the paint sources stand out in the output image by pushing the
+      gradients away from them.</dd>
+</dl>
+
+
+<h2 id="see_also">SEE ALSO</h2>
+
+<ul>
+<li><a href="pamgradient.html">pamgradient</a>
+<li><A href="ppmmake.html"><b>ppmmake</b></A>,
+<li><A href="ppmrainbow.html"><b>ppmrainbow</b></A>,
+<li><A href="pgmramp.html"><b>pgmramp</b></A>,
+<li><A href="ppmpat.html"><b>ppmpat</b></A>,
+<li><a href="pam.html">pam</a>
+</ul>
+
+<h2 id="history">HISTORY</h2>
+
+<p><b>pampaintspill</b> was new in Netpbm 10.50 (March 2010).
+
+
+<h2 id="copyright">COPYRIGHT</h2>
+
+<p>Copyright&nbsp;&copy; 2010 Scott Pakin, <a href=
+"mailto:scott+pbm@pakin.org"><i>scott+pbm@pakin.org</i></a>.</p>
+
+<hr />
+
+<h2 id="index">Table Of Contents</h2>
+
+<ul>
+  <li><a href="#name">NAME</a></li>
+  <li><a href="#synopsis">SYNOPSIS</a></li>
+  <li><a href="#description">DESCRIPTION</a></li>
+  <li><a href="#options">OPTIONS</a></li>
+  <li><a href="#see_also">SEE ALSO</a></li>
+  <li><a href="#history">HISTORY</a></li>
+  <li><a href="#copyright">COPYRIGHT</a></li>
+</ul>
+
+</body>
+</html>
+
diff --git a/pamslice.html b/pamslice.html
index efb42efe..e0e40566 100644
--- a/pamslice.html
+++ b/pamslice.html
@@ -3,16 +3,14 @@
 <HEAD><TITLE>Pamslice User Manual</TITLE></HEAD>
 <BODY>
 <H1>pamslice</H1>
-Updated: 22 June 2002
+Updated: 8 February 2010
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
-<A NAME="lbAB">&nbsp;</A>
 <H2>NAME</H2>
 pamslice - extract one line of values out of a Netpbm image
 
-<A NAME="lbAC">&nbsp;</A>
-<H2>SYNOPSIS</H2>
+<H2 id="synopsis">SYNOPSIS</H2>
 
 <B>pamslice</B>
 {<B>-row=</B><i>rownumber</i> | <B>-column=</B><i>columnnumber</i>}
@@ -24,8 +22,7 @@ pamslice - extract one line of values out of a Netpbm image
 You may use two hyphens instead of one.  You may separate an option
 name and its value with white space instead of an equals sign.
 
-<A NAME="lbAD">&nbsp;</A>
-<H2>DESCRIPTION</H2>
+<H2 id="description">DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
@@ -46,10 +43,9 @@ specifications of the image formats for details on exactly what these
 numbers mean.
 
 If you want to see all the pixels in a PPM, PGM, or PBM image in ASCII
-decimal, <b>pnmtoplainpnm</b> is a good way to do that.
+decimal, <b>pnmtopnm -plain</b> is a good way to do that.
 
-<A NAME="lbAE">&nbsp;</A>
-<H2>OPTIONS</H2>
+<H2 id="options">OPTIONS</H2>
 
 <DL COMPACT>
 <DT><B>-row=</B><i>rownumber</i>
@@ -88,14 +84,12 @@ decimal, <b>pnmtoplainpnm</b> is a good way to do that.
 
 </DL>
 
-<A NAME="lbAF">&nbsp;</A>
-<H2>SEE ALSO</H2>
+<H2 id="seealso">SEE ALSO</H2>
 
 <A HREF="pamcut.html">pamcut</A>
-<A HREF="pnmtoplainpnm.html">pnmtoplainpnm</A>
+<A HREF="pnmtopnm.html">pnmtopnm</A>
 <A HREF="pamchannel.html">pnmtoplainpnm</A>
 <A HREF="pnm.html">pnm</A>
-<A NAME="lbAG">&nbsp;</A>
 
 <a name="history">&nbsp;</a>
 <H2>HISTORY</H2>
@@ -104,8 +98,7 @@ decimal, <b>pnmtoplainpnm</b> is a good way to do that.
 It was backward compatible, but worked on Netpbm images other than PGM and
 PBM and added the <b>-plane</b> and <b>-xmgr</b> options.
 
-<a name="author"></a>
-<H2>AUTHOR</H2>
+<H2 id="author">AUTHOR</H2>
 
 <P>Jos Dingjan &lt;<A
 HREF="mailto:jos@tuatha.org">jos@tuatha.org</A>&gt; wrote
@@ -114,14 +107,12 @@ Beijersbergen's program with the same name.  Bryan Henderson converted it
 to <b>pamslice</b>.
 
 <HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
+<H2 id="index">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">OPTIONS</A>
-<LI><A HREF="#lbAF">SEE ALSO</A>
+<LI><A HREF="#synopsis">SYNOPSIS</A>
+<LI><A HREF="#description">DESCRIPTION</A>
+<LI><A HREF="#options">OPTIONS</A>
+<LI><A HREF="#seealso">SEE ALSO</A>
 <LI><A HREF="#history">HISTORY</A>
 <LI><A HREF="#author">AUTHOR</A>
 </UL>
diff --git a/pamtoavs.html b/pamtoavs.html
new file mode 100644
index 00000000..b79f1e7f
--- /dev/null
+++ b/pamtoavs.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<title>Pamtoavs User Manual</title>
+<meta http-equiv="content-type" content="text/html; charset=us-ascii" />
+</head>
+
+<body>
+
+<h1>pamtoavs</h1>
+
+<p>Updated: 7 February 2010</p>
+
+<p><a href="#index">Table Of Contents</a></p>
+
+
+<h2>NAME</h2>
+
+<p>pamtoavs - convert a Netpbm image to an AVS X image</p>
+
+
+<h2><a id="synopsis">SYNOPSIS</a></h2>
+
+<p><b>pamtoavs</b>
+[<i>netpbmfile</i>]
+
+
+<h2><a id="description">DESCRIPTION</a></h2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
+
+<p><b>pamtoavs</b> reads a Netpbm image as input and produces a Stardent
+<acronym xml:lang="en" title="Application Visualization System">AVS</acronym>
+X image as output. AVS X images are one of the few image formats <a
+href="http://www.gnuplot.info/">Gnuplot</a>&nbsp;v4.2 and later can use.
+
+<p><i>netpbmfile</i> is the input file, which defaults to Standard Input.
+Output is always on Standard Output.
+
+<p>Try the following:</p>
+
+<pre>
+    gnuplot&gt; plot 'myimage.avs' binary filetype=avs with rgbimage
+</pre>
+
+<p>See the <a href="http://www.gnuplot.info/documentation.html">Gnuplot
+manual</a> for more information.</p>
+
+
+<h2><a id="author">AUTHOR</a></h2>
+
+<p>Copyright&nbsp;&copy; 2010 Scott Pakin,
+<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
+
+
+<h2><a id="see_also">SEE ALSO</a></h2>
+
+<p><a href="avstopam.html">avstopam</a>,
+<a href="http://www.gnuplot.info/">gnuplot</a>,
+<a href="pam.html">pam</a></p>
+
+
+<hr />
+
+<h2 id="index">Table Of Contents</h2>
+
+<ul>
+<li><a href="#synopsis">SYNOPSIS</a></li>
+<li><a href="#description">DESCRIPTION</a></li>
+<li><a href="#author">AUTHOR</a></li>
+<li><a href="#see_also">SEE ALSO</a></li>
+</ul>
+
+</body>
+</html>
+