Updated: 7 February 2010
+ + + Table Of Contentsavstopam - convert an AVS X image to a Netpbm image +
avstopam - convert an AVS X image to a Netpbm image
+ -avstopam [avsfile]
This program is part of Netpbm. +
This program is part of Netpbm.
avstopam reads a Stardent AVS X image as input and produces a Netpbm -image as output. +image as output.
avsfile 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.
There are no command line options defined specifically for avstopam, but it recognizes the options common to all programs based on libnetpbm (See -Common Options.) +Common Options.)
Copyright © 2010 Scott Pakin, -scott+pbm@pakin.org. +scott+pbm@pakin.org.
This page, part of the Netpbm user's guide, describes FAX formats in relation to Netpbm facilities. - +
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 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 @@
Updated: 09 February 2020
-Table Of Contents
+Table Of Contents
pampaintspill - smoothly spill colors into the background
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.
This program is part of Netpbm. +
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: +pamgradient but differs in the following characteristics:
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.
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pampaintspill recognizes the following -command line options: +command line options:
Updated: 31 July 2010
+ + + + +pamrecolor - alter colors without affecting luminance
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.
This program is part of Netpbm. +
This program is part of Netpbm.
pamrecolor 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 ppmtopgm). You can have pamrecolor 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.
pamrecolor 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 pamrecolor knows by name. exact format of the PAM. If you want a PNM (PBM, PGM, or PPM) image, use pamtopnm 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.
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamrecolor recognizes the following -command line options: +command line options:
The default is "ntsc" because this is the color space that the Netpbm formats and many graphics utilities use. As a counterexample, GIMP uses sRGB as its native color -space. +space.
The luminance values pamrecolor uses for each of the above come from Bruce Lindbloom's -Computing RGB-to-XYZ and XYZ-to-RGB matrices page. +Computing RGB-to-XYZ and XYZ-to-RGB matrices page.
If you specify neither --targetcolor nor --colorfile, pamrecolor will randomly select a target color for -each pixel of the input image. +each pixel of the input image.
You may not specify both -targetcolor and -colorfile. @@ -154,7 +158,7 @@ image to be repeated in a tile pattern.
If you specify neither --targetcolor nor --colorfile, pamrecolor will randomly select a target color for -each pixel of the input image. +each pixel of the input image.
You may not specify both -targetcolor and -colorfile. @@ -176,23 +180,23 @@ invocations.
This command tints an image yellow: +
This command tints an image yellow:
- pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam + pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam
This command takes the colors from colorpicture.ppm and applies -them to graypicture.pgm: +them to graypicture.pgm:
- pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam + pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam
The grayscale version of colorizedpic.pam 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 --colorspace value for your conversion tool. +appropriate --colorspace value for your conversion tool.
Scott Pakin wrote pamrecolor in July 2010. +
Scott Pakin wrote pamrecolor in July 2010.
pamrecolor was new in Netpbm 10.52 (September 2010). @@ -229,7 +233,7 @@ photograph of the late 1800s).
Copyright (C) 2010 Scott -Pakin, scott+pbm@pakin.org. +Pakin, scott+pbm@pakin.org.
Updated: 5 April 2009
+ + +pamsistoaglyph - convert a single-image stereogram to a red/cyan +anaglyphic image
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.
This program is part of Netpbm.
pamsistoaglyph reads a Netpbm image as input and -produces a Netpbm image as output. +produces a Netpbm image as output.
pamsistoaglyph takes a single-image stereogram (SIS) such as those produced by pamsistoaglyph 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.
pamsistoaglyph can convert single-image random-dot stereograms (SIRDS), wallpaper stereograms, and even dual-image -stereograms to anaglyphic images. +stereograms to anaglyphic images.
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamsistoaglyph recognizes the following -command line options: +command line options:
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.
The registration algorithm used by pamsistoaglyph 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:
Copyright (C) 2009 Scott -Pakin, scott+pbm@pakin.org. +Pakin, scott+pbm@pakin.org.
Updated: 7 February 2010
+ + +pamtoavs - convert a Netpbm image to an AVS X image +
pamtoavs - convert a Netpbm image to an AVS X image
This program is part of Netpbm. +
This program is part of Netpbm.
pamtoavs reads a Netpbm image as input and produces a Stardent AVS @@ -27,14 +29,14 @@ href="http://www.gnuplot.info/">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: +
Try the following:
gnuplot> plot 'myimage.avs' binary filetype=avs with rgbimage
See the Gnuplot -manual for more information. +manual for more information.
There are no command line options defined specifically for pamtoavs, but it recognizes the options common to all programs based on libnetpbm (See -Common Options.) +Common Options.)
Copyright © 2010 Scott Pakin, -scott+pbm@pakin.org. +scott+pbm@pakin.org.
Updated: 27 June 2007
-Table Of Contents
+
+
Updated: 27 June 2007
+Table Of Contents
pamtooctaveimg - convert a Netpbm image to a GNU Octave image +
pamtooctaveimg - convert a Netpbm image to a GNU Octave image
This program is part of Netpbm. +
This program is part of Netpbm.
pamtooctaveimg reads a Netpbm image as input and produces a GNU Octave image file as output. @@ -45,7 +45,7 @@ Image Processing chapter of the GNU Octave manual for details.
There are no command line options defined specifically for pamtooctaveimg, but it recognizes the options common to all programs based on libnetpbm (See -Common Options.) +Common Options.)
There is no octavetopam program. However, GNU Octave's -saveimage command can save images in PPM format. +saveimage command can save images in PPM format.
+Copyright (C) 2007 Scott Pakin, -scott+pbm@pakin.org. +scott+pbm@pakin.org.
pnmflip - replaced by pamflip
This program is part of Netpbm. +
This program is part of Netpbm.
pnmflip was replaced in Netpbm 10.13 (December 2002) by pamflip. +
pamflip is mostly backward compatible with pnmflip, -but works on PAM images too. +but works on PAM images too.
One way pamflip is not backward compatible with pnmflip is that pnmflip lets you specify any number of basic flip options, @@ -23,12 +24,12 @@ whereas pamflip requires exactly one. (pamflip provides the -xform option for requesting multiple transformations, though). Because of this incompatibility, pnmflip still exists as a separate program, and all it does is translate its options to pamflip -style and run pamflip. +style and run pamflip.
You should not make any new use of pnmflip and if you modify an existing use, you should upgrade to pamflip. But note that if you write a program that might have to be used with very old -Netpbm, pnmflip is the only way to do that. +Netpbm, pnmflip is the only way to do that.
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 [filename]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.
This program is part of Netpbm. +
This program is part of Netpbm.
The pnmmercator 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 pnmmercator 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 Mercator -projection and will get double the height of the input file. +projection and will get double the height of the input file.
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.
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 pnmmercator -transformation with a pamscale reduction in size. +transformation with a pamscale reduction in size.
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.
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 -pamscale. +pamscale.
You can find maps to be used as input at flatplanet.sourceforge.net -or uic.edu/pape. +or uic.edu/pape.
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.
filename is the name of the input file. If you don't specify -this, pnmmercator reads the image from standard Input. +this, pnmmercator reads the image from standard Input.
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pnmmercator recognizes the following -command line options: +command line options:
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.
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.
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.
pnmmercator was new in Netpbm 10.49 (December 2009). +
pnmmercator was new in Netpbm 10.49 (December 2009).
Willem van Schaik (of pnmtopng/pngtopnm fame) wrote this program in October 2009 and -suggested it for inclusion in Netpbm. +suggested it for inclusion in Netpbm.
This program is part of Netpbm. +
ppmtogif - replaced by pamtogif
+This program is part of Netpbm.
ppmtogif was replaced in Netpbm 10.37 (December 2006) by -pamtogif. +pamtogif.
+pamtogif is mostly backward compatible with ppmtogif. +
One way pamtogif is not backward compatible with ppmtogif is that to specify a transparency (alpha) mask with ppmtogif, you supply the transparency as a separate pseudo-PGM image and use the @@ -77,8 +76,8 @@ the alpha image need not have the same maxval as the input. ppmtogif interprets the alpha file using the alpha file's maxval. -
You cannot specify both -transparent and -alpha. +
You cannot specify both -transparent and -alpha.
- -