diff options
-rw-r--r-- | pamarith.html | 11 | ||||
-rw-r--r-- | pamdepth.html | 19 | ||||
-rw-r--r-- | pgmkernel.html | 71 |
3 files changed, 59 insertions, 42 deletions
diff --git a/pamarith.html b/pamarith.html index 1ef36669..528b369c 100644 --- a/pamarith.html +++ b/pamarith.html @@ -52,11 +52,12 @@ the left input image. <P><b>pamarith</b> performs the arithmetic on each pair of identically located tuples in the two input images. -<p>The arithmetic operation is in all cases fundamentally a function -from two integers to an integer. The operation is performed on two -tuples as follows. The two input images must have the same depth, or -one of them must have depth one. <b>pamarith</b> fails if one of -these is not the case. +<p>The arithmetic operation is in all cases fundamentally a function from two +integers to an integer (but see below - the functions are defined in ways that +you can effectively e.g. add real numbers). The operation is performed on two +tuples as follows. The two input images must have the same depth, or one of +them must have depth one. <b>pamarith</b> fails if one of these is not the +case. <p>If they have the same depth, <b>pamarith</b> simply carries out the arithmetic one sample at a time. I.e. if at a particular position the diff --git a/pamdepth.html b/pamdepth.html index c188e441..a3b8d826 100644 --- a/pamdepth.html +++ b/pamdepth.html @@ -2,13 +2,13 @@ <HTML><HEAD><TITLE>Pamdepth User Manual</TITLE></HEAD> <BODY> <H1>pamdepth</H1> -Updated: 08 April 2000 +Updated: 19 December 2013 <BR> <A HREF="#index">Table Of Contents</A> <H2>NAME</H2> -pamdepth - change the maxval in a Netpbm image +pamdepth - change the depth (color resolution) in a Netpbm image <H2 id="synopsis">SYNOPSIS</H2> @@ -18,10 +18,17 @@ pamdepth - change the maxval in a Netpbm image <p>This program is part of <a href="index.html">Netpbm</a>. -<p><b>pamdepth</b> reads a Netpbm image as input, scales all the pixel -values, and writes out the image with the new maxval. Scaling the -colors down to a smaller maxval will result in some loss of -information. +<p><b>pamdepth</b> reads a Netpbm image as input, changes its depth (color +resolution), and writes out the resulting Netpbm image. I.e. the output has a +different maxval from the input, but all the same colors (apart from rounding +error). + +<p>Reducing the depth results in some loss of information. + +<p>Here is an example of the effect at the image format level: Assume you +start with an image with maxval 100 and sample values of 50 and 100. You +tell <b>pamdepth</b> to change it to depth 150. The output has maxval +200 and sample values 75 and 150. <p>This program works on multi-image streams. diff --git a/pgmkernel.html b/pgmkernel.html index 20face18..a0bdaaae 100644 --- a/pgmkernel.html +++ b/pgmkernel.html @@ -2,22 +2,23 @@ <HTML><HEAD><TITLE>Pgmkernel User Manual</TITLE></HEAD> <BODY> <H1>pgmkernel</H1> -Updated: 10 December 1992 +Updated: 19 December 2013 <BR> <A HREF="#index">Table Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> pgmkernel - generate a convolution kernel -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> +<H2 id="synopsis">SYNOPSIS</H2> -<B>pgmkernel</B> [<B>-weight</B> <I>w</I>] <I>width </I> [<I>height </I>] +<p> +<B>pgmkernel</B> [<B>-weight</B> <I>number</I>] <I>size</I> -<A NAME="lbAD"> </A> -<H2>DESCRIPTION</H2> +<p> +<B>pgmkernel</B> [<B>-weight</B> <I>number</I>] <I>width</I> <I>height</I> + +<H2 id="description">DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. @@ -25,9 +26,9 @@ pgmkernel - generate a convolution kernel with <b>pnmconvol</b>. The kernel is one where the weight of each location is inversely proportional to its distance from the center of the kernel. -<p><b>pgmkernel</b> generates a PGM image of size <I>width</I> by -<I>height</I> (or <I>width</I> by <I>width</I> if you don't specify -<I>height</I>. +<p><b>pgmkernel</b> generates a PGM image of width and height <I>size</I> +if you specify one argument, or width <i>width</i> and height <i>height</i> +if you specify two arguments. <p><b>pgmkernel</b> computes the convolution function K as follows. @@ -39,24 +40,34 @@ where <I>w</I> is a coefficient specified via the <b>-weight</b> option. <i>i</i> and <i>j</i> are measured in pixels. K is zero everywhere beyond the specified kernel width and height. -<P><b>pgmkernel</b> generates the output PGM file in the Plain (text) -variation of PGM. +<p>The sample values in the PGM output have this value scaled and biased using +the protocol <b>pnmconvol</b> specifies for representing the real numbers K +in PGM. -<A NAME="lbAE"> </A> -<H2>OPTIONS</H2> +<H2 id="options">OPTIONS</H2> -The optional <b>-weight</b> value should be a real number greater than --1. The default value is 6.0. +The optional <b>-weight</b> value must be a positive real number. The default +value is 6.0. -<A NAME="lbAF"> </A> -<H2>LIMITATIONS</H2> +<h2 id="limitations">LIMITATIONS</H2> <P>The computation time is proportional to <I>width</I>*<I>height</I>. This increases rapidly with the increase of the kernel size. A better approach could be using a FFT in these cases. -<A NAME="lbAG"> </A> -<H2>SEE ALSO</H2> +<h2 id="history">HISTORY</h2> + +<p>Before Netpbm 10.65 (December 2013), the output was always in +Plain (text) PGM format. (Now, like standard Netpbm programs, the default +is raw PGM and you can get Plain PGM with a <b>-plain</b> option). + +<p>Before Netpbm 10.65 (December 2013), this manual said negative values +for <b>-weight</b> were valid (as long as they were greater than -1.0). But +the program never worked with negative numbers and it isn't clear that the +result would be useful, so <b>-weight</b> is now required to be nonnegative +and the program fails gracefully if you specify a negative value. + +<H2 id="seealso">SEE ALSO</H2> <A HREF="pnmconvol.html">pnmconvol</A>, <A HREF="pnmsmooth.html">pnmsmooth</A> @@ -64,24 +75,22 @@ approach could be using a FFT in these cases. <A HREF="pgm.html">pgm</A> -<A NAME="lbAH"> </A> -<H2>AUTHOR</H2> +<H2 id="author">AUTHOR</H2> Alberto Accomazzi (<A HREF="mailto:alberto@cfa.harvard.edu">alberto@cfa.harvard.edu</A>). <HR> -<A NAME="index"> </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">BUGS</A> -<LI><A HREF="#lbAG">SEE ALSO</A> -<LI><A HREF="#lbAH">AUTHOR</A> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#options">OPTIONS</A> +<LI><A HREF="#limitations">LIMITATIONS</A> +<LI><A HREF="#history">HISTORY</A> +<LI><A HREF="#seealso">SEE ALSO</A> +<LI><A HREF="#author">AUTHOR</A> </UL> </BODY> </HTML> |