diff options
-rw-r--r-- | pamarith.html | 10 | ||||
-rw-r--r-- | pamfunc.html | 136 | ||||
-rw-r--r-- | pbmtodjvurle.html | 2 | ||||
-rw-r--r-- | ppmtoarbtxt.html | 39 |
4 files changed, 139 insertions, 48 deletions
diff --git a/pamarith.html b/pamarith.html index f79e2cde..9bd5c1a1 100644 --- a/pamarith.html +++ b/pamarith.html @@ -145,7 +145,8 @@ maxval. <h3 id="operations">The Operations</h3> -<p>Most of the operations are obvious from the option name. +<p>Most of the operations are obvious from the option name. The following +paragraphs cover those that aren't. <P><B>-subtract</B> subtracts a value in the right input image from a value in the left input image. @@ -178,8 +179,11 @@ say A is greater than B if A is less than B. <p><b>-compare</b> was new in Netpbm 10.13 (December 2002). <p><b>-and</b>, <b>-nand</b>, <b>-or</b>, <b>-nor</b>, and <b>-xor</b> -consider the input and output images to contain bit strings; they compute -bitwise logic operations. +consider the input and output images to contain bit strings; they +compute bitwise logic operations. Note that if the maxval is 1, you +can also look at these as logic operations on boolean input values. +See section <a href="#maxval">Maxval</a> for the special meaning of +maxval with respect to bit string operations such as these. <p><b>-shiftleft</b> and <b>-shiftright</b> consider the left input image and output image to contain bit strings. They compute a bit diff --git a/pamfunc.html b/pamfunc.html index 478863a2..29a8f6d1 100644 --- a/pamfunc.html +++ b/pamfunc.html @@ -4,16 +4,14 @@ <BODY> <H1>pamfunc</H1> -Updated: June 2002 +Updated: July 2007 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> -pamfunc - Apply simple arithmetic functions to a Netpbm image +pamfunc - Apply a simple monadic arithmetic function to a Netpbm image -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> +<H2 id="synopsis">SYNOPSIS</H2> <B>pamfunc</B> { @@ -23,6 +21,12 @@ pamfunc - Apply simple arithmetic functions to a Netpbm image <b>-subtractor=</b><i>integer</i> | <b>-min=</b><i>wholenum</i> | <b>-max=</b><i>wholenum</i> +<b>-andmask=</b><i>hexmask</i> +<b>-ormask=</b><i>hexmask</i> +<b>-xormask=</b><i>hexmask</i> +<b>-not</b> +<b>-shiftleft=</b><i>count</i> +<b>-shiftright=</b><i>count</i> } [<I>filespec</I>] @@ -30,8 +34,7 @@ pamfunc - Apply simple arithmetic functions to 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"> </A> -<H2>DESCRIPTION</H2> +<H2 id="description">DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. @@ -47,8 +50,7 @@ specified simple arithmetic function (e.g. addition) on pairs of samples from the two to produce the single output image. -<A NAME="lbAE"> </A> -<H2>OPTIONS</H2> +<H2 id="options">OPTIONS</H2> <DL COMPACT> <DT><B>-multiplier=<i>realnum</i></B> @@ -106,7 +108,7 @@ samples from the two to produce the single output image. "subtrahend" rather than a "subtractor." We use "subtractor" because it makes more sense. - <P>This is the same function as you would get with <b>-multiplier</b>, + <P>This is the same function as you would get with <b>-adder</b>, specifying the negative of <i>integer</i>. <DT><B>-min=<i>wholenum</i></B> @@ -129,10 +131,106 @@ samples from the two to produce the single output image. If <i>wholenum</i> is greater than the maxval, the function is idempotent -- the output is identical to the input. +<DT><B>-andmask=<i>hexmask</i></B> + +<DD> + <P>This option makes the transfer function that of bitwise anding + with <i>hexmask</i>. + + <p><i>hexmask</i> is in hexadecimal. Example: <kbd>0f</kbd> + + <p>See section <a href="#maxval">Maxval</a> for the special + meaning of maxval with respect to bit string operations such as + this. + + <p>This option was new in Netpbm 10.40 (September 2007). + +<DT><B>-ormask=<i>hexmask</i></B> + +<DD> + <P>This option makes the transfer function that of bitwise + inclusive oring with <i>hexmask</i>. + + <p>This is analogous to <b>-andmask</b>. + + <p>This option was new in Netpbm 10.40 (September 2007). + +<DT><B>-xormask=<i>hexmask</i></B> + +<DD> + <P>This option makes the transfer function that of bitwise + exclusive oring with <i>hexmask</i>. + + <p>This is analogous to <b>-andmask</b>. + + <p>This option was new in Netpbm 10.40 (September 2007). + +<dt><b>-not</b> + +<dd> + <p>This option makes the transfer function that of bitwise logical + inversion (e.g. sample value 0xAA becomes 0x55). + + <p>See section <a href="#maxval">Maxval</a> for the special + meaning of maxval with respect to bit string operations such as + this. + + <p><b>pnminvert</b> does the same thing for a bilevel visual image + which has maxval 1 or is of PBM type. + + <p>This option was new in Netpbm 10.40 (September 2007). + +<DT><B>-shiftleft=<i>count</i></B> + +<DD> + <P>This option makes the transfer function that of bitwise shifting + left by <i>count</i> bits. + + <p>See section <a href="#maxval">Maxval</a> for the special + meaning of maxval with respect to bit string operations such as + this. + + <p>This option was new in Netpbm 10.40 (September 2007). + +<DT><B>-shiftright=<i>count</i></B> + +<DD> + <P>This option makes the transfer function that of bitwise shifting + right by <i>count</i> bits. + + <p>This is analogous to <b>-shiftleft</b>. + + <p>This option was new in Netpbm 10.40 (September 2007). </DL> -<A NAME="lbAF"> </A> -<H2>SEE ALSO</H2> + +<h2 id="maxval">MAXVAL</h3> + +<p>For the arithmetic functions, the maxval has no meaning. The function +applies to the sample value as an integer. (Note that this differs from +the usual interpretation of PAM samples as being a fraction of a maxval, +but <em>does</em> produce more intuitive result: 2 times 5 is 10. + +<P>But with the bit string operations, the maxval has a special +meaning. The functions in question are: <B>-andmask</B>, <B>-ormask</B>, +<B>-xormask</B>, <B>-not</B>, <b>-shiftleft</b>, and <b>-shiftright</b>. + +<p>With these, each sample value the input image, and in the output +image, represents a bit string, not a number. The maxval tells how +wide the bit string is. The maxval must be a full binary count (a +power of two minus one, such as 0xff) and the number of ones in it is +the width of the bit string. + +<p>For a masking function, the mask value you specify must not have +more significant bits than the width indicated by the maxval. + +<p>For a shifting operation, the shift count you specify must not be +greater than the width indicated by the maxval. + +<p>The maxval of the output image is the same as that of the input image. + + +<H2 id="seealso">SEE ALSO</H2> <B><A HREF="ppmdim.html">ppmdim</A></B>, <B><A HREF="ppmbrighten.html">ppmbrighten</A></B>, @@ -141,13 +239,13 @@ samples from the two to produce the single output image. <b><A HREF="pamsummcol.html">pamsummcol</A></b>, <b><A HREF="pamsumm.html">pamsumm</A></b>, <B><A HREF="ppmfade.html">ppmfade</A></B>, +<B><A HREF="pnminvert.html">pnminvert</A></B>, <B><A HREF="pam.html">pam</A></B>, <B><A HREF="pnm.html">pnm</A></B>, -<A NAME="history"> </A> -<H2>HISTORY</H2> +<H2 id="history">HISTORY</H2> <p>This program was added to Netpbm in Release 10.3 (June 2002). @@ -155,11 +253,11 @@ samples from the two to produce the single output image. <A NAME="index"> </A> <H2>Table Of Contents</H2> <UL> -<LI><A HREF="#lbAB">NAME</A> -<LI><A HREF="#lbAC">SYNOPSIS</A> -<LI><A HREF="#lbAD">DESCRIPTION</A> -<LI><A HREF="#lbAE">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="#maxval">MAXVAL</A> +<LI><A HREF="#seealso">SEE ALSO</A> <LI><A HREF="#history">HISTORY</A> </UL> </BODY> diff --git a/pbmtodjvurle.html b/pbmtodjvurle.html index f52a7a38..e900b321 100644 --- a/pbmtodjvurle.html +++ b/pbmtodjvurle.html @@ -6,7 +6,6 @@ Updated: 10 April 2004 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="name"> </A> <H2>NAME</H2> pbmtodjvurle - convert a PBM image to DjVu Bitonal RLE format @@ -46,7 +45,6 @@ Copyright (C) 2004 Scott Pakin <scott+pbm@pakin.org>. <A NAME="index"> </A> <H2>Table Of Contents</H2> <UL> -<LI><A HREF="#name">NAME</A> <LI><A HREF="#synopsis">SYNOPSIS</A> <LI><A HREF="#description">DESCRIPTION</A> <LI><A HREF="#seealso">SEE ALSO</A> diff --git a/ppmtoarbtxt.html b/ppmtoarbtxt.html index 8e9f0f57..2fafbb8c 100644 --- a/ppmtoarbtxt.html +++ b/ppmtoarbtxt.html @@ -7,12 +7,10 @@ Updated: 27 April 2003 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> ppmtoarbtxt - generate image in arbitrary text format from PPM image -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> +<H2 id="synopsis">SYNOPSIS</H2> <B>ppmtoarbtxt</B> <I>bodyskl</I> @@ -20,17 +18,16 @@ ppmtoarbtxt - generate image in arbitrary text format from PPM image [<B>-tl</B> <I>tailskl</I>] [<I>ppmfile</I>] -<A NAME="lbAD"> </A> -<H2>DESCRIPTION</H2> +<H2 id="description">DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. -<b>ppmtoarbtxt</b> generates simple text-based graphics formats based on +<p><b>ppmtoarbtxt</b> generates simple text-based graphics formats based on format descriptions given as input. A text-based graphics format is one in which an image is represented by text (like PNM plain format, but unlike PNM raw format). -<b>ppmtoarbtxt</b>reads a PPM image as input. For each pixel in the +<b>ppmtoarbtxt</b> reads a PPM image as input. For each pixel in the image, <b>ppmtoarbtxt</b> writes the contents of the skeleton file <I>bodyskl</I>, with certain substitutions based on the value of the pixel, to stdout. The substitutions are as follows: @@ -105,8 +102,7 @@ edge of the image. <P>If the skeleton file ends with a LF-character, <b>ppmtoarbtxt</b> ignores it -- it does not include it in the output. -<A NAME="lbAE"> </A> -<H2>OPTIONS</H2> +<H2 id="options">OPTIONS</H2> <DL COMPACT> <DT><B>-hd</B> <I>headskl</I> @@ -124,8 +120,7 @@ the file named <i>tailskl</i> at the end of the output, after the last pixel. It is analogous to <b>-hd</b>. </DL> -<A NAME="lbAF"> </A> -<H2>EXAMPLES</H2> +<H2 id="examples">EXAMPLES</H2> <h3>gray inversion</H3> @@ -181,20 +176,17 @@ sphere { <#(posx),#(height)-#(posy),#(ilum %d 0 10)>, 0.5 } </pre> -<A NAME="lbAG"> </A> -<H2>SEE ALSO</H2> +<H2 id="seealso">SEE ALSO</H2> <A href="pnmtoplainpnm.html">pnmtoplainpnm</A> <A href="ppm.html">ppm</A> -<H2>HISTORY</H2> -<A NAME="history"> </A> +<H2 id="history">HISTORY</H2> <P><B>ppmtoarbtxt</b> was added to Netpbm in Release 10.14 (March 2003). It existed under the name <b>ppmtotxt</b> since 1995. -<A NAME="lbAH"> </A> -<H2>AUTHOR</H2> +<H2 id="author">AUTHOR</H2> Copyright (C) 1995 by Peter Kirchgessner @@ -202,14 +194,13 @@ Copyright (C) 1995 by Peter Kirchgessner <A NAME="index"> </A> <H2>Table Of Contents</H2> <UL> -<LI><A HREF="#lbAB">NAME</A> -<LI><A HREF="#lbAC">SYNOPSIS</A> -<LI><A HREF="#lbAD">DESCRIPTION</A> -<LI><A HREF="#lbAE">OPTIONS</A> -<LI><A HREF="#lbAF">EXAMPLES</A> -<LI><A HREF="#lbAG">SEE ALSO</A> +<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="#seealso">SEE ALSO</A> <LI><A HREF="#history">HISTORY</A> -<LI><A HREF="#lbAH">AUTHOR</A> +<LI><A HREF="#author">AUTHOR</A> </UL> </BODY> </HTML> |