Updated: 07 February 2010
++ ++Updated: 7 February 2010
+ + ++ + Table Of Contentsavstopam - convert an AVS X image to a Netpbm image -@@ -16,40 +16,40 @@ Updated: 07 February 2010 +-
avstopam - convert an AVS X image to a Netpbm image ++
avstopam - convert an AVS X image to a Netpbm image
++ + +-avstopam + [avsfile]
avsfile is the input file, which defaults to Standard Input. --Output is always on Standard Output. -+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
@@ -41,8 +48,8 @@ diff -urNp a/userguide/avstopam.html b/userguide/avstopam.html
Copyright © 2010 Scott Pakin,
--scott+pbm@pakin.org
-+scott+pbm@pakin.orgAUTHOR
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 -urNp a/userguide/libnetpbm_ug.html b/userguide/libnetpbm_ug.html ---- a/userguide/libnetpbm_ug.html 2025-02-04 10:47:27.824451560 +0100 -+++ b/userguide/libnetpbm_ug.html 2025-02-04 17:52:02.045207328 +0100 -@@ -374,7 +374,7 @@ plain format. -
The Libnetpbm Netpbm Image --Processing Manual describes the the libnetpbm functions for -+Processing Manual describes the libnetpbm functions for - processing image data. - -
The Libnetpbm Utility Manual -diff -urNp a/userguide/pamfunc.html b/userguide/pamfunc.html ---- a/userguide/pamfunc.html 2025-02-04 10:47:27.823451565 +0100 -+++ b/userguide/pamfunc.html 2025-02-04 17:52:19.661114878 +0100 -@@ -60,7 +60,7 @@ output image. - and bit string (such as and with 01001000). For the arithmetic functions, the - function arguments and results are the fraction that a sample is of the - maxval, i.e. normal interpretation of PAM tuples. But for the bit string --functions, the value is the the bit string whose value as a binary cipher is -+functions, the value is the bit string whose value as a binary cipher is - the sample value, and the maxval indicates the width of the bit string. - -
pammixmulti - blend together multiple PAM images -+
pammixmulti - blend together multiple PAM images
- - -Minimum unique abbreviation of an option is acceptable. You can use double - hyphen instead of a single hyphen to denote options. You can use white - space in place of the equals sign to separate an option name from its --value. -+value.
- - -This file is part of Netpbm. -+
This file is part of Netpbm.
- -pammixmulti mixes two or more images to produce a new image. The --program provides multiple ways to interpret "mix." -+program provides multiple ways to interpret "mix."
- - -In addition to the options common to all programs based on libnetpbm - (most notably -quiet, see - Common Options), pammixmulti recognizes the following --command line options: -+command line options:
- -mask, each pixel in the output is
- produced by a weighted average of the corresponding pixels from all
- the input images based on the grayscale level of an additional mask
--image.
---alpha-weighted was new in Netpbm 11.09 (December 2024). -+image.
-+-alpha-weighted was new in Netpbm 11.09 (December 2024).
- - -Use this to ensure you get the same image on separate invocations. -+
Use this to ensure you get the same image on separate invocations.
- -You supply the names of the files to mix as non-option arguments. -+
You supply the names of the files to mix as non-option arguments.
- - -Average a bunch of PPM images to produce a new PAM image: -+
Average a bunch of PPM images to produce a new PAM image:
-
- pammixmulti input*.ppm >output.ppm
- Mix these same images by taking each pixel from a randomly selected input --image: -+image:
- -
- pammixmulti -blend=random input*.ppm >output.ppm
- Use a mask image to control the fading among input images on a --pixel-by-pixel basis: -+pixel-by-pixel basis:
- -
- pammixmulti -blend=mask -maskfile=mask.pgm >output.pam \
- one.pam two.pam three.pam four.pam
- Do the same but with more abrupt transitions: -+
Do the same but with more abrupt transitions:
- -
- pammixmulti -blend=mask -maskfile=mask.pgm -stdev=0.0 >output.pam \
- one.pam two.pam three.pam four.pam
- and now with more gradual transitions: -+
and now with more gradual transitions:
- -
- pammixmulti -blend=mask -maskfile=mask.pgm -stdev=1.0 >output.pam \
-@@ -139,12 +139,12 @@ pixel-by-pixel basis:
-
- HISTORY
-
--pammixmulti was new in Netpbm 10.85 (December 2018).
-+
pammixmulti was new in Netpbm 10.85 (December 2018).
-
-
- AUTHOR
-
--Copyright 2018–2024 Scott Pakin, scott+pbm@pakin.org.
-+
Copyright 2018–2024 Scott Pakin, scott+pbm@pakin.org.
-
- SEE ALSO
-
-@@ -152,20 +152,20 @@ pixel-by-pixel basis:
- ppmmix,
- pamarith,
- pnm,
--pam
-+pam
-
-
- Table Of Contents
-
-
-
- Updated: 09 February 2020
+
+-Table Of Contents
++Table Of Contents
Minimum unique abbreviations of option are acceptable. You may use double hyphens instead of single hyphen to denote options. You may use @@ -331,9 +160,7 @@ diff -urNp a/userguide/pampaintspill.html b/userguide/pampaintspill.html
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 @@ -350,96 +177,40 @@ diff -urNp a/userguide/pampaintspill.html b/userguide/pampaintspill.html
Use this to ensure you get the same image on separate invocations. -+
Use this to ensure you get the same image on separate invocations.
- --This option was new in Netpbm 10.94 (March 2021).
This option was new in Netpbm 10.94 (March 2021).
-pampaintspill was new in Netpbm 10.50 (March 2010). -+
pampaintspill was new in Netpbm 10.50 (March 2010).
- - -Copyright © 2010–2021 Scott Pakin, --scott+pbm@pakin.org. -+scott+pbm@pakin.org.
- -Updated: 31 July 2010
-
+-
-Table Of Contents
-+Table Of Contents
Updated: 31 July 2010
++ ++ ++ ++ ++pamrecolor - alter colors without affecting luminance
+ +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. -+space in place of the equals sign to separate an option name from its value.
+@@ -30,7 +34,7 @@ space in place of the equals sign to separate an option name from its value.pamrecolor changes an image's colors to be as close as possible to given target colors but with the constraint that the -@@ -39,17 +39,17 @@ image will look identical if both are co +@@ -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.
-In addition to real Netpbm images, pamrecolor works on pseudo-Netpbm - images based on arbitrary color spaces. You can define the color space --explicitly or choose one of many that pamrecolor knows by name. -+explicitly or choose one of many that pamrecolor knows by name.
- -The output is a PAM image on standard output. Options control the +
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 @@ -469,7 +237,7 @@ diff -urNp a/userguide/pamrecolor.html b/userguide/pamrecolor.html
In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamrecolor recognizes the following @@ -478,28 +246,7 @@ diff -urNp a/userguide/pamrecolor.html b/userguide/pamrecolor.html
When you use this option, the input and output images are not true Netpbm - images, because the Netpbm image format specifies a particular color space. -@@ -76,9 +76,9 @@ the raster have different meaning. Many - images actually use a variation with a different color space. For example, - GIMP uses sRGB internally and if you - have GIMP generate a Netpbm image file, it really generates a variation of --the format that uses sRGB. -+the format that uses sRGB.
- --pamrecolor knows the following color spaces (name values): -+
pamrecolor knows the following color spaces (name values):
- -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 @@ -510,64 +257,29 @@ diff -urNp a/userguide/pamrecolor.html b/userguide/pamrecolor.html Bruce Lindbloom's -Computing RGB-to-XYZ and XYZ-to-RGB matrices page. -+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. -- --
You may not specify both -targetcolor and -colorfile. -+each pixel of the input image.
- -- -+You may not specify both -targetcolor and -colorfile.
- -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. -+
You may not specify both -targetcolor and -colorfile.
+You may not specify both -targetcolor and -colorfile. --
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.
--Use this to ensure you get the same image on separate invocations. -+
Use this to ensure you get the same image on separate invocations.
- -By default, pamrecolor uses a seed derived from the time of day - and process ID, which gives you fairly uncorrelated results in multiple --invocations. -- --
This option was new in Netpbm 10.61 (December 2012). -+invocations.
- --This option was new in Netpbm 10.61 (December 2012).
+You may not specify both -targetcolor and -colorfile. +@@ -176,23 +180,23 @@ invocations.
This command tints an image yellow:
- pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam +- pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam ++ pamrecolor --targetcolor=yellow colorpic.pam > yellowpic.pam
This command takes the colors from colorpicture.ppm and applies @@ -583,8 +296,10 @@ diff -urNp a/userguide/pamrecolor.html b/userguide/pamrecolor.html +them to graypicture.pgm:
- pamrecolor --colorfile=colorpic.ppm graypic.pgm > colorizedpic.pam -@@ -192,52 +188,52 @@ 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 @@ -593,11 +308,7 @@ diff -urNp a/userguide/pamrecolor.html b/userguide/pamrecolor.html
Here are a couple of fun special effects you can produce with --pamrecolor: -+pamrecolor:
- +@@ -203,25 +207,25 @@ 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). -+
pamrecolor was new in Netpbm 10.52 (September 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
+-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.
+ +avstopam, + gnuplot, +-pam ++pam
+ +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.
++ +Before Netpbm 10.79 (June 2017), there was a different program by the same --name in Netpbm, which was written by by Paul Haeberli -+name in Netpbm, which was written by Paul Haeberli - <paul@manray.sgi.com> in 1989 - and then modified extensively by others. +@@ -86,7 +87,7 @@ specify netpbmfile, the input is from Standard Input. +
Copyright (C) 2007 Scott Pakin, +-scott+pbm@pakin.org. ++scott+pbm@pakin.org.
+ +