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: 10 May 2020
+ + +pamstereogram - create a single-image stereogram from a PAM +depth map
This program is part of Netpbm. +
This program is part of Netpbm.
pamstereogram inputs a depth map (a map of the distances from your eye of the points in a scene) and outputs a single-image @@ -54,22 +57,22 @@ eyes. What's exciting about single-image stereograms is that they don't require special glasses to view, although it does require a bit of practice to train your eyes to unfocus properly. The pamstereogram program provides a wealth of control over how the -stereogram is generated, including the following: +stereogram is generated, including the following:
The output is a PAM image on standard output. Options control @@ -79,7 +82,7 @@ if you will use the image as input to a current Netpbm program, but many other programs don't know what a PAM is.
To make a red/green type of stereogram (that you view with 3-D -glasses) instead, see ppm3d. +glasses) instead, see ppm3d.
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamstereogram recognizes the following -command line options: +command line options:
You may use either single or double hyphens to denote options. You may use either whitespace or an equals sign to separate an option name -from its value. +from its value.
This option was new in Netpbm 10.71 (June 2015). -
This option was new in Netpbm 10.53 (December 2010). - +
This option was new in Netpbm 10.53 (December 2010).
+This option was new in Netpbm 10.53 (December 2010). - +
This option was new in Netpbm 10.53 (December 2010).
+This option was new in Netpbm 10.53 (December 2010). Before -Netpbm 10.61 (December 2012), it has no effect without -texfile. +Netpbm 10.61 (December 2012), it has no effect without -texfile.
+This option was new in Netpbm 10.61 (December 2012). Before that, the presence of -guidesize, with a positive value, has the same effect. - +
Before Netpbm 10.53 (December 2010), the default was 96 DPI. - +
Before Netpbm 10.53 (December 2010), the default was 96 DPI.
+Before Netpbm 10.53 (December 2010), pamstereogram used higher (lighter) numbers for things closer to the eye without --crosseyed and vice versa. +-crosseyed and vice versa.
+The number of distinct 3-D depths is far @@ -299,10 +302,10 @@ parameters (distance between eyes and tradeoff between perceptibility and depth) while -planes is a more computer-centric way (pixel distances in the resulting stereogram). -
This option was new in Netpbm 10.59 (June 2012). - +
This option was new in Netpbm 10.59 (June 2012).
+This is irrelevant if you use a pattern file (-patfile option), because there is no random element to pamstereogram's -behavior. +behavior.
-This option was new in Netpbm 10.32 (February 2006). +
This option was new in Netpbm 10.32 (February 2006).
+This option was new in Netpbm 10.91 (June 2020). +
This option was new in Netpbm 10.91 (June 2020).
The only parameter, infile, is the name of an input file that is a depth map image. If you don't specify infile, the -input is from standard input. +input is from standard input.
The input is a PAM image of depth 1. Each sample represents the distance from the eye that the 3-D image at that location should @@ -344,10 +348,10 @@ be. Lower (darker) numbers mean further from the eye.
pamstereogram pays no attention to the image's tuple type and -ignores all planes other than plane 0. +ignores all planes other than plane 0.
Like any Netpbm program, pamstereogram will accept PNM -input as if it were the PAM equivalent. +input as if it were the PAM equivalent.
You create an MTS with pamstereogram by passing the filename of a PAM "texture image" with a -texfile option. A texture image portrays the same 3-D object as the depth-map image but -indicates the colors that the program should apply to the object. +indicates the colors that the program should apply to the object.
pamstereogram ignores the texture image's background color when it overlaps copies of the 3-D object. This prevents, for example, a bright-red @@ -370,32 +374,32 @@ object remains bright red. A consequence of this feature is that an MTS looks best when the objects in the texture image have a crisp outline. Smooth transitions to the background color result in unwanted color artifacts around edges because the program ignores only exact matches with the -background color. +background color.
You should specify a larger-than-normal value for -eyesep (and/or -dpi) when producing an MTS. Otherwise, the 3-D object will repeat so many times that most colored pixels will overlap other colored -pixels, reducing the number of true-colored pixels that remain. +pixels, reducing the number of true-colored pixels that remain.
An MTS can employ a background pattern (-patfile). In this case, pamstereogram replaces background pixels with pattern pixels in -the final step of generating the image. +the final step of generating the image.
A good initial test is to input an image consisting of a solid shape of distance 0 within a large field of maximum distance (e.g., a -white square on a black background). +white square on a black background).
With the default values for -dpi and -eyesep, pattern -images that are 128 pixels wide can tile seamlessly. +images that are 128 pixels wide can tile seamlessly.
Generate a SIRDS out of small, brightly colored squares and -prepare it for display on an 87 DPI monitor: +prepare it for display on an 87 DPI monitor:
pamstereogram depthmap.pam \
@@ -406,7 +410,7 @@ prepare it for display on an 87 DPI monitor:
Generate a SIS by tiling a PPM file (a prior run with
-verbose indicates how wide the pattern file should be for
seamless tiling, although any width is acceptable for producing
-SISes):
+SISes):
pamstereogram depthmap.pam -patfile mypattern.ppm >3d.pam
@@ -416,7 +420,7 @@ SISes):
Generate an MTS by associating colors with a depth-mapped object
(using a large eye separation to reduce the number of repetitions of
the texture image) and twice smoothing over background-colored
-speckles:
+speckles:
pamstereogram depthmap.pam \
@@ -427,21 +431,21 @@ speckles:
SEE ALSO
Copyright © 2006-2020 Scott Pakin, scott+pbm@pakin.org. +
Copyright © 2006-2020 Scott 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.
- -