From a0dcd0fdec1283dd7e41063098ee6bb63e97abf6 Mon Sep 17 00:00:00 2001 From: giraffedata Date: Tue, 9 Feb 2010 03:45:35 +0000 Subject: "miscellaneous update" git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@1121 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- avstopam.html | 63 +++++++++++++++++++++++ directory.html | 6 +++ pampaintspill.html | 143 +++++++++++++++++++++++++++++++++++++++++++++++++++++ pamslice.html | 35 +++++-------- pamtoavs.html | 76 ++++++++++++++++++++++++++++ 5 files changed, 301 insertions(+), 22 deletions(-) create mode 100644 avstopam.html create mode 100644 pampaintspill.html create mode 100644 pamtoavs.html diff --git a/avstopam.html b/avstopam.html new file mode 100644 index 00000000..5b359ad4 --- /dev/null +++ b/avstopam.html @@ -0,0 +1,63 @@ + + + +Avstopam User Manual + + + + + +

avstopam

+ +

Updated: 7 February 2010

+ +

Table Of Contents

+ + +

NAME

+ +

avstopam - convert an AVS X image to a Netpbm image

+ + +

SYNOPSIS

+ +

avstopam +[avsfile] + + +

DESCRIPTION

+ +

This program is part of Netpbm.

+ +

avstopam reads a Stardent AVS X image as input and produces a Netpbm +image as output.

+ +

avsfile is the input file, which defaults to Standard Input. +Output is always on Standard Output. + +

AUTHOR

+ +

+ + +

pampaintspill

+ +

Table Of Contents

+ +

pampaintspill - smoothly spill colors into the background

+ +

SYNOPSIS

+ +

+pampaintspill +[--bgcolor=color] +[--wrap] [--all] +[--downsample=number] +[--power=number] [filename]

+ +

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. + +

DESCRIPTION

+ +

This program is part of Netpbm.

+ +

pampaintspill produces a smooth color gradient from all of the +non-background-colored pixels in an input image, effectively spilling +paint onto the background. pampaintspill is similar to +pamgradient but differs in the following characteristics:

+ +

pampaintspill accepts any number of paint + sources (non-background-colored pixels), which can lie anywhere + on the canvas. pamgradient accepts exactly + four paint sources, one in each corner of the image.
pampaintspill requires an input image while + pamgradient generates a new image from + scratch.
pampaintspill can produce tileable output and + can control how tightly the gradient colors bind to their source + pixels. +

+ +

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.

+ +

OPTIONS

+ +

--bgcolor=color: Explicitly specify the background color. color can be + specified using any of the formats accepted by the ppm_parsecolor() library + routine such as red or #ff0000. If + --bgcolor is not specified, pampaintspill makes an + educated guess about the background color based on the colors in the + image's corners.
--wrap: Allow gradients to wrap around image borders. That is, colors + that spill off the right side of the image reappear on the left side of + the image and likewise for left/right, top/bottom, and + bottom/top. --wrap makes images tileable, which is nice for + producing desktop backgrounds.
--all: Recolor all pixels, not just background pixels. Normally, + non-background-colored pixels in the input image appear unmodified in + the output image. With --all, all pixels are colored + based on their distance from all of the (other) non-background-colored + pixels.
--downsample=number: Ignore all but number non-background-colored pixels. + When a large number of pixels in the input image differ in color from + the background, pampaintspill runs very slowly. The + --downsample option randomly selects a given number of colored + pixels to use as paint sources for the gradients and ignores the rest, + thereby trading off image quality for speed of execution.
--power=number: Control how color intensity changes as a function of the + distance from a paint source. The default value for number is + -2.0, which means that intensity drops (because of the minus sign) with + the square (because of the 2.0) of the distance from each paint + source. -2.0 generally works well in practice, but other values can be + specified for various special effects. With very small numbers of paint + sources, -1.0 may produce subtler gradients, but these get muddier as + the number of paint sources increases. Positive numbers (e.g., 1.0 and + 2.0) make the paint sources stand out in the output image by pushing the + gradients away from them.

+ + +

HISTORY

+ +

pampaintspill was new in Netpbm 10.50 (March 2010). + + +

COPYRIGHT

+ +

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
HISTORY
COPYRIGHT

+ + + + diff --git a/pamslice.html b/pamslice.html index efb42efe..e0e40566 100644 --- a/pamslice.html +++ b/pamslice.html @@ -3,16 +3,14 @@ Pamslice User Manual

pamslice

-Updated: 22 June 2002 +Updated: 8 February 2010
Table Of Contents -

NAME

pamslice - extract one line of values out of a Netpbm image - -

SYNOPSIS

pamslice {-row=rownumber | -column=columnnumber} @@ -24,8 +22,7 @@ pamslice - extract one line of values out of a Netpbm image You may use two hyphens instead of one. You may separate an option name and its value with white space instead of an equals sign. - -

DESCRIPTION

This program is part of Netpbm. @@ -46,10 +43,9 @@ specifications of the image formats for details on exactly what these numbers mean. If you want to see all the pixels in a PPM, PGM, or PBM image in ASCII -decimal, pnmtoplainpnm is a good way to do that. +decimal, pnmtopnm -plain is a good way to do that. - -

OPTIONS

-row=rownumber @@ -88,14 +84,12 @@ decimal, pnmtoplainpnm is a good way to do that.

- -

HISTORY

@@ -104,8 +98,7 @@ decimal, pnmtoplainpnm is a good way to do that. It was backward compatible, but worked on Netpbm images other than PGM and PBM and added the -plane and -xmgr options. - -

AUTHOR

Jos Dingjan <jos@tuatha.org> wrote @@ -114,14 +107,12 @@ Beijersbergen's program with the same name. Bryan Henderson converted it to pamslice.

- -

NAME -
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO +
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO
HISTORY
AUTHOR

diff --git a/pamtoavs.html b/pamtoavs.html new file mode 100644 index 00000000..b79f1e7f --- /dev/null +++ b/pamtoavs.html @@ -0,0 +1,76 @@ + + + +Pamtoavs User Manual + + + + + +

pamtoavs

+ +

Updated: 7 February 2010

+ +

Table Of Contents

+ + +

NAME

+ +

pamtoavs - convert a Netpbm image to an AVS X image

+ + +

SYNOPSIS

+ +

pamtoavs +[netpbmfile] + + +

DESCRIPTION

+ +

This program is part of Netpbm.

+ +

pamtoavs reads a Netpbm image as input and produces a Stardent +AVS +X image as output. AVS X images are one of the few image formats Gnuplot v4.2 and later can use. + +

netpbmfile is the input file, which defaults to Standard Input. +Output is always on Standard Output. + +

Try the following:

+ +

+    gnuplot> plot 'myimage.avs' binary filetype=avs with rgbimage
+

+ +

See the Gnuplot +manual for more information.

+ + +

AUTHOR

+ +

+ + +

avstopam

NAME

Table Of Contents

pampaintspill

DESCRIPTION

OPTIONS

SEE ALSO

HISTORY

COPYRIGHT

Table Of Contents

pamslice

NAME

SYNOPSIS

SYNOPSIS

DESCRIPTION

DESCRIPTION

OPTIONS

OPTIONS

SEE ALSO

SEE ALSO

HISTORY

AUTHOR

AUTHOR

Table Of Contents

Table Of Contents

pamtoavs

NAME

Table Of Contents