diff options
| -rw-r--r-- | libnetpbm_image.html | 33 | ||||
| -rw-r--r-- | pamedge.html | 2 | ||||
| -rw-r--r-- | pamsumm.html | 9 | ||||
| -rw-r--r-- | pbmlife.html | 30 | ||||
| -rw-r--r-- | pnmcut.html | 44 | ||||
| -rw-r--r-- | pnmenlarge.html | 2 |
6 files changed, 44 insertions, 76 deletions
diff --git a/libnetpbm_image.html b/libnetpbm_image.html index 7e5edeae..858f0706 100644 --- a/libnetpbm_image.html +++ b/libnetpbm_image.html @@ -238,20 +238,25 @@ the <B>*</B><I>pamP</I> structure. It does not require any members of and sets all of those members. It expects all members after <b>tuple_type</b> to be meaningful. -<p><I>size</I> is the size of the <B>*</B><I>pamP</I> structure as -understood by the program processing the image. -<b>pnm_readpaminit()</B> does not attempt to use or set any members of -the structure beyond that. The point of this argument is that the -definition of the structure may change over time, with additional -fields being added to the end. This argument allows -<b>pnm_readpaminit</b> to distinguish between a new program that wants -to exploit the additional features and an old program that cannot (or -a new program that just doesn't want to deal with the added -complexity). At a minimum, this size must contain the members up -through <b>tuple_type</b>. You should use the <b>PAM_STRUCT_SIZE</B> -macro to compute this argument. -E.g. <b>PAM_STRUCT_SIZE(tuple_type)</b>. (This macro was introduced -in Netpbm 10.23 (July 2004). In older Netpbm, just use sizeof()). +<p><I>size</I> is the size of the <B>*</B><I>pamP</I> structure as understood +by the program processing the image. <b>pnm_readpaminit()</B> does not +attempt to use or set any members of the structure beyond that. The point of +this argument is that the definition of the structure may change over time, +with additional fields being added to the end. This argument allows +<b>pnm_readpaminit</b> to distinguish between a new program that wants to +exploit the additional features and an old program that cannot (or a new +program that just doesn't want to deal with the added complexity). At a +minimum, this size must contain the members up through <b>tuple_type</b>. You +should use the <b>PAM_STRUCT_SIZE</B> macro to compute this argument. +E.g. <b>PAM_STRUCT_SIZE(tuple_type)</b>. + +<B>PAM_STRUCT_SIZE</B> was introduced in Netpbm 10.23 (July 2004). In older +Netpbm, you can just use sizeof(), but then your code is <em>not</em> forward +compatible at the source code level with newer libnetpbm (because when you +compile it with newer libnetpbm header files, you'll be saying your structure +contains all the new members that have been invented, but your code doesn't +actually initialize them). So you might want to compute a proper size +yourself. <P>The function expects to find the image file positioned to the start of the header and leaves it positioned to the start of the raster. diff --git a/pamedge.html b/pamedge.html index 94fe3dce..e68960fb 100644 --- a/pamedge.html +++ b/pamedge.html @@ -36,7 +36,7 @@ two Sobel gradient operators at 90 degrees to each other. For more details see "Digital Image Processing" by Gonzalez and Wintz, chapter 7. -<P>The maxval of the output is the same as the maxval of the input +<P>The maxval of the output is the same as the maxval of the input. The effect is better with larger maxvals, so you may want to increase the maxval of the input by running it through <B>pamdepth</B> first. diff --git a/pamsumm.html b/pamsumm.html index c47941c7..656f25d9 100644 --- a/pamsumm.html +++ b/pamsumm.html @@ -87,10 +87,11 @@ extract it and then <b>pamsumm</b>. 200 and all the samples have value 50, <b>pamsumm</b> will give you 50 as an answer. But <b>pamsumm -normalize</b> will give you .25. - <p>If you want a result that is independent of maxval but still in - integers, and your input is PNM, you can use <b>pamdepth</b> to - convert to some standard maxval. For example, if you want the mean - intensity of a PPM image, on a scale of 0 to 99, do + <p>If instead you want a result that is independent of maxval but still + in integers, and your input is PNM, you can use <b>pamdepth</b> to + convert the input to some standard maxval and not use <b>-normalize</b>. + For example, if you want the mean intensity of a PPM image, on a scale of + 0 to 99, do <pre> <kbd> diff --git a/pbmlife.html b/pbmlife.html index b403343d..a35a00af 100644 --- a/pbmlife.html +++ b/pbmlife.html @@ -6,46 +6,40 @@ Updated: 21 February 1991 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> -pbmlife - apply Conway's rules of Life to a portable bitmap +pbmlife - apply Conway's rules of Life to a PBM image -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> +<H2 id="synopsis">SYNOPSIS</H2> <B>pbmlife</B> [<I>pbmfile</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>. -<p><b>pbmlife</b> reads a portable bitmap as input, applies the rules +<p><b>pbmlife</b> reads a PBM image as input, applies the rules of Life to it for one generation, and produces a PBM image as output. <P>A white pixel in the image is interpreted as a live beastie, and a black pixel as an empty space. -<A NAME="lbAE"> </A> -<H2>SEE ALSO</H2> +<H2 id="seealso">SEE ALSO</H2> <A HREF="pbm.html">pbm</A> -<A NAME="lbAF"> </A> -<H2>AUTHOR</H2> + +<H2 id="author">AUTHOR</H2> Copyright (C) 1988, 1991 by Jef Poskanzer. <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">SEE ALSO</A> -<LI><A HREF="#lbAF">AUTHOR</A> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#seealso">SEE ALSO</A> +<LI><A HREF="#author">AUTHOR</A> </UL> </BODY> </HTML> diff --git a/pnmcut.html b/pnmcut.html index fed6b74d..ea23c3ce 100644 --- a/pnmcut.html +++ b/pnmcut.html @@ -2,46 +2,15 @@ <HTML><HEAD><TITLE>Pnmcut User Manual</TITLE></HEAD> <BODY> <H1>pnmcut</H1> -Updated: 15 March 2004 +Updated: 19 January 2009 <BR> <A HREF="#index">Table Of Contents</A> -<A NAME="lbAB"> </A> <H2>NAME</H2> -pnmcut - cut a rectangle out of a PBM, PGM, or PPM image +<B>pnmcut</B> - replaced by pamcut -<A NAME="lbAC"> </A> -<H2>SYNOPSIS</H2> -<B>pnmcut</B> - -[<B>-left </B><I>leftcol</I>] - -[<B>-right </B><I>rightcol</I>] - -[<B>-top </B><I>toprow</I>] - -[<B>-bottom </B><I>bottomrow</I>] - -[<B>-width </B><I>width</I>] - -[<B>-height </B><I>height</I>] - -[<B>-pad</B>] - -[<B>-verbose</B>] - -[<I>left top width height</I>] - -[<I>pnmfile</I>] - -<p>Minimum unique abbreviation of option is 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. - - -<A NAME="lbAD"> </A> <H2>DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. @@ -52,12 +21,9 @@ href="pamcut.html"><b>pamcut</b></a>, introduced with Netpbm 9.20 (May adds many additional functions, including the ability to process PAM images. -<p><b>pnmcut</b> remains in the Netpbm package because it probably has -fewer bugs for now than <b>pamcut</b>. Some day, <b>pnmcut</b> will -probably become an alias for <b>pamcut</b>. - -<p>You can use the <b>pamcut</b> documentation for <b>pnmcut</b>, as long -as you avoid any function which it says was added after Netpbm 9.20. +<p><b>pnmcut</b> remained in the Netpbm package until Netpbm 10.46 (March +2009) because of hopes that it had fewer bugs than <b>pamcut</b> due to its +age. But now it would just be clutter. </BODY> </HTML> diff --git a/pnmenlarge.html b/pnmenlarge.html index 50d0367f..0471e5b2 100644 --- a/pnmenlarge.html +++ b/pnmenlarge.html @@ -5,8 +5,10 @@ <H1>pgmedge</H1> Updated: September 2004 <BR> + <H2>NAME</H2> <B>pnmenlarge</B> - replaced by pamenlarge + <H2>DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. |