2020-10-07 12:25:58 +00:00
|
|
|
diff --git a/userguide/avstopam.html b/userguide/avstopam.html
|
|
|
|
|
index eb39766..d104518 100644
|
|
|
|
|
--- a/userguide/avstopam.html
|
|
|
|
|
+++ b/userguide/avstopam.html
|
|
|
|
|
@@ -2,25 +2,29 @@
|
|
|
|
|
<html><head><title>Avstopam User Manual</title></head>
|
2018-06-04 12:47:58 +00:00
|
|
|
<body>
|
2020-10-07 12:25:58 +00:00
|
|
|
<h1>avstopam</h1>
|
|
|
|
|
-Updated: 07 February 2010
|
|
|
|
|
-<br>
|
|
|
|
|
+
|
|
|
|
|
+<p>Updated: 7 February 2010</p>
|
|
|
|
|
+
|
|
|
|
|
+<p><a href="#index">Table Of Contents</a></p>
|
|
|
|
|
+
|
|
|
|
|
<a href="#index">Table Of Contents</a>
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-<p>avstopam - convert an AVS X image to a Netpbm image
|
|
|
|
|
+<p>avstopam - convert an AVS X image to a Netpbm image</p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
|
|
-<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
+<h2><a id="synopsis">SYNOPSIS</a></h2>
|
|
|
|
|
|
|
|
|
|
<p><b>avstopam</b>
|
|
|
|
|
[<i>avsfile</i>]
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>avstopam</b> reads a Stardent <abbr title="Application
|
|
|
|
|
Visualization System">AVS</abbr> X image as input and produces a Netpbm
|
|
|
|
|
-image as output.
|
|
|
|
|
+image as output.</p>
|
|
|
|
|
|
|
|
|
|
<p><i>avsfile</i> is the input file, which defaults to Standard Input.
|
|
|
|
|
Output is always on Standard Output.
|
|
|
|
|
@@ -30,26 +34,26 @@ Output is always on Standard Output.
|
|
|
|
|
<p>There are no command line options defined specifically
|
|
|
|
|
for <b>avstopam</b>, but it recognizes the options common to all
|
|
|
|
|
programs based on libnetpbm (See <a href="index.html#commonoptions">
|
|
|
|
|
-Common Options</a>.)
|
|
|
|
|
+Common Options</a>.)</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
|
|
|
|
|
<p>Copyright © 2010 Scott Pakin,
|
|
|
|
|
-<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
+<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
|
|
|
|
|
|
|
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
|
|
|
|
|
-<p><a href="pamtoavs.html">pamtoavs</a>, <a href="pam.html">pam</a>
|
|
|
|
|
+<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><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
+<li><a href="#see_also">SEE ALSO</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
diff --git a/userguide/escp2topbm.html b/userguide/escp2topbm.html
|
|
|
|
|
index 9e808b7..33b19a0 100644
|
|
|
|
|
--- a/userguide/escp2topbm.html
|
|
|
|
|
+++ b/userguide/escp2topbm.html
|
|
|
|
|
@@ -8,6 +8,7 @@ Updated: 14 July 2015
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
|
|
|
|
+<H2>NAME</H2>
|
|
|
|
|
escp2topbm - convert an ESC/P2 printer file to a PBM image
|
|
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
diff --git a/userguide/faxformat.html b/userguide/faxformat.html
|
|
|
|
|
index 44b1ba5..827ffc8 100644
|
|
|
|
|
--- a/userguide/faxformat.html
|
|
|
|
|
+++ b/userguide/faxformat.html
|
2018-06-04 12:47:58 +00:00
|
|
|
@@ -5,10 +5,11 @@
|
|
|
|
|
Updated: 03 December 2008
|
2020-10-07 12:25:58 +00:00
|
|
|
<br>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
|
|
|
|
+<H2>SYNOPSIS</H2>
|
|
|
|
|
<p>This page, part of the <a href="index.html">Netpbm user's guide</a>,
|
|
|
|
|
describes FAX formats in relation to Netpbm facilities.
|
|
|
|
|
|
|
|
|
|
-
|
|
|
|
|
+<H2>DESCRIPTION</H2>
|
|
|
|
|
<p>The ITU (formerly CCITT) publishes standards for operation of fax machines
|
|
|
|
|
(the idea is to provide a way to be sure that a fax machine is able to receive
|
|
|
|
|
a fax sent by another). These standards incidentally specify graphics file
|
2020-10-07 12:25:58 +00:00
|
|
|
diff --git a/userguide/pampaintspill.html b/userguide/pampaintspill.html
|
|
|
|
|
index eeb1cac..e42db76 100644
|
|
|
|
|
--- a/userguide/pampaintspill.html
|
|
|
|
|
+++ b/userguide/pampaintspill.html
|
|
|
|
|
@@ -2,12 +2,12 @@
|
|
|
|
|
<html><head><title>Pampaintspill User Manual</title></head>
|
|
|
|
|
<body>
|
|
|
|
|
<h1>pampaintspill</h1>
|
|
|
|
|
-Updated: 09 February 2020
|
|
|
|
|
+<p>Updated: 09 February 2020
|
|
|
|
|
<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
+<a href="#index">Table Of Contents</a></p>
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
-pampaintspill - smoothly spill colors into the background
|
|
|
|
|
+<p>pampaintspill - smoothly spill colors into the background</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -16,31 +16,31 @@ pampaintspill - smoothly spill colors into the background
|
|
|
|
|
[<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>]
|
|
|
|
|
+[<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.
|
|
|
|
|
+from its value.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<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 "spilling
|
|
|
|
|
paint" onto the background. <b>pampaintspill</b> is similar to
|
|
|
|
|
-<b>pamgradient</b> but differs in the following characteristics:
|
|
|
|
|
+<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.
|
|
|
|
|
+ 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.
|
|
|
|
|
+ scratch.</li>
|
|
|
|
|
|
|
|
|
|
<li><b>pampaintspill</b> can produce tileable output and
|
|
|
|
|
can control how tightly the gradient colors bind to their source
|
|
|
|
|
@@ -49,14 +49,14 @@ paint" onto the background. <b>pampaintspill</b> is similar to
|
|
|
|
|
|
|
|
|
|
<p>Results are generally best when the input image contains just a few, crisp
|
|
|
|
|
spots of color. Use your drawing program's pencil tool — as opposed to a
|
|
|
|
|
-paintbrush or airbrush tool — with a small nib.
|
|
|
|
|
+paintbrush or airbrush tool — with a small nib.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
|
|
|
|
|
<p>In addition to the options common to all programs based on libnetpbm
|
|
|
|
|
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
|
|
|
|
|
Common Options</a>), <b>pampaintspill</b> recognizes the following
|
|
|
|
|
-command line options:
|
|
|
|
|
+command line options:</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
<dt><b>--bgcolor</b>=<i>color</i></dt>
|
|
|
|
|
diff --git a/userguide/pamrecolor.html b/userguide/pamrecolor.html
|
|
|
|
|
index 3f341d4..a5f2671 100644
|
|
|
|
|
--- a/userguide/pamrecolor.html
|
|
|
|
|
+++ b/userguide/pamrecolor.html
|
|
|
|
|
@@ -2,12 +2,15 @@
|
|
|
|
|
<html><head><title>Pamrecolor User Manual</title></head>
|
2018-06-04 12:47:58 +00:00
|
|
|
<body>
|
2020-10-07 12:25:58 +00:00
|
|
|
<h1>pamrecolor</h1>
|
|
|
|
|
-Updated: 31 July 2010
|
|
|
|
|
-<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
|
|
|
|
|
-<h2>NAME</h2>
|
|
|
|
|
-pamrecolor - alter colors without affecting luminance
|
|
|
|
|
+<p>Updated: 31 July 2010</p>
|
|
|
|
|
+
|
|
|
|
|
+<p><a href="#index">Table Of Contents</a></p>
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+<h2 id="name">NAME</h2>
|
|
|
|
|
+
|
|
|
|
|
+<p>pamrecolor - alter colors without affecting luminance</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -22,6 +25,7 @@ pamrecolor - alter colors without affecting luminance
|
|
|
|
|
[<b>-randomseed=</b><i>integer</i>]
|
|
|
|
|
|
|
|
|
|
[<i>infile</i>]
|
|
|
|
|
+</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>Minimum unique abbreviation of option is acceptable. You may use double
|
|
|
|
|
@@ -30,7 +34,7 @@ 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>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamrecolor</b> changes an image's colors to be as close as
|
|
|
|
|
possible to given target colors but with the constraint that the
|
|
|
|
|
@@ -39,7 +43,7 @@ image will look identical if both are converted to grayscale
|
|
|
|
|
(e.g. with
|
|
|
|
|
<a href="ppmtopgm.html">ppmtopgm</a>). You can have <b>pamrecolor</b> select
|
|
|
|
|
target colors randomly, specify a single hue for the entire image, or take the
|
|
|
|
|
-target colors from a target image.
|
|
|
|
|
+target colors from a target image.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamrecolor</b> works on pseudo-Netpbm images based on arbitrary
|
|
|
|
|
color spaces. You can define the color space explicitly or choose one
|
|
|
|
|
@@ -49,7 +53,7 @@ of many that <b>pamrecolor</b> knows by name.
|
|
|
|
|
exact format of the PAM. If you want a PNM (PBM, PGM, or PPM) image,
|
|
|
|
|
use <a href="pamtopnm.html">pamtopnm</a> on the output. There is no
|
|
|
|
|
need to convert if you will use the image as input to a current Netpbm
|
|
|
|
|
-program, but many other programs don't know what a PAM is.
|
|
|
|
|
+program, but many other programs don't know what a PAM is.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
@@ -57,7 +61,7 @@ program, but many other programs don't know what a PAM is.
|
|
|
|
|
<p>In addition to the options common to all programs based on libnetpbm
|
|
|
|
|
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
|
|
|
|
|
Common Options</a>), <b>pamrecolor</b> recognizes the following
|
|
|
|
|
-command line options:
|
|
|
|
|
+command line options:</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
|
|
|
|
|
@@ -109,12 +113,12 @@ the format that uses sRGB.
|
|
|
|
|
<p>The default is "ntsc" because this is the color space that the Netpbm
|
|
|
|
|
formats and many graphics utilities use. As a counterexample,
|
|
|
|
|
<a href="http://www.gimp.org/">GIMP</a> uses sRGB as its native color
|
|
|
|
|
-space.
|
|
|
|
|
+space.</p>
|
|
|
|
|
|
|
|
|
|
<p>The luminance values <b>pamrecolor</b> uses for each of the above come from
|
|
|
|
|
Bruce Lindbloom's
|
|
|
|
|
<a href="http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html">
|
|
|
|
|
-Computing RGB-to-XYZ and XYZ-to-RGB matrices</a> page.</dd>
|
|
|
|
|
+Computing RGB-to-XYZ and XYZ-to-RGB matrices</a> page.</p></dd>
|
|
|
|
|
|
|
|
|
|
<dt><b>--rmult</b>=<i>fraction</i></dt>
|
|
|
|
|
<dt><b>--gmult</b>=<i>fraction</i></dt>
|
|
|
|
|
@@ -137,7 +141,7 @@ library routine</a> (e.g., "hotpink" or "#ff69b4").
|
|
|
|
|
|
|
|
|
|
<p>If you specify neither <b>--targetcolor</b> nor
|
|
|
|
|
<b>--colorfile</b>, <b>pamrecolor</b> will randomly select a target color for
|
|
|
|
|
-each pixel of the input image.
|
|
|
|
|
+each pixel of the input image.</p>
|
|
|
|
|
|
|
|
|
|
<p>You may not specify both <b>-targetcolor</b> and <b>-colorfile</b>.
|
|
|
|
|
|
|
|
|
|
@@ -154,7 +158,7 @@ image to be repeated in a tile pattern.
|
|
|
|
|
|
|
|
|
|
<p>If you specify neither <b>--targetcolor</b> nor
|
|
|
|
|
<b>--colorfile</b>, <b>pamrecolor</b> will randomly select a target color for
|
|
|
|
|
-each pixel of the input image.
|
|
|
|
|
+each pixel of the input image.</p>
|
|
|
|
|
|
|
|
|
|
<p>You may not specify both <b>-targetcolor</b> and <b>-colorfile</b>.
|
|
|
|
|
|
|
|
|
|
@@ -176,23 +180,23 @@ invocations.
|
|
|
|
|
|
|
|
|
|
<h2 id="examples">EXAMPLES</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This command tints an image yellow:
|
|
|
|
|
+<p>This command tints an image yellow:</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
- pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam
|
|
|
|
|
+ pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>This command takes the colors from <b>colorpicture.ppm</b> and applies
|
|
|
|
|
-them to <b>graypicture.pgm</b>:
|
|
|
|
|
+them to <b>graypicture.pgm</b>:</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
- pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam
|
|
|
|
|
+ pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>The grayscale version of <b>colorizedpic.pam</b> will look just like
|
|
|
|
|
graypic.pgm. Note that if you use a non-Netpbm tool to do the conversion to
|
|
|
|
|
grayscale, you may additionally need to specify an
|
|
|
|
|
-appropriate <b>--colorspace</b> value for your conversion tool.
|
|
|
|
|
+appropriate <b>--colorspace</b> value for your conversion tool.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="notes">NOTES</h2>
|
|
|
|
|
@@ -203,25 +207,25 @@ appropriate <b>--colorspace</b> value for your conversion tool.
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Specify a color file that is identical to the input image but with
|
|
|
|
|
some large, colored text added to it. The text will "magically"
|
|
|
|
|
-vanish when the image is converted to grayscale.
|
|
|
|
|
+vanish when the image is converted to grayscale.</li>
|
|
|
|
|
|
|
|
|
|
<li>Provide a low-contrast grayscale image — perhaps a secret
|
|
|
|
|
message written in similar shades of gray — as the input file and
|
|
|
|
|
a colorful but completely different image as the color file. If done
|
|
|
|
|
carefully, the grayscale image can be hidden by the colorful image.
|
|
|
|
|
Only people who know to convert the result to grayscale can recover
|
|
|
|
|
-the original grayscale image.
|
|
|
|
|
+the original grayscale image.</li>
|
|
|
|
|
|
|
|
|
|
<li>Use <b>--targetcolor</b>=tan to make an image look like an
|
|
|
|
|
old-timey photograph (or, more precisely, a
|
|
|
|
|
<a href="http://en.wikipedia.org/wiki/Photographic_print_toning">sepia-toned
|
|
|
|
|
-photograph</a> of the late 1800s).
|
|
|
|
|
+photograph</a> of the late 1800s).</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="history">HISTORY</h2>
|
|
|
|
|
|
|
|
|
|
-<p>Scott Pakin wrote <b>pamrecolor</b> in July 2010.
|
|
|
|
|
+<p>Scott Pakin wrote <b>pamrecolor</b> in July 2010.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamrecolor</b> was new in Netpbm 10.52 (September 2010).
|
|
|
|
|
|
|
|
|
|
@@ -229,7 +233,7 @@ photograph</a> of the late 1800s).
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
|
|
|
|
|
<p>Copyright (C) 2010 Scott
|
|
|
|
|
-Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
+Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
|
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
@@ -246,14 +250,14 @@ Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#examples">EXAMPLES</a>
|
|
|
|
|
-<li><a href="#notes">NOTES</a>
|
|
|
|
|
-<li><a href="#history">HISTORY</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#examples">EXAMPLES</a></li>
|
|
|
|
|
+<li><a href="#notes">NOTES</a></li>
|
|
|
|
|
+<li><a href="#history">HISTORY</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
+<li><a href="#seealso">SEE ALSO</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
diff --git a/userguide/pamsistoaglyph.html b/userguide/pamsistoaglyph.html
|
|
|
|
|
index 1ca53ac..e545986 100644
|
|
|
|
|
--- a/userguide/pamsistoaglyph.html
|
|
|
|
|
+++ b/userguide/pamsistoaglyph.html
|
|
|
|
|
@@ -1,15 +1,18 @@
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
|
|
|
|
|
<html><head><title>Pamsistoaglyph User Manual</title></head>
|
2018-06-04 12:47:58 +00:00
|
|
|
<body>
|
2020-10-07 12:25:58 +00:00
|
|
|
+
|
|
|
|
|
<h1>pamsistoaglyph</h1>
|
|
|
|
|
-Updated: 05 April 2009
|
|
|
|
|
-<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
+
|
|
|
|
|
+<p>Updated: 5 April 2009</p>
|
|
|
|
|
+
|
|
|
|
|
+<p><a href="#index">Table Of Contents</a></p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-pamsistoaglyph - convert a single-image stereogram to a red/cyan
|
|
|
|
|
-anaglyphic image
|
|
|
|
|
+<p>pamsistoaglyph - convert a single-image stereogram to a red/cyan
|
|
|
|
|
+anaglyphic image</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
@@ -20,11 +23,11 @@ anaglyphic image
|
|
|
|
|
[--<b>minsep</b>=<i>number</i>]
|
|
|
|
|
[--<b>gray</b>=<i>number</i>]
|
|
|
|
|
[<i>in_netpbmfile</i>
|
|
|
|
|
-
|
|
|
|
|
+</p>
|
|
|
|
|
|
|
|
|
|
<p>All options can be abbreviated to their shortest unique prefix. You
|
|
|
|
|
may use either white space or an equals sign between an option name
|
|
|
|
|
-and its value.
|
|
|
|
|
+and its value.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
@@ -32,7 +35,7 @@ and its value.
|
|
|
|
|
<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
|
|
|
|
|
<p><b>pamsistoaglyph</b> reads a Netpbm image as input and
|
|
|
|
|
-produces a Netpbm image as output.
|
|
|
|
|
+produces a Netpbm image as output.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamsistoaglyph</b> takes a single-image stereogram
|
|
|
|
|
(SIS) such as those produced by <a href=
|
|
|
|
|
@@ -45,11 +48,11 @@ shape hidden within a single-image stereogram. Anaglyphic stereograms
|
|
|
|
|
are easier to perceive in 3-D but require a pair of red/cyan glasses
|
|
|
|
|
such as those often used to watch 3-D movies. The goal of
|
|
|
|
|
<b>pamsistoaglyph</b> is to help people who have trouble
|
|
|
|
|
-viewing single-image stereograms see the intriguing 3-D effect.
|
|
|
|
|
+viewing single-image stereograms see the intriguing 3-D effect.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamsistoaglyph</b> can convert single-image random-dot
|
|
|
|
|
stereograms (SIRDS), wallpaper stereograms, and even dual-image
|
|
|
|
|
-stereograms to anaglyphic images.
|
|
|
|
|
+stereograms to anaglyphic images.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
@@ -57,13 +60,13 @@ stereograms to anaglyphic images.
|
|
|
|
|
<p>In addition to the options common to all programs based on libnetpbm
|
|
|
|
|
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
|
|
|
|
|
Common Options</a>), <b>pamsistoaglyph</b> recognizes the following
|
|
|
|
|
-command line options:
|
|
|
|
|
+command line options:</p>
|
|
|
|
|
|
|
|
|
|
<p>For most images, no command-line options need to be specified. The
|
|
|
|
|
-following options are available, however, for unusual circumstances.
|
|
|
|
|
+following options are available, however, for unusual circumstances.</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
-<dt><b>--invert</b>
|
|
|
|
|
+<dt><b>--invert</b></dt>
|
|
|
|
|
<dd>Swap the left- and right-eye
|
|
|
|
|
images. <b>pamsistoaglyph</b> assumes that its input
|
|
|
|
|
represents a wall-eyed stereogram and generates the anaglyphic
|
|
|
|
|
@@ -71,17 +74,17 @@ following options are available, however, for unusual circumstances.
|
|
|
|
|
the page where it should pop out of the page (and vice versa),
|
|
|
|
|
this typically implies that the input image represents a
|
|
|
|
|
cross-eyed stereogram. Use <b>--invert</b> to correct
|
|
|
|
|
- the image depth.
|
|
|
|
|
+ the image depth.</dd>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
-<dt><b>--sep</b>=<i>number</i>
|
|
|
|
|
+<dt><b>--sep</b>=<i>number</i></dt>
|
|
|
|
|
<dd>Specify the distance in pixels between the left- and right-eye
|
|
|
|
|
images. Essentially, this corresponds to the distance between
|
|
|
|
|
repetitions of the background pattern. The <b>--sep</b>
|
|
|
|
|
option should rarely be necessary
|
|
|
|
|
as <b>pamsistoaglyph</b> is fairly good at determining
|
|
|
|
|
- automatically the eye-separation distance.
|
|
|
|
|
+ automatically the eye-separation distance.</dd>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
-<dt><b>--minsep</b>=<i>number</i>
|
|
|
|
|
+<dt><b>--minsep</b>=<i>number</i></dt>
|
|
|
|
|
<dd>This option is similar to <b>--sep</b> but
|
|
|
|
|
constrains <b>pamsistoaglyph</b> only to
|
|
|
|
|
a <i>minimum</i> eye-separation distance. Any distance larger
|
|
|
|
|
@@ -90,9 +93,9 @@ following options are available, however, for unusual circumstances.
|
|
|
|
|
as <b>pamsistoaglyph</b> is fairly good at determining
|
|
|
|
|
automatically the eye-separation distance. The default value for
|
|
|
|
|
the minimum eye-separation distance is 10% of the image width;
|
|
|
|
|
- this value seems to work well in practice.
|
|
|
|
|
+ this value seems to work well in practice.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>--gray</b>=<i>number</i>
|
|
|
|
|
+<dt><b>--gray</b>=<i>number</i></dt>
|
|
|
|
|
<dd>Limit the number of gray levels to use when searching for the
|
|
|
|
|
optimal eye-separation
|
|
|
|
|
distance. Because <b>pamsistoaglyph</b> looks for
|
|
|
|
|
@@ -103,7 +106,7 @@ following options are available, however, for unusual circumstances.
|
|
|
|
|
unintentional color variations (such as those caused by conversion
|
|
|
|
|
from a low-quality JPEG image, for example). The default of 63
|
|
|
|
|
seems to work well so the <b>--gray</b> option should
|
|
|
|
|
- rarely be necessary.
|
|
|
|
|
+ rarely be necessary.</dd>
|
|
|
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@@ -112,22 +115,22 @@ following options are available, however, for unusual circumstances.
|
|
|
|
|
<p>The registration algorithm used by <b>pamsistoaglyph</b>
|
|
|
|
|
was developed specifically for this program. As far as the author
|
|
|
|
|
knows, there are no existing algorithms for converting stereograms to
|
|
|
|
|
-anaglyphs. The algorithm works as follows:
|
|
|
|
|
+anaglyphs. The algorithm works as follows:</p>
|
|
|
|
|
|
|
|
|
|
<ol>
|
|
|
|
|
<li>Convert the image to grayscale to increase the ability to identify
|
|
|
|
|
- matches.
|
|
|
|
|
+ matches.</li>
|
|
|
|
|
|
|
|
|
|
<li>Count the number of pixels that match <i>N</i> pixels ahead in the
|
|
|
|
|
- image for all <i>N</i> in [1, <i>width</i>/2].
|
|
|
|
|
+ image for all <i>N</i> in [1, <i>width</i>/2].</li>
|
|
|
|
|
|
|
|
|
|
<li>Maintain a running mean (μ) and standard deviation (σ) of
|
|
|
|
|
- the number of matched pixels.
|
|
|
|
|
+ the number of matched pixels.</li>
|
|
|
|
|
|
|
|
|
|
<li>Store the <i>N</i> corresponding to each spike in the number of
|
|
|
|
|
matched pixels. A spike is defined as a tally that exceeds the
|
|
|
|
|
mean plus one, two, or three standard deviations. Only the first
|
|
|
|
|
- spike of a given standard-deviation multiplier is stored.
|
|
|
|
|
+ spike of a given standard-deviation multiplier is stored.</li>
|
|
|
|
|
|
|
|
|
|
<li>If a tally greater than μ+3σ was encountered, return the
|
|
|
|
|
corresponding <i>N</i>. If not, then if a tally greater than
|
|
|
|
|
@@ -138,13 +141,13 @@ anaglyphs. The algorithm works as follows:
|
|
|
|
|
produces the minimum average distance between matched pixels
|
|
|
|
|
(i.e., <i>#matches</i> divided by <i>#pixels</i>). If no
|
|
|
|
|
such <i>N</i> exceeds the minimum allowable eye-separation value,
|
|
|
|
|
- return zero to indicate failure.
|
|
|
|
|
+ return zero to indicate failure.</li>
|
|
|
|
|
|
|
|
|
|
<li>If the algorithm returned zero, rerun the algorithm independently
|
|
|
|
|
on each row of the input image and return the median of
|
|
|
|
|
all <i>N</i> that exceed the minimum allowable eye-separation
|
|
|
|
|
value. If no such <i>N</i> exists, abort with an error
|
|
|
|
|
- message.
|
|
|
|
|
+ message.</li>
|
|
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<h2 id="history">HISTORY</h2>
|
|
|
|
|
@@ -156,7 +159,7 @@ in Netpbm in Release 10.47 (June 2009).
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
|
|
|
|
|
<p>Copyright (C) 2009 Scott
|
|
|
|
|
-Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
+Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
@@ -174,13 +177,13 @@ Pakin, <a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#notes">NOTES</a>
|
|
|
|
|
-<li><a href="#history">HISTORY</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#notes">NOTES</a></li>
|
|
|
|
|
+<li><a href="#history">HISTORY</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
+<li><a href="#seealso">SEE ALSO</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
diff --git a/userguide/pamstereogram.html b/userguide/pamstereogram.html
|
|
|
|
|
index 759ca28..eec0e66 100644
|
|
|
|
|
--- a/userguide/pamstereogram.html
|
|
|
|
|
+++ b/userguide/pamstereogram.html
|
|
|
|
|
@@ -2,13 +2,16 @@
|
|
|
|
|
<html><head><title>Pamstereogram User Manual</title></head>
|
|
|
|
|
<body>
|
|
|
|
|
<h1>pamstereogram</h1>
|
|
|
|
|
-Updated: 10 May 2020
|
|
|
|
|
-<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
+
|
|
|
|
|
+<p>Updated: 10 May 2020</p>
|
|
|
|
|
+
|
2018-06-04 12:47:58 +00:00
|
|
|
+<p><a href="#index">Table Of Contents</a></p>
|
2020-10-07 12:25:58 +00:00
|
|
|
+
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-pamstereogram - create a single-image stereogram from a PAM depth map
|
|
|
|
|
+<p>pamstereogram - create a single-image stereogram from a PAM
|
|
|
|
|
+depth map</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -38,13 +41,13 @@ pamstereogram - create a single-image stereogram from a PAM depth map
|
|
|
|
|
[<b>-randomseed=</b><i>integer</i>]
|
|
|
|
|
[<b>-tileable</b>]
|
|
|
|
|
[<i>infile</i>]
|
|
|
|
|
-
|
|
|
|
|
+</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamstereogram</b> inputs a depth map (a map of the distances
|
|
|
|
|
from your eye of the points in a scene) and outputs a single-image
|
|
|
|
|
@@ -54,22 +57,22 @@ eyes. What's exciting about single-image stereograms is that they
|
|
|
|
|
don't require special glasses to view, although it does require a bit
|
|
|
|
|
of practice to train your eyes to unfocus properly. The
|
|
|
|
|
<b>pamstereogram</b> program provides a wealth of control over how the
|
|
|
|
|
-stereogram is generated, including the following:
|
|
|
|
|
+stereogram is generated, including the following:</p>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
-<li>black and white, grayscale, or color output
|
|
|
|
|
+<li>black and white, grayscale, or color output</li>
|
|
|
|
|
|
|
|
|
|
<li>single-image random-dot stereograms (SIRDS), single-image
|
|
|
|
|
stereograms (SIS) using a tiled image, or mapped-texture stereograms
|
|
|
|
|
-(MTS)
|
|
|
|
|
+(MTS)</li>
|
|
|
|
|
|
|
|
|
|
-<li>images targeting a given device resolution and eye separation
|
|
|
|
|
+<li>images targeting a given device resolution and eye separation</li>
|
|
|
|
|
|
|
|
|
|
-<li>optional guide boxes to assist in focusing
|
|
|
|
|
+<li>optional guide boxes to assist in focusing</li>
|
|
|
|
|
|
|
|
|
|
-<li>the ability to trade off depth levels for easier viewing
|
|
|
|
|
+<li>the ability to trade off depth levels for easier viewing</li>
|
|
|
|
|
|
|
|
|
|
-<li>choice of wall-eyed or cross-eyed stereograms
|
|
|
|
|
+<li>choice of wall-eyed or cross-eyed stereograms</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
<p>The output is a PAM image on standard output. Options control
|
|
|
|
|
@@ -79,7 +82,7 @@ if you will use the image as input to a current Netpbm program, but
|
|
|
|
|
many other programs don't know what a PAM is.
|
|
|
|
|
|
|
|
|
|
<p>To make a red/green type of stereogram (that you view with 3-D
|
|
|
|
|
-glasses) instead, see <b>ppm3d</b>.
|
|
|
|
|
+glasses) instead, see <b>ppm3d</b>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
@@ -87,36 +90,36 @@ glasses) instead, see <b>ppm3d</b>.
|
|
|
|
|
<p>In addition to the options common to all programs based on libnetpbm
|
|
|
|
|
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
|
|
|
|
|
Common Options</a>), <b>pamstereogram</b> recognizes the following
|
|
|
|
|
-command line options:
|
|
|
|
|
+command line options:</p>
|
|
|
|
|
|
|
|
|
|
<p>You may use either single or double hyphens to denote options. You
|
|
|
|
|
may use either whitespace or an equals sign to separate an option name
|
|
|
|
|
-from its value.
|
|
|
|
|
+from its value.</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-verbose</b>
|
|
|
|
|
+<dt><b>-verbose</b></dt>
|
|
|
|
|
<dd>Display messages about image sizes and formats and properties
|
|
|
|
|
-of the stereogram being generated.
|
|
|
|
|
+of the stereogram being generated.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-blackandwhite</b>
|
|
|
|
|
+<dt><b>-blackandwhite</b></dt>
|
|
|
|
|
<dd>Produce a single-image random-dot black-and-white stereogram.
|
|
|
|
|
-This is the default.
|
|
|
|
|
+This is the default.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-grayscale</b>
|
|
|
|
|
-<dd>Produce a single-image random-dot grayscale stereogram.
|
|
|
|
|
+<dt><b>-grayscale</b></dt>
|
|
|
|
|
+<dd>Produce a single-image random-dot grayscale stereogram.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-color</b>
|
|
|
|
|
-<dd>Produce a single-image random-dot color stereogram.
|
|
|
|
|
+<dt><b>-color</b></dt>
|
|
|
|
|
+<dd>Produce a single-image random-dot color stereogram.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-maxval=</b><i>value</i>
|
|
|
|
|
+<dt><b>-maxval=</b><i>value</i></dt>
|
|
|
|
|
<dd>Designate the maximum value of each gray/color component, i.e.
|
|
|
|
|
the color resolution. Smaller values make the output image have
|
|
|
|
|
smaller numbers of unique grays/colors. If you don't specify
|
|
|
|
|
<b>-maxval</b>, <b>pamstereogram</b> uses the maxval of the input
|
|
|
|
|
-image. This option has no effect with <b>-blackandwhite</b>.
|
|
|
|
|
+image. This option has no effect with <b>-blackandwhite</b>.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-patfile=</b><i>pamfile</i>
|
|
|
|
|
+<dt><b>-patfile=</b><i>pamfile</i></dt>
|
|
|
|
|
<dd>Specify an image to use as a repeated background pattern for
|
|
|
|
|
the stereogram instead of a random-dot pattern. Intricate images
|
|
|
|
|
generally produce a crisper 3-D effect that simpler images. The
|
|
|
|
|
@@ -125,9 +128,9 @@ grayscale or color) as the pattern file. You cannot specify the
|
|
|
|
|
<b>-patfile</b> option along with <b>-blackandwhite</b>,
|
|
|
|
|
<b>-grayscale</b>, <b>-color</b>, or <b>-maxval</b>. The
|
|
|
|
|
<b>-verbose</b> option will give you information on the ideal
|
|
|
|
|
-dimensions of the pattern file.
|
|
|
|
|
+dimensions of the pattern file.</p>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-xbegin=</b><i>pixels</i>
|
|
|
|
|
+<dt><b>-xbegin=</b><i>pixels</i></dt>
|
|
|
|
|
<dd>Specify the horizontal coordinate at which to begin stereogram generation.
|
|
|
|
|
The background pattern will be minimally distorted at this point and more
|
|
|
|
|
distorted at greater distances. Consider using this in conjunction
|
|
|
|
|
@@ -141,7 +144,7 @@ and <b>pamstereogram</b> actually ignores it with respect to <b>-texfile</b>
|
|
|
|
|
|
|
|
|
|
<p>This option was new in Netpbm 10.71 (June 2015).
|
|
|
|
|
|
|
|
|
|
-<dt><b>-texfile=</b><i>pamfile</i>
|
|
|
|
|
+<dt><b>-texfile=</b><i>pamfile</i></dt>
|
|
|
|
|
<dd>Specify an image to use as the texture for a mapped-texture
|
|
|
|
|
stereogram. The idea is that the depth-map image provides the depth
|
|
|
|
|
values of the 3-D object/scene while the texture image provides the
|
|
|
|
|
@@ -150,10 +153,10 @@ the depth-map image. (Note that it's required to have the same
|
|
|
|
|
dimensions.) The texture image's background color is ignored when
|
|
|
|
|
blending colors.
|
|
|
|
|
|
|
|
|
|
-<p>This option was new in Netpbm 10.53 (December 2010).
|
|
|
|
|
-
|
|
|
|
|
+<p>This option was new in Netpbm 10.53 (December 2010).</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-bgcolor=</b><i>color</i>
|
|
|
|
|
+<dt><b>-bgcolor=</b><i>color</i></dt>
|
|
|
|
|
<dd>Use <i>color</i> as the texture image's background color instead
|
|
|
|
|
of letting <b>pamstereogram</b> determine it automatically. Specify
|
|
|
|
|
the color as described for the
|
|
|
|
|
@@ -161,10 +164,10 @@ the color as described for the
|
|
|
|
|
routine</a>. The <b>-bgcolor</b> option is meaningful only in conjunction
|
|
|
|
|
with <b>-texfile</b>.
|
|
|
|
|
|
|
|
|
|
-<p>This option was new in Netpbm 10.53 (December 2010).
|
|
|
|
|
-
|
|
|
|
|
+<p>This option was new in Netpbm 10.53 (December 2010).</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-smoothing=</b><i>pixels</i>
|
|
|
|
|
+<dt><b>-smoothing=</b><i>pixels</i></dt>
|
|
|
|
|
<dd>When used without <b>-texfile</b>, attempt to eliminate artifacts
|
|
|
|
|
introduced by edges in the depth map if <i>pixels</i> is greater than zero.
|
|
|
|
|
|
|
|
|
|
@@ -175,29 +178,29 @@ by the stereogram's color constraints when producing a mapped-texture
|
|
|
|
|
stereogram. In this case, the <b>-smoothing</b> option is helpful
|
|
|
|
|
when the texture image includes smooth color transitions (as in a
|
|
|
|
|
photograph) but makes crisp texture images (as in a line drawing)
|
|
|
|
|
-appear blurry.
|
|
|
|
|
+appear blurry.</p>
|
|
|
|
|
|
|
|
|
|
<p>This option was new in Netpbm 10.53 (December 2010). Before
|
|
|
|
|
-Netpbm 10.61 (December 2012), it has no effect without <b>-texfile</b>.
|
|
|
|
|
+Netpbm 10.61 (December 2012), it has no effect without <b>-texfile</b>.</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-
|
|
|
|
|
-<dt><b>-xshift=</b><i>pixels</i>
|
|
|
|
|
+<dt><b>-xshift=</b><i>pixels</i></dt>
|
|
|
|
|
<dd>Shift the pattern image (designated by <b>-patfile</b>) to the
|
|
|
|
|
right by <i>pixels</i> pixels (default: 0).
|
|
|
|
|
-<!-- -xshift is helpful when creating "true-color" stereograms. -->
|
|
|
|
|
-This option is valid only along with <b>-patfile</b>.
|
|
|
|
|
+<!-- <b>-xshift</b> is helpful when creating "true-color" stereograms. -->
|
|
|
|
|
+This option is valid only along with <b>-patfile</b>.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-yshift</b> <i>pixels</i>
|
|
|
|
|
+<dt><b>-yshift</b> <i>pixels</i></dt>
|
|
|
|
|
<dd>Shift the pattern image (designated by <b>-patfile</b>)
|
|
|
|
|
downwards by <i>pixels</i> pixels (default: 0). This option is
|
|
|
|
|
-valid only along with <b>-patfile</b>.
|
|
|
|
|
+valid only along with <b>-patfile</b>.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-magnifypat=</b><i>scale</i>
|
|
|
|
|
+<dt><b>-magnifypat=</b><i>scale</i></dt>
|
|
|
|
|
<dd>Magnify each pixel in the pattern file or each random dot by
|
|
|
|
|
integral scaling factor <i>scale</i>. Note that
|
|
|
|
|
<b>pamstereogram</b> applies the pattern magnification
|
|
|
|
|
<em>after</em> pattern shifting (<b>-xshift</b> and
|
|
|
|
|
-<b>-yshift</b>).
|
|
|
|
|
+<b>-yshift</b>).</dd>
|
|
|
|
|
|
|
|
|
|
<dt><b>-guidebottom</b>
|
|
|
|
|
<dd>
|
|
|
|
|
@@ -211,7 +214,7 @@ square. At that point, a crisp, 3-D image will appear.
|
|
|
|
|
<p>This option was new in Netpbm 10.61 (December 2012). Before that,
|
|
|
|
|
the presence of <b>-guidesize</b>, with a positive value, has the same
|
|
|
|
|
effect.
|
|
|
|
|
-
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
<dt><b>-guidetop</b>
|
|
|
|
|
<dd>
|
|
|
|
|
@@ -221,7 +224,7 @@ Same as <b>-guidebottom</b>, except the guides go at the top of the image.
|
|
|
|
|
the presence of <b>-guidesize</b>, with a negative value, has the same
|
|
|
|
|
effect.
|
|
|
|
|
|
|
|
|
|
-<dt><b>-guidesize=</b><i>pixels</i>
|
|
|
|
|
+<dt><b>-guidesize=</b><i>pixels</i></dt>
|
|
|
|
|
|
|
|
|
|
<dd>The size (width and height) of each guide box.
|
|
|
|
|
|
|
|
|
|
@@ -236,15 +239,15 @@ too, and if you specify it with a negative value, it behaves as if you
|
|
|
|
|
specified <b>-guidetop</b> and specified <b>guidesize</b> with the absolute
|
|
|
|
|
value of that negative value.
|
|
|
|
|
|
|
|
|
|
-<dt><b>-dpi=</b><i>resolution</i>
|
|
|
|
|
+<dt><b>-dpi=</b><i>resolution</i></dt>
|
|
|
|
|
<dd>Specify the resolution of the output device in dots per inch.
|
|
|
|
|
The default is 100 DPI, which represents a fairly crisp screen
|
|
|
|
|
resolution.
|
|
|
|
|
|
|
|
|
|
-<p>Before Netpbm 10.53 (December 2010), the default was 96 DPI.
|
|
|
|
|
-
|
|
|
|
|
+<p>Before Netpbm 10.53 (December 2010), the default was 96 DPI.</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-crosseyed</b>
|
|
|
|
|
+<dt><b>-crosseyed</b></dt>
|
|
|
|
|
<dd>Invert the gray levels in the depth map (input image) so that the 3-D
|
|
|
|
|
image pops out of the page where it would otherwise sink into the page and
|
|
|
|
|
vice versa. Some people are unable to diverge their eyes and can only cross
|
|
|
|
|
@@ -255,10 +258,10 @@ colors are farther from the eye.
|
|
|
|
|
|
|
|
|
|
<p>Before Netpbm 10.53 (December 2010), <b>pamstereogram</b> used higher
|
|
|
|
|
(lighter) numbers for things closer to the eye <em>without</em>
|
|
|
|
|
-<b>-crosseyed</b> and vice versa.
|
|
|
|
|
+<b>-crosseyed</b> and vice versa.</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-
|
|
|
|
|
-<dt><b>-makemask</b>
|
|
|
|
|
+<dt><b>-makemask</b></dt>
|
|
|
|
|
<dd>Instead of a stereogram, output a PAM mask image showing
|
|
|
|
|
coloring constraints. New pixels will be taken from the pattern
|
|
|
|
|
file where the mask is black. Copies of existing pixels will be
|
|
|
|
|
@@ -266,30 +269,30 @@ taken from the pattern file where the mask is white. The
|
|
|
|
|
<b>-makemask</b> option can be used to help create more
|
|
|
|
|
sophisticated pattern files (to use with <b>-patfile</b>) Note that
|
|
|
|
|
<b>-makemask</b> ignores <b>-magnifypat</b>; it always produces
|
|
|
|
|
-masks that assume a pattern magnification of 1.
|
|
|
|
|
+masks that assume a pattern magnification of 1.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-eyesep=</b><i>inches</i>
|
|
|
|
|
+<dt><b>-eyesep=</b><i>inches</i></dt>
|
|
|
|
|
<dd>Specify the separation in inches between your eyes. The
|
|
|
|
|
default, 2.5 inches (6.4 cm), should be sufficient for most people
|
|
|
|
|
-and probably doesn't need to be changed.
|
|
|
|
|
+and probably doesn't need to be changed.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-depth=</b><i>fraction</i>
|
|
|
|
|
+<dt><b>-depth=</b><i>fraction</i></dt>
|
|
|
|
|
<dd>Specify the output image's depth of field. That is,
|
|
|
|
|
<i>fraction</i> represents the fractional distance of the near
|
|
|
|
|
plane from the far plane. Smaller numbers make the 3-D image easier
|
|
|
|
|
to perceive but flatter. Larger numbers make the 3-D image more
|
|
|
|
|
difficult to perceive but deeper. The default, 0.3333, generally
|
|
|
|
|
-works fairly well.
|
|
|
|
|
+works fairly well.</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-planes=</b><i>near_pixels</i>,<i>far_pixels</i>
|
|
|
|
|
+<dt><b>-planes=</b><i>near_pixels</i>,<i>far_pixels</i></dt>
|
|
|
|
|
<dd>Explicitly specify the distance between repeated pixels in the near plane
|
|
|
|
|
and in the far plane. This is an alternative to
|
|
|
|
|
<b>-eyesep</b> and <b>-depth</b>. The following equalities hold:
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
- <li><i>eyesep</i> = 2 * <i>far</i>
|
|
|
|
|
+ <li><i>eyesep</i> = 2 * <i>far</i></li>
|
|
|
|
|
<li><i>depth</i> = 2 * (<i>far</i> − <i>near</i>) /
|
|
|
|
|
- (2 * <i>far</i> − <i>near</i>)
|
|
|
|
|
+ (2 * <i>far</i> − <i>near</i>)</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<p>The number of distinct 3-D depths is <i>far</i>
|
|
|
|
|
@@ -299,10 +302,10 @@ parameters (distance between eyes and tradeoff between perceptibility
|
|
|
|
|
and depth) while <b>-planes</b> is a more computer-centric way (pixel
|
|
|
|
|
distances in the resulting stereogram).
|
|
|
|
|
|
|
|
|
|
-<p>This option was new in Netpbm 10.59 (June 2012).
|
|
|
|
|
-
|
|
|
|
|
+<p>This option was new in Netpbm 10.59 (June 2012).</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-randomseed=</b><i>integer</i>
|
|
|
|
|
+<dt><b>-randomseed=</b><i>integer</i></dt>
|
|
|
|
|
<dd>Specify a seed to be used for the random number generator.
|
|
|
|
|
The default is to use a seed based on the time of day, to one second
|
|
|
|
|
granularity.
|
|
|
|
|
@@ -313,18 +316,19 @@ every time you run <b>pamstereogram</b>.
|
|
|
|
|
|
|
|
|
|
<p>This is irrelevant if you use a pattern file (<b>-patfile</b>
|
|
|
|
|
option), because there is no random element to <b>pamstereogram</b>'s
|
|
|
|
|
-behavior.
|
|
|
|
|
+behavior.</p>
|
|
|
|
|
|
|
|
|
|
-<p>This option was new in Netpbm 10.32 (February 2006).
|
|
|
|
|
+<p>This option was new in Netpbm 10.32 (February 2006).</p>
|
|
|
|
|
+</dd>
|
|
|
|
|
|
|
|
|
|
-<dt><b>-tileable</b>
|
|
|
|
|
+<dt><b>-tileable</b></dt>
|
|
|
|
|
|
|
|
|
|
<dd>Make the generated image horizontally tileable. This works by
|
|
|
|
|
blending a left-to-right rendering (the equivalent
|
|
|
|
|
of <b>-xbegin</b>=0) with a right-to-left rendering (the equivalent
|
|
|
|
|
of <b>-xbegin</b>=<i>width−1</i>).
|
|
|
|
|
|
|
|
|
|
-<p>This option was new in Netpbm 10.91 (June 2020).
|
|
|
|
|
+<p>This option was new in Netpbm 10.91 (June 2020).</p></dd>
|
|
|
|
|
|
|
|
|
|
</dl>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
@@ -333,7 +337,7 @@ of <b>-xbegin</b>=<i>width−1</i>).
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<p>The only parameter, <i>infile</i>, is the name of an input file
|
|
|
|
|
that is a depth map image. If you don't specify <i>infile</i>, the
|
|
|
|
|
-input is from standard input.
|
|
|
|
|
+input is from standard input.</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<p>The input is a PAM image of depth 1. Each sample represents the
|
|
|
|
|
distance from the eye that the 3-D image at that location should
|
|
|
|
|
@@ -344,10 +348,10 @@ be. Lower (darker) numbers mean further from the eye.
|
|
|
|
|
<h3 id="inputimages">Input Images</h3>
|
|
|
|
|
|
|
|
|
|
<p><b>pamstereogram</b> pays no attention to the image's tuple type and
|
|
|
|
|
-ignores all planes other than plane 0.
|
|
|
|
|
+ignores all planes other than plane 0.</p>
|
|
|
|
|
|
|
|
|
|
<p>Like any Netpbm program, <b>pamstereogram</b> will accept PNM
|
|
|
|
|
-input as if it were the PAM equivalent.
|
|
|
|
|
+input as if it were the PAM equivalent.</p>
|
|
|
|
|
|
|
|
|
|
<h3 id="mappedtexture">Mapped-texture Stereograms</h3>
|
|
|
|
|
|
|
|
|
|
@@ -355,12 +359,12 @@ input as if it were the PAM equivalent.
|
|
|
|
|
drawn with true colors. Unlike a SIRDS or tiled-image SIS, however,
|
|
|
|
|
the image portrayed by an MTS is apparent in normal 2-D viewing. It
|
|
|
|
|
appears repeated multiple times and overlapped with itself, but it is
|
|
|
|
|
-not hidden.
|
|
|
|
|
+not hidden.</p>
|
|
|
|
|
|
|
|
|
|
<p>You create an MTS with <b>pamstereogram</b> by passing the filename
|
|
|
|
|
of a PAM "texture image" with a <b>-texfile</b> option. A
|
|
|
|
|
texture image portrays the same 3-D object as the depth-map image but
|
|
|
|
|
-indicates the colors that the program should apply to the object.
|
|
|
|
|
+indicates the colors that the program should apply to the object.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamstereogram</b> ignores the texture image's background color when it
|
|
|
|
|
overlaps copies of the 3-D object. This prevents, for example, a bright-red
|
|
|
|
|
@@ -370,32 +374,32 @@ object remains bright red. A consequence of this feature is that an MTS looks
|
|
|
|
|
best when the objects in the texture image have a crisp outline. Smooth
|
|
|
|
|
transitions to the background color result in unwanted color artifacts around
|
|
|
|
|
edges because the program ignores only <em>exact</em> matches with the
|
|
|
|
|
-background color.
|
|
|
|
|
+background color.</p>
|
|
|
|
|
|
|
|
|
|
<p>You should specify a larger-than-normal value for <b>-eyesep</b>
|
|
|
|
|
(and/or <b>-dpi</b>) when producing an MTS. Otherwise, the 3-D object will
|
|
|
|
|
repeat so many times that most colored pixels will overlap other colored
|
|
|
|
|
-pixels, reducing the number of true-colored pixels that remain.
|
|
|
|
|
+pixels, reducing the number of true-colored pixels that remain.</p>
|
|
|
|
|
|
|
|
|
|
<p>An MTS can employ a background pattern (<b>-patfile</b>). In this
|
|
|
|
|
case, <b>pamstereogram</b> replaces background pixels with pattern pixels in
|
|
|
|
|
-the final step of generating the image.
|
|
|
|
|
+the final step of generating the image.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h3 id="notes_misc">Miscellaneous</h3>
|
|
|
|
|
|
|
|
|
|
<p>A good initial test is to input an image consisting of a solid
|
|
|
|
|
shape of distance 0 within a large field of maximum distance (e.g., a
|
|
|
|
|
-white square on a black background).
|
|
|
|
|
+white square on a black background).</p>
|
|
|
|
|
|
|
|
|
|
<p>With the default values for <b>-dpi</b> and <b>-eyesep</b>, pattern
|
|
|
|
|
-images that are 128 pixels wide can tile seamlessly.
|
|
|
|
|
+images that are 128 pixels wide can tile seamlessly.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="examples">EXAMPLES</h2>
|
|
|
|
|
|
|
|
|
|
<p>Generate a SIRDS out of small, brightly colored squares and
|
|
|
|
|
-prepare it for display on an 87 DPI monitor:
|
|
|
|
|
+prepare it for display on an 87 DPI monitor:</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
pamstereogram depthmap.pam \
|
|
|
|
|
@@ -406,7 +410,7 @@ prepare it for display on an 87 DPI monitor:
|
|
|
|
|
<p>Generate a SIS by tiling a PPM file (a prior run with
|
|
|
|
|
<b>-verbose</b> indicates how wide the pattern file should be for
|
|
|
|
|
seamless tiling, although any width is acceptable for producing
|
|
|
|
|
-SISes):
|
|
|
|
|
+SISes):</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
pamstereogram depthmap.pam -patfile mypattern.ppm >3d.pam
|
|
|
|
|
@@ -416,7 +420,7 @@ SISes):
|
|
|
|
|
<p>Generate an MTS by associating colors with a depth-mapped object
|
|
|
|
|
(using a large eye separation to reduce the number of repetitions of
|
|
|
|
|
the texture image) and twice smoothing over background-colored
|
|
|
|
|
-speckles:
|
|
|
|
|
+speckles:</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
pamstereogram depthmap.pam \
|
|
|
|
|
@@ -427,21 +431,21 @@ speckles:
|
|
|
|
|
|
|
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="pam.html">pam</a>
|
|
|
|
|
+<li><a href="pam.html">pam</a></li>
|
|
|
|
|
|
|
|
|
|
-<li><a href="pamsistoaglyph.html">pamsistoaglyph</a>
|
|
|
|
|
+<li><a href="pamsistoaglyph.html">pamsistoaglyph</a></li>
|
|
|
|
|
|
|
|
|
|
-<li><a href="ppm3d.html">ppm3d</a>
|
|
|
|
|
+<li><a href="ppm3d.html">ppm3d</a></li>
|
|
|
|
|
|
|
|
|
|
<li>Harold W. Thimbleby, Stuart Inglis, and Ian H. Witten.
|
|
|
|
|
<em>Displaying 3D Images: Algorithms for Single Image Random Dot
|
|
|
|
|
Stereograms</em>. In IEEE Computer, <strong>27</strong>(10):38-48,
|
|
|
|
|
October 1994. DOI: <a
|
|
|
|
|
-href="http://dx.doi.org/10.1109/2.318576">10.1109/2.318576</a>.
|
|
|
|
|
+href="http://dx.doi.org/10.1109/2.318576">10.1109/2.318576</a>.</li>
|
|
|
|
|
|
|
|
|
|
<li>W. A. Steer.
|
|
|
|
|
<em>Stereograms: Technical Details</em>.
|
|
|
|
|
-URL: <a href="http://www.techmind.org/stereo/stech.html">http://www.techmind.org/stereo/stech.html</a>.
|
|
|
|
|
+URL: <a href="http://www.techmind.org/stereo/stech.html">http://www.techmind.org/stereo/stech.html</a>.</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@@ -457,24 +461,25 @@ Netpbm 10.61 (December 2012).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
-<p>Copyright © 2006-2020 Scott Pakin, <a href="mailto:scott+pbm@pakin.org">scott+pbm@pakin.org</a>.
|
|
|
|
|
+<p>Copyright © 2006-2020 Scott Pakin, <a href="mailto:scott+pbm@pakin.org">scott+pbm@pakin.org</a>.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#parameters">PARAMETERS</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#parameters">PARAMETERS</a></li>
|
|
|
|
|
<li><a href="#notes">NOTES</a>
|
|
|
|
|
- <ul>
|
|
|
|
|
- <li><a href="#inputimages">Input Images</a>
|
|
|
|
|
- <li><a href="#mappedtexture">Mapped-texture Stereograms</a>
|
|
|
|
|
- <li><a href="#notes_misc">Miscellaneous</a>
|
|
|
|
|
+<ul>
|
|
|
|
|
+ <li><a href="#inputimages">Input Images</a></li>
|
|
|
|
|
+ <li><a href="#mappedtexture">Mapped-texture Stereograms</a></li>
|
|
|
|
|
+ <li><a href="#notes_misc">Miscellaneous</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
-<li><a href="#examples">EXAMPLES</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
-<li><a href="#history">HISTORY</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
+</li>
|
|
|
|
|
+<li><a href="#examples">EXAMPLES</a></li>
|
|
|
|
|
+<li><a href="#seealso">SEE ALSO</a></li>
|
|
|
|
|
+<li><a href="#history">HISTORY</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
diff --git a/userguide/pamtoavs.html b/userguide/pamtoavs.html
|
|
|
|
|
index 5d0ae35..bee1a40 100644
|
|
|
|
|
--- a/userguide/pamtoavs.html
|
|
|
|
|
+++ b/userguide/pamtoavs.html
|
|
|
|
|
@@ -2,13 +2,15 @@
|
|
|
|
|
<html><head><title>Pamtoavs User Manual</title></head>
|
2018-06-04 12:47:58 +00:00
|
|
|
<body>
|
2020-10-07 12:25:58 +00:00
|
|
|
<h1>pamtoavs</h1>
|
|
|
|
|
-Updated: 07 February 2010
|
|
|
|
|
-<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
+
|
|
|
|
|
+<p>Updated: 7 February 2010</p>
|
|
|
|
|
+
|
2018-06-04 12:47:58 +00:00
|
|
|
+<p><a href="#index">Table Of Contents</a></p>
|
2020-10-07 12:25:58 +00:00
|
|
|
+
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-<p>pamtoavs - convert a Netpbm image to an AVS X image
|
|
|
|
|
+<p>pamtoavs - convert a Netpbm image to an AVS X image</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -17,7 +19,7 @@ Updated: 07 February 2010
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<p><b>pamtoavs</b> reads a Netpbm image as input and produces a Stardent
|
|
|
|
|
<abbr title="Application Visualization System">AVS</abbr>
|
|
|
|
|
@@ -27,14 +29,14 @@ href="http://www.gnuplot.info/">Gnuplot</a> 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.
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
-<p>Try the following:
|
|
|
|
|
+<p>Try the following:</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
<pre>
|
|
|
|
|
gnuplot> 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.
|
|
|
|
|
+manual</a> for more information.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
@@ -42,29 +44,29 @@ manual</a> for more information.
|
|
|
|
|
<p>There are no command line options defined specifically
|
|
|
|
|
for <b>pamtoavs</b>, but it recognizes the options common to all
|
|
|
|
|
programs based on libnetpbm (See <a href="index.html#commonoptions">
|
|
|
|
|
-Common Options</a>.)
|
|
|
|
|
+Common Options</a>.)</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
|
|
|
|
|
<p>Copyright © 2010 Scott Pakin,
|
|
|
|
|
-<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a>
|
|
|
|
|
+<a href="mailto:scott+pbm@pakin.org.">scott+pbm@pakin.org.</a></p>
|
|
|
|
|
|
|
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
|
|
|
|
|
<p><a href="avstopam.html">avstopam</a>,
|
|
|
|
|
<a href="http://www.gnuplot.info/">gnuplot</a>,
|
|
|
|
|
-<a href="pam.html">pam</a>
|
|
|
|
|
+<a href="pam.html">pam</a></p>
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
+<li><a href="#see_also">SEE ALSO</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
diff --git a/userguide/pamtooctaveimg.html b/userguide/pamtooctaveimg.html
|
|
|
|
|
index 4e09e8e..d2cc50b 100644
|
|
|
|
|
--- a/userguide/pamtooctaveimg.html
|
|
|
|
|
+++ b/userguide/pamtooctaveimg.html
|
|
|
|
|
@@ -2,13 +2,13 @@
|
|
|
|
|
<html><head><title>Pamtooctaveimg User Manual</title></head>
|
2018-06-04 12:47:58 +00:00
|
|
|
<body>
|
2020-10-07 12:25:58 +00:00
|
|
|
<h1>pamtooctaveimg</h1>
|
|
|
|
|
-<br>
|
|
|
|
|
-<p>Updated: 27 June 2007<br>
|
|
|
|
|
-<a href="#index">Table Of Contents</a>
|
|
|
|
|
+
|
|
|
|
|
+<p>Updated: 27 June 2007<br />
|
|
|
|
|
+<a href="#index">Table Of Contents</a></p>
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-<p>pamtooctaveimg - convert a Netpbm image to a GNU Octave image
|
|
|
|
|
+<p>pamtooctaveimg - convert a Netpbm image to a GNU Octave image</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="synopsis">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -17,7 +17,7 @@
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p><b>pamtooctaveimg</b> reads a Netpbm image as input and produces a <a
|
|
|
|
|
href="http://www.octave.org/">GNU Octave</a> image file as output.
|
|
|
|
|
@@ -45,7 +45,7 @@ Image Processing chapter</a> of the GNU Octave manual for details.
|
|
|
|
|
<p>There are no command line options defined specifically
|
|
|
|
|
for <b>pamtooctaveimg</b>, but it recognizes the options common to all
|
|
|
|
|
programs based on libnetpbm (See <a href="index.html#commonoptions">
|
|
|
|
|
-Common Options</a>.)
|
|
|
|
|
+Common Options</a>.)</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="arguments">ARGUMENTS</h2>
|
|
|
|
|
|
|
|
|
|
@@ -77,7 +77,8 @@ specify <i>netpbmfile</i>, the input is from Standard Input.
|
|
|
|
|
<h2 id="notes">NOTES</h2>
|
|
|
|
|
|
|
|
|
|
<p>There is no <b>octavetopam</b> program. However, GNU Octave's
|
|
|
|
|
-<b>saveimage</b> command can save images in PPM format.
|
|
|
|
|
+<b>saveimage</b> command can save images in PPM format.</p>
|
|
|
|
|
+
|
|
|
|
|
|
|
|
|
|
<h2 id="history">HISTORY</h2>
|
|
|
|
|
|
|
|
|
|
@@ -86,7 +87,7 @@ specify <i>netpbmfile</i>, the input is from Standard Input.
|
|
|
|
|
<h2 id="author">AUTHOR</h2>
|
|
|
|
|
|
|
|
|
|
<p>Copyright (C) 2007 Scott Pakin,
|
|
|
|
|
-<a href="mailto:scott+pbm@pakin.org">scott+pbm@pakin.org</a>.
|
|
|
|
|
+<a href="mailto:scott+pbm@pakin.org">scott+pbm@pakin.org</a>.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="seealso">SEE ALSO</h2>
|
|
|
|
|
|
|
|
|
|
@@ -98,15 +99,15 @@ href="http://www.gnu.org/software/octave/doc/interpreter/index.html"><b>octave</
|
|
|
|
|
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
-<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#arguments">ARGUMENTS</a>
|
|
|
|
|
-<li><a href="#examples">EXAMPLES</a>
|
|
|
|
|
-<li><a href="#notes">NOTES</a>
|
|
|
|
|
-<li><a href="#history">HISTORY</a>
|
|
|
|
|
-<li><a href="#author">AUTHOR</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
|
|
+<li><a href="#description">DESCRIPTION</a></li>
|
|
|
|
|
+<li><a href="#options">OPTIONS</a></li>
|
|
|
|
|
+<li><a href="#arguments">ARGUMENTS</a></li>
|
|
|
|
|
+<li><a href="#examples">EXAMPLES</a></li>
|
|
|
|
|
+<li><a href="#notes">NOTES</a></li>
|
|
|
|
|
+<li><a href="#history">HISTORY</a></li>
|
|
|
|
|
+<li><a href="#author">AUTHOR</a></li>
|
|
|
|
|
+<li><a href="#seealso">SEE ALSO</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
diff --git a/userguide/pnmflip.html b/userguide/pnmflip.html
|
|
|
|
|
index 2bd7368..8a1916e 100644
|
|
|
|
|
--- a/userguide/pnmflip.html
|
|
|
|
|
+++ b/userguide/pnmflip.html
|
|
|
|
|
@@ -5,17 +5,18 @@
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-pnmflip - replaced by pamflip
|
|
|
|
|
+<p>pnmflip - replaced by pamflip</p>
|
|
|
|
|
|
|
|
|
|
<h2>DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
2018-06-04 12:47:58 +00:00
|
|
|
<p><b>pnmflip</b> was replaced in Netpbm 10.13 (December 2002) by
|
|
|
|
|
<b><a href="pamflip.html">pamflip</a></b>.
|
|
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
+<h2>DESCRIPTION</h2>
|
|
|
|
|
<p><b>pamflip</b> is mostly backward compatible with <b>pnmflip</b>,
|
|
|
|
|
-but works on PAM images too.
|
|
|
|
|
+but works on PAM images too.</p>
|
|
|
|
|
|
|
|
|
|
<p>One way <b>pamflip</b> is not backward compatible with <b>pnmflip</b>
|
|
|
|
|
is that <b>pnmflip</b> lets you specify any number of basic flip options,
|
|
|
|
|
@@ -23,12 +24,12 @@ whereas <b>pamflip</b> requires exactly one. (<b>pamflip</b> provides
|
|
|
|
|
the <b>-xform</b> option for requesting multiple transformations, though).
|
|
|
|
|
Because of this incompatibility, <b>pnmflip</b> still exists as a
|
|
|
|
|
separate program, and all it does is translate its options to <b>pamflip</b>
|
|
|
|
|
-style and run <b>pamflip</b>.
|
|
|
|
|
+style and run <b>pamflip</b>.</p>
|
|
|
|
|
|
|
|
|
|
<p>You should not make any new use of <b>pnmflip</b> and if you modify an
|
|
|
|
|
existing use, you should upgrade to <b>pamflip</b>. But note that if you
|
|
|
|
|
write a program that might have to be used with very old
|
|
|
|
|
-Netpbm, <b>pnmflip</b> is the only way to do that.
|
|
|
|
|
+Netpbm, <b>pnmflip</b> is the only way to do that.</p>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
diff --git a/userguide/pnmmercator.html b/userguide/pnmmercator.html
|
|
|
|
|
index 998f7fb..65576ac 100644
|
|
|
|
|
--- a/userguide/pnmmercator.html
|
|
|
|
|
+++ b/userguide/pnmmercator.html
|
|
|
|
|
@@ -18,11 +18,12 @@ projection and vice-versa
|
|
|
|
|
[<b><i>filename</i></b>]
|
|
|
|
|
|
|
|
|
|
<p>Minimum unique abbreviation of option is acceptable.
|
|
|
|
|
-You may use double hyphens instead of single hyphen to denote options.
|
|
|
|
|
+You may use double hyphens instead of single hyphen to denote options.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="description">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>This program is part of <a
|
|
|
|
|
+href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p>The <b>pnmmercator</b> utility, converts a rectangular projection worldmap
|
|
|
|
|
to a Mercator projection format, as used for maps.google.com and many other
|
|
|
|
|
@@ -31,34 +32,34 @@ online maps. The map used as input for <b>pnmmercator</b> must have rows for
|
|
|
|
|
file will typically be twice as wide as high, but this is not a
|
|
|
|
|
requirement. The output file will be using the <a
|
|
|
|
|
href="http://en.wikipedia.org/wiki/Mercator_projection">Mercator
|
|
|
|
|
-projection</a> and will get double the height of the input file.
|
|
|
|
|
+projection</a> and will get double the height of the input file.</p>
|
|
|
|
|
|
|
|
|
|
<p>Maps using the Mercator projection are stretched more the closer a row is
|
|
|
|
|
to the North or South Pole. The last few degrees (> 85 or < -85 degrees)
|
|
|
|
|
are not part of a Mercator map at all because they would be stretched too much
|
|
|
|
|
and the rows close to the edge will show banding, because they originate from
|
|
|
|
|
-the same row in the original map.
|
|
|
|
|
+the same row in the original map.</p>
|
|
|
|
|
|
|
|
|
|
<p>To overcome this, the program will by default do interpolation of pixel
|
|
|
|
|
colors, which will eliminate the banding effect, but will cause some blurring
|
|
|
|
|
of the output. With the -nomix option, this interpolation of colors isn't
|
|
|
|
|
applied. You can obtain the highest quality output by starting with an input
|
|
|
|
|
map of high resolution, so that you can follow the <b>pnmmercator</b>
|
|
|
|
|
-transformation with a <b>pamscale</b> reduction in size.
|
|
|
|
|
+transformation with a <b>pamscale</b> reduction in size.</p>
|
|
|
|
|
|
|
|
|
|
<p>This program can also convert a Mercator projection map back to a
|
|
|
|
|
rectangular projection based. As said, the Mercator map doesn't have
|
|
|
|
|
information about the latitudes close to the poles. Therefore the top rows in
|
|
|
|
|
the output image will be identical and copied from the row corresponding with
|
|
|
|
|
-latitude of 85 degrees. The same at the bottom of the map.
|
|
|
|
|
+latitude of 85 degrees. The same at the bottom of the map.</p>
|
|
|
|
|
|
|
|
|
|
<p>Pnmmercator doesn't have any provision for scaling the image. You can scale
|
|
|
|
|
by piping the output of the program through Netpbm programs such as
|
|
|
|
|
-<b>pamscale</b>.
|
|
|
|
|
+<b>pamscale</b>.</p>
|
|
|
|
|
|
|
|
|
|
<p>You can find maps to be used as input at <a
|
|
|
|
|
href="http://flatplanet.sourceforge.net/maps/natural.html">flatplanet.sourceforge.net</a>
|
|
|
|
|
-or <a href="http://www.evl.uic.edu/pape/data/Earth/">uic.edu/pape</a>.
|
|
|
|
|
+or <a href="http://www.evl.uic.edu/pape/data/Earth/">uic.edu/pape</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p>The point of a Mercator projection map is that compass directions work on
|
|
|
|
|
it. If you draw a straight line northeast from some point on the Mercator
|
|
|
|
|
@@ -78,33 +79,33 @@ proportional to angular longitude.
|
|
|
|
|
<h2 id="parameters">PARAMETERS</h2>
|
|
|
|
|
|
|
|
|
|
<p><b><i>filename</i></b> is the name of the input file. If you don't specify
|
|
|
|
|
-this, <b>pnmmercator</b> reads the image from standard Input.
|
|
|
|
|
+this, <b>pnmmercator</b> reads the image from standard Input.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="options">OPTIONS</h2>
|
|
|
|
|
|
|
|
|
|
<p>In addition to the options common to all programs based on libnetpbm
|
|
|
|
|
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
|
|
|
|
|
Common Options</a>), <b>pnmmercator</b> recognizes the following
|
|
|
|
|
-command line options:
|
|
|
|
|
+command line options:</p>
|
|
|
|
|
|
|
|
|
|
<dl compact>
|
|
|
|
|
<dt><b>-inverse</b></dt>
|
|
|
|
|
<dd>
|
|
|
|
|
<p>With this option a conversion from Mercator to degrees is applied.The
|
|
|
|
|
-output image will have half the height of the input map.
|
|
|
|
|
+output image will have half the height of the input map.</p>
|
|
|
|
|
</dd>
|
|
|
|
|
<dt><b>-nomix</b></dt>
|
|
|
|
|
<dd>
|
|
|
|
|
<p>Default behaviour is that color blending is applied in between two adjacent
|
|
|
|
|
rows. If you specify the -nomix parameter there is no blending. The
|
|
|
|
|
consequence is a banding at the top and bottom of the map. With this option,
|
|
|
|
|
-the output map will also consist of exactly the same colors as the input.
|
|
|
|
|
+the output map will also consist of exactly the same colors as the input.</p>
|
|
|
|
|
</dd>
|
|
|
|
|
<dt><b>-verbose</b> and <b>-vverbose</b></dt>
|
|
|
|
|
<dd>
|
|
|
|
|
<p>This parameter outputs some additional information. If you double the 'v',
|
|
|
|
|
it will output debug data about the lat/long degree and Mercator
|
|
|
|
|
-conversions.
|
|
|
|
|
+conversions.</p>
|
|
|
|
|
</dd>
|
|
|
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
@@ -114,25 +115,26 @@ conversions.
|
|
|
|
|
<b><a href="ppmglobe.html">ppmglobe</a></b>
|
|
|
|
|
|
|
|
|
|
<h2 id="history">HISTORY</h2>
|
|
|
|
|
-<p><b>pnmmercator</b> was new in Netpbm 10.49 (December 2009).
|
|
|
|
|
+<p><b>pnmmercator</b> was new in Netpbm 10.49 (December 2009).</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="authors">AUTHORS</h2>
|
|
|
|
|
|
|
|
|
|
<p><a href="mailto:willem@schaik.com">Willem van Schaik</a> (of
|
|
|
|
|
<b>pnmtopng</b>/<b>pngtopnm</b> fame) wrote this program in October 2009 and
|
|
|
|
|
-suggested it for inclusion in Netpbm.
|
|
|
|
|
+suggested it for inclusion in Netpbm.</p>
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
|
|
|
|
<h2 id="index">Table Of Contents</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="#synopsis">SYNOPSIS</a>
|
|
|
|
|
-<li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
-<li><a href="#parameters">PARAMETERS</a>
|
|
|
|
|
-<li><a href="#options">OPTIONS</a>
|
|
|
|
|
-<li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
-<li><a href="#history">HISTORY</a>
|
|
|
|
|
-<li><a href="#authors">AUTHORS</a>
|
|
|
|
|
+</li><li><a href="#description">DESCRIPTION</a>
|
|
|
|
|
+</li><li><a href="#parameters">PARAMETERS</a>
|
|
|
|
|
+</li><li><a href="#options">OPTIONS</a>
|
|
|
|
|
+</li><li><a href="#seealso">SEE ALSO</a>
|
|
|
|
|
+</li><li><a href="#history">HISTORY</a>
|
|
|
|
|
+</li><li><a href="#authors">AUTHORS</a>
|
|
|
|
|
+</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
diff --git a/userguide/ppmtogif.html b/userguide/ppmtogif.html
|
|
|
|
|
index 513133a..fa72e09 100644
|
|
|
|
|
--- a/userguide/ppmtogif.html
|
|
|
|
|
+++ b/userguide/ppmtogif.html
|
|
|
|
|
@@ -5,17 +5,16 @@
|
|
|
|
|
|
|
|
|
|
<h2>NAME</h2>
|
|
|
|
|
|
|
|
|
|
-ppmtogif - replaced by pamtogif
|
|
|
|
|
-
|
|
|
|
|
-<h2>DESCRIPTION</h2>
|
|
|
|
|
-
|
|
|
|
|
-<p>This program is part of <a href="index.html">Netpbm</a>.
|
|
|
|
|
+<p>ppmtogif - replaced by pamtogif</p>
|
|
|
|
|
+<p>This program is part of <a href="index.html">Netpbm</a>.</p>
|
|
|
|
|
|
2018-06-04 12:47:58 +00:00
|
|
|
<p><b>ppmtogif</b> was replaced in Netpbm 10.37 (December 2006) by
|
2020-10-07 12:25:58 +00:00
|
|
|
-<b><a href="pamtogif.html">pamtogif</a></b>.
|
|
|
|
|
+<b><a href="pamtogif.html">pamtogif</a></b>.</p>
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
+<h2>SYNOPSIS</h2>
|
|
|
|
|
<p><b>pamtogif</b> is mostly backward compatible with <b>ppmtogif</b>.
|
2018-06-04 12:47:58 +00:00
|
|
|
|
2020-10-07 12:25:58 +00:00
|
|
|
+<h2>DESCRIPTION</h2>
|
|
|
|
|
<p>One way <b>pamtogif</b> is not backward compatible with <b>ppmtogif</b>
|
2018-06-04 12:47:58 +00:00
|
|
|
is that to specify a transparency (alpha) mask with <b>ppmtogif</b>, you
|
|
|
|
|
supply the transparency as a separate pseudo-PGM image and use the
|
2020-10-07 12:25:58 +00:00
|
|
|
@@ -77,8 +76,8 @@ the alpha image need not have the same maxval as the input.
|
|
|
|
|
<b>ppmtogif</b> interprets the alpha file using the alpha file's
|
|
|
|
|
maxval.
|
|
|
|
|
|
|
|
|
|
-<p>You cannot specify both <b>-transparent</b> and <b>-alpha</b>.
|
|
|
|
|
+<p>You cannot specify both <b>-transparent</b> and <b>-alpha</b>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-</body>
|
|
|
|
|
-</html>
|
|
|
|
|
+</BODY>
|
|
|
|
|
+</HTML>
|
