OPTIONS

There are no command line options defined specifically -for anytopnm, but it recognizes the options common to all +for anytopnm. + +anytopnm does not recognize the options common to all programs based on libnetpbm (See -Common Options.) +Common Options.) However, the -version option works.

hpcdtoppm

-Updated: 7 August 2003 -
- -Table Of Contents - -

NAME

+ +Hpcdtoppm User Manual + +

hpcdtoppm

+Updated: 07 August 2003 +
+Table Of Contents + +

NAME

hpcdtoppm - convert a Photo-CD image into a PBM image -

SYNOPSIS

- -hpcdtoppm -infile -[-a] -[{-C|-0|-Overview|-O} file opt] -[-c0] -[-c-] -[-c+] -[-crop] -[-d] -[-dpi f] -[-eps] -[-epsd] -[-epsg] -[-fak scale] -[-hori] -[-i] -[-l] -[-m] -[-n] -[-pb pos] -[-pgm] -[-ph height] -[-pl pos] -[-pos] -[-ppm] -[-ps] -[-psd] -[-psg] -[-pw width] -[-r] -[-rep] -[-S long short] -[-s] -[-vert] -[-x] -[-ycc] -[-1|-Base/16|-128x192] -[-2|-Base/4|-256x384] -[-3|-Base|-512x768] -[-4|-4Base|-1024x1536] -[-5|-16Base|-2048x3072] -[-6|-64Base|-4096x6144] -[outfile] - -

DESCRIPTION

SYNOPSIS

+ +hpcdtoppm +infile +[-a] +[{-C|-0|-Overview|-O} file opt] +[-c0] +[-c-] +[-c+] +[-crop] +[-d] +[-dpi f] +[-eps] +[-epsd] +[-epsg] +[-fak scale] +[-hori] +[-i] +[-l] +[-m] +[-n] +[-pb pos] +[-pgm] +[-ph height] +[-pl pos] +[-pos] +[-ppm] +[-ps] +[-psd] +[-psg] +[-pw width] +[-r] +[-rep] +[-S long short] +[-s] +[-vert] +[-x] +[-ycc] +[-1|-Base/16|-128x192] +[-2|-Base/4|-256x384] +[-3|-Base|-512x768] +[-4|-4Base|-1024x1536] +[-5|-16Base|-2048x3072] +[-6|-64Base|-4096x6144] +[outfile] + +

DESCRIPTION

This program is part of Netpbm.

This program accepts Photo-CD image or overview file data from the -specified input file, infile (or, if the resolution is lower -than 64Base and the file argument is specified as -, from +specified input file, infile (or, if the resolution is lower +than 64Base and the file argument is specified as -, from standard input), and writes either PBM Format or PostScript to the specified output file (or to standard output if no file is specified). -

On a standard Photo-CD, image files appear in the directory +

On a standard Photo-CD, image files appear in the directory photo_cd/images, in files with names of the form -imgnnnn.pcd, where nnnn is a 4-digit-number. The -overview file appears in photo_cd/overview.pcd. +imgnnnn.pcd, where nnnn is a 4-digit-number. The +overview file appears in photo_cd/overview.pcd. -

Photo-CD images are stored using as many as 6 different resolutions: +

Photo-CD images are stored using as many as 6 different resolutions: -

+           Format              Resolution
           ------              ----------
           64Base              4096x6144 (ProPhotoCD only)
@@ -83,309 +82,314 @@ overview file appears in photo_cd/overview.pcd.
           Base                512x768
           Base/4              256x384
           Base/16             128x192
-
+

The overview file employs Base/16 format. +

The overview file employs Base/16 format. -

OPTIONS

Invoking hpcdtoppm without arguments produces a list of default values. Note that you can supply only one size option. -

-a +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), hpcdtoppm recognizes the following +command line options: + +
+
-a -
Automatically determine image orientation (this option is +
Automatically determine image orientation (this option is experimental, and does not work for overview files). -
{-C | -0 | -Overview | -O } file opt +
{-C | -0 | -Overview | -O } file opt -
Extract all images from an overview file. The mandatory -file argument is the name of a PPM file; output files are named -filennnn, where nnnn is a 4-digit number. Overview +
Extract all images from an overview file. The mandatory +file argument is the name of a PPM file; output files are named +filennnn, where nnnn is a 4-digit number. Overview images are extracted in their original Base/16 format. The value of -opt determines the orientation of the contact sheet image; +opt determines the orientation of the contact sheet image; recognized values are: -
-
n +
+
n -
Do not rotate the image. +
Do not rotate the image. -
l +
l -
Rotate the picture counter-clockwise (portrait mode). +
Rotate the picture counter-clockwise (portrait mode). -
r +
r -
Rotate the picture clockwise (portrait mode). +
Rotate the picture clockwise (portrait mode). -
+
-
-c0 +
-c0 -
Do not correct (brighten or darken) the image. +
Do not correct (brighten or darken) the image. -
-c- +
-c- -
Darken the image. +
Darken the image. -
-c+ +
-c+ -
Brighten the image. +
Brighten the image. -
-crop +
-crop -
Cut off the black frame which sometimes appears at the image +
Cut off the black frame which sometimes appears at the image borders. -
-d +
-d -
Show only the decompressed difference rather than the complete image +
Show only the decompressed difference rather than the complete image (applicable only to 4Base and 16Base images). -
-dpi res +
-dpi res -
Set the printer resolution to res for dithered Postscript +
Set the printer resolution to res for dithered Postscript images. -
-eps +
-eps -
Write a RGB Encapsulated Postscript color image. +
Write a RGB Encapsulated Postscript color image. -
-epsd +
-epsd -
Write a Floyd-Steinberg dithered image in Encapsulated Postscript. +
Write a Floyd-Steinberg dithered image in Encapsulated Postscript. -
-epsg +
-epsg -
Write a grayscale image in Encapsulated Postscript. +
Write a grayscale image in Encapsulated Postscript. -
-fak scale +
-fak scale -
Set the scaling factor for dithered PostScript images to -scale. +
Set the scaling factor for dithered PostScript images to +scale. -
-hori +
-hori -
Flip the image horizontally. +
Flip the image horizontally. -
-i +
-i -
Send information from an image file header to Standard Error. +
Send information from an image file header to Standard Error. -
-l +
-l -
Rotate the picture counter-clockwise (portrait mode). +
Rotate the picture counter-clockwise (portrait mode). -
-m +
-m -
Write messages about the phases of decoding to standard error. +
Write messages about the phases of decoding to standard error. -
-n +
-n -
Do not rotate the image. +
Do not rotate the image. -
-pb pos +
-pb pos -
Set the bottom position of the Postscript image to pos. +
Set the bottom position of the Postscript image to pos. -
-pgm +
-pgm -
Write a pgm (grayscale) image. +
Write a pgm (grayscale) image. -
-ph height +
-ph height -
Set the height of the Postscript image to height. +
Set the height of the Postscript image to height. -
-pl pos +
-pl pos -
Set the leftmost position of the Postscript image to pos. +
Set the leftmost position of the Postscript image to pos. -
-pos +
-pos -
Print the relative starting position of the data for the current +
Print the relative starting position of the data for the current resolution. -
-ppm +
-ppm -
Write a ppm RGB (color) image. +
Write a ppm RGB (color) image. -
-ps +
-ps -
Write a RGB Postscript color image. +
Write a RGB Postscript color image. -
-psd +
-psd -
Write a Floyd-Steinberg dithered image in Postscript. +
Write a Floyd-Steinberg dithered image in Postscript. -
-psg +
-psg -
Write a Postscript grayscale image. +
Write a Postscript grayscale image. -
-pw width +
-pw width -
Set the width of the Postscript image to width. +
Set the width of the Postscript image to width. -
-r +
-r -
Rotate the picture clockwise (portrait mode). +
Rotate the picture clockwise (portrait mode). -
-rep +
-rep -
Try to jump over reading errors in the Huffman code. +
Try to jump over reading errors in the Huffman code. -
-S long short +
-S long short -
Cut out a subrectangle with boundaries defined by the values: +
Cut out a subrectangle with boundaries defined by the values: -
-
long +
+
long -
For the longer side of the image. +
For the longer side of the image. -
short +
short -
For the shorter side of the image. +
For the shorter side of the image. -
+
-where long and short take one of two forms: +where long and short take one of two forms: -
-
a-b +
+
a-b -
Cut from position a to position b. +
Cut from position a to position b. -
a+b +
a+b -
Starting at offset a, cut a length of b. +
Starting at offset a, cut a length of b. -
+
-and where a and b are either integers representing pixel +and where a and b are either integers representing pixel locations, or floating point values over the range [0.0 ... 1.0], representing the fraction of the length of a side. -
-s +
-s -
Apply a simple sharpness operator to the luminosity channel. +
Apply a simple sharpness operator to the luminosity channel. -
-vert +
-vert -
Flip the image vertically. +
Flip the image vertically. -
-x +
-x -
Overskip Mode (applicable to Base/16, Base/4, Base and 4Base). +
Overskip Mode (applicable to Base/16, Base/4, Base and 4Base). In Photo-CD images the luminosity channel is stored in full resolution, the two chromaticity channels are stored in half resolution only and have to be interpolated. In Overskip Mode, the chromaticity channels of the next higher resolution are taken instead of interpolating. To see the difference, generate one PPM with and -one PPM without this option. Use pamarith to generate the difference image -of these two images. Call ppmhist -for this difference or show it with xv (push the HistEq button +one PPM without this option. Use pamarith to generate the difference image +of these two images. Call ppmhist +for this difference or show it with xv (push the HistEq button in the color editor). -
-ycc +
-ycc -
Write the image in a variation on PPM format in which the samples +
Write the image in a variation on PPM format in which the samples are YCC instead of RGB. -
-1|-Base/16|-128x192 +
-1|-Base/16|-128x192 -
Extract the Base/16 image. +
Extract the Base/16 image. -
-2|-Base/4|-256x384 +
-2|-Base/4|-256x384 -
Extract the Base/4 image. +
Extract the Base/4 image. -
-3|-Base|-512x768 +
-3|-Base|-512x768 -
Extract the Base image. +
Extract the Base image. -
-4|-4Base|-1024x1536 +
-4|-4Base|-1024x1536 -
Extract the 4Base image. +
Extract the 4Base image. -
-5|-16Base|-2048x3072 +
-5|-16Base|-2048x3072 -
Extract the 16Base image. +
Extract the 16Base image. -
-6|-64Base|-4096x6144 +
-6|-64Base|-4096x6144 -
Extract the 64Base image. This resolution can be extracted from +
Extract the 64Base image. This resolution can be extracted from ProPhotoCD images only. The path of the 64Base extension files is derived from the path to the image file. This means that it doesn't work on stdin an the directory structure must be the very same as on the ProPhotoCD. -
+

Postcript Output

POSTSCRIPT OUTPUT

For Postscript output (options -ps, -eps, --psg, -epsg, -psd, -epsg) you can define +

For Postscript output (options -ps, -eps, +-psg, -epsg, -psd, -epsg) you can define both the resolution and placement of the image. Both size and position are specified in points (1/72 inch). -

The position of the image (where the origin is assumed to be at the -lower left corner of the page) is controlled by the -pl and --pb options (applicable at all resolutions). +

The position of the image (where the origin is assumed to be at the +lower left corner of the page) is controlled by the -pl and +-pb options (applicable at all resolutions). -

The size of color and grayscale images is changed with the --pw and -ph options. Every image pixel is mapped onto +

The size of color and grayscale images is changed with the +-pw and -ph options. Every image pixel is mapped onto one Postscript pixel. -

There are three modes of control for dithered Postscript: +

There are three modes of control for dithered Postscript: -

Image size +
+
Image size -
(-pw and -ph) +
(-pw and -ph) -
Printer resolution +
Printer resolution -
(-dpi) +
(-dpi) -
Scaling factor +
Scaling factor -
(-fak) +
(-fak) -
+

These three factors are interdependent, hence no more then two can -be specified simultaneously. Using -dpi and the --pw/-ph options together often yields pleasing results. +

These three factors are interdependent, hence no more then two can +be specified simultaneously. Using -dpi and the +-pw/-ph options together often yields pleasing results. Even using the default values for these options will produce results differing from those obtained without use of the options. -

Limitations

LIMITATIONS

The program ignores read protection. -

The -i option is not working correctly. +

The -i option is not working correctly. -

Available information obout the Photo-CD format is vague; this +

Available information obout the Photo-CD format is vague; this program was developed by trial-and-error after staring at hex-dumps. Please send bugs reports and patches to the author. -

VERSION

The name hpcdtoppm stands for "Hadmut's pcdtoppm," to make it distinguishable in the event that someone else is building a @@ -394,10 +398,10 @@ similar application and naming it pcdtoppm.

This is version 0.6. -

AUTHOR

Hadmut Danish has given permission to Bryan Henderson (August 2003) to distribute this documentation as part of Netpbm on Sourceforge and @@ -413,26 +417,26 @@ and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. -

The hpcdtoppm software itself (as opposed to this supporting +

The hpcdtoppm software itself (as opposed to this supporting documentation) is licensed by Danisch under a similar license, but with an additional restriction that a recipient may not sell the software or use it in profit-making activity. See the source code of the program for details on its license. -

Manual page extensively modified by R. P. C. Rodgers (rodgers@nlm.nih.gov). - -

SYNOPSIS -
DESCRIPTION -
OPTIONS -
POSTSCRIPT OUTPUT -
LIMITATIONS -
SEE ALSO -
VERSION -
AUTHOR -

- - +

Manual page extensively modified by R. P. C. Rodgers (rodgers@nlm.nih.gov). + +

SYNOPSIS +
DESCRIPTION +
OPTIONS +
POSTSCRIPT OUTPUT +
LIMITATIONS +
SEE ALSO +
VERSION +
AUTHOR +

+ + diff --git a/icontopbm.html b/icontopbm.html index 684e230c..e77cd875 100644 --- a/icontopbm.html +++ b/icontopbm.html @@ -1,21 +1,19 @@ - -Icontopbm User Manual - -

icontopbm

+ +Icontopbm User Manual + +

icontopbm

-Table Of Contents +

NAME

+icontopbm - replaced by sunicontopnm -icontopbm - convert a Sun icon image to PBM +

SYNOPSIS

+icontopbm +[iconfile] -icontopbm -[iconfile] - -

DESCRIPTION

This program is part of Netpbm. @@ -36,9 +34,5 @@ for icontopbm, as long as you recognize that any change the sunicontopnm manual says happened in or after Netpbm 10.53 doesn't apply to icontopbm. - - - - - - + + diff --git a/jbigtopnm.html b/jbigtopnm.html index 98f6883a..ea7a8679 100644 --- a/jbigtopnm.html +++ b/jbigtopnm.html @@ -1,30 +1,30 @@ - -Jbigtopnm User Manual - -

Jbigtopnm

+ +Jbigtopnm User Manual + +

jbigtopnm

Updated: 29 September 2018 -
-Table Of Contents +
+Table Of Contents -

NAME

jbigtopnm - JBIG to PNM image file converter -

SYNOPSIS

-jbigtopnm +jbigtopnm [-xmax] [-ymax] [-binary] [-diagnose] [-plane] -[input-file [output-file]] +[input-file [output-file]]

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

DESCRIPTION

This program is part of Netpbm. @@ -33,100 +33,105 @@ file or standard input, decompresses it, and outputs a PBM or PGM file. If the input has one plane, or you choose just one plane of it, the output is PBM. Otherwise, the output is PGM. -

JBIG is a highly effective lossless compression algorithm for +

JBIG is a highly effective lossless compression algorithm for bi-level images (one bit per pixel), which is particularly suitable for scanned document pages. -

A JBIG encoded image can be stored in several resolutions in one or +

A JBIG encoded image can be stored in several resolutions in one or several BIEs. All resolution layers except the lowest one are stored efficiently as differences to the next lower resolution layer. You -can use options -x and -y to stop the decompression at a +can use options -x and -y to stop the decompression at a specified maximal output image size. The input file can consist of several concatenated BIEs which contain different increasing resolution layers of the same image. -

OPTIONS

+ +

In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), jbigtopnm recognizes the following +command line options:

Before Netpbm 10.85 (December 2018), only single-character single-hyphen abbreviations of the options are accepted. -

-x number +
-xmax number -: Decode only up to the largest resolution layer which is still not -more than number pixels wide. If no such resolution layer +; Decode only up to the largest resolution layer which is still not +more than number pixels wide. If no such resolution layer exists, then use the smallest one available. -
-y number +
-ymax number -: Decode only up to the largest resolution layer which is still not -more than number pixels high. If no such resolution layer +; Decode only up to the largest resolution layer which is still not +more than number pixels high. If no such resolution layer exists, then use the smallest one available. You can also use options --x and -y together which selects the largest layer that +-x and -y together which selects the largest layer that satisfies both limits. -
-b +
-binary -: Use binary values instead of Gray code words in order to decode +; Use binary values instead of Gray code words in order to decode pixel values from multiple bitplanes. This option has effect only if the input has more than one bitplane and you don't select just one of those bitplanes. Note that the decoder has to be used in the same mode as the encoder and cannot determine from the BIE, whether Gray or binary code words were used by the encoder. -
-d +
-diagnose -: Diagnose a BIE. With this option, jbigtopnm only prints a +; Diagnose a BIE. With this option, jbigtopnm only prints a summary of the header information found in the input file and then exits. -
-p number +
-plane number -: If the input contains multiple bitplanes, then extract only the +; If the input contains multiple bitplanes, then extract only the specified single plane as a PBM file. The first plane has number 0. -

+ -

STANDARDS

This program implements the JBIG image coding algorithm as specified in ISO/IEC 11544:1993 and ITU-T T.82(1993). -

AUTHOR

jbigtopnm is based on the JBIG library by Markus Kuhn, part +

jbigtopnm is based on the JBIG library by Markus Kuhn, part of his JBIG-KIT -package. The jbgtopbm program is part of the -JBIG-KIT package. +href="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT +package. The jbgtopbm program is part of the +JBIG-KIT package. -

jbigtopnm is part of the Netpbm package of graphics tools. +

jbigtopnm is part of the Netpbm package of graphics tools. -

LICENSE

-If you use jbigtopnm, you are using various patents, +If you use jbigtopnm, you are using various patents, particularly on its arithmetic encoding method, and in all probability you do not have a license from the patent owners to do so. -

SYNOPSIS -
DESCRIPTION -
OPTIONS -
STANDARDS -
AUTHOR -
SEE ALSO -
LICENSE -

- - +

SYNOPSIS +
DESCRIPTION +
OPTIONS +
STANDARDS +
AUTHOR +
SEE ALSO +
LICENSE +

+ + diff --git a/jpegtopnm.html b/jpegtopnm.html index 1d489070..9262e033 100644 --- a/jpegtopnm.html +++ b/jpegtopnm.html @@ -1,39 +1,39 @@ - -Jpegtopnm User Manual - -

JPEGTOPNM

+ +Jpegtopnm User Manual + +

jpegtopnm

Updated: 13 October 2002 -
-Table Of Contents +
+Table Of Contents -

NAME

jpegtopnm - convert JPEG/JFIF file to PPM or PGM image -

SYNOPSIS

- -jpegtopnm -[-dct {int|fast|float}] -[-nosmooth] -[-maxmemory N] -[{-adobe|-notadobe}] -[-comments] -[-dumpexif] -[-exif=filespec] -[-multiple] -[-repair] -[-verbose] -[-tracelevel N] -[filename] +

SYNOPSIS

+ +jpegtopnm +[-dct {int|fast|float}] +[-nosmooth] +[-maxmemory N] +[{-adobe|-notadobe}] +[-comments] +[-dumpexif] +[-exif=filespec] +[-multiple] +[-repair] +[-verbose] +[-tracelevel N] +[filename]

DESCRIPTION

This program is part of Netpbm. -

jpegtopnm converts JFIF images to PPM or PGM images. +

jpegtopnm converts JFIF images to PPM or PGM images.

By default, jpegtopnm expects the input stream to contain one JFIF image and produces one PGM or PPM image as output. It fails if the @@ -48,7 +48,7 @@ so is the output. don't specify filename, Standard Input. The output stream is Standard Output. -

If a JFIF input image is of the grayscale variety, jpegtopnm +

If a JFIF input image is of the grayscale variety, jpegtopnm generates a PGM image. Otherwise, it generates a PPM image.

Before Netpbm 10.11 (October 2002), jpegtopnm did not have @@ -62,61 +62,68 @@ something other than another JFIF image. The producers of these files expect them to work with any JFIF interpreter because most JFIF interpreters just stop reading the file after the first JFIF image. -

jpegtopnm uses the Independent JPEG Group's JPEG library to -interpret the input file. See http://www.ijg.org +

jpegtopnm uses the Independent JPEG Group's JPEG library to +interpret the input file. See http://www.ijg.org for information on the library. -

"JFIF" is the correct name for the image format commonly +

"JFIF" is the correct name for the image format commonly known as "JPEG." Strictly speaking, JPEG is a method of compression. The image format using JPEG compression that is by far the most common is JFIF. There is also a subformat of TIFF that uses JPEG compression. -

EXIF is an image format that is a subformat of JFIF (to wit, a JFIF +

EXIF is an image format that is a subformat of JFIF (to wit, a JFIF file that contains an EXIF header as an APP1 marker). -jpegtopnm handles EXIF. +jpegtopnm handles EXIF. -

JFIF files can have either 8 bits per sample or 12 bits per sample. +

JFIF files can have either 8 bits per sample or 12 bits per sample. The 8 bit variety is by far the most common. There are two versions of the IJG JPEG library. One reads only 8 bit files and the other reads only 12 bit files. You must link the appropriate one of these -libraries with jpegtopnm. Ordinarily, this means the library -is in your shared library search path when you run jpegtopnm. +libraries with jpegtopnm. Ordinarily, this means the library +is in your shared library search path when you run jpegtopnm. -

jpegtopnm generates output with either one byte or two bytes +

jpegtopnm generates output with either one byte or two bytes per sample depending on whether the JFIF input has either 8 bits or 12 -bits per sample. You can use pamdepth to reduce a +bits per sample. You can use pamdepth to reduce a two-byte-per-sample file to a one-byte-per-sample file if you need to. -

If the JFIF file uses the CMYK or YCCK color space, the input does +

If the JFIF file uses the CMYK or YCCK color space, the input does not actually contain enough information to know what color each pixel is. To know what color a pixel is, one would have to know the properties of the inks to which the color space refers. -jpegtopnm interprets the colors using the common transformation +jpegtopnm interprets the colors using the common transformation which assumes all the inks are simply subtractive and linear. -

See the jpegtopnm manual +

See the jpegtopnm manual for information on how images lose quality when you convert to and from JFIF. -

OPTIONS

-The options are only for advanced users: -

-dct int +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), jpegtopnm recognizes the following +command line options: -

+The options are only for advanced users. + +

-dct int + +

Use integer DCT method (default). -

-dct fast +

-dct fast -

Use fast integer DCT (less accurate). -

-dct float +

-dct float -

Use floating-point DCT method. The float method is very slightly more accurate than the int method, but is much slower unless your machine has very fast floating-point hardware. Also @@ -124,22 +131,22 @@ note that results of the floating-point method may vary slightly across machines, while the integer methods should give the same results everywhere. The fast integer method is much less accurate than the other two. -

-nosmooth +

-nosmooth -

Use a faster, lower-quality upsampling routine. -

-maxmemory N +

-maxmemory N -

Set limit on the amount of memory jpegtopnm uses in +

Set limit on the amount of memory jpegtopnm uses in processing large images. Value is in thousands of bytes, or millions of bytes if "M" is suffixed to the number. For example, --maxmemory 4m selects 4000000 bytes. If jpegtopnm needs +-maxmemory 4m selects 4000000 bytes. If jpegtopnm needs more space, it uses temporary files. -

-adobe -

-notadobe +

-adobe +

-notadobe -

There are two variations on the CMYK (and likewise YCCK) color space that may be used in the JFIF input. In the normal one, a zero value for a color components indicates absence of ink. In the other, a zero value means the @@ -147,52 +154,52 @@ maximum ink coverage. The latter is used by Adobe Photoshop when it creates a bare JFIF output file (but not when it creates JFIF output as part of Encapsulated Postscript output). -

These options tell jpegtopnm which version of the CMYK or +

These options tell jpegtopnm which version of the CMYK or YCCK color space the image uses. If you specify neither, -jpegtopnm tries to figure it out on its own. In the present +jpegtopnm tries to figure it out on its own. In the present version, it doesn't try very hard at all: It just assumes the Photoshop version, since Photoshop and its emulators seem to be the main source of CMYK and YCCK images. But with experience of use, future versions might be more sophisticated. -

If the JFIF image does not indicate that it is CMYK or YCCK, these +

If the JFIF image does not indicate that it is CMYK or YCCK, these options have no effect. -

If you don't use the right one of these options, the symptom is +

If you don't use the right one of these options, the symptom is output that looks like a negative. -

-dumpexif +

-dumpexif -

Print the interpreted contents of any Exif header in the input -file to the Standard Error file. Similar to the program jhead +

Print the interpreted contents of any Exif header in the input +file to the Standard Error file. Similar to the program jhead (not part of the Netpbm package).

This option was added in Netpbm 9.19 (September 2001). -

-exif=filespec +

-exif=filespec -

Extract the contents of the EXIF header from the input image and -write it to the file filespec. filespec=- means +

Extract the contents of the EXIF header from the input image and +write it to the file filespec. filespec=- means write it to Standard Output. When you write the EXIF header to -Standard Output, jpegtopnm does not output the converted image +Standard Output, jpegtopnm does not output the converted image (which is what normally would go to Standard Output) at all. -

jpegtopnm writes the contents of the EXIF header +

jpegtopnm writes the contents of the EXIF header byte-for-byte, starting with the two byte length field (which length includes those two bytes). -

You can use this file as input to pnmtojpeg to insert an +

You can use this file as input to pnmtojpeg to insert an identical EXIF header into a new JFIF image. -

If there is no EXIF header, jpegtopnm writes two bytes of +

If there is no EXIF header, jpegtopnm writes two bytes of binary zero and nothing else. -

An EXIF header takes the form of a JFIF APP1 marker. Only the +

An EXIF header takes the form of a JFIF APP1 marker. Only the first such marker within the JFIF header counts.

This option was added in Netpbm 9.19 (September 2001). -

-multiple +

-multiple

Read multiple JFIF images sequentially from the input stream. See Description section for details. @@ -224,129 +231,128 @@ contents at the top, but the bottom is padded with gray. jpegtopnm always fails in the cases in question. -

-comments +

-comments -

Print any comments in the input file to the Standard Error file. -

-verbose +

-verbose -

Print details about the conversion to the Standard Error file. -

-tracelevel n +

-tracelevel n -

Turn on the JPEG library's trace messages to the Standard Error -file. A higher value of n gets more trace information. --verbose implies a trace level of at least 1. +

Turn on the JPEG library's trace messages to the Standard Error +file. A higher value of n gets more trace information. +-verbose implies a trace level of at least 1. -

EXAMPLES

This example converts the color JFIF file foo.jpg to a PPM file +

This example converts the color JFIF file foo.jpg to a PPM file named foo.ppm: -

+     jpegtopnm foo.jpg >foo.ppm
-
+

HINTS

-You can use pnmquant to color quantize the result, i.e. to +You can use pnmquant to color quantize the result, i.e. to reduce the number of distinct colors in the image. In fact, you may have to if you want to convert the PPM file to certain other formats. -ppmdither Does a more sophisticated quantization. +ppmdither Does a more sophisticated quantization. -

Use pamscale to change the dimensions of the resulting +

Use pamscale to change the dimensions of the resulting image. -

Use ppmtopgm to convert a color JFIF file to a grayscale +

Use ppmtopgm to convert a color JFIF file to a grayscale PGM file. -

You can easily use these converters together. E.g.: +

You can easily use these converters together. E.g.: -

+     jpegtopnm foo.jpg | ppmtopgm | pamscale .25 >foo.pgm
-
+

-dct fast and/or -nosmooth gain speed at a small +

-dct fast and/or -nosmooth gain speed at a small sacrifice in quality. -

If you are fortunate enough to have very fast floating point -hardware, -dct float may be even faster than -dct fast. -But on most machines -dct float is slower than -dct int; +

If you are fortunate enough to have very fast floating point +hardware, -dct float may be even faster than -dct fast. +But on most machines -dct float is slower than -dct int; in this case it is not worth using, because its theoretical accuracy advantage is too small to be significant in practice. -

Another program, djpeg, is similar. djpeg is +

Another program, djpeg, is similar. djpeg is maintained by the Independent JPEG Group and packaged with the JPEG -library which jpegtopnm uses for all its JPEG work. Because of +library which jpegtopnm uses for all its JPEG work. Because of that, you may expect it to exploit more current JPEG features. Also, -since you have to have the library to run jpegtopnm, but not -vice versa, cjpeg may be more commonly available. +since you have to have the library to run jpegtopnm, but not +vice versa, cjpeg may be more commonly available. -

On the other hand, djpeg does not use the NetPBM libraries +

On the other hand, djpeg does not use the NetPBM libraries to generate its output, as all the NetPBM tools such as -jpegtopnm do. This means it is less likely to be consistent +jpegtopnm do. This means it is less likely to be consistent with all the other programs that deal with the NetPBM formats. Also, -the command syntax of jpegtopnm is consistent with that of the -other Netpbm tools, unlike djpeg. +the command syntax of jpegtopnm is consistent with that of the +other Netpbm tools, unlike djpeg. -

ENVIRONMENT

JPEGMEM +
+
JPEGMEM -
If this environment variable is set, its value is the default +
If this environment variable is set, its value is the default memory limit. The value is specified as described for the --maxmemory option. An explicit -maxmemory option -overrides any JPEGMEM. +-maxmemory option. An explicit -maxmemory option +overrides any JPEGMEM. -
+

AUTHOR

jpegtopnm and this manual were derived in large part from -djpeg, by the Independent JPEG Group. The program is otherwise +

jpegtopnm and this manual were derived in large part from +djpeg, by the Independent JPEG Group. The program is otherwise by Bryan Henderson on March 19, 2000. -

SYNOPSIS -
DESCRIPTION -
OPTIONS -
EXAMPLES -
HINTS -
ENVIRONMENT -
SEE ALSO -
LIMITATIONS -
AUTHOR -

- - +

SYNOPSIS +
DESCRIPTION +
OPTIONS +
EXAMPLES +
HINTS +
ENVIRONMENT +
SEE ALSO +
AUTHOR +

+ + diff --git a/mrf.html b/mrf.html index f0f0e531..7415980e 100644 --- a/mrf.html +++ b/mrf.html @@ -12,7 +12,7 @@ MRF - monochrome recursive format (compressed bitmaps)

DESCRIPTION

This document describes the MRF format supported by +

This document describes the MRF format recognized by Netpbm.

MRF is a compressed format for bilevel (1-bit mono) images. It diff --git a/pam.html b/pam.html index 0078d4f0..a45846e4 100644 --- a/pam.html +++ b/pam.html @@ -1,34 +1,34 @@ - - - -PAM format specification - - - -Table Of Contents - -

pam

+ + + +PAM format specification + + + + +

pam

Updated: 27 November 2013 -
+
+Table Of Contents -

GENERAL

The PAM image format is a lowest common denominator 2 dimensional map format. -

It is designed to be used for any of myriad kinds of graphics, but can +

It is designed to be used for any of myriad kinds of graphics, but can theoretically be used for any kind of data that is arranged as a two dimensional rectangular array. Actually, from another perspective it can be seen as a format for data arranged as a three dimensional array. -

The name "PAM" is an acronym derived from "Portable +

The name "PAM" is an acronym derived from "Portable Arbitrary Map." This derivation makes more sense if you consider it in the context of the other Netpbm format names: PBM, PGM, and PPM. -

This format does not define the meaning of the data at any particular +

This format does not define the meaning of the data at any particular point in the array. It could be red, green, and blue light intensities such that the array represents a visual image, or it could be the same red, green, and blue components plus a transparency @@ -36,7 +36,7 @@ component, or it could contain annual rainfalls for places on the surface of the Earth. Any process that uses the PAM format must further define the format to specify the meanings of the data. -

A PAM image describes a two dimensional grid of tuples. The tuples are +

A PAM image describes a two dimensional grid of tuples. The tuples are arranged in rows and columns. The width of the image is the number of columns. The height of the image is the number of rows. All rows are the same width and all columns are the same height. The tuples may have any @@ -48,7 +48,7 @@ maxval is the same for every sample in the image. The two dimensional array of all the Nth samples of each tuple is called the Nth plane or Nth channel of the image. -

Though the basic format does not assign any meaning to the tuple values, it +

Though the basic format does not assign any meaning to the tuple values, it does include an optional string that describes that meaning. The contents of this string, called the tuple type, are arbitrary from the point of view of the basic PAM format, but users of the format may assign @@ -56,23 +56,23 @@ meaning to it by convention so they can identify their particular implementations of the PAM format. Some tuple types are defined as official subformats of PAM. See Defined Tuple Types. -

The Confusing Universe of Netpbm Formats

It is easy to get confused about the relationship between the PAM +

It is easy to get confused about the relationship between the PAM format and PBM, PGM, PPM, and PNM. Here is a little enlightenment: -

"PNM" is not really a format. It is a shorthand for the PBM, PGM, +

"PNM" is not really a format. It is a shorthand for the PBM, PGM, and PPM formats collectively. It is also the name of a group of library functions that can each handle all three of those formats. -

"PAM" is in fact a fourth format. But it is so general +

"PAM" is in fact a fourth format. But it is so general that you can represent the same information in a PAM image as you can in a PBM, PGM, or PPM image. And in fact a program that is designed to read PBM, PGM, or PPM and does so with a recent version of the Netpbm library will read an equivalent PAM image just fine and the program will never know the difference. -

To confuse things more, there is a collection of library routines +

To confuse things more, there is a collection of library routines called the "pam" functions that read and write the PAM format, but also read and write the PBM, PGM, and PPM formats. They do this because the latter formats are much older and more popular, so @@ -80,21 +80,21 @@ even a new program must work with them. Having the library handle all the formats makes it convenient to write programs that use the newer PAM format as well. -

THE LAYOUT

A convenient way to read and write the PAM format accurately is via the +

A convenient way to read and write the PAM format accurately is via the libnetpbm C subroutine library. -

A PAM file consists of a sequence of one or more PAM images. There are +

A PAM file consists of a sequence of one or more PAM images. There are no data, delimiters, or padding before, after, or between images. -

Each PAM image consists of a header followed immediately by a raster. -

Here is an example header:

-
+
 P7
 WIDTH 227
 HEIGHT 149
@@ -102,87 +102,87 @@ DEPTH 3
 MAXVAL 255
 TUPLTYPE RGB
 ENDHDR
-
+

The header begins with the ASCII characters "P7" followed +

The header begins with the ASCII characters "P7" followed by newline. This is the magic number. -

Note: xv thumbnail images also start with the "P7" magic number. +

Note: xv thumbnail images also start with the "P7" magic number. (This and PAM were independent extensions to the Netpbm formats). The rest of the format makes it easy to distinguish PAM from that format, though). -

The header continues with an arbitrary number of lines of ASCII +

The header continues with an arbitrary number of lines of ASCII text. Each line ends with and is delimited by a newline character. -

Each header line consists of zero or more whitespace-delimited +

Each header line consists of zero or more whitespace-delimited tokens or begins with "#". If it begins with "#" it is a comment and the rest of this specification does not apply to it. -

A header line which has zero tokens is valid but has no meaning. +

A header line which has zero tokens is valid but has no meaning. -

The type of header line is identified by its first token, which is +

The type of header line is identified by its first token, which is 8 characters or less: -

ENDHDR +
+
ENDHDR -
This is the last line in the header. The header must contain +
This is the last line in the header. The header must contain exactly one of these header lines. -
HEIGHT +
HEIGHT -
The second token is a decimal number representing the height +
The second token is a decimal number representing the height of the image (number of rows). The header must contain exactly one of these header lines. -
WIDTH +
WIDTH -
The second token is a decimal number representing the width of the +
The second token is a decimal number representing the width of the image (number of columns). The header must contain exactly one of these header lines. -
DEPTH +
DEPTH -
The second token is a decimal number representing the depth of the +
The second token is a decimal number representing the depth of the image (number of planes or channels). The header must contain exactly one of these header lines. -
MAXVAL +
MAXVAL -
The second token is a decimal number representing the maxval of the image. +
The second token is a decimal number representing the maxval of the image. The header must contain exactly one of these header lines. -
TUPLTYPE +
TUPLTYPE -
The header may contain any number of these header lines, including +
The header may contain any number of these header lines, including zero. The rest of the line is part of the tuple type. The rest of the line is not tokenized, but the tuple type does not include any -white space immediately following TUPLTYPE or at the very end +white space immediately following TUPLTYPE or at the very end of the line. It does not include a newline. There must be something other than white space after the TUPLTYPE token. -
If there are multiple TUPLTYPE header lines, the tuple type +
If there are multiple TUPLTYPE header lines, the tuple type is the concatenation of the values from each of them, separated by a single blank, in the order in which they appear in the header. If -there are no TUPLTYPE header lines the tuple type is the null +there are no TUPLTYPE header lines the tuple type is the null string. -
+

The raster consists of each row of the image, in order from top to bottom, consecutive with no delimiter of any kind between, before, or after, rows. -

Each row consists of every tuple in the row, in order from left to right, consecutive with no delimiter of any kind between, before, or after, tuples. -

Each tuple consists of every sample in the tuple, in order, consecutive with no delimiter of any kind between, before, or after, samples. -

Each sample consists of an unsigned integer in pure binary format, with the most significant byte first. The number of bytes is the minimum number of bytes required to represent the maxval of the image. @@ -190,20 +190,20 @@ minimum number of bytes required to represent the maxval of the image.

The character referred to as "newline" herein is the character known in ASCII as Line Feed or LF. -

LIMITATIONS

Height, width, depth, and maxval are at least 1.

Height, width, and depth have no defined maximum, but processors and generators of images usually have their own limitations. -

The maxval of an image is never greater than 65535. (The reason it is +

The maxval of an image is never greater than 65535. (The reason it is limited is to make it easier to build an image processor, in which intermediate arithmetic values often have to fit within 31 or 32 bits). There was no specified limitation before October, 2005, but essentially all implementations have always observed it. -

DEFINED TUPLE TYPES

Some tuple types are defined in this specification to specify official subformats of PAM for especially popular applications of the @@ -225,34 +225,34 @@ separately validate that the depth is consistent with the tuple type. Also, it is good practice to accept a depth that is too great and just ignore the higher numbered planes. -

PAM Used For Visual Images

A common use of PAM images is to represent visual images such +

A common use of PAM images is to represent visual images such as are typically represented by images in the older and more concrete PBM, PGM, and PPM formats.

Black And White

A black and white image, such as would alternatively be represented by a +

A black and white image, such as would alternatively be represented by a PBM image, has a tuple type of "BLACKANDWHITE". Such a PAM image has a depth of 1 and maxval 1 where the one sample in each tuple is 0 to represent a black pixel and 1 to represent a white one. The maxval, height, width, and order of tuples in the raster bear the obvious relationship to those of the equivalent PGM image. -

Note that in the PBM format, a sample value of zero means white, but in +

Note that in the PBM format, a sample value of zero means white, but in PAM, zero means black.

Grayscale

A grayscale image, such as would alternatively be represented by a PGM +

A grayscale image, such as would alternatively be represented by a PGM image, has a tuple type of "GRAYSCALE". Such a PAM image has a depth of 1. The maxval, height, width, and raster bear the obvious relationship to those of the equivalent PGM image.

Color

A color image, such as would alternatively be represented by a PPM image, +

A color image, such as would alternatively be represented by a PPM image, has a tuple type of "RGB". Such a PAM image has a depth of 3. The maxval, height, width, and raster bear the obvious relationship to those of the PPM image. The first plane represents red, the second green, and the third blue. @@ -292,8 +292,9 @@ foreground color samples.

No Internet Media Type (aka MIME type, content type) for PBM has been registered with IANA, but the unofficial value -image/x-portable-arbitrarymap is assigned by this specification, to -be consistent with conventional values for the older Netpbm formats. +image/x-portable-arbitrarymap is +assigned by this specification, to be consistent with conventional values for +the older Netpbm formats.

FILE NAME

@@ -301,36 +302,36 @@ be consistent with conventional values for the older Netpbm formats. But this is not required. -

pamarith

+ +Pamarith User Manual + +

pamarith

Updated: 03 January 2015 -
-Table Of Contents +
+Table Of Contents -

NAME

pamarith - perform arithmetic on two Netpbm images -

SYNOPSIS

All options can be abbreviated to their shortest unique prefix. +

All options can be abbreviated to their shortest unique prefix. 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. -

pamarith reads two PBM, PGM, PPM, or PAM images as input. +

pamarith reads two PBM, PGM, PPM, or PAM images as input. It performs the specified binary arithmetic operation on their sample values and produces an output of a format which is the more general of the two input formats. The two input images must be of the same width @@ -36,9 +35,9 @@ and height. The arithmetic is performed on each pair of identically located tuples to generate the identically located tuple of the output. -

For the purpose of the calculation, it assumes any PBM, PGM, or PPM +

For the purpose of the calculation, it assumes any PBM, PGM, or PPM input image is the equivalent PAM image of tuple type -BLACKANDWHITE, GRAYSCALE, or RGB, respectively, +BLACKANDWHITE, GRAYSCALE, or RGB, respectively, and if it produces a PBM, PGM, or PPM output, produces the equivalent of the PAM image which is the result of the calculation. @@ -49,7 +48,7 @@ argument image; the second pamfile argument identifies the

If the output is PAM, the tuple type is the same as the tuple type of the left input image. -

pamarith performs the arithmetic on each pair of identically +

pamarith performs the arithmetic on each pair of identically located tuples in the two input images.

The arithmetic operation is in all cases fundamentally a function from two @@ -86,10 +85,10 @@ corresponds to "full intensity."), and a sample value divided by the maxval gives the fraction.

For pamarith, this interpretation applies to the regular -arithmetic functions: -add, -subtract, -multiply, +arithmetic functions: -add, -subtract, -multiply, -divide, --difference, -minimum, -maximum, -mean, -and -compare. For those, you should think of the arguments and +-difference, -minimum, -maximum, -mean, +and -compare. For those, you should think of the arguments and result as numbers in the range [0,1). For example, if the maxval of the left argument image is 100 and the maxval of the right argument image is 200 and the maxval of the output image is 200, and the left @@ -97,7 +96,7 @@ sample value in an -add calculation is 50 and the right sample is 60, the actual calculation is 50/100 + 60/200 = 160/200, and the output sample value is 160. -

For these functions, pamarith makes the output image's +

For these functions, pamarith makes the output image's maxval the maximum of the two input maxvals, except with -compare, where pamarith uses an output maxval of 2. (Before Netpbm 10.14 (February 2003), there was no exception for @@ -123,10 +122,10 @@ arithmetic on the fractions 5/255 and 10/255. It multiplies those together and then rescales to the output maxval, giving a sample value in the output PAM of 50/255 rounded to the nearest integer: 0. -

With the bit string operations, the maxval has a whole different -meaning. The operations in question are: -and, -or, --nand, -nor, -xor, and -shiftleft, --shiftright. +

With the bit string operations, the maxval has a whole different +meaning. The operations in question are: -and, -or, +-nand, -nor, -xor, and -shiftleft, +-shiftright.

With these, each sample value in one or both input images, and in the output image, represents a bit string, not a number. The maxval @@ -144,30 +143,62 @@ interpretation of the samples. The sample value is the actual shift count. But it's still required that no sample value exceed the maxval. -

The Operations

Most of the operations are obvious from the option name. The following -paragraphs cover those that aren't. +

NOTE: UNARY FUNCTIONS

-subtract subtracts a value in the right input image from a -value in the left input image. +

pamarith applies only binary functions. If you want to apply a +unary function, e.g. "halve", to a single image, use pamfunc. -

-difference calculates the absolute value of -the difference. -

-multiply does an ordinary arithmetic multiplication, but -tends to produce nonobvious results because of the way pamarith -interprets sample values. See Maxval. +

OPTIONS

-divide divides a value in the left input image by the value -in the right input image. But like -multiply, it tends to -produce nonobvious results. Note that pamarith clipping -behavior makes this of little use when the left argument (dividend) is -greater than the right argument (divisor) -- the result in that case -is always the maxval. If the divisor is 0, the result is the maxval. -This option was new in Netpbm 10.30 (October 2005). +

In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamarith recognizes the following +command line options: -

-compare produces the value 0 when the value in the +

The Function

+ +

These options select the function that pamarith applies. + +

You must specify one of these, and cannot specify more than one. + +

-add +

Adds the two values. If the result is larger than maxval, it is +clipped. + +

-subtract +

Subtracts a value in the right input image from a value in the left input +image. + +

-minimum +

Chooses the smaller value of the two. + +

-maximum +

Chooses the larger value of the two. + +

-difference +

Calculates the absolute value of the difference. + +

-multiply +

Does an ordinary arithmetic multiplication, but tends to produce +nonobvious results because of the way pamarith interprets +sample values. See Maxval. + +

-divide +

Divides a value in the left input image by the value in the right +input image. But like -multiply, it tends to produce nonobvious +results. Note that pamarith clipping behavior makes this of +little use when the left argument (dividend) is greater than the right +argument (divisor) -- the result in that case is always the maxval. +If the divisor is 0, the result is the maxval. + +

-divide was new in Netpbm 10.30 (October 2005). + +

-compare +

Produces the value 0 when the value in the left input image is less than the value in the right input image, 1 when the values are equal, and 2 when the left is greater than the right. @@ -179,44 +210,41 @@ say A is greater than B if A is less than B.

-compare was new in Netpbm 10.13 (December 2002). -

-and, -nand, -or, -nor, and -xor -consider the input and output images to contain bit strings; they -compute bitwise logic operations. Note that if the maxval is 1, you -can also look at these as logic operations on boolean input values. +

-and, -nand, -or, -nor, -xor +

These consider the input and output images to contain bit strings; +they compute bitwise logic operations. Note that if the maxval is 1, +you can also look at these as logic operations on boolean input values. See section Maxval for the special meaning of maxval with respect to bit string operations such as these. -

-shiftleft and -shiftright consider the left input -image and output image to contain bit strings. They compute a bit -shift operation, with bits falling off the left or right end and -zeroes shifting in, as opposed to bits off one end to the other. The -right input image sample value is the number of bit positions to -shift. +

-shiftleft, -shiftright +

These consider the left input image and output image to contain +bit strings. They compute a bit shift operation, with bits falling +off the left or right end and zeroes shifting in, as opposed to bits +off one end to the other. The right input image sample value is the +number of bit positions to shift.

Note that the maxval (see Maxval) determines the width of the frame within which you are shifting. -

Notes

- -

If you want to apply a unary function, e.g. "halve", to a single -image, use pamfunc. +

HISTORY

pamarith replaced pnmarith in Netpbm 10.3 (June 2002). @@ -231,25 +259,29 @@ would be removed from Netpbm -- the plan was just to rewrite it to use the images to have different depths as long as one of them has depth 1, and that made it backward compatible with pnmarith. -

The original pnmarith did not have the -mean option. +

The original pnmarith did not have the -mean option. -

The -compare option was added in Netpbm 10.13 (December 2002). +

The -compare option was added in Netpbm 10.13 (December 2002).

The bit string operations were added in Netpbm 10.27 (March 2005). -

The -divide option was added in Netpbm 10.30 (October 2005). - -

SYNOPSIS -
DESCRIPTION -
MAXVAL -
THE OPERATIONS -
NOTES -
HISTORY -
SEE ALSO -
AUTHOR -

- - +

The -divide option was added in Netpbm 10.30 (October 2005). + +

SYNOPSIS +
DESCRIPTION +
- Maxval +
+
OPTIONS +
- The Functions +
+
NOTE: UNARY FUNCTIONS +
SEE ALSO +
HISTORY +

+ + diff --git a/pamfix.html b/pamfix.html index 1decac85..f4021fc7 100644 --- a/pamfix.html +++ b/pamfix.html @@ -1,32 +1,32 @@ - -Pamfix User Manual - -

pamfix

+ +Pamfix User Manual + +

pamfix

Updated: 06 March 2014 -
-Table Of Contents +
+Table Of Contents -

NAME

pamfix - repair a Netpbm image with various corruptions -

SYNOPSIS

-pamfix +pamfix [-truncate] [-changemaxval] [-clip] [-verbose] -[netpbmfile] +[netpbmfile]

DESCRIPTION

This program is part of Netpbm. @@ -40,7 +40,7 @@ illegally large sample values.

pamfix looks at only on the first image in a multi-image stream. -

Truncated stream

Truncated Stream

This is a stream that is missing the last part. Netpbm corrects this by creating an output image that simply has fewer rows. @@ -111,12 +111,42 @@ in the image. Request this with -changemaxval.

You cannot specify both -clip and -changemaxval. -

OPTIONS

-pnm, -pam, -pamcut, -pamfile, +

In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamfix recognizes the following +command line options: + +

-truncate + +: Create a truncated output image from all the valid input rows that +could be read. + +
-changemaxval + +: Raise the maxval to cope with pixel values that exceed the maxval +stated in the header of the input file. + +
-clip + +: Change all pixel values that exceed the maxval stated in the header +of the input file. + +
-verbose + +: Report details of the transportation to standard error. + +

+ +

HISTORY

@@ -125,15 +155,18 @@ in the image. Request this with -changemaxval. the truncated image repair (and for invalid sample values would simply pass them through to its output, generating an invalid Netpbm image). -

SYNOPSIS -
DESCRIPTION -
Truncated Stream -
Excessive Sample Value -
SEE ALSO -
HISTORY -

- - +

SYNOPSIS +
DESCRIPTION +
- Truncated Stream +
- Excessive Sample Value +
+
OPTIONS +
SEE ALSO +
HISTORY +

+ + diff --git a/pammixmulti.html b/pammixmulti.html index c5854c32..97cf4122 100755 --- a/pammixmulti.html +++ b/pammixmulti.html @@ -1,18 +1,14 @@ - - - - -Pammixmulti User Manual - + +Pammixmulti User Manual

pammixmulti

- -Updated: 18 November 2018
+Updated: 18 November 2018
+
Table Of Contents -

NAME

pammixmulti - blend together multiple PAM images

NAME

pammixmulti - blend together multiple PAM images

SYNOPSIS

@@ -26,20 +22,24 @@ Updated: 18 November 2018

Minimum unique abbreviation of an option is acceptable. You can use a single hyphen instead of double hyphens to denote options. You can use white space in place of the equals sign to separate an option name from its -value.

+value.

DESCRIPTION

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

OPTIONS

pammixmulti accepts the following command-line options:

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

--blend=average|random|mask: This option specifies how the input images should be mixed to produce the @@ -50,7 +50,7 @@ output is produced by selecting the corresponding pixel from one of the input images, chosen at random on a per-pixel basis. With --blend=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.
+on the grayscale level of an additional mask image.
--maskfile=filename
--stdev=number
--randomseed integer @@ -91,39 +91,39 @@ like --blend=average. number defaults to 0.25.

ARGUMENTS
-
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.
EXAMPLES
-
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 \ @@ -131,14 +131,14 @@ pixel-by-pixel basis:
-
HISTORY
+
HISTORY

pammixmulti was new in Netpbm 10.85 (December 2018).
AUTHOR
-
Copyright 2018 Scott Pakin, scott+pbm@pakin.org.
+
Copyright 2018 Scott Pakin, scott+pbm@pakin.org.
SEE ALSO
@@ -152,14 +152,14 @@ pixel-by-pixel basis:

Table Of Contents

-
SYNOPSIS
-
DESCRIPTION
-
OPTIONS
-
ARGUMENTS
-
EXAMPLES
-
HISTORY
-
AUTHOR
-
SEE ALSO
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
ARGUMENTS +
EXAMPLES +
HISTORY +
AUTHOR +
SEE ALSO
diff --git a/pampaintspill.html b/pampaintspill.html index 935529f2..eeb1cac6 100644 --- a/pampaintspill.html +++ b/pampaintspill.html @@ -107,12 +107,12 @@ command line options:
SEE ALSO

-
pamgradient +
pamgradient
ppmmake,
ppmrainbow,
pgmramp,
ppmpat, -
pam +
pam

HISTORY
@@ -138,4 +138,3 @@ command line options: - diff --git a/pamrgbatopng.html b/pamrgbatopng.html index 8eac29a9..de924b81 100644 --- a/pamrgbatopng.html +++ b/pamrgbatopng.html @@ -1,25 +1,20 @@ - -Pamrgbtopng User Manual - -
pamrgbatopng
+ +Pamrgbtopng User Manual + +
pamrgbatopng
Updated: 28 June 2015 -
-Table Of Contents +
-
NAME
+
NAME
-pamrgbatopng - convert PAM color/transparency image to PNG +pamrgbatopng - replaced by pamtopng -
SYNOPSIS
+
SYNOPSIS
-pamrgbatopng +pamrgbatopng [pamfile] -
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. - -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -38,6 +33,6 @@ options. But the one feature it had that pnmtopng lacked was the ability to recognize transparency in a PAM image. pamtopng has that, as well as most of the features of pnmtopng. - - + + diff --git a/pamshadedrelief.html b/pamshadedrelief.html index 179313be..95e701cf 100644 --- a/pamshadedrelief.html +++ b/pamshadedrelief.html @@ -1,27 +1,27 @@ - -Pamshadedrelief User Manual - -
pamshadedrelief
+ +Pamshadedrelief User Manual + +
pamshadedrelief
Updated: 26 July 2014 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pamshadedrelief - generate shaded relief image from an elevation map -
SYNOPSIS
+
SYNOPSIS
-pamshadedrelief +pamshadedrelief -[-gamma g] +[-gamma g] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. -
pamshadedrelief creates a shaded relief image from an elevation map. +
pamshadedrelief creates a shaded relief image from an elevation map. A shaded relief image is a visual image of terrain, showing the terrain as if illuminated by oblique light and viewed from above, so that the brightess of each spot depends upon its slope. A common example of a shaded relief image @@ -43,88 +43,92 @@ landscape. -
OPTIONS
+
OPTIONS
-
All options can be abbreviated to their shortest unique prefix. +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamshadedrelief recognizes the following +command line option: -
-
-gamma factor +
+
-gamma factor +
-g factor -
The specified factor is used to gamma adjust the image in -the same manner as performed by pnmgamma. The default value is +
The specified factor is used to gamma adjust the image in +the same manner as performed by pnmgamma. The default value is 1.0, which results in a medium contrast image. Values larger than 1 lighten the image and reduce contrast, while values less than 1 darken the image, increasing contrast. -
Note that this is separate from the gamma correction that is part of the -definition of the PAM GRAYSCALE format. The image pamshadedrelief +
Note that this is separate from the gamma correction that is part of the +definition of the PAM GRAYSCALE format. The image pamshadedrelief generates is a genuine, gamma-corrected PAM GRAYSCALE image in any case. This option simply changes the contrast and may compensate for a display device that does not correctly render PAM GRAYSCALE images. -
+
-
DESIGN NOTES
+
DESIGN NOTES
-The-gamma option isn't really necessary since you can achieve -the same effect by piping the output from pamshadedrelief through -pnmgamma. However, pamshadedrelief performs an internal gamma +The-gamma option isn't really necessary since you can achieve +the same effect by piping the output from pamshadedrelief through +pnmgamma. However, pamshadedrelief performs an internal gamma map anyway in the process of rendering the elevation array into the PAM GRAYSCALE format, so there's no additional overhead in allowing an additional gamma adjustment. -
SEE ALSO
+
SEE ALSO
-ppmrelief +ppmrelief -pnmgamma, +pnmgamma, -pnmsmooth +pnmsmooth -pamcrater +pamcrater -pam, +pam, -
AUTHOR
+
AUTHOR

pgmcrater, from which this is derived, was written by John Walker: -
+
John Walker Autodesk SA Avenue des Champs-Montants 14b CH-2074 MARIN Suisse/Schweiz/Svizzera/Svizra/Switzerland - Usenet:kelvin@Autodesk.com - Fax:038/33 88 15 - Voice:038/33 76 33 -
+ Usenet:kelvin@Autodesk.com + Fax:038/33 88 15 + Voice:038/33 76 33 +
-
Permission to use, copy, modify, and distribute this software and +
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, without any conditions or restrictions. This software is provided "as is" without express or implied warranty. -
HISTORY
+
HISTORY

pgmcrater was split into pamshadedrelief and pamcrater in Netpbm 10.68 (September 2014). See the history section of the pamcrater manual for details. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
DESIGN NOTES -
SEE ALSO -
AUTHOR -
HISTORY -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
DESIGN NOTES +
SEE ALSO +
AUTHOR +
HISTORY +
+ + diff --git a/pamsplit.html b/pamsplit.html index 15972eb9..489f8f4e 100644 --- a/pamsplit.html +++ b/pamsplit.html @@ -1,22 +1,22 @@ - -Pamsplit User Manual - -
pamsplit
+ +Pamsplit User Manual + +
pamsplit
Updated: 11 August 2011 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pamsplit - split a multi-image Netpbm file into single-image files -
SYNOPSIS
+
SYNOPSIS
-pamsplit +pamsplit -[netpbmfile +[netpbmfile -[ output_file_pattern]] +[ output_file_pattern]] [-padname=n] @@ -25,25 +25,25 @@ 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
+
DESCRIPTION

This program is part of Netpbm.
pamsplit reads a PNM or PAM stream as input. It copies each image in the input into a separate file, in the same format. -
netpbmfile is the file name of the input file, or -- to indicate Standard Input. The default is Standard Input. +
netpbmfile is the file name of the input file, or +- to indicate Standard Input. The default is Standard Input. -
output_file_pattern tells how to name the output files. It +
output_file_pattern tells how to name the output files. It is the file name of the output file, except that the first occurrence of "%d" in it is replaced by the image sequence number in unpadded ASCII decimal, with the sequence starting at 0. If -there is no "%d" in the pattern, pamsplit fails. +there is no "%d" in the pattern, pamsplit fails. -
The default output file pattern is "image%d". +
The default output file pattern is "image%d". -
The -padname option specifies to how many characters you +
The -padname option specifies how many characters you want the image sequence number in the output file name padded with zeroes. pamsplit adds leading zeroes to the image sequence number to get up to at least that number of characters. This is just @@ -52,14 +52,10 @@ example, pamsplit - outputfile%d.ppm -padname=3 would yield output filenames outputfile000.ppm, outputfile001.ppm, etc. -
The default is no padding (equivalent to -padname=0). -
The -padname option was new in Netpbm 10.23 (July 2004). -Before that, there was never any padding. - -
Note that to do the reverse operation (combining multiple +
Note that to do the reverse operation (combining multiple single-image Netpbm files into a multi-image one), there is no special -Netpbm program. Just use cat. +Netpbm program. Just use cat.
If you just want to find out basic information about the images in a stream, you can use pamfile on the stream. @@ -71,21 +67,44 @@ them, use pampick. files, use pamexec. -
SEE ALSO
- -pamfile, -pampick, -pamexec, -pnm, -pam, -cat man page - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
SEE ALSO -
- - +
OPTIONS
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamsplit recognizes the following +command line option: + +
+
-padname=n + +
Specify the width (i.e. number of digits) of the image sequence +number field in the filenames of the output files. The image +sequence will be padded with leading zeroes to achieve the stated +width. + +
The default is no padding (equivalent to -padname=0). + +
The -padname option was new in Netpbm 10.23 (July 2004). +Before that, there was never any padding. + +
+ +
SEE ALSO
+ +pamfile, +pampick, +pamexec, +pnm, +pam, +cat man page + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
+ + diff --git a/pamstereogram.html b/pamstereogram.html index d2a67f8e..759ca28d 100644 --- a/pamstereogram.html +++ b/pamstereogram.html @@ -1,22 +1,14 @@ - - - -Pamstereogram User Manual - - + +Pamstereogram User Manual -
pamstereogram
+Updated: 10 May 2020 +
+Table Of Contents -
Updated: 10 May 2020
- -
Table Of Contents
- +
NAME
-
NAME
- -
pamstereogram - create a single-image stereogram from a PAM -depth map
+pamstereogram - create a single-image stereogram from a PAM depth map
SYNOPSIS
@@ -46,13 +38,13 @@ depth map
[-randomseed=integer] [-tileable] [infile] -
+
DESCRIPTION
-
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 @@ -62,22 +54,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:
-
black and white, grayscale, or color output
+
black and white, grayscale, or color output
single-image random-dot stereograms (SIRDS), single-image stereograms (SIS) using a tiled image, or mapped-texture stereograms -(MTS)
+(MTS) -
images targeting a given device resolution and eye separation
+
images targeting a given device resolution and eye separation -
optional guide boxes to assist in focusing
+
optional guide boxes to assist in focusing -
the ability to trade off depth levels for easier viewing
+
the ability to trade off depth levels for easier viewing -
choice of wall-eyed or cross-eyed stereograms
+
choice of wall-eyed or cross-eyed stereograms

The output is a PAM image on standard output. Options control @@ -87,48 +79,55 @@ 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.
OPTIONS
+
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: +
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.
-
-verbose
+
-verbose
Display messages about image sizes and formats and properties -of the stereogram being generated.
+of the stereogram being generated. -
-blackandwhite
+
-blackandwhite
Produce a single-image random-dot black-and-white stereogram. -This is the default.
+This is the default. -
-grayscale
-
Produce a single-image random-dot grayscale stereogram.
+
-grayscale +
Produce a single-image random-dot grayscale stereogram. -
-color
-
Produce a single-image random-dot color stereogram.
+
-color +
Produce a single-image random-dot color stereogram. -
-maxval=value
+
-maxval=value
Designate the maximum value of each gray/color component, i.e. the color resolution. Smaller values make the output image have smaller numbers of unique grays/colors. If you don't specify -maxval, pamstereogram uses the maxval of the input -image. This option has no effect with -blackandwhite.
+image. This option has no effect with -blackandwhite. -
-patfile=pamfile
+
-patfile=pamfile
Specify an image to use as a repeated background pattern for the stereogram instead of a random-dot pattern. Intricate images generally produce a crisper 3-D effect that simpler images. The output file will have the same maxval and format (black and white, grayscale or color) as the pattern file. You cannot specify the -patfile option along with -blackandwhite, --grayscale, -color, or -maxval.
+-grayscale, -color, or -maxval. The +-verbose option will give you information on the ideal +dimensions of the pattern file. -
-xbegin=pixels
+
-xbegin=pixels
Specify the horizontal coordinate at which to begin stereogram generation. The background pattern will be minimally distorted at this point and more distorted at greater distances. Consider using this in conjunction @@ -142,7 +141,7 @@ and pamstereogram actually ignores it with respect to -texfile
This option was new in Netpbm 10.71 (June 2015). -
-texfile=pamfile
+
-texfile=pamfile
Specify an image to use as the texture for a mapped-texture stereogram. The idea is that the depth-map image provides the depth values of the 3-D object/scene while the texture image provides the @@ -151,10 +150,10 @@ the depth-map image. (Note that it's required to have the same dimensions.) The texture image's background color is ignored when blending colors. -
This option was new in Netpbm 10.53 (December 2010).
-
+
This option was new in Netpbm 10.53 (December 2010). + -
-bgcolor=color
+
-bgcolor=color
Use color as the texture image's background color instead of letting pamstereogram determine it automatically. Specify the color as described for the @@ -162,10 +161,10 @@ the color as described for the routine. The -bgcolor option is meaningful only in conjunction with -texfile. -
This option was new in Netpbm 10.53 (December 2010).
-
+
This option was new in Netpbm 10.53 (December 2010). -
-smoothing=pixels
+ +
-smoothing=pixels
When used without -texfile, attempt to eliminate artifacts introduced by edges in the depth map if pixels is greater than zero. @@ -176,29 +175,29 @@ by the stereogram's color constraints when producing a mapped-texture stereogram. In this case, the -smoothing option is helpful when the texture image includes smooth color transitions (as in a photograph) but makes crisp texture images (as in a line drawing) -appear blurry.
+appear blurry.
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. + -
-xshift=pixels
+
-xshift=pixels
Shift the pattern image (designated by -patfile) to the right by pixels pixels (default: 0). - -This option is valid only along with -patfile.
+ +This option is valid only along with -patfile. -
-yshift pixels
+
-yshift pixels
Shift the pattern image (designated by -patfile) downwards by pixels pixels (default: 0). This option is -valid only along with -patfile.
+valid only along with -patfile. -
-magnifypat=scale
+
-magnifypat=scale
Magnify each pixel in the pattern file or each random dot by integral scaling factor scale. Note that pamstereogram applies the pattern magnification after pattern shifting (-xshift and --yshift).
+-yshift).
-guidebottom
@@ -212,7 +211,7 @@ square. At that point, a crisp, 3-D image will appear.
This option was new in Netpbm 10.61 (December 2012). Before that, the presence of -guidesize, with a positive value, has the same effect. -
+
-guidetop
@@ -222,7 +221,7 @@ Same as -guidebottom, except the guides go at the top of the image. the presence of -guidesize, with a negative value, has the same effect. -
-guidesize=pixels
+
-guidesize=pixels
The size (width and height) of each guide box. @@ -237,15 +236,15 @@ too, and if you specify it with a negative value, it behaves as if you specified -guidetop and specified guidesize with the absolute value of that negative value. -
-dpi=resolution
+
-dpi=resolution
Specify the resolution of the output device in dots per inch. The default is 100 DPI, which represents a fairly crisp screen resolution. -
Before Netpbm 10.53 (December 2010), the default was 96 DPI.
-
+
Before Netpbm 10.53 (December 2010), the default was 96 DPI. + -
-crosseyed
+
-crosseyed
Invert the gray levels in the depth map (input image) so that the 3-D image pops out of the page where it would otherwise sink into the page and vice versa. Some people are unable to diverge their eyes and can only cross @@ -256,10 +255,10 @@ colors are farther from the eye.
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. -
-makemask
+ +
-makemask
Instead of a stereogram, output a PAM mask image showing coloring constraints. New pixels will be taken from the pattern file where the mask is black. Copies of existing pixels will be @@ -267,30 +266,30 @@ taken from the pattern file where the mask is white. The -makemask option can be used to help create more sophisticated pattern files (to use with -patfile) Note that -makemask ignores -magnifypat; it always produces -masks that assume a pattern magnification of 1.
+masks that assume a pattern magnification of 1. -
-eyesep=inches
+
-eyesep=inches
Specify the separation in inches between your eyes. The default, 2.5 inches (6.4 cm), should be sufficient for most people -and probably doesn't need to be changed.
+and probably doesn't need to be changed. -
-depth=fraction
+
-depth=fraction
Specify the output image's depth of field. That is, fraction represents the fractional distance of the near plane from the far plane. Smaller numbers make the 3-D image easier to perceive but flatter. Larger numbers make the 3-D image more difficult to perceive but deeper. The default, 0.3333, generally -works fairly well.
+works fairly well. -
-planes=near_pixels,far_pixels
+
-planes=near_pixels,far_pixels
Explicitly specify the distance between repeated pixels in the near plane and in the far plane. This is an alternative to -eyesep and -depth. The following equalities hold:
-
eyesep = 2 * far
+
eyesep = 2 * far
depth = 2 * (far − near) / - (2 * far − near)
+ (2 * far − near)

The number of distinct 3-D depths is far @@ -300,26 +299,25 @@ 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). + -
-randomseed=integer
+
-randomseed=integer
Specify a seed to be used for the random number generator. The default is to use a seed based on the time of day, to one second granularity.
It is useful to specify the seed if you want to create reproducible results. With the same random seed, you should get identical results -every time you run pamstereogram.
+every time you run pamstereogram.
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). -
-tileable
+
-tileable
Make the generated image horizontally tileable. This works by blending a left-to-right rendering (the equivalent @@ -327,7 +325,6 @@ of -xbegin=0) with a right-to-left rendering (the equivalent of -xbegin=width−1).
This option was new in Netpbm 10.91 (June 2020). -

@@ -336,7 +333,7 @@ of -xbegin=width−1).
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 @@ -347,10 +344,10 @@ be. Lower (darker) numbers mean further from the eye.
Input Images

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.
Mapped-texture Stereograms
@@ -358,12 +355,12 @@ input as if it were the PAM equivalent.
drawn with true colors. Unlike a SIRDS or tiled-image SIS, however, the image portrayed by an MTS is apparent in normal 2-D viewing. It appears repeated multiple times and overlapped with itself, but it is -not hidden.
+not hidden.
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 @@ -373,32 +370,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.
Miscellaneous

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

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 \ @@ -409,7 +406,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 @@ -419,7 +416,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 \ @@ -430,25 +427,25 @@ speckles:

SEE ALSO

-
pam
+
pam -
pamsistoaglyph
+
pamsistoaglyph -
ppm3d
+
ppm3d
Harold W. Thimbleby, Stuart Inglis, and Ian H. Witten. Displaying 3D Images: Algorithms for Single Image Random Dot Stereograms. In IEEE Computer, 27(10):38-48, October 1994. DOI: 10.1109/2.318576.
+href="http://dx.doi.org/10.1109/2.318576">10.1109/2.318576.
W. A. Steer. Stereograms: Technical Details. -URL: http://www.techmind.org/stereo/stech.html.
+URL: http://www.techmind.org/stereo/stech.html.
-
HISTORY
+
HISTORY

pamstereogram was new in Netpbm 10.22 (April 2004), but probably broken beyond usability until Netpbm 10.32 (February 2006) and Netpbm 10.26.23 @@ -459,26 +456,25 @@ broken beyond usability until Netpbm 10.32 (February 2006) and Netpbm 10.26.23 Netpbm 10.61 (December 2012). -
AUTHOR
-
Copyright © 2006-2020 Scott Pakin, scott+pbm@pakin.org.
+
AUTHOR
+
Copyright © 2006-2020 Scott Pakin, scott+pbm@pakin.org. -
Table Of Contents
+
Table Of Contents

-
SYNOPSIS
-
DESCRIPTION
-
OPTIONS
-
PARAMETERS
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
PARAMETERS
NOTES -
-
Input Images
-
Mapped-texture Stereograms
-
Miscellaneous
+
+
Input Images +
Mapped-texture Stereograms +
Miscellaneous
- -
EXAMPLES
-
SEE ALSO
-
HISTORY
-
AUTHOR
+
EXAMPLES +
SEE ALSO +
HISTORY +
AUTHOR
diff --git a/pamsumm.html b/pamsumm.html index 3e0a4694..d8cab088 100644 --- a/pamsumm.html +++ b/pamsumm.html @@ -1,17 +1,17 @@ - -Pamsumm User Manual - -
pamsumm
+ +Pamsumm User Manual + +
pamsumm
Updated: 26 October 2012 -
+
-Table Of Contents +Table Of Contents -
NAME
+
NAME
pamsumm - Summarize the samples in a Netpbm image arithmetically -
SYNOPSIS
-pamsumm +
SYNOPSIS
+pamsumm { -sum | -mean | @@ -20,13 +20,13 @@ pamsumm - Summarize the samples in a Netpbm image arithmetically } [-normalize] [-brief] -[imagefile] +[imagefile] -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. 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
+
DESCRIPTION

This program is part of Netpbm. @@ -51,36 +51,41 @@ want to summarize a particular plane, use pamchannel to extract it and then pamsumm. -
OPTIONS
+
OPTIONS
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamsumm recognizes the following +command line options:
You must specify exactly one of -sum, -mean, -min, or -max. -
-
-sum +
+
-sum -
-
This option makes the summary function addition. +
+
This option makes the summary function addition. -
-mean +
-mean -
-
This option makes the summary function arithmetic mean. +
+
This option makes the summary function arithmetic mean. -
-min +
-min -
-
This option makes the summary function arithmetic minimum. +
+
This option makes the summary function arithmetic minimum. -
-max +
-max -
-
This option makes the summary function arithmetic maximum. +
+
This option makes the summary function arithmetic maximum. -
-normalize +
-normalize -
-
This option causes each sample to be normalized to a fraction +
+
This option causes each sample to be normalized to a fraction (in the range 0..1) so the result is independent of the image's maxval. E.g. if you request the mean of an image which has maxval 200 and all the samples have value 50, pamsumm will give you @@ -106,12 +111,12 @@ extract it and then pamsumm.
This option was new in Netpbm 10.22 (April 2004) -
+
-
SEE ALSO
+
SEE ALSO
-pamsummcol, -pam, +pamsummcol, +pam,
HISTORY
@@ -119,14 +124,14 @@ extract it and then pamsumm. 2004). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
HISTORY -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
HISTORY +
+ + diff --git a/pamtable.html b/pamtable.html index 202eec0b..9580a135 100644 --- a/pamtable.html +++ b/pamtable.html @@ -1,23 +1,23 @@ - -Pamtable User Manual - -
pamtable
+ +Pamtable User Manual + +
pamtable
Updated: 15 April 2017 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pamtable - print the raster as a table of numerical sample values -
SYNOPSIS
+
SYNOPSIS
-pamtable +pamtable -[netpbmfile] +[netpbmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -26,12 +26,12 @@ sample values. For example, a 5-pixel wide, 2-pixel high rainbow (black, red, green, blue, white) PPM image with maxval 255 would appear as follows:
-+ 0 0 0|255 0 0| 0 255 0| 0 0 255|255 255 255 0 0 0|255 0 0| 0 255 0| 0 0 255|255 255 255 - +
@@ -53,7 +53,7 @@ number of spaces required to print the maxval of the image.
If you want the samples to print more densely, use pamdepth to reduce the maxval (thus making the decimal numbers for the samples narrower). -
The less program (not part of Netpbm) is good for browsing through +
The less program (not part of Netpbm) is good for browsing through the table. Use its --chop-long-lines option and use cursor movement keys to scroll around in the image. @@ -67,33 +67,36 @@ comes from Standard Input.
OPTIONS
-
None. +
There are no command line options defined specifically +for pamtable, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) -
SEE ALSO
+
SEE ALSO
-pamfile, -pamcut, -pamchannel, -pnm, -pam, -pamslice, -ppmtoarbtxt, -ppmtoterm, +pamfile, +pamcut, +pamchannel, +pnm, +pam, +pamslice, +ppmtoarbtxt, +ppmtoterm,
HISTORY

pamtable was new in Netpbm 10.79 (June 2017). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
ARGUMENTS -
OPTIONS -
SEE ALSO -
HISTORY -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
ARGUMENTS +
OPTIONS +
SEE ALSO +
HISTORY +
+ + diff --git a/pamtompfont.html b/pamtompfont.html index e31538cb..aab69cd1 100644 --- a/pamtompfont.html +++ b/pamtompfont.html @@ -1,23 +1,23 @@ - -Pamtompfont User Manual - -
pamtompfont
+ +Pamtompfont User Manual + +
pamtompfont
Updated: 18 May 2008 +
+Table Of Contents -Table Of Contents - -
NAME
+
NAME
pamtompfont - Convert Netpbm image to Mplayer bitmap font file -
SYNOPSIS
-pamtompfont -[imagefile] +
SYNOPSIS
+pamtompfont +[netpbmfile] -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. 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
+
DESCRIPTION

This program is part of Netpbm. @@ -43,27 +43,30 @@ raster file of the to left corner of the glyph, and the width of the glyph in pixels. -
OPTIONS
+
OPTIONS
-
None. +
There are no command line options defined specifically +for pamtompfont, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) -
SEE ALSO
+
SEE ALSO
-pam +pam
HISTORY

pamtompfont was added to Netpbm in Release 10.43 (June 2008). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
HISTORY -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
HISTORY +
+ + diff --git a/pamtooctaveimg.html b/pamtooctaveimg.html index 64a8f62c..4e09e8e1 100644 --- a/pamtooctaveimg.html +++ b/pamtooctaveimg.html @@ -58,7 +58,7 @@ specify netpbmfile, the input is from Standard Input.
- % pamtooctaveimg myimage.ppm > myimage.img + % pamtooctaveimg myimage.ppm > myimage.img % octave > [img,map] = loadimage("myimage.img"); diff --git a/pamtotiff.html b/pamtotiff.html index e2301097..4334a543 100644 --- a/pamtotiff.html +++ b/pamtotiff.html @@ -1,59 +1,59 @@ - -Pamtotiff User Manual - -pamtotiff + +Pamtotiff User Manual + +pamtotiff Updated: 05 April 2017 - -Table Of Contents + +Table Of Contents -NAME +NAME pamtotiff - convert a Netpbm image to a TIFF file -SYNOPSIS +SYNOPSIS -pamtotiff +pamtotiff -[-none | -packbits | -lzw | -g3 | -g4 -| -flate | -adobeflate] +[-none | -packbits | -lzw | -g3 | -g4 +| -flate | -adobeflate] -[-2d] +[-2d] -[-fill] +[-fill] -[-predictor=n] +[-predictor=n] -[-msb2lsb|-lsb2msb] +[-msb2lsb|-lsb2msb] -[-rowsperstrip=n] +[-rowsperstrip=n] -[-minisblack|-miniswhite|mb|mw] +[-minisblack|-miniswhite|mb|mw] -[-truecolor] +[-truecolor] -[-color] +[-color] -[-indexbits=bitwidthlist] +[-indexbits=bitwidthlist] -[-xresolution=xres] +[-xresolution=xres] -[-yresolution=yres] +[-yresolution=yres] -[-resolutionunit={inch | centimeter | none | +[-resolutionunit={inch | centimeter | none | in | cm | no}] [-append] [-tag=taglist] -[pamfile] +[pamfile] -You can use the minimum unique abbreviation of the options. You + You can use the minimum unique abbreviation of the options. You can use two hyphens instead of one. You can separate an option name from its value with white space instead of an equals sign. - DESCRIPTION +DESCRIPTION This program is part of Netpbm. @@ -67,7 +67,7 @@ ignored all but the first Netpbm image in the input stream. The Output File -By default, the output goes to Standard Output. Alternatively, you can + By default, the output goes to Standard Output. Alternatively, you can specify an output file with the -output option and pamtotiff will write its output directly to that file. @@ -131,18 +131,18 @@ for example, you would set up a write-only Standard Output to the file /tmp/myimage.tiff like this: - + $ pamtotiff myimage.pnm >/tmp/myimage.tiff - + In Bash, you would set up a read/write Standard Output to the file /tmp/myimage.tiff like this: - + $ pamtotiff myimage.pnm 1<>/tmp/myimage.tiff - + TIFF Capability @@ -151,11 +151,16 @@ In Bash, you would set up a read/write Standard Output to the file equivalent you provide) to generate the TIFF output. Details of the format it produces are therefore controlled by that library. -OPTIONS +OPTIONS + +In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pamtotiff recognizes the following +command line options: Compression -By default, pamtotiff creates a TIFF file with no + By default, pamtotiff creates a TIFF file with no compression. This is your best bet most of the time. If you want to try another compression scheme or tweak some of the other even more obscure output options, there are a number of options which to @@ -169,20 +174,20 @@ now expired and new TIFF libraries do LZW, but the pamtotiff behavior remains the same for compatibility with older TIFF libraries and applications of pamtotiff. - The -none, -packbits, -lzw, -g3, --g4, -flate, and -adobeflate options are used to + The -none, -packbits, -lzw, -g3, +-g4, -flate, and -adobeflate options are used to override the default and set the compression scheme used in creating the output file. -The -predictor option is meaningful only with LZW compression: a +The -predictor option is meaningful only with LZW compression: a predictor value of 2 causes each scanline of the output image to undergo horizontal differencing before it is encoded; a value of 1 forces each -scanline to be encoded without differencing. By default, pamtotiff -creates a TIFF file with msb-to-lsb fill order. The -msb2lsb and --lsb2msb options are used to override the default and set the fill +scanline to be encoded without differencing. By default, pamtotiff +creates a TIFF file with msb-to-lsb fill order. The -msb2lsb and +-lsb2msb options are used to override the default and set the fill order used in creating the file. - With some older TIFF libraries, -lzw doesn't work because + With some older TIFF libraries, -lzw doesn't work because the TIFF library doesn't do LZW compression. This is because of concerns about Unisys's patent on LZW which was then in force. Actually, with very old TIFF libraries, -lzw works because no @@ -193,7 +198,7 @@ issue. patent-free compression common in the Unix world implemented by the "Z" library. It is what the PNG format uses. - Fax Compression +Fax Compression If you have bilevel data (e.g. PBM), you can generate a TIFF that uses the same compression scheme specified for use by fax machines. See the Fill Order The -msb2lsb and lsb2msb options control the fill order. - The fill order is the order in which pixels are packed into a byte in + The fill order is the order in which pixels are packed into a byte in the Tiff raster, in the case that there are multiple pixels per byte. msb-to-lsb means that the leftmost columns go into the most significant bits of the byte in the Tiff image. However, there is @@ -230,55 +235,55 @@ endianness of integers in a Tiff image is designated by the image's magic number). However, ImageMagick and older Netpbm both have been known to implement that interpretation. 2001.09.06. - If the image does not have sub-byte pixels, these options have no + If the image does not have sub-byte pixels, these options have no effect other than to set the value of the FILLORDER tag in the Tiff image (which may be useful for those programs that misinterpret the tag with reference to 16 bit samples). Color Space --color tells pamtotiff to produce a color, as + -color tells pamtotiff to produce a color, as opposed to grayscale, TIFF image if the input is PPM, even if it -contains only shades of gray. Without this option, pamtotiff +contains only shades of gray. Without this option, pamtotiff produces a grayscale TIFF image if the input is PPM and contains only shades of gray, and at most 256 shades. Otherwise, it produces a -color TIFF output. For PBM and PGM input, pamtotiff always +color TIFF output. For PBM and PGM input, pamtotiff always produces grayscale TIFF output and this option has no effect. - The -color option can prevent pamtotiff from making +The -color option can prevent pamtotiff from making two passes through the input file, thus improving speed and memory usage. See Multiple Passes. - -truecolor tells pamtotiff to produce the 24-bit RGB + -truecolor tells pamtotiff to produce the 24-bit RGB form of TIFF output if it is producing a color TIFF image. Without -this option, pamtotiff produces a colormapped (paletted) TIFF +this option, pamtotiff produces a colormapped (paletted) TIFF image unless there are more than 256 colors (and in the latter case, issues a warning). - The -truecolor option can prevent pamtotiff from + The -truecolor option can prevent pamtotiff from making two passes through the input file, thus improving speed and memory usage. See Multiple Passes. - The -color and -truecolor options did not exist + The -color and -truecolor options did not exist before Netpbm 9.21 (December 2001). - If pamtotiff produces a grayscale TIFF image, this option + If pamtotiff produces a grayscale TIFF image, this option has no effect. - The -minisblack and -miniswhite options force the + The -minisblack and -miniswhite options force the output image to have a "minimum is black" or "minimum is white" photometric, respectively. If you don't specify -either, pamtotiff uses minimum is black except when using Group -3 or Group 4 compression, in which case pamtotiff follows CCITT +either, pamtotiff uses minimum is black except when using Group +3 or Group 4 compression, in which case pamtotiff follows CCITT fax standards and uses "minimum is white." This usually results in better compression and is generally preferred for bilevel coding. These photometrics are for grayscale images, so these options are invalid if the image is color (but only if it is truly color; they are valid with, for example, a PPM image that contains only shades of gray). - Before Netpbm 9.11 (February 200)1, pamtotiff always produced + Before Netpbm 9.11 (February 200)1, pamtotiff always produced "minimum is black," because of a bug. In either case, -pamtotiff sets the photometric interpretation tag in the TIFF +pamtotiff sets the photometric interpretation tag in the TIFF output according to which photometric is actually used. Before Netpbm 10.78 (March 2017), pamtotiff respected @@ -286,28 +291,28 @@ output according to which photometric is actually used. invalid TIFF images that have the indicated photometric but red, green, and blue raster planes. - The -indexbits option is meaningful only for a colormapped + The -indexbits option is meaningful only for a colormapped (paletted) image. In this kind of image, the raster contains values which are indexes into a table of colors, with the indexes normally taking less space that the color description in the table. -pamtotiff can generate indexes of 1, 2, 4, or 8 bits. By +pamtotiff can generate indexes of 1, 2, 4, or 8 bits. By default, it will use 8, because many programs that interpret TIFF images can't handle any other width. - But if you have a small number of colors, you can make your image + But if you have a small number of colors, you can make your image considerably smaller by allowing fewer than 8 bits per index, using the --indexbits option. The value is a comma-separated list of the -bit widths you allow. pamtotiff chooses the smallest width you allow +-indexbits option. The value is a comma-separated list of the +bit widths you allow. pamtotiff chooses the smallest width you allow that allows it to index the entire color table. If you don't allow any -such width, pamtotiff fails. Normally, the only useful value for -this option is 1,2,4,8, because a program either understands the 8 +such width, pamtotiff fails. Normally, the only useful value for +this option is 1,2,4,8, because a program either understands the 8 bit width (default) or understands them all. - In a Baseline TIFF image, according to the 1992 TIFF 6.0 + In a Baseline TIFF image, according to the 1992 TIFF 6.0 specification, 4 and 8 are the only valid widths. There are no formal standards that allow any other values. - This option was added in June 2002. Before that, only 8 bit indices were + This option was added in June 2002. Before that, only 8 bit indices were possible. Extra Tags @@ -373,7 +378,7 @@ an IMAGEWIDTH tag that gives the actual width of the image. Output -See The Output File. + See The Output File. -output names the output file. Without this option pamtotiff writes to Standard Output. @@ -396,29 +401,29 @@ always Standard Output in 10.67) instead of replacing its contents. Other -You can use the -rowsperstrip option to set the number of + You can use the -rowsperstrip option to set the number of rows (scanlines) in each strip of data in the output file. By default, the output file has the number of rows per strip set to a value that will ensure each strip is no more than 8 kilobytes long. - NOTES +NOTES -There are myriad variations of the TIFF format, and this program -generates only a few of them. pamtotiff creates a grayscale + There are myriad variations of the TIFF format, and this program +generates only a few of them. pamtotiff creates a grayscale TIFF file if its input is a PBM (monochrome) or PGM (grayscale) or -equivalent PAM file. pamtotiff also creates a grayscale file +equivalent PAM file. pamtotiff also creates a grayscale file if it input is PPM (color) or equivalent PAM, but there is only one color in the image. If the input is a PPM (color) file and there are 256 colors or -fewer, but more than 1, pamtotiff generates a color palette -TIFF file. If there are more colors than that, pamtotiff +fewer, but more than 1, pamtotiff generates a color palette +TIFF file. If there are more colors than that, pamtotiff generates an RGB (not RGBA) single plane TIFF file. Use -pnmtotiffcmyk to generate the cyan-magenta-yellow-black ink +pnmtotiffcmyk to generate the cyan-magenta-yellow-black ink color separation TIFF format. - The number of bits per sample in the TIFF output is determined by + The number of bits per sample in the TIFF output is determined by the maxval of the Netpbm input. If the maxval is less than 256, the bits per sample in the output is the smallest number that can encode the maxval. If the maxval is greater than or equal to 256, there are 16 @@ -460,25 +465,25 @@ your planes aren't really color components, you'll want to disable this via the -color option. - Multiple Passes +Multiple Passes -pamtotiff reads the input image once if it can, and + pamtotiff reads the input image once if it can, and otherwise twice. It needs that second pass (which happens before the main pass, of course) to analyze the colors in the image and generate a color map (palette) and determine if the image is grayscale. So the second pass happens only when the input is PPM. And you can avoid it -then by specifying both the -truecolor and -color +then by specifying both the -truecolor and -color options. - If the input image is small enough to fit in your system's file + If the input image is small enough to fit in your system's file cache, the second pass is very fast. If not, it requires reading from disk twice, which can be slow. - When the input is from a file that cannot be rewound and reread, -pamtotiff reads the entire input image into a temporary file + When the input is from a file that cannot be rewound and reread, +pamtotiff reads the entire input image into a temporary file which can, and works from that. Even if it needs only one pass. - Before Netpbm 9.21 (December 2001), pamtotiff always read + Before Netpbm 9.21 (December 2001), pamtotiff always read the entire image into virtual memory and then did one, two, or three passes through the memory copy. The -truecolor and -color options did not exist. The passes through memory would @@ -487,7 +492,7 @@ The image in memory required considerably more memory (12 bytes per pixel) than the cached file version of the image would. - Resolution +Resolution A Tiff image may contain information about the resolution of the image, which means how big in real dimensions (centimeters, etc.) each pixel in the @@ -535,7 +540,7 @@ does not contain horizontal resolution information. Likewise for -yresolution. If you don't specify -resolutionunit, the default is inches. - Before Netpbm 10.16 (June 2003), -resolutionunit did not + Before Netpbm 10.16 (June 2003), -resolutionunit did not exist and the resolution unit was always inches.
@@ -546,56 +551,57 @@ exist and the resolution unit was always inches. PAM input. It was extended and renamed in Netpbm 10.30 (October 2005). -
SEE ALSO
+
SEE ALSO
-tifftopnm, +tifftopnm, -pnmtotiffcmyk, +pnmtotiffcmyk, -pamdepth, +pamdepth, -pamtopnm, +pamtopnm, -pam +pam -
AUTHOR
+
AUTHOR
Derived by Jef Poskanzer from ras2tiff.c, which is Copyright (c) 1990 by Sun Microsystems, Inc. -Author: Patrick J. Naughton (naughton@wind.sun.com). +Author: Patrick J. Naughton (naughton@wind.sun.com). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION

The Output File -
+

Old Versions

TIFF Capability
-
OPTIONS +
OPTIONS

Compression

Fax Compression

Fill Order -
Color Space +
Color Space
Extra Tags
Output
Other
-
NOTES -
-
Multiple Passes -
Extra Channels -
-
HISTORY -
SEE ALSO -
AUTHOR -
- - +
NOTES +
+
Extra Channels +
Multiple Passes +
Resolution +
+
HISTORY +
SEE ALSO +
AUTHOR +
+ + diff --git a/pamvalidate.html b/pamvalidate.html index a50f9b90..4ea689a5 100644 --- a/pamvalidate.html +++ b/pamvalidate.html @@ -1,21 +1,21 @@ - -Pamvalidate User Manual - -
pamvalidate
+ +Pamvalidate User Manual + +
pamvalidate
Updated: 22 March 2014 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pamvalidate - validate Netpbm image format -
SYNOPSIS
+
SYNOPSIS
-pamvalidate +pamvalidate -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -47,31 +47,33 @@ stream.
See pamfix for a way to salvage an invalid Netpbm image stream. -
OPTIONS
+
OPTIONS
-
None. +
There are no command line options defined specifically +for pamvalidate, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) +
SEE ALSO
-
SEE ALSO
- -pam -pnm -pamfix +pam +pnm +pamfix
HISTORY

pamvalidate was new in Netpbm 10.66 (March 2014). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
HISTORY -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
HISTORY +
+ + diff --git a/pbmmake.html b/pbmmake.html index fba27f14..06afbb73 100644 --- a/pbmmake.html +++ b/pbmmake.html @@ -1,26 +1,26 @@ - -Pbmmake User Manual - -
pbmmake
+ +Pbmmake User Manual + +
pbmmake
Updated: 13 December 2003 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pbmmake - create a blank bitmap of a specified size -
SYNOPSIS
+
SYNOPSIS
-pbmmake -[-white|-black|-gray] -width -height +pbmmake +[-white|-black|-gray] +width +height
You can abbreviate any option to its shortest unique prefix. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -28,31 +28,46 @@ pbmmake - create a blank bitmap of a specified size height, either all black, all white, or a dithered gray. The default is white. -
OPTIONS
+
OPTIONS
-
In addition to the usual -white and -black, this -program implements -gray. This gives a simple 50% gray pattern +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pbmmake recognizes the following +command line options: + +
+
-white +
-black +
-gray + +
In addition to the usual -white and -black, this +program implements -gray. This gives a simple 50% gray pattern with 1's and 0's alternating. -
SEE ALSO
+
With none of the above specified, the output image will be entirely +white. + +
+ +
SEE ALSO
-pgmmake, -ppmmake, -pbm +pgmmake, +ppmmake, +pbm -
AUTHOR
+
AUTHOR
Copyright (C) 1989 by Jef Poskanzer. -
-
Table Of Contents
- -
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+ +
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
+ + diff --git a/pbmtog3.html b/pbmtog3.html index dc53eccb..5606c989 100644 --- a/pbmtog3.html +++ b/pbmtog3.html @@ -42,10 +42,9 @@ command line options:
This option causes the output to have the bits in every byte reversed so the least significant bit becomes the most significant bit. -Apparently, there is some ambiguity in transmission protocols so that -the bits get reversed on transmission, and this compensates for that. -If you get a whole bunch of "bad code word" messages when you try to -read the G3 file (e.g. with g3topbm), try using this option. +Some fax modems expect bits in reverse order, and this compensates for +that. If you get a whole bunch of "bad code word" messages when you try +to read the G3 file (e.g. with g3topbm), try using this option. Note that the output is not G3 when you use this option.
-nofixedwidth diff --git a/pbmtogem.html b/pbmtogem.html index 0b34d268..f8073b43 100644 --- a/pbmtogem.html +++ b/pbmtogem.html @@ -31,7 +31,7 @@ Common Options.)
LIMITATIONS
-pbmtogem does not support compression of repeated lines +pbmtogem cannot compress repeated lines.
SEE ALSO
diff --git a/pbmtoicon.html b/pbmtoicon.html index 6a6f7602..e46d63a7 100644 --- a/pbmtoicon.html +++ b/pbmtoicon.html @@ -1,21 +1,19 @@ - -Pbmtoicon User Manual - -
pbmtoicon
+ +Pbmtoicon User Manual + +
pbmtoicon
-Table Of Contents +
NAME
-
NAME
+pbmtoicon - replaced by pbmtosunicon -pbmtoicon - convert a Sun icon image to PBM +
SYNOPSIS
-
SYNOPSIS
+pbmtoicon +[iconfile] -pbmtoicon -[iconfile] - -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -36,9 +34,5 @@ for pbmtoicon, as long as you recognize that any change the pbmtosunicon manual says happened in or after Netpbm 10.53 doesn't apply to pbmtoicon. - - - - - - + + diff --git a/pbmtoppa.html b/pbmtoppa.html index 5a7d4121..f4e695d1 100644 --- a/pbmtoppa.html +++ b/pbmtoppa.html @@ -236,7 +236,7 @@ as small as 1/4 inch without causing the printer to choke with same should work for the 820 and 1000, but it hasn't been tested. Also, use the pbmraw GSDriver if you have it; it's faster. -
Here is a tip to integrate HP720C support in RedHat's printtool: +
Here is a tip to integrate HP720C capability in RedHat's printtool:
Install pbmtoppa. Copy pbmtoppa to /usr/bin. @@ -254,7 +254,7 @@ StartEntry: DeskJet720C About: { \ This driver drives the HP DeskJet 720C \ inkjet printer. \ - It does not support color printing. \ + It cannot do color printing. \ IMPORTANT! Insert \ "- | pbm2ppa -" \ in the "Extra GS Options " field.\ diff --git a/pgmdeshadow.html b/pgmdeshadow.html index acde9010..0349b260 100644 --- a/pgmdeshadow.html +++ b/pgmdeshadow.html @@ -1,24 +1,22 @@ - -Pgmdeshadow User Manual - -
pgmdeshadow
+ +Pgmdeshadow User Manual + +
pgmdeshadow
Updated: 06 July 2006 -
+
+Table Of Contents -Table Of Contents - -
NAME
+
NAME
pgmdeshadow - Deshadow a PGM image -
SYNOPSIS
- -pgmdeshadow +
SYNOPSIS
-[pnmfile] +pgmdeshadow +[pnmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -36,11 +34,14 @@ algorithm from Luc Vincent, "Morphological Grayscale Reruction in Image Analysis: Applications and Efficient Algorithms. -
OPTIONS
+
OPTIONS
-
None. +
There are no command line options defined specifically +for pgmdeshadow, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) -
REFERENCES
+
REFERENCES

@@ -52,26 +53,26 @@ pp. 176-201.
-
SEE ALSO
+
SEE ALSO
-ppmshadow, -pgm +ppmshadow, +pgm
HISTORY
-
pgmdeshadow was added to Netpbm in Version 10.35 (August 2006). +
pgmdeshadow was added to Netpbm in Version 10.35 (August 2006). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
REFERENCES -
SEE ALSO -
HISTORY -
+
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
REFERENCES +
SEE ALSO +
HISTORY +
- - + + diff --git a/pgmramp.html b/pgmramp.html index 3008dc01..12e1d530 100644 --- a/pgmramp.html +++ b/pgmramp.html @@ -1,28 +1,28 @@ - -Pgmramp User Manual - -
pgmramp
+ +Pgmramp User Manual + +
pgmramp
Updated: 15 February 2014 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pgmramp - generate a grayscale ramp -
SYNOPSIS
+
SYNOPSIS
-pgmramp -{-lr|-tb|-rectangle|-ellipse|-diagonal} +pgmramp +{-lr|-tb|-rectangle|-ellipse|-diagonal} [-maxval=maxval] -width height +width height -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or an equals sign between an option name and its value. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -47,75 +47,81 @@ example, the -lr option gives you a left to right ramp and gives you a right to left ramp. -
To generate a simple ramp of all the values from 0 to maxval, and not +
To generate a simple ramp of all the values from 0 to maxval, and not necessarily a graphic image, use pamseq.
ppmrainbow does something similar to what pgmramp does, but for color. The image fades between two colors of your choice. -
OPTIONS
+
OPTIONS
+
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pgmramp recognizes the following +command line options: +
You must specify exactly one of the ramp type options. -
-
-lr -
+ +
+
-lr +
A left to right ramp. Black on the left; white on the right. -
-tb -
+
-tb +
A top to bottom ramp. Black on top; white on the bottom. -
-rectangle -
+
-rectangle +
An outside-in rectangular ramp. It is black around the edges and white in the center. -
-ellipse -
+
-ellipse +
An outside-in elliptical ramp. It is black around the edge and white in the center. -
-diagonal -
+
-diagonal +
A ramp from top left corner diagonally down to bottom right. Black at the top left; white at the bottom right.
This option was new in Netpbm 10.66 (March 2014). -
-maxval=maxval -
+
-maxval=maxval +
The maxval for the generated image. Default is 255.
This option was new in Netpbm 10.1 (June 2002). Before that, the maxval is always 255. -
+
-
SEE ALSO
+
SEE ALSO
-pamflip, -pamarith, -pnmgamma, -pamseq, -ppmrainbow, -pamgradient, -pgm +pamflip, +pamarith, +pnmgamma, +pamseq, +ppmrainbow, +pamgradient, +pgm -
AUTHOR
+
AUTHOR
Copyright (C) 1989 by Jef Poskanzer. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
+ + diff --git a/pngtopnm.html b/pngtopnm.html index 42709612..64d8f8a0 100644 --- a/pngtopnm.html +++ b/pngtopnm.html @@ -1,33 +1,31 @@ - -Pngtopnm User Manual - -
pngtopnm
+ +Pngtopnm User Manual + +
pngtopnm
Updated: 22 July 2008 -
-Table Of Contents -
NAME
+
NAME
-pngtopnm - convert a PNG image into a PNM image +pngtopnm - Convert a PNG image to PNM: replaced by pngtopam -
SYNOPSIS
+
SYNOPSIS
-pngtopnm +pngtopnm [-verbose] [-alpha | -mix] [-background=color] -
+
[-gamma=value] [-text=filename] [-time] -[pngfile] +[pngfile] -
Minimum unique abbreviation of option is acceptable. You may use double +
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -60,9 +58,5 @@ after Netpbm 10.44 doesn't apply to pngtopnm.
- - - - - - + + diff --git a/pnmalias.html b/pnmalias.html index a527dcf1..bfcd506d 100644 --- a/pnmalias.html +++ b/pnmalias.html @@ -1,36 +1,36 @@ - -Pnmalias User Manual - -
pnmalias
+ +Pnmalias User Manual + +
pnmalias
Updated: 15 March 2004 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmalias - antialias a PNM image -
SYNOPSIS
+
SYNOPSIS
-pnmalias +pnmalias -[-bgcolor color] +[-bgcolor color] -[-fgcolor color] +[-fgcolor color] -[-bonly] +[-bonly] -[-fonly] +[-fonly] -[-balias] +[-balias] -[-falias] +[-falias] -[-weight w] +[-weight w] -[pnmfile] +[pnmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -39,64 +39,69 @@ anti-aliasing to background and foreground pixels. If the input file is a PBM, pnmalias promotes the output anti-aliased image to a PGM, and prints a message informing the user of the change in format. -
OPTIONS
+
OPTIONS
-
-bgcolor colorb sets the background color the +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmalias recognizes the following +command line options: + +
-bgcolor colorb sets the background color the colorb. -
-fgcolor colorf sets the foreground color to +
-fgcolor colorf sets the foreground color to colorf.
Pixels with these values will be anti-aliased. By default, pnmalias takes the background color to be black, and foreground color to be white. -
Specify the color (color) as described for the Specify the color (color) as described for the argument of the pnm_parsecolor() library routine. -
Note that even when dealing with PGMs, background and foreground +
Note that even when dealing with PGMs, background and foreground colors need to be specified in the fashion described above. In this case, pnmalias takes the background and foreground pixel values to be the value of the red component for the specified color. -
-bonly says to apply anti-aliasing only to the background pixels. +
-bonly says to apply anti-aliasing only to the background pixels. -
-fonly says to apply anti-aliasing only to the foreground pixels. +
-fonly says to apply anti-aliasing only to the foreground pixels. -
-balias says to apply anti-aliasing to all pixels surrounding +
-balias says to apply anti-aliasing to all pixels surrounding background pixels. -
-falias says to apply anti-aliasing to all pixels surrounding +
-falias says to apply anti-aliasing to all pixels surrounding foreground pixels.
If you specify neither -balias nor -falias, pnmalias applies anti-aliasing only among neighboring background and foreground pixels. -
-weight w says to use w as the central weight -for the aliasing filter. w must be a real number in the range -0 < w < 1. The lower the value of w is, the +
-weight w says to use w as the central weight +for the aliasing filter. w must be a real number in the range +0 < w < 1. The lower the value of w is, the "blurrier" the output image is. The default is w = 1/3. -
SEE ALSO
+
SEE ALSO
-pbmtext, -pnmsmooth, -pnm +pbmtext, +pnmsmooth, +pnm -
AUTHOR
+
AUTHOR
Copyright (C) 1992 by Alberto Accomazzi, Smithsonian Astrophysical Observatory. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
+ + diff --git a/pnmcolormap.html b/pnmcolormap.html index 70a382db..2ce2ea3d 100644 --- a/pnmcolormap.html +++ b/pnmcolormap.html @@ -1,64 +1,64 @@ - -Pnmcolormap User Manual - -
pnmcolormap
+ +Pnmcolormap User Manual + +
pnmcolormap
Updated: 09 February 2019 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmcolormap - create quantization color map for a Netpbm image -
SYNOPSIS
+
SYNOPSIS
-pnmcolormap +pnmcolormap -[-center|-meancolor|-meanpixel] +[-center|-meancolor|-meanpixel] -[-spreadbrightness|-spreadluminosity] +[-spreadbrightness|-spreadluminosity] -[-splitpixelct|-splitcolorct|-splitspread] +[-splitpixelct|-splitcolorct|-splitspread] -[-sort] +[-sort] -[-square] +[-square] -ncolors|all +ncolors|all -[pnmfile] +[pnmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm.
pnmcolormap reads a PNM or PAM image as input, chooses -ncolors colors to best represent the image and writes a PNM +ncolors colors to best represent the image and writes a PNM color map defining them as output. A PAM image may actually contain tuples of any kind, but pnmcolormap's concept of the tuple values that best represent the ones present in the image may not make sense if the tuple type isn't RGB or GRAYSCALE. The design of the program, and the rest of this manual, assumes the tuples represent colors. -
You can use this map as input to pnmremap on the same input +
You can use this map as input to pnmremap on the same input image to quantize the colors in that image, I.e. produce a similar -image with fewer colors. pnmquant does both the pnmcolormap -and pnmremap steps for you. +image with fewer colors. pnmquant does both the pnmcolormap +and pnmremap steps for you. -
A PNM colormap is a PNM image of any dimensions that contains at +
A PNM colormap is a PNM image of any dimensions that contains at least one pixel of each color in the set of colors it represents. The ones pnmcolormap generates have exactly one pixel of each color, except where padding is necessary with the -square option. -
The quantization method is Heckbert's "median cut". +
The quantization method is Heckbert's "median cut". See QUANTIZATION METHOD. -
The output image is of the same format (PBM, PGM, PPM, PAM) as the +
The output image is of the same format (PBM, PGM, PPM, PAM) as the input image. Note that a colormap of a PBM image is not very interesting. -
The colormap generally has the same maxval as the input image, but -pnmcolormap may reduce it if there are too many colors in the +
The colormap generally has the same maxval as the input image, but +pnmcolormap may reduce it if there are too many colors in the input, as part of its quantization algorithm.
pnmcolormap works on a multi-image input stream. In that @@ -72,77 +72,82 @@ from each image would make the same color in two images map to different colors. Before Netpbm 10.31 (December 2005), pnmcolormap ignored any image after the first. -
If you want to create a colormap without basing it on the colors in -an input image, pamseq, ppmmake, and pnmcat can +
If you want to create a colormap without basing it on the colors in +an input image, pamseq, ppmmake, and pnmcat can be useful. -
PARAMETERS
+
PARAMETERS
-
The single parameter, which is required, is the number of colors you want -in the output colormap. pnmcolormap may produce a color map with -slightly fewer colors than that. You may specify all to get a colormap +
The single parameter, which is required, is the number of colors you want +in the output colormap. pnmcolormap may produce a color map with +slightly fewer colors than that. You may specify all to get a colormap of every color in the input image (no quantization). When you specify all, the function is essentially the same as that of ppmhist -map. ppmhist is much older. -
OPTIONS
+
OPTIONS
-
All options can be abbreviated to their shortest unique prefix. You +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmcolormap recognizes the following +command line options: + +
All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or an equals sign between an option name and its value. -
-
-sort +
+
-sort -
This option causes the output colormap to be sorted by the red +
This option causes the output colormap to be sorted by the red component intensity, then the green, then the blue in ascending order. This is an insertion sort, so it is not very fast on large colormaps. Sorting is useful because it allows you to compare two sets of colors. -
-square +
-square -
By default, pnmcolormap produces as the color map a PPM +
By default, pnmcolormap produces as the color map a PPM image with one row and with one column for each color in the colormap. -This option causes pnmcolormap instead to produce a PPM image +This option causes pnmcolormap instead to produce a PPM image that is within one row or column of being square, with the last pixel duplicated as necessary to create a number of pixels which is such an almost-perfect square. -
-verbose +
-verbose -
This option causes pnmcolormap to display messages to -Standard Error about the quantization.
-center +
This option causes pnmcolormap to display messages to +Standard Error about the quantization.
-center -
-meancolor +
-meancolor -
-meanpixel +
-meanpixel -
-spreadbrightness +
-spreadbrightness -
-spreadluminosity +
-spreadluminosity -
-splitpixelct +
-splitpixelct -
-splitcolorct +
-splitcolorct -
-splitspread +
-splitspread -
These options control the quantization algorithm. See These options control the quantization algorithm. See QUANTIZATION METHOD. -
+
-
QUANTIZATION METHOD
+
QUANTIZATION METHOD
-
A quantization method is a way to choose which colors, being fewer +
A quantization method is a way to choose which colors, being fewer in number than in the input, you want in the output. -pnmcolormap uses Heckbert's "median cut" quantization +pnmcolormap uses Heckbert's "median cut" quantization method. -
This method involves separating all the colors into +
This method involves separating all the colors into "boxes," each holding colors that represent about the same number of pixels. You start with one box and split boxes in two until the number of boxes is the same as the number of colors you want in @@ -165,31 +170,31 @@ the output, and choose one color to represent each box. in Netpbm 10.88 (September 2019). Before that, pnmcolormap always splits the box containing the most pixels. -
When you split a box, you do it so each sub-box has the same number of +
When you split a box, you do it so each sub-box has the same number of pixels (except one sub-box has more if the full box has an odd number), with the "greatest" pixels in one sub-box and the "least" pixels in the other. "Greater," for a particular box, means it is brighter in the color component (red, green, blue) which has the largest spread in that -box. pnmcolormap gives you two ways to define "largest spread.": 1) +box. pnmcolormap gives you two ways to define "largest spread.": 1) largest spread of brightness; 2) largest spread of contribution to the luminosity of the color. E.g. red is weighted much more than blue. Select -among these with the -spreadbrightness and -spreadluminosity -options. The default is -spreadbrightness. Where there are multiple +among these with the -spreadbrightness and -spreadluminosity +options. The default is -spreadbrightness. Where there are multiple colors of the median magnitude, they are distributed arbitrarily among between the subboxes. This arbitrary distribution depends upon what the system's qsort function does with multiple equal values, so pnmcolormap may produce slightly different results on different systems. -
pnmcolormap provides three ways of choosing a color to represent a +
pnmcolormap provides three ways of choosing a color to represent a box: 1) the center color - the color halfway between the greatest and least colors in the box, using the above definition of "greater"; 2) the mean of the colors (each component averaged separately by brightness) in the box; 3) the mean weighted by the number of pixels of a color in the image. -
Select among these with the -center, -meancolor, and --meanpixel options. The default is -center. +
Select among these with the -center, -meancolor, and +-meanpixel options. The default is -center. -
Note that in all three methods, there may be colors in the output +
Note that in all three methods, there may be colors in the output which do not appear in the input at all.
Also note that the color chosen to represent the colors in Box A the best @@ -203,27 +208,27 @@ and in fact the color pnmcolormap chose to represent Box B may not appear in the pnmremap output at all. -
REFERENCES
+
REFERENCES
"Color Image Quantization for Frame Buffer Display" by Paul Heckbert, SIGGRAPH '82 Proceedings, page 297. -
SEE ALSO
+
SEE ALSO
-pnmremap, -pnmquant, -ppmquantall, -pamgetcolor, -pamdepth, -ppmdither, -pamseq, -ppmmake, -pnmcat, -ppm +pnmremap, +pnmquant, +ppmquantall, +pamgetcolor, +pamdepth, +ppmdither, +pamseq, +ppmmake, +pnmcat, +ppm -
HISTORY
+
HISTORY
-
Before Netpbm 10.15 (April 2003), pnmcolormap used a lot +
Before Netpbm 10.15 (April 2003), pnmcolormap used a lot more memory for large images because it kept the entire input image in memory. Now, it processes it a row at a time, but because it sometimes must make multiple passes through the image, it first copies @@ -239,23 +244,23 @@ Netpbm 9.23 split it out into two separate programs: pnmquant with a program that simply calls pnmcolormap and pnmremap. -
AUTHOR
+
AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
PARAMETERS -
OPTIONS -
QUANTIZATION METHOD -
REFERENCES -
SEE ALSO -
HISTORY -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
PARAMETERS +
OPTIONS +
QUANTIZATION METHOD +
REFERENCES +
SEE ALSO +
HISTORY +
AUTHOR +
+ + diff --git a/pnmcomp.html b/pnmcomp.html index 510d646c..f35b9cb4 100644 --- a/pnmcomp.html +++ b/pnmcomp.html @@ -1,17 +1,15 @@ - -Pnmcomp User Manual - -
pnmcomp
+ +Pnmcomp User Manual + +
pnmcomp
Updated: 02 August 2014 -
-Table Of Contents -
NAME
+
NAME
-pnmcomp - replaced by pamcomp +pnmcomp - replaced by pamcomp -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -29,8 +27,5 @@ its age. But now it would just be clutter. pnmcomp. Features that are in pamcomp but not pnmcomp are indicated by statements that they didn't exist before 10.21. - - - - - + + diff --git a/pnmnorm.html b/pnmnorm.html index 17af3f4c..566964b1 100644 --- a/pnmnorm.html +++ b/pnmnorm.html @@ -1,22 +1,22 @@ - -Pnmnorm User Manual - -
pnmnorm
+ +Pnmnorm User Manual + +
pnmnorm
Updated: 19 December 2014 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmnorm - normalize the contrast in a Netpbm image -
SYNOPSIS
+
SYNOPSIS
-pnmnorm +pnmnorm -[-bpercent=percent | -bvalue=N | -bsingle] +[-bpercent=percent | -bvalue=N | -bsingle] -[-wpercent=percent | -wvalue=N | -wsingle] +[-wpercent=percent | -wvalue=N | -wsingle] [-midvalue=N] @@ -24,19 +24,19 @@ pnmnorm - normalize the contrast in a Netpbm image [-maxexpand=percent] -[-keephues] +[-keephues] -[-luminosity | -colorvalue | -saturation] +[-luminosity | -colorvalue | -saturation] -[ppmfile] +[ppmfile] -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or an equals sign between an option name and its value. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -53,11 +53,11 @@ becomes black, the brightness that becomes white, and the brightness that becomes that middle value, pnmnorm computes a quadratic equation that maps all the other brightnesses from input values to output values. -
The program first determines a mapping of old brightness to new +
The program first determines a mapping of old brightness to new brightness. For each possible brightness of a pixel, the program determines a corresponding brightness for the output image. -
Then for each pixel in the image, the program computes a color which has +
Then for each pixel in the image, the program computes a color which has the desired output brightness and puts that in the output. With a color image, it is not always possible to compute such a color and retain any semblance of the original hue, so the brightest and dimmest pixels may only @@ -74,7 +74,7 @@ In the case of saturation, "brightness" is pretty much a misnomer, but you can use the brightness analogy to see what it does. In the analogy, bright means saturated and dark means unsaturated. -
Note that all of these are different from separately normalizing +
Note that all of these are different from separately normalizing the individual color components.
An alternative way to spread out the brightnesses in an image is @@ -86,26 +86,38 @@ gives you more contrast than pnmnorm does, but can considerably change the picture in exchange. -
OPTIONS
+
OPTIONS
-
By default, the darkest 2 percent of all pixels are mapped to +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmnorm recognizes the following +command line options: + +
By default, the darkest 2 percent of all pixels are mapped to black, and the brightest 1 percent are mapped to white. You can override this behavior and specify either a different percentage, or specific brightness values to map to black and to white, or just have the single greatest brightness map to white and the least brightness map to black. -
To specify a percentage, use the -bpercent and --wpercent options, or you can specify the exact pixel values to -be mapped by using the -bvalue and -wvalue options. +
+
-bpercent +
-wpercent +
-bvalue +
-wvalue + +
+
To specify a percentage, use the -bpercent and +-wpercent options, or you can specify the exact pixel values to +be mapped by using the -bvalue and -wvalue options. You can get appropriate numbers for the options from ppmhist. If you just want to enhance the contrast, then choose values at elbows in the histogram; e.g. if value 29 represents 3% of the image but value 30 represents 20%, choose 30 for -bvalue. If you want to brighten the image, then set -bvalue to 0 and just fiddle with wvalue; similarly, to -darken the image, set wvalue to maxval and play with -bvalue. +bvalue. If you want to brighten the image, then set +bvalue to 0 and just fiddle with wvalue; similarly, to +darken the image, set wvalue to maxval and play with +bvalue.
If you specify both -bvalue and -bpercent, pnmnorm uses the one that produces the least change. The same goes for @@ -134,7 +146,7 @@ In that case, pnmnorm adjusts the percentile value as required. In the example, it uses 99 as the black value (like -bvalue=99). -
It is also possible for your -bpercent and -wpercent +
It is also possible for your -bpercent and -wpercent options to select the same brightness value for the stretch-to-white and stretch-to-black value because of the fact that pnmnorm can't subdivide a histogram cell. E.g. if an image is all brightness @@ -156,12 +168,17 @@ range expansion of 150% (from a range of 40 to a range of 100). That much stretching means two adjacent pixels that used to differ in intensity by 4 units now differ by 10, and that might be unsightly. +
-bsingle +

To specify that the single least brightness in the image should stretch to black in the output, specify -bsingle. To specify that the single greatest brightness in the image should stretch to white in the output, specify -wsingle. -bsingle and -wsingle were new in Netpbm 10.69 (December 2014). +
-maxexpand +
+
So that you can put a limit on the amount of expansion without having to examine the image first, there is the -maxexpand option. It specifies the maximum expansion you will tolerate, as an @@ -176,18 +193,18 @@ amount you specified.
When pnmnorm limits the expansion because of -maxexpand, it tells you about it with a message like this:
-+ limiting expansion of 150% to 50% - +

In any case, pnmnorm tells you exactly what expansion it's doing, like this:
-+ remapping 25..75 to 0..100 - +

Before Netpbm 10.26 (December 2004), it was not valid to specify both @@ -195,19 +212,26 @@ doing, like this:
-maxexpand was new in Netpbm 10.32 (February 2006). -
The -keephues option says to keep each pixel the same hue as +
-keephues +
+ +
This option says to keep each pixel the same hue as it is in the input; just adjust its brightness. You normally want this; the only reason it is not the default behavior is backward compatibility with a design mistake. -
By default, pnmnorm normalizes contrast in each component -independently (except that the meaning of the -wpercent and --bpercent options are based on the overall brightnesses of the +
By default, pnmnorm normalizes contrast in each component +independently (except that the meaning of the -wpercent and +-bpercent options are based on the overall brightnesses of the colors, not each component taken separately). So if you have a color -which is intensely red but dimly green, pnmnorm would make the +which is intensely red but dimly green, pnmnorm would make the red more intense and the green less intense, so you end up with a different hue than you started with. +
-midvalue=N +
-middle=N +
+
When you specify -midvalue=N, pnmnorm uses a quadratic function to map old brightnesses to new ones, making sure that an old brightness of N becomes 50% bright in the output. You can override @@ -220,16 +244,16 @@ fit), pnmnorm just ignores your -midvalue and maps linearly. -midvalue and -middle were new in Netpbm 10.57 (December 2011). -
If you specify -keephues, pnmnorm would likely leave +
If you specify -keephues, pnmnorm would likely leave this pixel alone, since its overall brightness is medium. -
-keephues can cause clipping, because a certain color may be +
-keephues can cause clipping, because a certain color may be below a target intensity while one of its components is saturated. -Where that's the case, pnmnorm uses the maximum representable +Where that's the case, pnmnorm uses the maximum representable intensity for the saturated component and the pixel ends up with less overall intensity, and a different hue, than it is supposed to have. -
This option is meaningless on grayscale images. +
This option is meaningless on grayscale images.
When you don't specify -keephues, the -luminosity, -colorvalue, and -saturation options @@ -238,13 +262,17 @@ components), but are meaningless when it comes to applying the transfer function (since it is applied to each individual RGB component). -
Before Netpbm 9.25 (March 2002), there was no -keephues option. +
Before Netpbm 9.25 (March 2002), there was no -keephues option. +
-luminosity +
-colorvalue +
-saturation +

-luminosity, -colorvalue, and -saturation determine what property of the pixels pnmnorm normalizes. I.e., what kind of brightness. You cannot specify more than one of these. -
The -luminosity option says to use the luminosity (i.e. the +
The -luminosity option says to use the luminosity (i.e. the "Y" in the YUV or YCbCr color space) as the pixel's brightness. The luminosity is a measure of how bright a human eye would find the color, taking into account the fact that the human eye is more sensitive to some @@ -252,21 +280,21 @@ RGB components than others.
This option is default. -
This option is meaningless on grayscale images. +
This option is meaningless on grayscale images. -
Before Netpbm 10.28 (August 2005), there was no -luminosity option, +
Before Netpbm 10.28 (August 2005), there was no -luminosity option, but its meaning was still the default. -
Before Netpbm 10.28 (August 2005), there was no -colorvalue option. +
Before Netpbm 10.28 (August 2005), there was no -colorvalue option. -
The -colorvalue option says to use the color value (i.e. the +
The -colorvalue option says to use the color value (i.e. the "V" in the HSV color space) as the pixel's brightness. The color value is the gamma-adjusted intensity of the most intense RGB component. -
This option is meaningless on grayscale images. +
This option is meaningless on grayscale images. -
Before Netpbm 10.28 (August 2005), there was no -colorvalue option. +
Before Netpbm 10.28 (August 2005), there was no -colorvalue option.
The -saturation option says to use the saturation (i.e. the "S" in the HSV color space) as the pixel's brightness. The @@ -279,28 +307,28 @@ intense RGB component (all intensities gamma-adjusted).
This option is meaningless on grayscale images. -
Before Netpbm 10.28 (August 2005), there was no -colorvalue option. - - - -
SEE ALSO
- -pnmhisteq, -pamlevels, -ppmhist, -pgmhist, -pambrighten, -ppmdim, -pnmgamma, -pnm - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
- - +
Before Netpbm 10.28 (August 2005), there was no -colorvalue option. + +
+ +
SEE ALSO
+ +pnmhisteq, +pamlevels, +ppmhist, +pgmhist, +pambrighten, +ppmdim, +pnmgamma, +pnm + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
+ + diff --git a/pnmpad.html b/pnmpad.html index 5b9208b4..7847a502 100644 --- a/pnmpad.html +++ b/pnmpad.html @@ -193,8 +193,9 @@ This causes verbose messages.
- pad=($(pnmpad -reportonly -left=10 -right=10 -top=10 -bottom=10)) - pbmmake -gray 10 10 | pnmpaste input.ppm ${pad[0]} ${pad[2]} - + pad=($(pnmpad -reportonly -left=10 -right=10 -top=10 -bottom=10 input.ppm)) + pbmmake -gray ${pad[4]} ${pad[5]} | \ + pnmpaste input.ppm ${pad[0]} ${pad[2]} -
diff --git a/pnmpaste.html b/pnmpaste.html index 8342965e..92b6672b 100644 --- a/pnmpaste.html +++ b/pnmpaste.html @@ -1,27 +1,28 @@ - -Pnmpaste User Manual - -
pnmpaste
+ +Pnmpaste User Manual + +
pnmpaste
Updated: 16 December 2018 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmpaste - paste a rectangle into a PNM image -
SYNOPSIS
+
SYNOPSIS
-pnmpaste +pnmpaste -[-replace|-or|-and|-xor] +[-replace | -or | -and | -xor | +-nor | -nand | -nxor] -frompnmfile x y -[intopnmfile] +frompnmfile x y +[intopnmfile] -
You can abbreviate all options to their shortest unique prefix. +
You can abbreviate all options to their shortest unique prefix. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -42,28 +43,37 @@ edge or below the top edge of the base image, while a negative value indicates the number of pixels right of the right edge or below the bottom edge (so x = -5 means 5 pixels left of the right edge). -
If any part of the pasted image does not fit within the base image, +
If any part of the pasted image does not fit within the base image, pnmpaste fails. -
This tool is most useful in combination with pamcut. For +
This tool is most useful in combination with pamcut. For instance, if you want to edit a small segment of a large image, and your image editor cannot edit the large image, you can cut out the segment you are interested in, edit it, and then paste it back in. -
Another useful companion tool is pbmmask. +
Another useful companion tool is pbmmask. -
pamcomp is a more general tool, except that it lacks the +
pamcomp is a more general tool, except that it lacks the "or," "and," and "xor" functions. -pamcomp allows you to specify a transparency mask in order to have +pamcomp allows you to specify a transparency mask in order to have only part of the inserted image get inserted. So the inserted pixels need not be a rectangle. You can also have the inserted image be translucent, so the resulting image is a mixture of the inserted image and the base image. -
OPTIONS
+
OPTIONS
-
The option specifies the operation to use when doing the paste. -The default is -replace, which means to do the obvious paste: +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmpaste recognizes the following +command line options: + +
+
-replace, -or, -and, -xor, +-nor, -nand, -nxor +
+
These option specify the operation to use when doing the paste. +The default is -replace, which means to do the obvious paste: replace pixels of the "into" image with those of the "from" image. @@ -71,8 +81,8 @@ replace pixels of the "into" image with those of the and nxor are allowed only if both input images are PBM images. They say to combine the "from" and "into" images by performing boolean operations: Each pixel of the output image is the result of the boolean operation on the -corresponding pixels of the two input image, where white is TRUE and black is -FALSE. +corresponding pixels of the two input images, where white is TRUE and black +is FALSE.
Note that this is different from what you would get by doing a bit arithmetic on the bits in the PBM images, because in PBM, white is @@ -81,30 +91,31 @@ in boolean arithmetic.
-nand, -nor, and -nxor were new in Netpbm 10.85 (December 2018). + +
- -
SEE ALSO
+
SEE ALSO
-pamcomp, -pamcut, -pnminvert, -pnmarith, -pbmmask, -pnm +pamcomp, +pamcut, +pnminvert, +pnmarith, +pbmmask, +pnm -
AUTHOR
+
AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
+ + diff --git a/pnmquantall.html b/pnmquantall.html index 389d87ea..fe2cfdbf 100644 --- a/pnmquantall.html +++ b/pnmquantall.html @@ -55,16 +55,18 @@ it gives you access to the various options of pnmcolormap and
OPTIONS
-
In addition to the options common to all programs based on libnetpbm -(most notably -quiet, see -Common Options), pnmquantall recognizes the following -command line option: +
pnmquantall recognizes the following command line option:

-ext extension -
Specify an extension for the output files. By default the input files are overwritten. +
Specify an extension for the output files. By default the input files +are overwritten.
+
pnmquantall does not recognize the options common to all +programs based on libnetpbm (See +Common Options.) However, the -version option works. +
SEE ALSO
pnmquant, diff --git a/pnmscale.html b/pnmscale.html index f14903cc..9d86609c 100644 --- a/pnmscale.html +++ b/pnmscale.html @@ -1,17 +1,15 @@ - -Pnmscale User Manual - -
pnmscale
+ +Pnmscale User Manual + +
pnmscale
Updated: 02 February 2009 -
-Table Of Contents -
NAME
+
NAME
-pnmscale - replaced by pamscale +pnmscale - replaced by pamscale -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -29,8 +27,8 @@ its age. But now it would just be clutter. pnmscale. Features that are in pamscale but not pnmscale are indicated by statements that they didn't exist before 10.20. - - + + diff --git a/pnmtojbig.html b/pnmtojbig.html index c62b3393..f4a18a2e 100644 --- a/pnmtojbig.html +++ b/pnmtojbig.html @@ -108,17 +108,16 @@ approximately 35 stripes will be used for the whole image.
-m number -
Select the maximum horizontal offset of the adaptive template -pixel. The JBIG encoder uses a number of neighbour pixels in order to -get statistical a priori knowledge of the probability, whether the -next pixel will be black or white. One single pixel out of this -template of context neighbor pixels can be moved around. Especially -for dithered images it can be a significant advantage to have one -neighbor pixel which has a distance large enough to cover the period -of a dither function. By default, the adaptive template pixel can be -moved up to 8 pixels away. This encoder supports up to 23 pixels, -however as decoders are only required to support at least a distance -of 16 pixels by the standard, no higher value than 16 for +
Select the maximum horizontal offset of the adaptive template pixel. The +JBIG encoder uses a number of neighbour pixels in order to get statistical a +priori knowledge of the probability, whether the next pixel will be black or +white. One single pixel out of this template of context neighbor pixels can +be moved around. Especially for dithered images it can be a significant +advantage to have one neighbor pixel which has a distance large enough to +cover the period of a dither function. By default, the adaptive template +pixel can be moved up to 8 pixels away. This encoder go up to 23 pixels, +however as decoders are only required to handle at least a distance of 16 +pixels by the standard, no higher value than 16 for number is recommended in order to maintain interoperability with other JBIG implementations. The maximal vertical offset of the adaptive template pixel is always zero. diff --git a/pnmtojpeg.html b/pnmtojpeg.html index 07f61ea7..b4b842f7 100644 --- a/pnmtojpeg.html +++ b/pnmtojpeg.html @@ -1,111 +1,116 @@ - -Pnmtojpeg User Manual - -
PNMTOJPEG
+ +Pnmtojpeg User Manual + +
pnmtojpeg
Updated: 23 April 2007 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmtojpeg - convert PNM image to a JFIF ("JPEG") image -
SYNOPSIS
- -pnmtojpeg -[-exif=filespec] -[-quality=n] -[{-grayscale|-greyscale}] -[-density=nxn[dpi,dpcm]] -[-optimize|-optimise] -[-rgb] -[-progressive] -[-comment=text] -[-dct={int|fast|float}] -[-arithmetic] -[-restart=n] -[-smooth=n] -[-maxmemory=n] -[-verbose] -[-baseline] -[-qtables=filespec] -[-qslots=n[,...]] -[-sample=HxV[,...]] -[-scans=filespec] -[-tracelevel=N] - -filename +
SYNOPSIS
+ +pnmtojpeg +[-exif=filespec] +[-quality=n] +[{-grayscale|-greyscale}] +[-density=nxn[dpi,dpcm]] +[-optimize|-optimise] +[-rgb] +[-progressive] +[-comment=text] +[-dct={int|fast|float}] +[-arithmetic] +[-restart=n] +[-smooth=n] +[-maxmemory=n] +[-verbose] +[-baseline] +[-qtables=filespec] +[-qslots=n[,...]] +[-sample=HxV[,...]] +[-scans=filespec] +[-tracelevel=N] + +filename
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. -
pnmtojpeg converts the named PBM, PGM, or PPM image file, or +
pnmtojpeg converts the named PBM, PGM, or PPM image file, or the standard input if no file is named, to a JFIF file on the standard output. -
pnmtojpeg uses the Independent JPEG Group's JPEG library to -create the output file. See http://www.ijg.org for information +
pnmtojpeg uses the Independent JPEG Group's JPEG library to +create the output file. See http://www.ijg.org for information on the library. -
"JFIF" is the correct name for the image format commonly +
"JFIF" is the correct name for the image format commonly known as "JPEG." Strictly speaking, JPEG is a method of compression. The image format using JPEG compression that is by far the most common is JFIF. There is also a subformat of TIFF that uses JPEG compression. -
EXIF is an image format that is a subformat of JFIF (to wit, a JFIF +
EXIF is an image format that is a subformat of JFIF (to wit, a JFIF file that contains an EXIF header as an APP1 marker). -pnmtojpeg creates an EXIF image when you specify the --exif option. +pnmtojpeg creates an EXIF image when you specify the +-exif option. -
OPTIONS
+
OPTIONS
-
The basic options are: +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmtojpeg recognizes the following +command line options: -
-
-exif=filespec +
Basic Options
-
+
+
-exif=filespec + +
This option specifies that the output image is to be EXIF (a subformat of JFIF), i.e. it will have an EXIF header as a JFIF APP1 marker. The contents of that marker are the contents of the specified file. -The special value - +The special value - means to read the EXIF header contents from standard input. It is invalid to specify standard input for both the EXIF header and the input image. -
+
The EXIF file starts with a two byte field which is the length of the file, including the length field, in pure binary, most significant byte first. The special value of zero for the length field means there -is to be no EXIF header, i.e. the same as no -exif +is to be no EXIF header, i.e. the same as no -exif option. This is useful for when you convert a file from JFIF to PNM -using jpegtopnm, +using jpegtopnm, then transform it, then convert it back to JFIF with -pnmtojpeg, and you don't know whether or not it includes an EXIF header. -jpegtopnm +pnmtojpeg, and you don't know whether or not it includes an EXIF header. +jpegtopnm creates an EXIF file containing nothing but two bytes of zero when the input JFIF file has no EXIF header. Thus, you can transfer any EXIF header from the input JFIF to the output JFIF without worrying about whether an EXIF header actually exists. -
+
The contents of the EXIF file after the length field are the exact byte for byte contents of the APP1 marker, not counting the length field, that constitutes the EXIF header. -
-quality=n +
-quality=n -
Scale quantization tables to adjust image quality. n is 0 +
Scale quantization tables to adjust image quality. n is 0 (worst) to 100 (best); default is 75. Below about 25 can produce images some interpreters won't be able to interpret. See below for more info. -
-grayscale -
-greyscale +
-grayscale +
-greyscale
-rgb
These options determine the color space used in the JFIF output. @@ -129,7 +134,7 @@ The extra CPU time probably indicates that processing of all the extra compressed data consumed all the CPU time saved by not having to convert the RGB inputs to YCbCr. -
Grayscale format takes up a lot less space and takes less time to create +
Grayscale format takes up a lot less space and takes less time to create and process than the color formats, even if the image contains nothing but black, white, and gray. @@ -173,30 +178,30 @@ image. pnmtojpeg always created a JFIF with a density of 1x1 in unspecified units. -
-optimize +
-optimize -
Perform optimization of entropy encoding parameters. Without -this, pnmtojpeg uses default encoding parameters. --optimize usually makes the JFIF file a little smaller, but -pnmtojpeg runs somewhat slower and needs much more memory. +
Perform optimization of entropy encoding parameters. Without +this, pnmtojpeg uses default encoding parameters. +-optimize usually makes the JFIF file a little smaller, but +pnmtojpeg runs somewhat slower and needs much more memory. Image quality and speed of decompression are unaffected by --optimize. +-optimize. -
-progressive +
-progressive -
+
Create a progressive JPEG file (see below). -
-comment=text +
-comment=text -
+
Include a comment marker in the JFIF output, with comment text -text. +text. Without this option, there are no comment markers in the output. -
+
-
The -quality option lets you trade off compressed file size +
The -quality option lets you trade off compressed file size against quality of the reconstructed image: the higher the quality setting, the larger the JFIF file, and the closer the output image will be to the original input. Normally you want to use the lowest @@ -204,11 +209,11 @@ quality setting (smallest file) that decompresses into something visually indistinguishable from the original image. For this purpose the quality setting should be between 50 and 95 for reasonable results; the default of 75 is often about right. If you see defects -at -quality=75, then go up 5 or 10 counts at a time until you +at -quality=75, then go up 5 or 10 counts at a time until you are happy with the output image. (The optimal setting will vary from one image to another.) -
-quality=100 generates a quantization table of all 1's, +
-quality=100 generates a quantization table of all 1's, minimizing loss in the quantization step (but there is still information loss in subsampling, as well as roundoff error). This setting is mainly of interest for experimental purposes. Quality @@ -216,18 +221,18 @@ values above about 95 are not recommended for normal use; the compressed file size goes up dramatically for hardly any gain in output image quality. -
In the other direction, quality values below 50 will produce very +
In the other direction, quality values below 50 will produce very small files of low image quality. Settings around 5 to 10 might be useful in preparing an index of a large image library, for example. -Try -quality=2 (or so) for some amusing Cubist effects. (Note: +Try -quality=2 (or so) for some amusing Cubist effects. (Note: quality values below about 25 generate 2-byte quantization tables, -which are considered optional in the JFIF standard. pnmtojpeg +which are considered optional in the JFIF standard. pnmtojpeg emits a warning message when you give such a quality value, because some other JFIF programs may be unable to decode the resulting file. -Use -baseline if you need to ensure compatibility at low +Use -baseline if you need to ensure compatibility at low quality values.) -
The -progressive option creates a "progressive +
The -progressive option creates a "progressive JPEG" file. In this type of JFIF file, the data is stored in multiple scans of increasing quality. If the file is being transmitted over a slow communications link, the decoder can use the @@ -245,27 +250,28 @@ JPEG file at all. might consider the JPEG2000 format instead. See pamtojpeg2k. -
Options for advanced users: -
+
Advanced options
+ +
-
-dct=int +
-dct=int -
Use integer DCT method (default). +
Use integer DCT method (default). -
-dct=fast +
-dct=fast -
Use fast integer DCT (less accurate). +
Use fast integer DCT (less accurate). -
-dct=float +
-dct=float -
Use floating-point DCT method. The float method is very slightly +
Use floating-point DCT method. The float method is very slightly more accurate than the int method, but is much slower unless your machine has very fast floating-point hardware. Also note that results of the floating-point method may vary slightly across machines, while the integer methods should give the same results everywhere. The fast integer method is much less accurate than the other two. -
-arithmetic +
-arithmetic
Use arithmetic coding. Default is Huffman encoding. Arithmetic coding tends to get you a smaller result. @@ -286,111 +292,111 @@ with the message, "Sorry, there are legal restrictions on arithmetic coding" or "Sorry, arithmetic coding not supported," this is the problem. -
-restart=n +
-restart=n -
-Emit a JPEG restart marker every n MCU rows, or every n -MCU blocks if you append B to the number. -restart 0 +
+Emit a JPEG restart marker every n MCU rows, or every n +MCU blocks if you append B to the number. -restart 0 (the default) means no restart markers. -
-smooth=n +
-smooth=n -
-Smooth the input image to eliminate dithering noise. n, +
+Smooth the input image to eliminate dithering noise. n, ranging from 1 to 100, indicates the strength of smoothing. 0 (the default) means no smoothing. -
-maxmemory=n +
-maxmemory=n -
+
Set a limit for amount of memory to use in processing large images. Value is in thousands of bytes, or millions of bytes if you append -M to the number. For example, -max=4m -selects 4,000,000 bytes. If pnmtojpeg +M to the number. For example, -max=4m +selects 4,000,000 bytes. If pnmtojpeg needs more space, it will use temporary files. -
-verbose +
-verbose -
+
Print to the Standard Error file messages about the conversion process. This can be helpful in debugging problems. -
+
-
The -restart option tells pnmtojpeg to insert extra +
The -restart option tells pnmtojpeg to insert extra markers that allow a JPEG decoder to resynchronize after a transmission error. Without restart markers, any damage to a compressed file will usually ruin the image from the point of the error to the end of the image; with restart markers, the damage is usually confined to the portion of the image up to the next restart marker. Of course, the restart markers occupy extra space. We -recommend -restart=1 for images that will be transmitted +recommend -restart=1 for images that will be transmitted across unreliable networks such as Usenet. -
The -smooth option filters the input to eliminate +
The -smooth option filters the input to eliminate fine-scale noise. This is often useful when converting dithered images to JFIF: a moderate smoothing factor of 10 to 50 gets rid of dithering patterns in the input file, resulting in a smaller JFIF file and a better-looking image. Too large a smoothing factor will visibly blur the image, however. -
Options for wizards: +
Wizard Options
-
-
-baseline +
+
-baseline -
Force baseline-compatible quantization tables to be generated. +
Force baseline-compatible quantization tables to be generated. This clamps quantization values to 8 bits even at low quality settings. (This switch is poorly named, since it does not ensure that the output is actually baseline JPEG. For example, you can use --baseline and -progressive together.) +-baseline and -progressive together.) -
-qtables=filespec +
-qtables=filespec -
Use the quantization tables given in the specified text file. +
Use the quantization tables given in the specified text file. -
-qslots=n[,...] +
-qslots=n[,...] -
Select which quantization table to use for each color component. +
Select which quantization table to use for each color component. -
-sample=HxV[,...] +
-sample=HxV[,...] -
Set JPEG sampling factors for each color component. +
Set JPEG sampling factors for each color component. -
-scans=filespec +
-scans=filespec -
Use the scan script given in the specified text file. See below +
Use the scan script given in the specified text file. See below for information on scan scripts. -
-tracelevel=N +
-tracelevel=N -
This sets the level of debug tracing the program outputs as it runs. +
This sets the level of debug tracing the program outputs as it runs. 0 means none, and is the default. This level primarily controls tracing of the JPEG library, and you can get some pretty interesting information about the compression process. -
+
-
The "wizard" options are intended for experimentation +
The "wizard" options are intended for experimentation with JPEG. If you don't know what you are doing, don't use them. These switches are documented further in the file wizard.doc that comes with the Independent JPEG Group's JPEG library. -
EXAMPLES
+
EXAMPLES
-
This example compresses the PPM file foo.ppm with a quality factor +
This example compresses the PPM file foo.ppm with a quality factor of 60 and saves the output as foo.jpg:
- pnmtojpeg -quality=60 foo.ppm > foo.jpg + pnmtojpeg -quality=60 foo.ppm > foo.jpg

Here's a more typical example. It converts from BMP to JFIF:
- cat foo.bmp | bmptoppm | pnmtojpeg > foo.jpg + cat foo.bmp | bmptoppm | pnmtojpeg > foo.jpg
-
JPEG Loss
+
JPEG LOSS

When you compress with JPEG, you lose information -- i.e. the resulting image has somewhat lower quality than the original. This is a characteristic @@ -400,24 +406,24 @@ to JFIF, you will lose quality. The more you do it, the more you lose. Drawings (charts, cartoons, line drawings, and such with few colors and sharp edges) suffer the most. -
To avoid this, you can use a compressed image format other than +
To avoid this, you can use a compressed image format other than JPEG. PNG and JPEG2000 are good choices, and Netpbm contains converters for those.
If you need to use JFIF on a drawing, you should experiment with -pnmtojpeg's -quality and -smooth options to get a -satisfactory conversion. -smooth 10 or so is often helpful. +pnmtojpeg's -quality and -smooth options to get a +satisfactory conversion. -smooth 10 or so is often helpful. -
Because of the loss, you should do all the manipulation you have to +
Because of the loss, you should do all the manipulation you have to do on the image in some other format and convert to JFIF as the last step. And if you can keep a copy in the original format, so much the better. -The -optimize option to pnmtojpeg is worth using when +The -optimize option to pnmtojpeg is worth using when you are making a "final" version for posting or archiving. It's also a win when you are using low quality settings to make very small JFIF files; the percentage improvement is often a lot more than -it is on larger files. (At present, -optimize mode is +it is on larger files. (At present, -optimize mode is automatically in effect when you generate a progressive JPEG file).
You can do flipping and rotating transformations losslessly with @@ -426,118 +432,123 @@ Jpeg Group's JPEG library. jpegtran exercises its intimate knowledge of the way JPEG works to do the transformation without ever actually decompressing the image. -
+
OTHER PROGRAMS
-
Another program, cjpeg, is similar. cjpeg is +
Another program, cjpeg, is similar. cjpeg is maintained by the Independent JPEG Group and packaged with the JPEG -library which pnmtojpeg uses for all its JPEG work. Because of +library which pnmtojpeg uses for all its JPEG work. Because of that, you may expect it to exploit more current JPEG features. Also, -since you have to have the library to run pnmtojpeg, but not -vice versa, cjpeg may be more commonly available. +since you have to have the library to run pnmtojpeg, but not +vice versa, cjpeg may be more commonly available. -
On the other hand, cjpeg does not use the NetPBM libraries -to process its input, as all the NetPBM tools such as pnmtojpeg +
On the other hand, cjpeg does not use the NetPBM libraries +to process its input, as all the NetPBM tools such as pnmtojpeg do. This means it is less likely to be consistent with all the other programs that deal with the NetPBM formats. Also, the command syntax -of pnmtojpeg is consistent with that of the other Netpbm tools, -unlike cjpeg. +of pnmtojpeg is consistent with that of the other Netpbm tools, +unlike cjpeg. -
SCAN SCRIPTS
+
SCAN SCRIPTS
-
Use the -scan option to specify a scan script. Or use the --progressive option to specify a particular built-in scan +
Use the -scan option to specify a scan script. Or use the +-progressive option to specify a particular built-in scan script. -
Just what a scan script is, and the basic format of the scan script -file, is covered in the wizard.doc file that comes with the +
Just what a scan script is, and the basic format of the scan script +file, is covered in the wizard.doc file that comes with the Independent JPEG Group's JPEG library. Scan scripts are same for -pnmtojpeg as the are for cjpeg. +pnmtojpeg as the are for cjpeg. -
This section contains additional information that isn't, but +
This section contains additional information that isn't, but probably should be, in that document. -
First, there are many restrictions on what is a valid scan script. -The JPEG library, and thus pnmtojpeg, checks thoroughly for any +
First, there are many restrictions on what is a valid scan script. +The JPEG library, and thus pnmtojpeg, checks thoroughly for any lack of compliance with these restrictions, but does little to tell you how the script fails to comply. The messages are very general and sometimes untrue. -
+
To start with, the entries for the DC coefficient must come before any entries for the AC coefficients. The DC coefficient is Coefficient 0; all the other coefficients are AC coefficients. So in an entry for the DC coefficient, the two numbers after the colon must be 0 and 0. In an entry for AC coefficients, the first number after the colon must not be 0. -
+
In a DC entry, the color components must be in increasing order. E.g. "0,2,1" before the colon is wrong. So is "0,0,0". -
+
In an entry for an AC coefficient, you must specify only one color component. I.e. there can be only one number before the colon. -
+
In the first entry for a particular coefficient for a particular color component, the "Ah" value must be zero, but the Al value can be any valid bit number. In subsequent entries, Ah must be the Al value from the previous entry (for that coefficient for that color component), and the Al value must be one less than the Ah value. -
+
The script must ultimately specify at least some of the DC coefficient for every color component. Otherwise, you get the error message "Script does not transmit all the data." You need not specify all of the bits of the DC coefficient, or any of the AC coefficients. -
+
There is a standard option in building the JPEG library to omit scan script capability. If for some reason your library was built with this option, you get the message "Requested feature was omitted at compile time." -
ENVIRONMENT
+
ENVIRONMENT
-
-
JPEGMEM +
+
JPEGMEM -
If this environment variable is set, its value is the default +
If this environment variable is set, its value is the default memory limit. The value is specified as described for the --maxmemory option. An explicit -maxmemory option -overrides any JPEGMEM. +-maxmemory option. An explicit -maxmemory option +overrides any JPEGMEM. -
+
-
SEE ALSO
+
SEE ALSO
-jpegtopnm, -pnm, -cjpeg man page, -djpeg man page, -jpegtran man page, -rdjpgcom man page, -wrjpgcom man page +jpegtopnm, +pnm, +cjpeg man page, +djpeg man page, +jpegtran man page, +rdjpgcom man page, +wrjpgcom man page
Wallace, Gregory K. "The JPEG Still Picture Compression Standard", Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44. -
AUTHOR
+
AUTHOR
-pnmtojpeg and this manual were derived in large part from -cjpeg, by the Independent JPEG Group. The program is otherwise +pnmtojpeg and this manual were derived in large part from +cjpeg, by the Independent JPEG Group. The program is otherwise by Bryan Henderson on March 07, 2000. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
EXAMPLES -
JPEG LOSS -
OTHER PROGRAMS -
SCAN SCRIPTS -
ENVIRONMENT -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
+
Basic Options +
Advanced options +
Wizard Options +
+
EXAMPLES +
JPEG LOSS +
OTHER PROGRAMS +
SCAN SCRIPTS +
ENVIRONMENT +
SEE ALSO +
AUTHOR +
+ + diff --git a/pnmtopng.html b/pnmtopng.html index 167291aa..e2c3f9bd 100644 --- a/pnmtopng.html +++ b/pnmtopng.html @@ -1,18 +1,17 @@ - - -Pnmtopng User Manual - -
pnmtopng
+ +Pnmtopng User Manual + +
pnmtopng
Updated: 13 March 2019 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmtopng - convert a PNM image to PNG -
SYNOPSIS
+
SYNOPSIS
-pnmtopng +pnmtopng [-verbose] [-downscale] [-interlace] @@ -45,14 +44,14 @@ pnmtopng - convert a PNM image to PNG [-comp_buffer_size=n] [-force] [-libversion] -[pnmfile] +[pnmfile] - +
Obsolete options:
-[-filter n] +[-filter n]
Options available only in older versions: @@ -63,18 +62,18 @@ Options available only in older versions: [-time [yy]yy-mm-dd hh:mm:ss] -
Minimum unique abbreviation of option is acceptable. You may use double +
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm.
pnmtopng reads a PNM image as input and produces a PNG image as output. -
Color component values in PNG files are either eight or sixteen +
Color component values in PNG files are either eight or sixteen bits wide, so pnmtopng will automatically scale colors to have a maxval of 255 or 65535. @@ -98,7 +97,9 @@ power of two minus one (255 and 65535 are good choices) to minimize the error. -
OPTIONS
+
OPTIONS
+ +
Note: Option Syntax of Older Versions

pnmtopng changed in Netpbm 10.30 (October 2005) to use the standard Netpbm command line syntax. Before that, you could not @@ -116,7 +117,7 @@ E.g. The old shell command
- pnmtopng -phys 800 800 0 input.pnm >output.png + pnmtopng -phys 800 800 0 input.pnm > output.png
@@ -124,28 +125,35 @@ E.g. The old shell command
- pnmtopng -size "800 800 0" input.pnm >output.png + pnmtopng -size "800 800 0" input.pnm > output.png

If you're writing a program that needs to work with both new and old -pnmtopng, have it first try with the new syntax, and if it fails +, have it first try with the new syntax, and if it fails with "unrecognized option," fall back to the old syntax. -
-
-verbose -
+
Current Options
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmtopng recognizes the following +command line options: + +
+
-verbose +
This causes pnmtopng to display information about the format of the output file. -
-downscale -
+
-downscale +
This enables pnmtopng to scale maxvalues of more then 65535 to 16 bits. Since this means loss of image data, pnmtopng does not do it by default. -
-interlace -
+
-interlace +
This causes the PNG file to be interlaced, in Adam7 format. The interlaced format is one in which the raster data starts with a low-resolution representation of the entire image, then continues with additional information @@ -161,9 +169,9 @@ gradually paint down to the bottom. But with an interlaced image, the displayer can start by showing a low-resolution version of the image, then gradually improve the display as more data arrives. -
-alpha=filename +
-alpha=filename -
This specifies the transparency (alpha) channel of the image. You supply +
This specifies the transparency (alpha) channel of the image. You supply the transparency channel as a standard PGM transparency mask (see the PGM specification. pnmtopng does not necessarily represents the transparency information as a transparency channel @@ -172,21 +180,21 @@ palette, it will do so in order to make a smaller PNG file. pnmtopng even sorts the palette so it can omit the opaque colors from the transparency part of the palette and save space for the palette. -
-transparent=color -
-pnmtopng marks the specified color as transparent in the PNG image. +
-transparent=color +
+pnmtopng marks the specified color as transparent in the PNG image. -
Specify the color (color) as described for the Specify the color (color) as described for the argument of the pnm_parsecolor() library routine. -E.g. red or -rgb:ff/00/0d. If the color you specify is not present in the -image, pnmtopng selects instead the color in the image that is +E.g. red or +rgb:ff/00/0d. If the color you specify is not present in the +image, pnmtopng selects instead the color in the image that is closest to the one you specify. Closeness is measured as a Cartesian distance between colors in RGB space. If multiple colors are -equidistant, pnmtopng chooses one of them arbitrarily. +equidistant, pnmtopng chooses one of them arbitrarily. -
However, if you prefix your color specification with +
However, if you prefix your color specification with "=", e.g.
@@ -195,19 +203,19 @@ equidistant, pnmtopng chooses one of them arbitrarily.
-
only the exact color you specify will be transparent. If that +
only the exact color you specify will be transparent. If that color does not appear in the image, there will be no transparency. -pnmtopng issues an information message when this is the case. +pnmtopng issues an information message when this is the case. -
-background=color -
+
-background=color +
Causes pnmtopng to create a background color chunk in the PNG output which can be used for subsequent transparency channel or transparent color conversions. Specify color the same as for -transparent. -
-palette=palettefile +
-palette=palettefile -
This option specifies a palette to use in the PNG. It forces +
This option specifies a palette to use in the PNG. It forces pnmtopng to create the paletted (colormapped) variety of PNG -- if that isn't possible, pnmtopng fails. If the palette you specify doesn't contain exactly the colors in the image, @@ -217,10 +225,10 @@ only reason you would specify the -palette option is if you care in what order the colors appear in the palette. The PNG palette has colors in the same order as the palette you specify. -
You specify the palette by naming a PPM file that has one pixel for +
You specify the palette by naming a PPM file that has one pixel for each color in the palette. -
Alternatively, consider the case that have a palette and you want +
Alternatively, consider the case that have a palette and you want to make sure your PNG contains only colors from the palette, approximating if necessary. You don't care what indexes the PNG uses internally for the colors (i.e. the order of the PNG palette). In @@ -229,9 +237,9 @@ image and your palette PPM through pnmremap. Though you might think it would, using -palette in this case wouldn't even save pnmtopng any work. -
-gamma=value +
-gamma=value -
Causes pnmtopng to create a gAMA chunk. This information helps +
Causes pnmtopng to create a gAMA chunk. This information helps describe how the color values in the PNG must be interpreted. Without the gAMA chunk, whatever interprets the PNG must get this information separately (or just assume something standard). If your input is a true @@ -243,14 +251,14 @@ have digital computational ability. Also, some simple programs that generate images from scratch do it with a gamma transfer in which the gamma value is 1.0. -
-hist +
-hist -
Use this parameter to create a chunk that specifies the frequency +
Use this parameter to create a chunk that specifies the frequency (or histogram) of the colors in the image. -
-text=filename +
-text=filename -
+
This option lets you include arbitrary text strings in the PNG output, as tEXt chunks. @@ -286,9 +294,9 @@ delimiter characters after it, plus the text in subsequent continuation lines.
There is no limit on the length of a file line or entry or key or text string. There is no limit on the number of entries. -
-ztxt=filename +
-ztxt=filename -
The same as -text, except the text string is compressed in the PNG +
The same as -text, except the text string is compressed in the PNG output. pnmtopng uses zTXt chunks instead of a tEXt chunks, unless the key for the text string starts with "A" or "T". This odd exception exists for backward compatibility; we don't know why the program @@ -296,9 +304,9 @@ was originally designed this way, except that the distinction was meant to roughly identify the keys "Author" and "Title". -
-rgb=chroma_list +
-rgb=chroma_list -
This option specifies how red, green, and blue component values +
This option specifies how red, green, and blue component values of a pixel specify a particular color, by telling the chromaticities of those 3 primary illuminants and of white (i.e. full strength of all three). @@ -317,9 +325,9 @@ arguments. the option -chroma does the same thing, but with slightly different syntax. -
-size="x y unit" +
-size="x y unit" -
This option determines the aspect ratio of the individual pixels +
This option determines the aspect ratio of the individual pixels of your image as well as the physical resolution of it.
unit is either 0 or 1. When it is 1, @@ -363,9 +371,9 @@ more information on what this really means.
This option was new in Netpbm 10.71 (June 2015). Before that, pnmtopng never generates an sRGB chunk. -
-modtime="[yy]yy-mm-dd hh:mm:ss" +
-modtime="[yy]yy-mm-dd hh:mm:ss" -
This option allows you to specify the modification time value to +
This option allows you to specify the modification time value to be placed in the PNG output. You can specify the year parameter either as a two digit or four digit value. @@ -373,9 +381,9 @@ either as a two digit or four digit value. the option -time does the same thing, but with slightly different syntax. -
-filter=n +
-filter=n -
This option is obsolete. Before Netpbm 10.22 (April 2004), this was +
This option is obsolete. Before Netpbm 10.22 (April 2004), this was the only way to specify a row filter. It specifies a single type of row filter, by number, that pnmtopng must use on each row. @@ -399,9 +407,9 @@ you could use the -filter option to specify one permitted row filter type. The default, when you specify no filter options, was the same. -
-compression=n +
-compression=n -
This option sets set the compression level of the zlib +
This option sets set the compression level of the zlib compression. Select a level from 0 for no compression (maximum speed) to 9 for maximum compression (minimum speed). @@ -437,7 +445,7 @@ library knows only one method today, so there's nothing to choose.
This option was new in Netpbm 10.30 (October 2005). -
-comp_window_bits=N +
-comp_window_bits=N
This option tells how big a window the zlib compression algorithm uses. The value is the base 2 logarithm of the window size in bytes, @@ -450,7 +458,7 @@ to 32K).
This option was new in Netpbm 10.30 (October 2005). -
-comp_buffer_size=N +
-comp_buffer_size=N
This option determines in what size pieces pnmtopng does the zlib compression. One compressed piece goes in each IDAT chunk in the @@ -466,9 +474,9 @@ compression buffer) in bytes.
This option was new in Netpbm 10.30 (October 2005). -
-force +
-force -
+
When you specify this, pnmtopng limits its optimizations. The resulting PNG output is as similar to the Netpbm input as possible. For example, the PNG output will not be paletted and the transparency channel will @@ -476,9 +484,9 @@ be represented as a full transparency channel even if the information could be represented more succinctly with a transparency chunk. -
-libversion +
-libversion -
+
This option causes pnmtopng to display version information about itself and the libraries it uses, in addition to all its normal function. Do not confuse this with the Netpbm common @@ -490,31 +498,35 @@ information about the Netpbm library and do nothing else. has changed too much over the history of pnmtopng. The option is good only for human eyes. -
+
-
SEE ALSO
+
SEE ALSO
-pngtopam, -pamtopng, -pnmremap, -pnmgamma, -pnm +pngtopam, +pamtopng, +pnmremap, +pnmgamma, +pnm
For information on the PNG format, see http://schaik.com/png. -
AUTHOR
+
AUTHOR
Copyright (C) 1995-1997 by Alexander Lehmann and Willem van Schaik. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
+
Note: Option Syntax of Older Versions +
Current Options +
+
SEE ALSO +
AUTHOR +
+ + diff --git a/ppmquantall.html b/ppmquantall.html index fc7fc209..1e0132d7 100644 --- a/ppmquantall.html +++ b/ppmquantall.html @@ -1,17 +1,16 @@ - -Ppmquantall User Manual - -
ppmquantall
+ +Ppmquantall User Manual + +
ppmquantall
Updated: 05 March 2012 -
-Table Of Contents +
-
NAME
+
NAME
-ppmquantall - replaced by pnmquantall +ppmquantall - replaced by pnmquantall -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -25,8 +24,5 @@ before the renaming.
For Netpbm before 10.58, where the program is still named ppmquantall, just use the pnmquantall manual. - - - - - + + diff --git a/ppmshadow.html b/ppmshadow.html index 9683faef..170a783a 100644 --- a/ppmshadow.html +++ b/ppmshadow.html @@ -63,10 +63,7 @@ you don't specify ppmfile, the input is Standard Input.
OPTIONS
-
In addition to the options common to all programs based on libnetpbm -(most notably -quiet, see -Common Options), ppmshadow recognizes the following -command line options: +ppmshadow recognizes the following command line options:

-b blur_size @@ -117,6 +114,9 @@ same as the horizontal offset (above), upward.
+
ppmshadow does not recognize the options common to all +programs based on libnetpbm (See +Common Options.) However, the -version option works.
LIMITATIONS
diff --git a/ppmtoilbm.html b/ppmtoilbm.html index ca06b813..b94c31a8 100644 --- a/ppmtoilbm.html +++ b/ppmtoilbm.html @@ -1,61 +1,61 @@ - -Ppmtoilbm User Manual - -
ppmtoilbm
+ +Ppmtoilbm User Manual + +
ppmtoilbm
Updated: 28 June 2015 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
ppmtoilbm - convert a PPM image into an ILBM file -
SYNOPSIS
+
SYNOPSIS
-ppmtoilbm +ppmtoilbm -[-maxplanes|-mp N] +[-maxplanes|-mp N] -[-fixplanes|-fp N] +[-fixplanes|-fp N] -[-ham6|-ham8] +[-ham6|-ham8] -[{-dcbits|-dcplanes} r g b] +[{-dcbits|-dcplanes} r g b] [ --normal|-hamif|-hamforce|-24if|-24force| --dcif|-dcforce|-cmaponly +-normal|-hamif|-hamforce|-24if|-24force| +-dcif|-dcforce|-cmaponly ] -[-ecs|-aga] +[-ecs|-aga] -[-compress|-nocompress] +[-compress|-nocompress] -[-cmethod type] +[-cmethod type] -[-map ppmfile] +[-map ppmfile] -[ppmfile] +[ppmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm.
ppmtoilbm reads a PPM image as input. Produces an ILBM file as output. ppmtoilbm understands the following ILBM types: -
+
-
Normal ILBMs with 1-16 planes +
Normal ILBMs with 1-16 planes -
Amiga HAM with 3-16 planes +
Amiga HAM with 3-16 planes -
24 bit +
24 bit -
Color map (BMHD + CMAP chunk only, nPlanes = 0) +
Color map (BMHD + CMAP chunk only, nPlanes = 0) -
Unofficial direct color. 1-16 planes for each color component. +
Unofficial direct color. 1-16 planes for each color component.
@@ -63,110 +63,115 @@ as output. ppmtoilbm understands the following ILBM types: colormap files) unofficial DCOL chunk for direct color ILBM. -
OPTIONS
+
OPTIONS
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), ppmtoilbm recognizes the following +command line options:
Options marked with (*) can be prefixed with a "no", e.g. "-nohamif". All options can be abbreviated to their shortest unique prefix. -
-
-maxplanes | -mp n +
+
-maxplanes | -mp n -
(default 5, minimum 1, maximum 16) Maximum planes to write in a +
(default 5, minimum 1, maximum 16) Maximum planes to write in a normal ILBM. If the image does not fit into <n> planes, ppmtoilbm writes a HAM file (if -hamif is used), a 24bit file (if -24if is used) or a direct color file (if -dcif is used) or aborts with an error. -
-fixplanes | -fp b +
-fixplanes | -fp b -
(min 1, max 16) If a normal ILBM is written, it will have exactly +
(min 1, max 16) If a normal ILBM is written, it will have exactly <n> planes. -
-hambits | -hamplanes n +
-hambits | -hamplanes n -
(default 6, min 3, max 16) Select number of planes for HAM -picture. The current Amiga hardware supports 6 and 8 planes, so for +
(default 6, min 3, max 16) Select number of planes for HAM +picture. The current Amiga hardware understands 6 and 8 planes, so for now you should only use this values. -
-normal +
-normal -
Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and +
Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and -cmaponly. Also sets compression type to byterun1.
This is the default. -
-hamif (*) -
-24if (*) -
-dcif (*) +
-hamif (*) +
-24if (*) +
-dcif (*) -
Write a HAM/24bit/direct color file if the image does not fit into +
Write a HAM/24bit/direct color file if the image does not fit into <maxplanes> planes. -
-hamforce (*) -
-24force (*) -
-dcforce (*) +
-hamforce (*) +
-24force (*) +
-dcforce (*) -
Write a HAM/24bit/direct color file. +
Write a HAM/24bit/direct color file. -
-dcbits r g b -
-dcplanes r g b +
-dcbits r g b +
-dcplanes r g b -
(default 5, min 1, max 16). Select number of bits for red, green +
(default 5, min 1, max 16). Select number of bits for red, green and blue in a direct color ILBM. -
-ecs +
-ecs -
Shortcut for: -hamplanes 6 -maxplanes 5 +
Shortcut for: -hamplanes 6 -maxplanes 5
This is the default. -
-aga +
-aga -
Shortcut for: -hamplanes 8 -maxplanes 8 +
Shortcut for: -hamplanes 8 -maxplanes 8 -
-ham6 +
-ham6 -
Shortcut for: -hamplanes 6 -hamforce +
Shortcut for: -hamplanes 6 -hamforce -
-ham8 +
-ham8 -
Shortcut for: -hamplanes 8 -hamforce +
Shortcut for: -hamplanes 8 -hamforce -
-compress (*) +
-compress (*) -
This is the default. +
This is the default. -
Compress the BODY chunk. The default compression method is +
Compress the BODY chunk. The default compression method is byterun1. Compression requires building the ILBM image in memory; turning compression off allows stream-writing of the image, but the resulting file will usually be 30% to 50% larger. Another alternative is the -savemem option, this will keep memory requirements for compression at a minimum, but is very slow. -
-cmethod none|byterun1 +
-cmethod none|byterun1 -
This option does the same thing as -compress. +
This option does the same thing as -compress. -
-map ppmfile +
-map ppmfile -
Write a normal ILBM using the colors in <ppmfile> as the +
Write a normal ILBM using the colors in <ppmfile> as the colormap. The colormap file also determines the number of planes, a -maxplanes or -fixplanes option is ignored. -
-cmaponly +
-cmaponly -
Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, +
Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, nPlanes = 0. -
-savemem +
-savemem -
See the -compress option. +
See the -compress option. -
+
-
LIMITATIONS
+
LIMITATIONS

HAM pictures will always get a grayscale colormap; a real color selection algorithm might give better results. On the other hand, @@ -175,17 +180,17 @@ the same depth (no. of planes) share a common colormap, which is useful for building HAM animations. -
REFERENCES
+
REFERENCES
Amiga ROM Kernel Reference Manual - Devices (3rd Ed.) -
+
Addison Wesley, ISBN 0-201-56775-X -
SEE ALSO
+
SEE ALSO
-ppm, -ilbmtoppm +ppm, +ilbmtoppm
HISTORY
@@ -193,25 +198,25 @@ Addison Wesley, ISBN 0-201-56775-X
For about a year in 1993-1994, there was a -savemem option. -
AUTHORS
+
AUTHORS

Copyright (C) 1989 by Jef Poskanzer. -
Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de) - - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
LIMITATIONS -
REFERENCES -
SEE ALSO -
HISTORY -
AUTHORS -
- - +
Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de) + + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
LIMITATIONS +
REFERENCES +
SEE ALSO +
HISTORY +
AUTHORS +
+ + diff --git a/ppmtomitsu.html b/ppmtomitsu.html index bb65f1f1..e03d14a8 100644 --- a/ppmtomitsu.html +++ b/ppmtomitsu.html @@ -36,7 +36,7 @@ ppmtomitsu - convert a PPM image to a Mitsubishi S340-10 file format suitable to be printed by a Mitsubishi S340-10 printer, or any other Mitsubishi color sublimation printer. -
The Mitsubishi S340-10 Color Sublimation printer supports 24bit +
The Mitsubishi S340-10 Color Sublimation printer can print in 24 bit color. Images of the available sizes take so long to transfer that there is a fast method, employing a lookuptable, that ppmtomitsu will use if there is a maximum of 256 colors in the image. ppmtomitsu @@ -50,8 +50,8 @@ printer. The printer understands putting together images in the printers memory; ppmtomitsu doesn't utilize this as pnmcat etc provide the same functionality and let you view the result on-screen, too. The S340-10 is the lowest common denominator printer; for higher -resolution printers there's the dpi300 option. The other printers also -support higher values for enlarge eg, but I don't think that's +resolution printers there's the dpi300 option. The other printers are also +capable of higher values for enlarge eg, but I don't think that's essential enough to warrant a change in the program.
For proper results, the input maxval must be 255. Use pamdepth diff --git a/ppmtoterm.html b/ppmtoterm.html index 23ac56c0..e25f73d0 100644 --- a/ppmtoterm.html +++ b/ppmtoterm.html @@ -1,30 +1,30 @@ - -Ppmtoterm User Manual - -
ppmtoterm
+ +Ppmtoterm User Manual + +
ppmtoterm
Updated: 17 June 2017 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image -
SYNOPSIS
+
SYNOPSIS
-ppmtoterm +ppmtoterm -[ppmfile] +[ppmfile] -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. 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
+
DESCRIPTION

This program is part of Netpbm. -
This program tries to produce an accurate representation of a PPM +
This program tries to produce an accurate representation of a PPM image on an terminal that implements the ANSI ISO 6429 standard. It approximates colors, finding the minimum Cartesian distance between the input RGB vectors and the ones in the generated palette. As the @@ -32,11 +32,11 @@ available color palette is somewhat restricted, you get the best results when the colors in the original image are few and the RGB intensities are close to zero, half of maximum, and maximum. -
You can usually get good results with cartoons or images with +
You can usually get good results with cartoons or images with plain colors (no gradients). With photos, results can vary, but are usually not very accurate. -
The output image has one line for each row and one character for each +
The output image has one line for each row and one character for each column of the input image. E.g. an 80 pixel by 25 pixel PPM image would fill up an 80x25 terminal screen. Use pamscale or pamcut to make your image fit properly on your screen. @@ -48,12 +48,12 @@ appear square on your terminal, as it should, you'll want to squash it vertically or stretch it horizontally by a factor of two (resulting int 10x20 characters are 20x40 characters). -
The image starts at the current cursor position on the terminal +
The image starts at the current cursor position on the terminal screen. Each successive row starts at Column 0 on the screen. If you want to shift the image up or down, for example to center it, use pnmpad on the input. -
This program was born with the objective of displaying nice color +
This program was born with the objective of displaying nice color images on the Linux console, e.g. a proper logo at Linux boot.
ppmtoascii does a similar things, but combines 2 or 8 pixels into @@ -64,41 +64,42 @@ pixel.
pbmto4425 does a similar thing for black and white images, using line drawing characters, on some terminals. -
OPTIONS
+
OPTIONS
-
-None. +
There are no command line options defined specifically +for ppmtoterm, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) +
SEE ALSO
-
SEE ALSO
+pamscale, +pamcut, +ppmtoascii, +pbmtoascii, +pbmto4425, +ppm -pamscale, -pamcut, -ppmtoascii, -pbmtoascii, -pbmto4425, -ppm - -
AUTHOR
+
AUTHOR
Copyright (C) 2002 by Ero Carrera. -
HISTORY
- -
This program was new in Netpbm 10.9 (August 2002). +
HISTORY
+
This program was new in Netpbm 10.9 (August 2002). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
HISTORY +
+ + diff --git a/rletopnm.html b/rletopnm.html index 93a4d267..8a912be9 100644 --- a/rletopnm.html +++ b/rletopnm.html @@ -132,7 +132,7 @@ Army High Performance Computing Research Center (AHPCRC) Minnesota Supercomputer Center, Inc. -
Modifications by Eric Haines to support raw and plain formats. +
Modifications by Eric Haines to produce raw and plain formats.
Modifications by Bryan Henderson to create transparency files and use mnemonic options. diff --git a/tifftopnm.html b/tifftopnm.html index c0526212..af540dfc 100644 --- a/tifftopnm.html +++ b/tifftopnm.html @@ -1,30 +1,30 @@ - -Tifftopnm User Manual - -
tifftopnm
+ +Tifftopnm User Manual + +
tifftopnm
Updated: 02 January 2015 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
tifftopnm - convert a TIFF file into a PNM image -
SYNOPSIS
+
SYNOPSIS
-tifftopnm +tifftopnm -[-alphaout={alpha-filename,-}] -[-headerdump] +[-alphaout={alpha-filename,-}] +[-headerdump] [-verbose]
-[-respectfillorder] -[-byrow] -[-orientraw] -[tiff-filename] +[-respectfillorder] +[-byrow] +[-orientraw] +[tiff-filename] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -39,9 +39,9 @@ which type it is writing. output stream. Before Netpbm 10.27 (March 2005), however, it would just ignore all but the first input image. -
The tiff-filename argument names the file that contains the Tiff +
The tiff-filename argument names the file that contains the Tiff image. If you specify "-" or don't specify this -argument, tifftopnm uses Standard Input. +argument, tifftopnm uses Standard Input.
In either case, before Netpbm 10.70 (March 2015), the file must be seekable. That means no pipe, but any regular file is fine. In current @@ -49,14 +49,13 @@ Netpbm, the file need not be seekable, but if it isn't, tifftopnm creates a temporary regular file containing the entire image, so you must have resources for that (and it may defeat your reason for using a pipe). -
TIFF Capability

pamtotiff uses the Libtiff.org TIFF library (or whatever equivalent you provide) to interpret the TIFF input. So the set of files it is able to interpret is determined mostly by that library. -
This program cannot read every possible TIFF file -- there are +
This program cannot read every possible TIFF file -- there are myriad variations of the TIFF format. However, it does understand monochrome and gray scale, RGB, RGBA (red/green/blue with transparency channel), CMYK (Cyan-Magenta-Yellow-Black ink color separation), and @@ -77,91 +76,96 @@ intelligence. That native intelligence does not know as many formats as TIFFRGBAImageGet() does. And certain compressed formats simply cannot be read with TIFFReadScanLine(). -
Before Netpbm 10.11 (October 2002), tifftopnm never used +
Before Netpbm 10.11 (October 2002), tifftopnm never used TIFFRGBAImageGet(), so it could not interpret many of the formats it can interpret today. -
There is no fundamental reason that this program could not read +
There is no fundamental reason that this program could not read other kinds of TIFF files even when they don't fit in memory all at once. The existing limitations are mainly because no one has asked for more.
Output Image
-
The PNM output has the same maxval as the Tiff input, except that +
The PNM output has the same maxval as the Tiff input, except that if the Tiff input is colormapped (which implies a maxval of 65535) the PNM output has a maxval of 255. Though this may result in lost information, such input images hardly ever actually have more color resolution than a maxval of 255 provides and people often cannot deal with PNM files that have maxval > 255. By contrast, a non-colormapped Tiff image that doesn't need a maxval > 255 doesn't -have a maxval > 255, so when tifftopnm sees a +have a maxval > 255, so when tifftopnm sees a non-colormapped maxval > 255, it takes it seriously and produces a matching output maxval. -
Another exception is where the TIFF maxval is greater than 65535, +
Another exception is where the TIFF maxval is greater than 65535, which is the maximum allowed by the Netpbm formats. In that case, tifftopnm uses a maxval of 65535, and you lose some information in the conversion. -
OPTIONS
+
OPTIONS
-
You may abbreviate any option to its shortest unique prefix. You may use +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), tifftopnm recognizes the following +command line options: + +
You may abbreviate any option to its shortest unique prefix. You may use two hyphens instead of one in options. You may separate an option and its value either by an equals sign or white space. -
-
-alphaout=alpha-filename +
+
-alphaout=alpha-filename -
tifftopnm creates a PGM file containing the alpha channel +
tifftopnm creates a PGM file containing the alpha channel values in the input image. If the input image doesn't contain a -transparency channel, the alpha-filename file contains all zero -(transparent) transparency values. If you don't specify -alphaout, +transparency channel, the alpha-filename file contains all zero +(transparent) transparency values. If you don't specify -alphaout, -tifftopnm does not generate a transparency file, and if the input -image has an transparency channel, tifftopnm simply discards it. +tifftopnm does not generate a transparency file, and if the input +image has an transparency channel, tifftopnm simply discards it. -
If you specify - as the filename, tifftopnm +
If you specify - as the filename, tifftopnm writes the transparency output to Standard Output and discards the image. -
See pamcomp for one way to use +
See pamcomp for one way to use the transparency output file. -
-respectfillorder +
-respectfillorder -
By default, tifftopnm ignores the "fillorder" +
By default, tifftopnm ignores the "fillorder" tag in the TIFF input, which means it may incorrectly interpret the image. To make it follow the spec, use this option. For a lengthy -but engaging discussion of why tifftopnm works this way and how -to use the -respectfillorder option, see the note on fillorder +but engaging discussion of why tifftopnm works this way and how +to use the -respectfillorder option, see the note on fillorder below. -
-byrow +
-byrow -
This option can make tifftopnm run faster. +
This option can make tifftopnm run faster. -
tifftopnm has two ways to do the conversion from Tiff to PNM, using +
tifftopnm has two ways to do the conversion from Tiff to PNM, using respectively two facilities of the TIFF library: -
+
-
Whole Image +
Whole Image -
Decode the entire image into memory at once, using +
Decode the entire image into memory at once, using TIFFRGBAImageGet(), then convert to PNM and output row by row. -
Row By Row -
Read, convert, and output one row at a time +
Row By Row +
Read, convert, and output one row at a time using TIFFReadScanline() -
+
-
Whole Image is preferable because the Tiff library does more of the +
Whole Image is preferable because the Tiff library does more of the work, which means it understands more of the Tiff format possibilities now and in the future. Also, some compressed TIFF formats don't allow you to extract an individual row. -
Row By Row uses far less memory, which means with large images, it +
Row By Row uses far less memory, which means with large images, it can run in environments where Whole Image cannot and may also run faster. And because Netpbm code does more of the work, it's possible that it can be more flexible or at least give better diagnostic @@ -170,13 +174,13 @@ information if there's something wrong with the TIFF.
The Netpbm native code may do something correctly that the TIFF library does incorrectly, or vice versa. -
In Netpbm, we stress function over performance, so by default we +
In Netpbm, we stress function over performance, so by default we try Whole Image first, and if we can't get enough memory for the decoded image or TIFFRGBAImageGet() fails, we fall back to Row By Row. But if you specify the -byrow option, tifftopnm will not attempt Whole Image. If Row By Row does not work, it simply fails. -
See Color Separation (CMYK) TIFFs for a +
See Color Separation (CMYK) TIFFs for a description of one way Row By Row makes a significant difference in your results. @@ -185,13 +189,13 @@ your results. tifftopnm then scales them back to maxval 65535, but the lower 8 bits of information is gone. -
In many versions of the TIFF library, TIFFRGBAImageGet() does not +
In many versions of the TIFF library, TIFFRGBAImageGet() does not correctly interpret TIFF files in which the raster orientation is column-major (i.e. a row of the raster is a column of the image). With such a TIFF library and file, you must use -byrow to get correct output. -
Before Netpbm 10.11 (October 2002), tifftopnm always did Row +
Before Netpbm 10.11 (October 2002), tifftopnm always did Row By Row. Netpbm 10.12 always tried Whole Image first. -byrow came in with Netpbm 10.13 (January 2003). @@ -230,18 +234,18 @@ that have an orientation other than the common one.
Print extra messages to Standard Error about the conversion. -
-headerdump +
-headerdump -
Dump TIFF file information to stderr. This information may be useful +
Dump TIFF file information to stderr. This information may be useful in debugging TIFF file conversion problems. -
+
-
NOTES
+
NOTES
-
Fillorder
+
Fillorder
-
+
There is a piece of information in the header of a TIFF image called "fillorder." The TIFF specification quite clearly states that this value tells the order in which bits are arranged in a byte @@ -250,42 +254,42 @@ assuming that the image has a format where more than one pixel can be represented by a single byte: 1) the byte is filled from most significant bit to least significant bit going left to right in the image; and 2) the opposite. -
+
However, there is confusion in the world as to the meaning of fillorder. Evidence shows that some people believe it has to do with byte order when a single value is represented by two bytes. -
+
These people cause TIFF images to be created that, while they use a MSB-to-LSB fillorder, have a fillorder tag that says they used LSB-to-MSB. A program that properly interprets a TIFF image will not end up with the image that the author intended in this case. -
-For a long time, tifftopnm did not understand fillorder itself +
+For a long time, tifftopnm did not understand fillorder itself and assumed the fillorder was MSB-to-LSB regardless of the fillorder tag in the TIFF header. And as far as I know, there is no legitimate reason to use a fillorder other than MSB-to-LSB. So users of -tifftopnm were happily using those TIFF images that had +tifftopnm were happily using those TIFF images that had incorrect fillorder tags. -
-So that those users can continue to be happy, tifftopnm today +
+So that those users can continue to be happy, tifftopnm today continues to ignore the fillorder tag unless you tell it not to. (It does, however, warn you when the fillorder tag does not say MSB-to-LSB that the tag is being ignored). -
+
If for some reason you have a TIFF image that actually has LSB-to-MSB fillorder, and its fillorder tag correctly indicates that, you must -use the -respectfillorder option on tifftopnm to get +use the -respectfillorder option on tifftopnm to get proper results. -
-Examples of incorrect TIFF images are at ftp://weather.noaa.gov. They are -apparently created by a program called faxtotiff. +
+Examples of incorrect TIFF images are at ftp://weather.noaa.gov. They are +apparently created by a program called faxtotiff. -
+
This note was written on January 1, 2002. -
Color Separation (CMYK) TIFFs
+
Color Separation (CMYK) TIFFs

Some TIFF images contain color information in CMYK form, whereas PNM images use RGB. There are various formulas for converting between these @@ -307,36 +311,36 @@ Row By Row mode. Y=(1-K)*(1-B) formula always. -
SEE ALSO
+
SEE ALSO
-pnmtotiff, -pnmtotiffcmyk, -pamcomp, -pnm +pnmtotiff, +pnmtotiffcmyk, +pamcomp, +pnm -
AUTHOR
+
AUTHOR

Derived by Jef Poskanzer from tif2ras.c, which is Copyright (c) -1990 by Sun Microsystems, Inc. Author: Patrick J. Naughton (naughton@wind.sun.com). - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION +1990 by Sun Microsystems, Inc. Author: Patrick J. Naughton (naughton@wind.sun.com). + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
+
TIFF Capability +
Output Image +
+
OPTIONS +
NOTES
-
Tiff Capability -
Output Image -
-
OPTIONS -
NOTES -
-
Fillorder -
Color Separation (CMYK) TIFFs -
-
SEE ALSO -
AUTHOR -
- - +
Fillorder +
Color Separation (CMYK) TIFFs +
+
SEE ALSO +
AUTHOR +
+ + diff --git a/winicon.html b/winicon.html index 81748bf9..71c83b4d 100644 --- a/winicon.html +++ b/winicon.html @@ -73,11 +73,11 @@ invented in the mid-eighties for Windows 1:

Windows 1 used monochrome 32x32 icons only.
Windows 3.0 added color icons with bpp values up to 8. -
Windows 4.0 (a.k.a. Windows95) added support for 32-bpp images and +
Windows 4.0 (a.k.a. Windows95) added option for 32-bpp images and resolutions up to 256 by 256. -
NT 5.1 (a.k.a. Windows XP) added support for the 8-bit +
NT 5.1 (a.k.a. Windows XP) added option for the 8-bit transparency channel in the unused bits of 32-bpp images. -
NT 6.0 (a.k.a. Windows Vista) added support for PNG +
NT 6.0 (a.k.a. Windows Vista) added option for PNG encoded images
-- cgit 1.4.1: This option causes the output to have the bits in every byte reversed so the least significant bit becomes the most significant bit. -Apparently, there is some ambiguity in transmission protocols so that -the bits get reversed on transmission, and this compensates for that. -If you get a whole bunch of "bad code word" messages when you try to -read the G3 file (e.g. with g3topbm), try using this option. +Some fax modems expect bits in reverse order, and this compensates for +that. If you get a whole bunch of "bad code word" messages when you try +to read the G3 file (e.g. with g3topbm), try using this option. Note that the output is not G3 when you use this option.
-nofixedwidth diff --git a/pbmtogem.html b/pbmtogem.html index 0b34d268..f8073b43 100644 --- a/pbmtogem.html +++ b/pbmtogem.html @@ -31,7 +31,7 @@ Common Options.)
LIMITATIONS
-pbmtogem does not support compression of repeated lines +pbmtogem cannot compress repeated lines.
SEE ALSO
diff --git a/pbmtoicon.html b/pbmtoicon.html index 6a6f7602..e46d63a7 100644 --- a/pbmtoicon.html +++ b/pbmtoicon.html @@ -1,21 +1,19 @@ - -Pbmtoicon User Manual - -
pbmtoicon
+ +Pbmtoicon User Manual + +
pbmtoicon
-Table Of Contents +
NAME
-
NAME
+pbmtoicon - replaced by pbmtosunicon -pbmtoicon - convert a Sun icon image to PBM +
SYNOPSIS
-
SYNOPSIS
+pbmtoicon +[iconfile] -pbmtoicon -[iconfile] - -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -36,9 +34,5 @@ for pbmtoicon, as long as you recognize that any change the pbmtosunicon manual says happened in or after Netpbm 10.53 doesn't apply to pbmtoicon. - - - - - - + + diff --git a/pbmtoppa.html b/pbmtoppa.html index 5a7d4121..f4e695d1 100644 --- a/pbmtoppa.html +++ b/pbmtoppa.html @@ -236,7 +236,7 @@ as small as 1/4 inch without causing the printer to choke with same should work for the 820 and 1000, but it hasn't been tested. Also, use the pbmraw GSDriver if you have it; it's faster. -
Here is a tip to integrate HP720C support in RedHat's printtool: +
Here is a tip to integrate HP720C capability in RedHat's printtool:
Install pbmtoppa. Copy pbmtoppa to /usr/bin. @@ -254,7 +254,7 @@ StartEntry: DeskJet720C About: { \ This driver drives the HP DeskJet 720C \ inkjet printer. \ - It does not support color printing. \ + It cannot do color printing. \ IMPORTANT! Insert \ "- | pbm2ppa -" \ in the "Extra GS Options " field.\ diff --git a/pgmdeshadow.html b/pgmdeshadow.html index acde9010..0349b260 100644 --- a/pgmdeshadow.html +++ b/pgmdeshadow.html @@ -1,24 +1,22 @@ - -Pgmdeshadow User Manual - -
pgmdeshadow
+ +Pgmdeshadow User Manual + +
pgmdeshadow
Updated: 06 July 2006 -
+
+Table Of Contents -Table Of Contents - -
NAME
+
NAME
pgmdeshadow - Deshadow a PGM image -
SYNOPSIS
- -pgmdeshadow +
SYNOPSIS
-[pnmfile] +pgmdeshadow +[pnmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -36,11 +34,14 @@ algorithm from Luc Vincent, "Morphological Grayscale Reruction in Image Analysis: Applications and Efficient Algorithms. -
OPTIONS
+
OPTIONS
-
None. +
There are no command line options defined specifically +for pgmdeshadow, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) -
REFERENCES
+
REFERENCES

@@ -52,26 +53,26 @@ pp. 176-201.
-
SEE ALSO
+
SEE ALSO
-ppmshadow, -pgm +ppmshadow, +pgm
HISTORY
-
pgmdeshadow was added to Netpbm in Version 10.35 (August 2006). +
pgmdeshadow was added to Netpbm in Version 10.35 (August 2006). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
REFERENCES -
SEE ALSO -
HISTORY -
+
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
REFERENCES +
SEE ALSO +
HISTORY +
- - + + diff --git a/pgmramp.html b/pgmramp.html index 3008dc01..12e1d530 100644 --- a/pgmramp.html +++ b/pgmramp.html @@ -1,28 +1,28 @@ - -Pgmramp User Manual - -
pgmramp
+ +Pgmramp User Manual + +
pgmramp
Updated: 15 February 2014 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pgmramp - generate a grayscale ramp -
SYNOPSIS
+
SYNOPSIS
-pgmramp -{-lr|-tb|-rectangle|-ellipse|-diagonal} +pgmramp +{-lr|-tb|-rectangle|-ellipse|-diagonal} [-maxval=maxval] -width height +width height -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one to designate an option. You may use either white space or an equals sign between an option name and its value. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -47,75 +47,81 @@ example, the -lr option gives you a left to right ramp and gives you a right to left ramp. -
To generate a simple ramp of all the values from 0 to maxval, and not +
To generate a simple ramp of all the values from 0 to maxval, and not necessarily a graphic image, use pamseq.
ppmrainbow does something similar to what pgmramp does, but for color. The image fades between two colors of your choice. -
OPTIONS
+
OPTIONS
+
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pgmramp recognizes the following +command line options: +
You must specify exactly one of the ramp type options. -
-
-lr -
+ +
+
-lr +
A left to right ramp. Black on the left; white on the right. -
-tb -
+
-tb +
A top to bottom ramp. Black on top; white on the bottom. -
-rectangle -
+
-rectangle +
An outside-in rectangular ramp. It is black around the edges and white in the center. -
-ellipse -
+
-ellipse +
An outside-in elliptical ramp. It is black around the edge and white in the center. -
-diagonal -
+
-diagonal +
A ramp from top left corner diagonally down to bottom right. Black at the top left; white at the bottom right.
This option was new in Netpbm 10.66 (March 2014). -
-maxval=maxval -
+
-maxval=maxval +
The maxval for the generated image. Default is 255.
This option was new in Netpbm 10.1 (June 2002). Before that, the maxval is always 255. -
+
-
SEE ALSO
+
SEE ALSO
-pamflip, -pamarith, -pnmgamma, -pamseq, -ppmrainbow, -pamgradient, -pgm +pamflip, +pamarith, +pnmgamma, +pamseq, +ppmrainbow, +pamgradient, +pgm -
AUTHOR
+
AUTHOR
Copyright (C) 1989 by Jef Poskanzer. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
+ + diff --git a/pngtopnm.html b/pngtopnm.html index 42709612..64d8f8a0 100644 --- a/pngtopnm.html +++ b/pngtopnm.html @@ -1,33 +1,31 @@ - -Pngtopnm User Manual - -
pngtopnm
+ +Pngtopnm User Manual + +
pngtopnm
Updated: 22 July 2008 -
-Table Of Contents -
NAME
+
NAME
-pngtopnm - convert a PNG image into a PNM image +pngtopnm - Convert a PNG image to PNM: replaced by pngtopam -
SYNOPSIS
+
SYNOPSIS
-pngtopnm +pngtopnm [-verbose] [-alpha | -mix] [-background=color] -
+
[-gamma=value] [-text=filename] [-time] -[pngfile] +[pngfile] -
Minimum unique abbreviation of option is acceptable. You may use double +
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -60,9 +58,5 @@ after Netpbm 10.44 doesn't apply to pngtopnm.
-m number -: Select the maximum horizontal offset of the adaptive template -pixel. The JBIG encoder uses a number of neighbour pixels in order to -get statistical a priori knowledge of the probability, whether the -next pixel will be black or white. One single pixel out of this -template of context neighbor pixels can be moved around. Especially -for dithered images it can be a significant advantage to have one -neighbor pixel which has a distance large enough to cover the period -of a dither function. By default, the adaptive template pixel can be -moved up to 8 pixels away. This encoder supports up to 23 pixels, -however as decoders are only required to support at least a distance -of 16 pixels by the standard, no higher value than 16 for +; Select the maximum horizontal offset of the adaptive template pixel. The +JBIG encoder uses a number of neighbour pixels in order to get statistical a +priori knowledge of the probability, whether the next pixel will be black or +white. One single pixel out of this template of context neighbor pixels can +be moved around. Especially for dithered images it can be a significant +advantage to have one neighbor pixel which has a distance large enough to +cover the period of a dither function. By default, the adaptive template +pixel can be moved up to 8 pixels away. This encoder go up to 23 pixels, +however as decoders are only required to handle at least a distance of 16 +pixels by the standard, no higher value than 16 for number is recommended in order to maintain interoperability with other JBIG implementations. The maximal vertical offset of the adaptive template pixel is always zero. diff --git a/pnmtojpeg.html b/pnmtojpeg.html index 07f61ea7..b4b842f7 100644 --- a/pnmtojpeg.html +++ b/pnmtojpeg.html @@ -1,111 +1,116 @@ - -Pnmtojpeg User Manual - -
PNMTOJPEG
+ +Pnmtojpeg User Manual + +
pnmtojpeg
Updated: 23 April 2007 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmtojpeg - convert PNM image to a JFIF ("JPEG") image -
SYNOPSIS
- -pnmtojpeg -[-exif=filespec] -[-quality=n] -[{-grayscale|-greyscale}] -[-density=nxn[dpi,dpcm]] -[-optimize|-optimise] -[-rgb] -[-progressive] -[-comment=text] -[-dct={int|fast|float}] -[-arithmetic] -[-restart=n] -[-smooth=n] -[-maxmemory=n] -[-verbose] -[-baseline] -[-qtables=filespec] -[-qslots=n[,...]] -[-sample=HxV[,...]] -[-scans=filespec] -[-tracelevel=N] - -filename +
SYNOPSIS
+ +pnmtojpeg +[-exif=filespec] +[-quality=n] +[{-grayscale|-greyscale}] +[-density=nxn[dpi,dpcm]] +[-optimize|-optimise] +[-rgb] +[-progressive] +[-comment=text] +[-dct={int|fast|float}] +[-arithmetic] +[-restart=n] +[-smooth=n] +[-maxmemory=n] +[-verbose] +[-baseline] +[-qtables=filespec] +[-qslots=n[,...]] +[-sample=HxV[,...]] +[-scans=filespec] +[-tracelevel=N] + +filename
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. -
pnmtojpeg converts the named PBM, PGM, or PPM image file, or +
pnmtojpeg converts the named PBM, PGM, or PPM image file, or the standard input if no file is named, to a JFIF file on the standard output. -
pnmtojpeg uses the Independent JPEG Group's JPEG library to -create the output file. See http://www.ijg.org for information +
pnmtojpeg uses the Independent JPEG Group's JPEG library to +create the output file. See http://www.ijg.org for information on the library. -
"JFIF" is the correct name for the image format commonly +
"JFIF" is the correct name for the image format commonly known as "JPEG." Strictly speaking, JPEG is a method of compression. The image format using JPEG compression that is by far the most common is JFIF. There is also a subformat of TIFF that uses JPEG compression. -
EXIF is an image format that is a subformat of JFIF (to wit, a JFIF +
EXIF is an image format that is a subformat of JFIF (to wit, a JFIF file that contains an EXIF header as an APP1 marker). -pnmtojpeg creates an EXIF image when you specify the --exif option. +pnmtojpeg creates an EXIF image when you specify the +-exif option. -
OPTIONS
+
OPTIONS
-
The basic options are: +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmtojpeg recognizes the following +command line options: -
-
-exif=filespec +
Basic Options
-
+
+
-exif=filespec + +
This option specifies that the output image is to be EXIF (a subformat of JFIF), i.e. it will have an EXIF header as a JFIF APP1 marker. The contents of that marker are the contents of the specified file. -The special value - +The special value - means to read the EXIF header contents from standard input. It is invalid to specify standard input for both the EXIF header and the input image. -
+
The EXIF file starts with a two byte field which is the length of the file, including the length field, in pure binary, most significant byte first. The special value of zero for the length field means there -is to be no EXIF header, i.e. the same as no -exif +is to be no EXIF header, i.e. the same as no -exif option. This is useful for when you convert a file from JFIF to PNM -using jpegtopnm, +using jpegtopnm, then transform it, then convert it back to JFIF with -pnmtojpeg, and you don't know whether or not it includes an EXIF header. -jpegtopnm +pnmtojpeg, and you don't know whether or not it includes an EXIF header. +jpegtopnm creates an EXIF file containing nothing but two bytes of zero when the input JFIF file has no EXIF header. Thus, you can transfer any EXIF header from the input JFIF to the output JFIF without worrying about whether an EXIF header actually exists. -
+
The contents of the EXIF file after the length field are the exact byte for byte contents of the APP1 marker, not counting the length field, that constitutes the EXIF header. -
-quality=n +
-quality=n -
Scale quantization tables to adjust image quality. n is 0 +
Scale quantization tables to adjust image quality. n is 0 (worst) to 100 (best); default is 75. Below about 25 can produce images some interpreters won't be able to interpret. See below for more info. -
-grayscale -
-greyscale +
-grayscale +
-greyscale
-rgb
These options determine the color space used in the JFIF output. @@ -129,7 +134,7 @@ The extra CPU time probably indicates that processing of all the extra compressed data consumed all the CPU time saved by not having to convert the RGB inputs to YCbCr. -
Grayscale format takes up a lot less space and takes less time to create +
Grayscale format takes up a lot less space and takes less time to create and process than the color formats, even if the image contains nothing but black, white, and gray. @@ -173,30 +178,30 @@ image. pnmtojpeg always created a JFIF with a density of 1x1 in unspecified units. -
-optimize +
-optimize -
Perform optimization of entropy encoding parameters. Without -this, pnmtojpeg uses default encoding parameters. --optimize usually makes the JFIF file a little smaller, but -pnmtojpeg runs somewhat slower and needs much more memory. +
Perform optimization of entropy encoding parameters. Without +this, pnmtojpeg uses default encoding parameters. +-optimize usually makes the JFIF file a little smaller, but +pnmtojpeg runs somewhat slower and needs much more memory. Image quality and speed of decompression are unaffected by --optimize. +-optimize. -
-progressive +
-progressive -
+
Create a progressive JPEG file (see below). -
-comment=text +
-comment=text -
+
Include a comment marker in the JFIF output, with comment text -text. +text. Without this option, there are no comment markers in the output. -
+
-
The -quality option lets you trade off compressed file size +
The -quality option lets you trade off compressed file size against quality of the reconstructed image: the higher the quality setting, the larger the JFIF file, and the closer the output image will be to the original input. Normally you want to use the lowest @@ -204,11 +209,11 @@ quality setting (smallest file) that decompresses into something visually indistinguishable from the original image. For this purpose the quality setting should be between 50 and 95 for reasonable results; the default of 75 is often about right. If you see defects -at -quality=75, then go up 5 or 10 counts at a time until you +at -quality=75, then go up 5 or 10 counts at a time until you are happy with the output image. (The optimal setting will vary from one image to another.) -
-quality=100 generates a quantization table of all 1's, +
-quality=100 generates a quantization table of all 1's, minimizing loss in the quantization step (but there is still information loss in subsampling, as well as roundoff error). This setting is mainly of interest for experimental purposes. Quality @@ -216,18 +221,18 @@ values above about 95 are not recommended for normal use; the compressed file size goes up dramatically for hardly any gain in output image quality. -
In the other direction, quality values below 50 will produce very +
In the other direction, quality values below 50 will produce very small files of low image quality. Settings around 5 to 10 might be useful in preparing an index of a large image library, for example. -Try -quality=2 (or so) for some amusing Cubist effects. (Note: +Try -quality=2 (or so) for some amusing Cubist effects. (Note: quality values below about 25 generate 2-byte quantization tables, -which are considered optional in the JFIF standard. pnmtojpeg +which are considered optional in the JFIF standard. pnmtojpeg emits a warning message when you give such a quality value, because some other JFIF programs may be unable to decode the resulting file. -Use -baseline if you need to ensure compatibility at low +Use -baseline if you need to ensure compatibility at low quality values.) -
The -progressive option creates a "progressive +
The -progressive option creates a "progressive JPEG" file. In this type of JFIF file, the data is stored in multiple scans of increasing quality. If the file is being transmitted over a slow communications link, the decoder can use the @@ -245,27 +250,28 @@ JPEG file at all. might consider the JPEG2000 format instead. See pamtojpeg2k. -
Options for advanced users: -
+
Advanced options
+ +
-
-dct=int +
-dct=int -
Use integer DCT method (default). +
Use integer DCT method (default). -
-dct=fast +
-dct=fast -
Use fast integer DCT (less accurate). +
Use fast integer DCT (less accurate). -
-dct=float +
-dct=float -
Use floating-point DCT method. The float method is very slightly +
Use floating-point DCT method. The float method is very slightly more accurate than the int method, but is much slower unless your machine has very fast floating-point hardware. Also note that results of the floating-point method may vary slightly across machines, while the integer methods should give the same results everywhere. The fast integer method is much less accurate than the other two. -
-arithmetic +
-arithmetic
Use arithmetic coding. Default is Huffman encoding. Arithmetic coding tends to get you a smaller result. @@ -286,111 +292,111 @@ with the message, "Sorry, there are legal restrictions on arithmetic coding" or "Sorry, arithmetic coding not supported," this is the problem. -
-restart=n +
-restart=n -
-Emit a JPEG restart marker every n MCU rows, or every n -MCU blocks if you append B to the number. -restart 0 +
+Emit a JPEG restart marker every n MCU rows, or every n +MCU blocks if you append B to the number. -restart 0 (the default) means no restart markers. -
-smooth=n +
-smooth=n -
-Smooth the input image to eliminate dithering noise. n, +
+Smooth the input image to eliminate dithering noise. n, ranging from 1 to 100, indicates the strength of smoothing. 0 (the default) means no smoothing. -
-maxmemory=n +
-maxmemory=n -
+
Set a limit for amount of memory to use in processing large images. Value is in thousands of bytes, or millions of bytes if you append -M to the number. For example, -max=4m -selects 4,000,000 bytes. If pnmtojpeg +M to the number. For example, -max=4m +selects 4,000,000 bytes. If pnmtojpeg needs more space, it will use temporary files. -
-verbose +
-verbose -
+
Print to the Standard Error file messages about the conversion process. This can be helpful in debugging problems. -
+
-
The -restart option tells pnmtojpeg to insert extra +
The -restart option tells pnmtojpeg to insert extra markers that allow a JPEG decoder to resynchronize after a transmission error. Without restart markers, any damage to a compressed file will usually ruin the image from the point of the error to the end of the image; with restart markers, the damage is usually confined to the portion of the image up to the next restart marker. Of course, the restart markers occupy extra space. We -recommend -restart=1 for images that will be transmitted +recommend -restart=1 for images that will be transmitted across unreliable networks such as Usenet. -
The -smooth option filters the input to eliminate +
The -smooth option filters the input to eliminate fine-scale noise. This is often useful when converting dithered images to JFIF: a moderate smoothing factor of 10 to 50 gets rid of dithering patterns in the input file, resulting in a smaller JFIF file and a better-looking image. Too large a smoothing factor will visibly blur the image, however. -
Options for wizards: +
Wizard Options
-
-
-baseline +
+
-baseline -
Force baseline-compatible quantization tables to be generated. +
Force baseline-compatible quantization tables to be generated. This clamps quantization values to 8 bits even at low quality settings. (This switch is poorly named, since it does not ensure that the output is actually baseline JPEG. For example, you can use --baseline and -progressive together.) +-baseline and -progressive together.) -
-qtables=filespec +
-qtables=filespec -
Use the quantization tables given in the specified text file. +
Use the quantization tables given in the specified text file. -
-qslots=n[,...] +
-qslots=n[,...] -
Select which quantization table to use for each color component. +
Select which quantization table to use for each color component. -
-sample=HxV[,...] +
-sample=HxV[,...] -
Set JPEG sampling factors for each color component. +
Set JPEG sampling factors for each color component. -
-scans=filespec +
-scans=filespec -
Use the scan script given in the specified text file. See below +
Use the scan script given in the specified text file. See below for information on scan scripts. -
-tracelevel=N +
-tracelevel=N -
This sets the level of debug tracing the program outputs as it runs. +
This sets the level of debug tracing the program outputs as it runs. 0 means none, and is the default. This level primarily controls tracing of the JPEG library, and you can get some pretty interesting information about the compression process. -
+
-
The "wizard" options are intended for experimentation +
The "wizard" options are intended for experimentation with JPEG. If you don't know what you are doing, don't use them. These switches are documented further in the file wizard.doc that comes with the Independent JPEG Group's JPEG library. -
EXAMPLES
+
EXAMPLES
-
This example compresses the PPM file foo.ppm with a quality factor +
This example compresses the PPM file foo.ppm with a quality factor of 60 and saves the output as foo.jpg:
- pnmtojpeg -quality=60 foo.ppm > foo.jpg + pnmtojpeg -quality=60 foo.ppm > foo.jpg

Here's a more typical example. It converts from BMP to JFIF:
- cat foo.bmp | bmptoppm | pnmtojpeg > foo.jpg + cat foo.bmp | bmptoppm | pnmtojpeg > foo.jpg
-
JPEG Loss
+
JPEG LOSS

When you compress with JPEG, you lose information -- i.e. the resulting image has somewhat lower quality than the original. This is a characteristic @@ -400,24 +406,24 @@ to JFIF, you will lose quality. The more you do it, the more you lose. Drawings (charts, cartoons, line drawings, and such with few colors and sharp edges) suffer the most. -
To avoid this, you can use a compressed image format other than +
To avoid this, you can use a compressed image format other than JPEG. PNG and JPEG2000 are good choices, and Netpbm contains converters for those.
If you need to use JFIF on a drawing, you should experiment with -pnmtojpeg's -quality and -smooth options to get a -satisfactory conversion. -smooth 10 or so is often helpful. +pnmtojpeg's -quality and -smooth options to get a +satisfactory conversion. -smooth 10 or so is often helpful. -
Because of the loss, you should do all the manipulation you have to +
Because of the loss, you should do all the manipulation you have to do on the image in some other format and convert to JFIF as the last step. And if you can keep a copy in the original format, so much the better. -The -optimize option to pnmtojpeg is worth using when +The -optimize option to pnmtojpeg is worth using when you are making a "final" version for posting or archiving. It's also a win when you are using low quality settings to make very small JFIF files; the percentage improvement is often a lot more than -it is on larger files. (At present, -optimize mode is +it is on larger files. (At present, -optimize mode is automatically in effect when you generate a progressive JPEG file).
You can do flipping and rotating transformations losslessly with @@ -426,118 +432,123 @@ Jpeg Group's JPEG library. jpegtran exercises its intimate knowledge of the way JPEG works to do the transformation without ever actually decompressing the image. -
+
OTHER PROGRAMS
-
Another program, cjpeg, is similar. cjpeg is +
Another program, cjpeg, is similar. cjpeg is maintained by the Independent JPEG Group and packaged with the JPEG -library which pnmtojpeg uses for all its JPEG work. Because of +library which pnmtojpeg uses for all its JPEG work. Because of that, you may expect it to exploit more current JPEG features. Also, -since you have to have the library to run pnmtojpeg, but not -vice versa, cjpeg may be more commonly available. +since you have to have the library to run pnmtojpeg, but not +vice versa, cjpeg may be more commonly available. -
On the other hand, cjpeg does not use the NetPBM libraries -to process its input, as all the NetPBM tools such as pnmtojpeg +
On the other hand, cjpeg does not use the NetPBM libraries +to process its input, as all the NetPBM tools such as pnmtojpeg do. This means it is less likely to be consistent with all the other programs that deal with the NetPBM formats. Also, the command syntax -of pnmtojpeg is consistent with that of the other Netpbm tools, -unlike cjpeg. +of pnmtojpeg is consistent with that of the other Netpbm tools, +unlike cjpeg. -
SCAN SCRIPTS
+
SCAN SCRIPTS
-
Use the -scan option to specify a scan script. Or use the --progressive option to specify a particular built-in scan +
Use the -scan option to specify a scan script. Or use the +-progressive option to specify a particular built-in scan script. -
Just what a scan script is, and the basic format of the scan script -file, is covered in the wizard.doc file that comes with the +
Just what a scan script is, and the basic format of the scan script +file, is covered in the wizard.doc file that comes with the Independent JPEG Group's JPEG library. Scan scripts are same for -pnmtojpeg as the are for cjpeg. +pnmtojpeg as the are for cjpeg. -
This section contains additional information that isn't, but +
This section contains additional information that isn't, but probably should be, in that document. -
First, there are many restrictions on what is a valid scan script. -The JPEG library, and thus pnmtojpeg, checks thoroughly for any +
First, there are many restrictions on what is a valid scan script. +The JPEG library, and thus pnmtojpeg, checks thoroughly for any lack of compliance with these restrictions, but does little to tell you how the script fails to comply. The messages are very general and sometimes untrue. -
+
To start with, the entries for the DC coefficient must come before any entries for the AC coefficients. The DC coefficient is Coefficient 0; all the other coefficients are AC coefficients. So in an entry for the DC coefficient, the two numbers after the colon must be 0 and 0. In an entry for AC coefficients, the first number after the colon must not be 0. -
+
In a DC entry, the color components must be in increasing order. E.g. "0,2,1" before the colon is wrong. So is "0,0,0". -
+
In an entry for an AC coefficient, you must specify only one color component. I.e. there can be only one number before the colon. -
+
In the first entry for a particular coefficient for a particular color component, the "Ah" value must be zero, but the Al value can be any valid bit number. In subsequent entries, Ah must be the Al value from the previous entry (for that coefficient for that color component), and the Al value must be one less than the Ah value. -
+
The script must ultimately specify at least some of the DC coefficient for every color component. Otherwise, you get the error message "Script does not transmit all the data." You need not specify all of the bits of the DC coefficient, or any of the AC coefficients. -
+
There is a standard option in building the JPEG library to omit scan script capability. If for some reason your library was built with this option, you get the message "Requested feature was omitted at compile time." -
ENVIRONMENT
+
ENVIRONMENT
-
-
JPEGMEM +
+
JPEGMEM -
If this environment variable is set, its value is the default +
If this environment variable is set, its value is the default memory limit. The value is specified as described for the --maxmemory option. An explicit -maxmemory option -overrides any JPEGMEM. +-maxmemory option. An explicit -maxmemory option +overrides any JPEGMEM. -
+
-
SEE ALSO
+
SEE ALSO
-jpegtopnm, -pnm, -cjpeg man page, -djpeg man page, -jpegtran man page, -rdjpgcom man page, -wrjpgcom man page +jpegtopnm, +pnm, +cjpeg man page, +djpeg man page, +jpegtran man page, +rdjpgcom man page, +wrjpgcom man page
Wallace, Gregory K. "The JPEG Still Picture Compression Standard", Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44. -
AUTHOR
+
AUTHOR
-pnmtojpeg and this manual were derived in large part from -cjpeg, by the Independent JPEG Group. The program is otherwise +pnmtojpeg and this manual were derived in large part from +cjpeg, by the Independent JPEG Group. The program is otherwise by Bryan Henderson on March 07, 2000. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
EXAMPLES -
JPEG LOSS -
OTHER PROGRAMS -
SCAN SCRIPTS -
ENVIRONMENT -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
+
Basic Options +
Advanced options +
Wizard Options +
+
EXAMPLES +
JPEG LOSS +
OTHER PROGRAMS +
SCAN SCRIPTS +
ENVIRONMENT +
SEE ALSO +
AUTHOR +
+ + diff --git a/pnmtopng.html b/pnmtopng.html index 167291aa..e2c3f9bd 100644 --- a/pnmtopng.html +++ b/pnmtopng.html @@ -1,18 +1,17 @@ - - -Pnmtopng User Manual - -
pnmtopng
+ +Pnmtopng User Manual + +
pnmtopng
Updated: 13 March 2019 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
pnmtopng - convert a PNM image to PNG -
SYNOPSIS
+
SYNOPSIS
-pnmtopng +pnmtopng [-verbose] [-downscale] [-interlace] @@ -45,14 +44,14 @@ pnmtopng - convert a PNM image to PNG [-comp_buffer_size=n] [-force] [-libversion] -[pnmfile] +[pnmfile] - +
Obsolete options:
-[-filter n] +[-filter n]
Options available only in older versions: @@ -63,18 +62,18 @@ Options available only in older versions: [-time [yy]yy-mm-dd hh:mm:ss] -
Minimum unique abbreviation of option is acceptable. You may use double +
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. -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm.
pnmtopng reads a PNM image as input and produces a PNG image as output. -
Color component values in PNG files are either eight or sixteen +
Color component values in PNG files are either eight or sixteen bits wide, so pnmtopng will automatically scale colors to have a maxval of 255 or 65535. @@ -98,7 +97,9 @@ power of two minus one (255 and 65535 are good choices) to minimize the error. -
OPTIONS
+
OPTIONS
+ +
Note: Option Syntax of Older Versions

pnmtopng changed in Netpbm 10.30 (October 2005) to use the standard Netpbm command line syntax. Before that, you could not @@ -116,7 +117,7 @@ E.g. The old shell command
- pnmtopng -phys 800 800 0 input.pnm >output.png + pnmtopng -phys 800 800 0 input.pnm > output.png
@@ -124,28 +125,35 @@ E.g. The old shell command
- pnmtopng -size "800 800 0" input.pnm >output.png + pnmtopng -size "800 800 0" input.pnm > output.png

If you're writing a program that needs to work with both new and old -pnmtopng, have it first try with the new syntax, and if it fails +, have it first try with the new syntax, and if it fails with "unrecognized option," fall back to the old syntax. -
-
-verbose -
+
Current Options
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmtopng recognizes the following +command line options: + +
+
-verbose +
This causes pnmtopng to display information about the format of the output file. -
-downscale -
+
-downscale +
This enables pnmtopng to scale maxvalues of more then 65535 to 16 bits. Since this means loss of image data, pnmtopng does not do it by default. -
-interlace -
+
-interlace +
This causes the PNG file to be interlaced, in Adam7 format. The interlaced format is one in which the raster data starts with a low-resolution representation of the entire image, then continues with additional information @@ -161,9 +169,9 @@ gradually paint down to the bottom. But with an interlaced image, the displayer can start by showing a low-resolution version of the image, then gradually improve the display as more data arrives. -
-alpha=filename +
-alpha=filename -
This specifies the transparency (alpha) channel of the image. You supply +
This specifies the transparency (alpha) channel of the image. You supply the transparency channel as a standard PGM transparency mask (see the PGM specification. pnmtopng does not necessarily represents the transparency information as a transparency channel @@ -172,21 +180,21 @@ palette, it will do so in order to make a smaller PNG file. pnmtopng even sorts the palette so it can omit the opaque colors from the transparency part of the palette and save space for the palette. -
-transparent=color -
-pnmtopng marks the specified color as transparent in the PNG image. +
-transparent=color +
+pnmtopng marks the specified color as transparent in the PNG image. -
Specify the color (color) as described for the Specify the color (color) as described for the argument of the pnm_parsecolor() library routine. -E.g. red or -rgb:ff/00/0d. If the color you specify is not present in the -image, pnmtopng selects instead the color in the image that is +E.g. red or +rgb:ff/00/0d. If the color you specify is not present in the +image, pnmtopng selects instead the color in the image that is closest to the one you specify. Closeness is measured as a Cartesian distance between colors in RGB space. If multiple colors are -equidistant, pnmtopng chooses one of them arbitrarily. +equidistant, pnmtopng chooses one of them arbitrarily. -
However, if you prefix your color specification with +
However, if you prefix your color specification with "=", e.g.
@@ -195,19 +203,19 @@ equidistant, pnmtopng chooses one of them arbitrarily.
-
only the exact color you specify will be transparent. If that +
only the exact color you specify will be transparent. If that color does not appear in the image, there will be no transparency. -pnmtopng issues an information message when this is the case. +pnmtopng issues an information message when this is the case. -
-background=color -
+
-background=color +
Causes pnmtopng to create a background color chunk in the PNG output which can be used for subsequent transparency channel or transparent color conversions. Specify color the same as for -transparent. -
-palette=palettefile +
-palette=palettefile -
This option specifies a palette to use in the PNG. It forces +
This option specifies a palette to use in the PNG. It forces pnmtopng to create the paletted (colormapped) variety of PNG -- if that isn't possible, pnmtopng fails. If the palette you specify doesn't contain exactly the colors in the image, @@ -217,10 +225,10 @@ only reason you would specify the -palette option is if you care in what order the colors appear in the palette. The PNG palette has colors in the same order as the palette you specify. -
You specify the palette by naming a PPM file that has one pixel for +
You specify the palette by naming a PPM file that has one pixel for each color in the palette. -
Alternatively, consider the case that have a palette and you want +
Alternatively, consider the case that have a palette and you want to make sure your PNG contains only colors from the palette, approximating if necessary. You don't care what indexes the PNG uses internally for the colors (i.e. the order of the PNG palette). In @@ -229,9 +237,9 @@ image and your palette PPM through pnmremap. Though you might think it would, using -palette in this case wouldn't even save pnmtopng any work. -
-gamma=value +
-gamma=value -
Causes pnmtopng to create a gAMA chunk. This information helps +
Causes pnmtopng to create a gAMA chunk. This information helps describe how the color values in the PNG must be interpreted. Without the gAMA chunk, whatever interprets the PNG must get this information separately (or just assume something standard). If your input is a true @@ -243,14 +251,14 @@ have digital computational ability. Also, some simple programs that generate images from scratch do it with a gamma transfer in which the gamma value is 1.0. -
-hist +
-hist -
Use this parameter to create a chunk that specifies the frequency +
Use this parameter to create a chunk that specifies the frequency (or histogram) of the colors in the image. -
-text=filename +
-text=filename -
+
This option lets you include arbitrary text strings in the PNG output, as tEXt chunks. @@ -286,9 +294,9 @@ delimiter characters after it, plus the text in subsequent continuation lines.
There is no limit on the length of a file line or entry or key or text string. There is no limit on the number of entries. -
-ztxt=filename +
-ztxt=filename -
The same as -text, except the text string is compressed in the PNG +
The same as -text, except the text string is compressed in the PNG output. pnmtopng uses zTXt chunks instead of a tEXt chunks, unless the key for the text string starts with "A" or "T". This odd exception exists for backward compatibility; we don't know why the program @@ -296,9 +304,9 @@ was originally designed this way, except that the distinction was meant to roughly identify the keys "Author" and "Title". -
-rgb=chroma_list +
-rgb=chroma_list -
This option specifies how red, green, and blue component values +
This option specifies how red, green, and blue component values of a pixel specify a particular color, by telling the chromaticities of those 3 primary illuminants and of white (i.e. full strength of all three). @@ -317,9 +325,9 @@ arguments. the option -chroma does the same thing, but with slightly different syntax. -
-size="x y unit" +
-size="x y unit" -
This option determines the aspect ratio of the individual pixels +
This option determines the aspect ratio of the individual pixels of your image as well as the physical resolution of it.
unit is either 0 or 1. When it is 1, @@ -363,9 +371,9 @@ more information on what this really means.
This option was new in Netpbm 10.71 (June 2015). Before that, pnmtopng never generates an sRGB chunk. -
-modtime="[yy]yy-mm-dd hh:mm:ss" +
-modtime="[yy]yy-mm-dd hh:mm:ss" -
This option allows you to specify the modification time value to +
This option allows you to specify the modification time value to be placed in the PNG output. You can specify the year parameter either as a two digit or four digit value. @@ -373,9 +381,9 @@ either as a two digit or four digit value. the option -time does the same thing, but with slightly different syntax. -
-filter=n +
-filter=n -
This option is obsolete. Before Netpbm 10.22 (April 2004), this was +
This option is obsolete. Before Netpbm 10.22 (April 2004), this was the only way to specify a row filter. It specifies a single type of row filter, by number, that pnmtopng must use on each row. @@ -399,9 +407,9 @@ you could use the -filter option to specify one permitted row filter type. The default, when you specify no filter options, was the same. -
-compression=n +
-compression=n -
This option sets set the compression level of the zlib +
This option sets set the compression level of the zlib compression. Select a level from 0 for no compression (maximum speed) to 9 for maximum compression (minimum speed). @@ -437,7 +445,7 @@ library knows only one method today, so there's nothing to choose.
This option was new in Netpbm 10.30 (October 2005). -
-comp_window_bits=N +
-comp_window_bits=N
This option tells how big a window the zlib compression algorithm uses. The value is the base 2 logarithm of the window size in bytes, @@ -450,7 +458,7 @@ to 32K).
This option was new in Netpbm 10.30 (October 2005). -
-comp_buffer_size=N +
-comp_buffer_size=N
This option determines in what size pieces pnmtopng does the zlib compression. One compressed piece goes in each IDAT chunk in the @@ -466,9 +474,9 @@ compression buffer) in bytes.
This option was new in Netpbm 10.30 (October 2005). -
-force +
-force -
+
When you specify this, pnmtopng limits its optimizations. The resulting PNG output is as similar to the Netpbm input as possible. For example, the PNG output will not be paletted and the transparency channel will @@ -476,9 +484,9 @@ be represented as a full transparency channel even if the information could be represented more succinctly with a transparency chunk. -
-libversion +
-libversion -
+
This option causes pnmtopng to display version information about itself and the libraries it uses, in addition to all its normal function. Do not confuse this with the Netpbm common @@ -490,31 +498,35 @@ information about the Netpbm library and do nothing else. has changed too much over the history of pnmtopng. The option is good only for human eyes. -
+
-
SEE ALSO
+
SEE ALSO
-pngtopam, -pamtopng, -pnmremap, -pnmgamma, -pnm +pngtopam, +pamtopng, +pnmremap, +pnmgamma, +pnm
For information on the PNG format, see http://schaik.com/png. -
AUTHOR
+
AUTHOR
Copyright (C) 1995-1997 by Alexander Lehmann and Willem van Schaik. -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
+
Note: Option Syntax of Older Versions +
Current Options +
+
SEE ALSO +
AUTHOR +
+ + diff --git a/ppmquantall.html b/ppmquantall.html index fc7fc209..1e0132d7 100644 --- a/ppmquantall.html +++ b/ppmquantall.html @@ -1,17 +1,16 @@ - -Ppmquantall User Manual - -
ppmquantall
+ +Ppmquantall User Manual + +
ppmquantall
Updated: 05 March 2012 -
-Table Of Contents +
-
NAME
+
NAME
-ppmquantall - replaced by pnmquantall +ppmquantall - replaced by pnmquantall -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -25,8 +24,5 @@ before the renaming.
For Netpbm before 10.58, where the program is still named ppmquantall, just use the pnmquantall manual. - - - - - + + diff --git a/ppmshadow.html b/ppmshadow.html index 9683faef..170a783a 100644 --- a/ppmshadow.html +++ b/ppmshadow.html @@ -63,10 +63,7 @@ you don't specify ppmfile, the input is Standard Input.
OPTIONS
-
In addition to the options common to all programs based on libnetpbm -(most notably -quiet, see -Common Options), ppmshadow recognizes the following -command line options: +ppmshadow recognizes the following command line options:

-b blur_size @@ -117,6 +114,9 @@ same as the horizontal offset (above), upward.
+
ppmshadow does not recognize the options common to all +programs based on libnetpbm (See +Common Options.) However, the -version option works.
LIMITATIONS
diff --git a/ppmtoilbm.html b/ppmtoilbm.html index ca06b813..b94c31a8 100644 --- a/ppmtoilbm.html +++ b/ppmtoilbm.html @@ -1,61 +1,61 @@ - -Ppmtoilbm User Manual - -
ppmtoilbm
+ +Ppmtoilbm User Manual + +
ppmtoilbm
Updated: 28 June 2015 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
ppmtoilbm - convert a PPM image into an ILBM file -
SYNOPSIS
+
SYNOPSIS
-ppmtoilbm +ppmtoilbm -[-maxplanes|-mp N] +[-maxplanes|-mp N] -[-fixplanes|-fp N] +[-fixplanes|-fp N] -[-ham6|-ham8] +[-ham6|-ham8] -[{-dcbits|-dcplanes} r g b] +[{-dcbits|-dcplanes} r g b] [ --normal|-hamif|-hamforce|-24if|-24force| --dcif|-dcforce|-cmaponly +-normal|-hamif|-hamforce|-24if|-24force| +-dcif|-dcforce|-cmaponly ] -[-ecs|-aga] +[-ecs|-aga] -[-compress|-nocompress] +[-compress|-nocompress] -[-cmethod type] +[-cmethod type] -[-map ppmfile] +[-map ppmfile] -[ppmfile] +[ppmfile] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm.
ppmtoilbm reads a PPM image as input. Produces an ILBM file as output. ppmtoilbm understands the following ILBM types: -
+
-
Normal ILBMs with 1-16 planes +
Normal ILBMs with 1-16 planes -
Amiga HAM with 3-16 planes +
Amiga HAM with 3-16 planes -
24 bit +
24 bit -
Color map (BMHD + CMAP chunk only, nPlanes = 0) +
Color map (BMHD + CMAP chunk only, nPlanes = 0) -
Unofficial direct color. 1-16 planes for each color component. +
Unofficial direct color. 1-16 planes for each color component.
@@ -63,110 +63,115 @@ as output. ppmtoilbm understands the following ILBM types: colormap files) unofficial DCOL chunk for direct color ILBM. -
OPTIONS
+
OPTIONS
+ +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), ppmtoilbm recognizes the following +command line options:
Options marked with (*) can be prefixed with a "no", e.g. "-nohamif". All options can be abbreviated to their shortest unique prefix. -
-
-maxplanes | -mp n +
+
-maxplanes | -mp n -
(default 5, minimum 1, maximum 16) Maximum planes to write in a +
(default 5, minimum 1, maximum 16) Maximum planes to write in a normal ILBM. If the image does not fit into <n> planes, ppmtoilbm writes a HAM file (if -hamif is used), a 24bit file (if -24if is used) or a direct color file (if -dcif is used) or aborts with an error. -
-fixplanes | -fp b +
-fixplanes | -fp b -
(min 1, max 16) If a normal ILBM is written, it will have exactly +
(min 1, max 16) If a normal ILBM is written, it will have exactly <n> planes. -
-hambits | -hamplanes n +
-hambits | -hamplanes n -
(default 6, min 3, max 16) Select number of planes for HAM -picture. The current Amiga hardware supports 6 and 8 planes, so for +
(default 6, min 3, max 16) Select number of planes for HAM +picture. The current Amiga hardware understands 6 and 8 planes, so for now you should only use this values. -
-normal +
-normal -
Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and +
Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and -cmaponly. Also sets compression type to byterun1.
This is the default. -
-hamif (*) -
-24if (*) -
-dcif (*) +
-hamif (*) +
-24if (*) +
-dcif (*) -
Write a HAM/24bit/direct color file if the image does not fit into +
Write a HAM/24bit/direct color file if the image does not fit into <maxplanes> planes. -
-hamforce (*) -
-24force (*) -
-dcforce (*) +
-hamforce (*) +
-24force (*) +
-dcforce (*) -
Write a HAM/24bit/direct color file. +
Write a HAM/24bit/direct color file. -
-dcbits r g b -
-dcplanes r g b +
-dcbits r g b +
-dcplanes r g b -
(default 5, min 1, max 16). Select number of bits for red, green +
(default 5, min 1, max 16). Select number of bits for red, green and blue in a direct color ILBM. -
-ecs +
-ecs -
Shortcut for: -hamplanes 6 -maxplanes 5 +
Shortcut for: -hamplanes 6 -maxplanes 5
This is the default. -
-aga +
-aga -
Shortcut for: -hamplanes 8 -maxplanes 8 +
Shortcut for: -hamplanes 8 -maxplanes 8 -
-ham6 +
-ham6 -
Shortcut for: -hamplanes 6 -hamforce +
Shortcut for: -hamplanes 6 -hamforce -
-ham8 +
-ham8 -
Shortcut for: -hamplanes 8 -hamforce +
Shortcut for: -hamplanes 8 -hamforce -
-compress (*) +
-compress (*) -
This is the default. +
This is the default. -
Compress the BODY chunk. The default compression method is +
Compress the BODY chunk. The default compression method is byterun1. Compression requires building the ILBM image in memory; turning compression off allows stream-writing of the image, but the resulting file will usually be 30% to 50% larger. Another alternative is the -savemem option, this will keep memory requirements for compression at a minimum, but is very slow. -
-cmethod none|byterun1 +
-cmethod none|byterun1 -
This option does the same thing as -compress. +
This option does the same thing as -compress. -
-map ppmfile +
-map ppmfile -
Write a normal ILBM using the colors in <ppmfile> as the +
Write a normal ILBM using the colors in <ppmfile> as the colormap. The colormap file also determines the number of planes, a -maxplanes or -fixplanes option is ignored. -
-cmaponly +
-cmaponly -
Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, +
Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, nPlanes = 0. -
-savemem +
-savemem -
See the -compress option. +
See the -compress option. -
+
-
LIMITATIONS
+
LIMITATIONS

HAM pictures will always get a grayscale colormap; a real color selection algorithm might give better results. On the other hand, @@ -175,17 +180,17 @@ the same depth (no. of planes) share a common colormap, which is useful for building HAM animations. -
REFERENCES
+
REFERENCES
Amiga ROM Kernel Reference Manual - Devices (3rd Ed.) -
+
Addison Wesley, ISBN 0-201-56775-X -
SEE ALSO
+
SEE ALSO
-ppm, -ilbmtoppm +ppm, +ilbmtoppm
HISTORY
@@ -193,25 +198,25 @@ Addison Wesley, ISBN 0-201-56775-X
For about a year in 1993-1994, there was a -savemem option. -
AUTHORS
+
AUTHORS

Copyright (C) 1989 by Jef Poskanzer. -
Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de) - - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
LIMITATIONS -
REFERENCES -
SEE ALSO -
HISTORY -
AUTHORS -
- - +
Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de) + + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
LIMITATIONS +
REFERENCES +
SEE ALSO +
HISTORY +
AUTHORS +
+ + diff --git a/ppmtomitsu.html b/ppmtomitsu.html index bb65f1f1..e03d14a8 100644 --- a/ppmtomitsu.html +++ b/ppmtomitsu.html @@ -36,7 +36,7 @@ ppmtomitsu - convert a PPM image to a Mitsubishi S340-10 file format suitable to be printed by a Mitsubishi S340-10 printer, or any other Mitsubishi color sublimation printer. -
The Mitsubishi S340-10 Color Sublimation printer supports 24bit +
The Mitsubishi S340-10 Color Sublimation printer can print in 24 bit color. Images of the available sizes take so long to transfer that there is a fast method, employing a lookuptable, that ppmtomitsu will use if there is a maximum of 256 colors in the image. ppmtomitsu @@ -50,8 +50,8 @@ printer. The printer understands putting together images in the printers memory; ppmtomitsu doesn't utilize this as pnmcat etc provide the same functionality and let you view the result on-screen, too. The S340-10 is the lowest common denominator printer; for higher -resolution printers there's the dpi300 option. The other printers also -support higher values for enlarge eg, but I don't think that's +resolution printers there's the dpi300 option. The other printers are also +capable of higher values for enlarge eg, but I don't think that's essential enough to warrant a change in the program.
For proper results, the input maxval must be 255. Use pamdepth diff --git a/ppmtoterm.html b/ppmtoterm.html index 23ac56c0..e25f73d0 100644 --- a/ppmtoterm.html +++ b/ppmtoterm.html @@ -1,30 +1,30 @@ - -Ppmtoterm User Manual - -
ppmtoterm
+ +Ppmtoterm User Manual + +
ppmtoterm
Updated: 17 June 2017 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image -
SYNOPSIS
+
SYNOPSIS
-ppmtoterm +ppmtoterm -[ppmfile] +[ppmfile] -
All options can be abbreviated to their shortest unique prefix. +
All options can be abbreviated to their shortest unique prefix. 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
+
DESCRIPTION

This program is part of Netpbm. -
This program tries to produce an accurate representation of a PPM +
This program tries to produce an accurate representation of a PPM image on an terminal that implements the ANSI ISO 6429 standard. It approximates colors, finding the minimum Cartesian distance between the input RGB vectors and the ones in the generated palette. As the @@ -32,11 +32,11 @@ available color palette is somewhat restricted, you get the best results when the colors in the original image are few and the RGB intensities are close to zero, half of maximum, and maximum. -
You can usually get good results with cartoons or images with +
You can usually get good results with cartoons or images with plain colors (no gradients). With photos, results can vary, but are usually not very accurate. -
The output image has one line for each row and one character for each +
The output image has one line for each row and one character for each column of the input image. E.g. an 80 pixel by 25 pixel PPM image would fill up an 80x25 terminal screen. Use pamscale or pamcut to make your image fit properly on your screen. @@ -48,12 +48,12 @@ appear square on your terminal, as it should, you'll want to squash it vertically or stretch it horizontally by a factor of two (resulting int 10x20 characters are 20x40 characters). -
The image starts at the current cursor position on the terminal +
The image starts at the current cursor position on the terminal screen. Each successive row starts at Column 0 on the screen. If you want to shift the image up or down, for example to center it, use pnmpad on the input. -
This program was born with the objective of displaying nice color +
This program was born with the objective of displaying nice color images on the Linux console, e.g. a proper logo at Linux boot.
ppmtoascii does a similar things, but combines 2 or 8 pixels into @@ -64,41 +64,42 @@ pixel.
pbmto4425 does a similar thing for black and white images, using line drawing characters, on some terminals. -
OPTIONS
+
OPTIONS
-
-None. +
There are no command line options defined specifically +for ppmtoterm, but it recognizes the options common to all +programs based on libnetpbm (See +Common Options.) +
SEE ALSO
-
SEE ALSO
+pamscale, +pamcut, +ppmtoascii, +pbmtoascii, +pbmto4425, +ppm -pamscale, -pamcut, -ppmtoascii, -pbmtoascii, -pbmto4425, -ppm - -
AUTHOR
+
AUTHOR
Copyright (C) 2002 by Ero Carrera. -
HISTORY
- -
This program was new in Netpbm 10.9 (August 2002). +
HISTORY
+
This program was new in Netpbm 10.9 (August 2002). -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION -
OPTIONS -
SEE ALSO -
AUTHOR -
- - +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
OPTIONS +
SEE ALSO +
AUTHOR +
HISTORY +
+ + diff --git a/rletopnm.html b/rletopnm.html index 93a4d267..8a912be9 100644 --- a/rletopnm.html +++ b/rletopnm.html @@ -132,7 +132,7 @@ Army High Performance Computing Research Center (AHPCRC) Minnesota Supercomputer Center, Inc. -
Modifications by Eric Haines to support raw and plain formats. +
Modifications by Eric Haines to produce raw and plain formats.
Modifications by Bryan Henderson to create transparency files and use mnemonic options. diff --git a/tifftopnm.html b/tifftopnm.html index c0526212..af540dfc 100644 --- a/tifftopnm.html +++ b/tifftopnm.html @@ -1,30 +1,30 @@ - -Tifftopnm User Manual - -
tifftopnm
+ +Tifftopnm User Manual + +
tifftopnm
Updated: 02 January 2015 -
-Table Of Contents +
+Table Of Contents -
NAME
+
NAME
tifftopnm - convert a TIFF file into a PNM image -
SYNOPSIS
+
SYNOPSIS
-tifftopnm +tifftopnm -[-alphaout={alpha-filename,-}] -[-headerdump] +[-alphaout={alpha-filename,-}] +[-headerdump] [-verbose]
-[-respectfillorder] -[-byrow] -[-orientraw] -[tiff-filename] +[-respectfillorder] +[-byrow] +[-orientraw] +[tiff-filename] -
DESCRIPTION
+
DESCRIPTION

This program is part of Netpbm. @@ -39,9 +39,9 @@ which type it is writing. output stream. Before Netpbm 10.27 (March 2005), however, it would just ignore all but the first input image. -
The tiff-filename argument names the file that contains the Tiff +
The tiff-filename argument names the file that contains the Tiff image. If you specify "-" or don't specify this -argument, tifftopnm uses Standard Input. +argument, tifftopnm uses Standard Input.
In either case, before Netpbm 10.70 (March 2015), the file must be seekable. That means no pipe, but any regular file is fine. In current @@ -49,14 +49,13 @@ Netpbm, the file need not be seekable, but if it isn't, tifftopnm creates a temporary regular file containing the entire image, so you must have resources for that (and it may defeat your reason for using a pipe). -
TIFF Capability

pamtotiff uses the Libtiff.org TIFF library (or whatever equivalent you provide) to interpret the TIFF input. So the set of files it is able to interpret is determined mostly by that library. -
This program cannot read every possible TIFF file -- there are +
This program cannot read every possible TIFF file -- there are myriad variations of the TIFF format. However, it does understand monochrome and gray scale, RGB, RGBA (red/green/blue with transparency channel), CMYK (Cyan-Magenta-Yellow-Black ink color separation), and @@ -77,91 +76,96 @@ intelligence. That native intelligence does not know as many formats as TIFFRGBAImageGet() does. And certain compressed formats simply cannot be read with TIFFReadScanLine(). -
Before Netpbm 10.11 (October 2002), tifftopnm never used +
Before Netpbm 10.11 (October 2002), tifftopnm never used TIFFRGBAImageGet(), so it could not interpret many of the formats it can interpret today. -
There is no fundamental reason that this program could not read +
There is no fundamental reason that this program could not read other kinds of TIFF files even when they don't fit in memory all at once. The existing limitations are mainly because no one has asked for more.
Output Image
-
The PNM output has the same maxval as the Tiff input, except that +
The PNM output has the same maxval as the Tiff input, except that if the Tiff input is colormapped (which implies a maxval of 65535) the PNM output has a maxval of 255. Though this may result in lost information, such input images hardly ever actually have more color resolution than a maxval of 255 provides and people often cannot deal with PNM files that have maxval > 255. By contrast, a non-colormapped Tiff image that doesn't need a maxval > 255 doesn't -have a maxval > 255, so when tifftopnm sees a +have a maxval > 255, so when tifftopnm sees a non-colormapped maxval > 255, it takes it seriously and produces a matching output maxval. -
Another exception is where the TIFF maxval is greater than 65535, +
Another exception is where the TIFF maxval is greater than 65535, which is the maximum allowed by the Netpbm formats. In that case, tifftopnm uses a maxval of 65535, and you lose some information in the conversion. -
OPTIONS
+
OPTIONS
-
You may abbreviate any option to its shortest unique prefix. You may use +
In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), tifftopnm recognizes the following +command line options: + +
You may abbreviate any option to its shortest unique prefix. You may use two hyphens instead of one in options. You may separate an option and its value either by an equals sign or white space. -
-
-alphaout=alpha-filename +
+
-alphaout=alpha-filename -
tifftopnm creates a PGM file containing the alpha channel +
tifftopnm creates a PGM file containing the alpha channel values in the input image. If the input image doesn't contain a -transparency channel, the alpha-filename file contains all zero -(transparent) transparency values. If you don't specify -alphaout, +transparency channel, the alpha-filename file contains all zero +(transparent) transparency values. If you don't specify -alphaout, -tifftopnm does not generate a transparency file, and if the input -image has an transparency channel, tifftopnm simply discards it. +tifftopnm does not generate a transparency file, and if the input +image has an transparency channel, tifftopnm simply discards it. -
If you specify - as the filename, tifftopnm +
If you specify - as the filename, tifftopnm writes the transparency output to Standard Output and discards the image. -
See pamcomp for one way to use +
See pamcomp for one way to use the transparency output file. -
-respectfillorder +
-respectfillorder -
By default, tifftopnm ignores the "fillorder" +
By default, tifftopnm ignores the "fillorder" tag in the TIFF input, which means it may incorrectly interpret the image. To make it follow the spec, use this option. For a lengthy -but engaging discussion of why tifftopnm works this way and how -to use the -respectfillorder option, see the note on fillorder +but engaging discussion of why tifftopnm works this way and how +to use the -respectfillorder option, see the note on fillorder below. -
-byrow +
-byrow -
This option can make tifftopnm run faster. +
This option can make tifftopnm run faster. -
tifftopnm has two ways to do the conversion from Tiff to PNM, using +
tifftopnm has two ways to do the conversion from Tiff to PNM, using respectively two facilities of the TIFF library: -
+
-
Whole Image +
Whole Image -
Decode the entire image into memory at once, using +
Decode the entire image into memory at once, using TIFFRGBAImageGet(), then convert to PNM and output row by row. -
Row By Row -
Read, convert, and output one row at a time +
Row By Row +
Read, convert, and output one row at a time using TIFFReadScanline() -
+
-
Whole Image is preferable because the Tiff library does more of the +
Whole Image is preferable because the Tiff library does more of the work, which means it understands more of the Tiff format possibilities now and in the future. Also, some compressed TIFF formats don't allow you to extract an individual row. -
Row By Row uses far less memory, which means with large images, it +
Row By Row uses far less memory, which means with large images, it can run in environments where Whole Image cannot and may also run faster. And because Netpbm code does more of the work, it's possible that it can be more flexible or at least give better diagnostic @@ -170,13 +174,13 @@ information if there's something wrong with the TIFF.
The Netpbm native code may do something correctly that the TIFF library does incorrectly, or vice versa. -
In Netpbm, we stress function over performance, so by default we +
In Netpbm, we stress function over performance, so by default we try Whole Image first, and if we can't get enough memory for the decoded image or TIFFRGBAImageGet() fails, we fall back to Row By Row. But if you specify the -byrow option, tifftopnm will not attempt Whole Image. If Row By Row does not work, it simply fails. -
See Color Separation (CMYK) TIFFs for a +
See Color Separation (CMYK) TIFFs for a description of one way Row By Row makes a significant difference in your results. @@ -185,13 +189,13 @@ your results. tifftopnm then scales them back to maxval 65535, but the lower 8 bits of information is gone. -
In many versions of the TIFF library, TIFFRGBAImageGet() does not +
In many versions of the TIFF library, TIFFRGBAImageGet() does not correctly interpret TIFF files in which the raster orientation is column-major (i.e. a row of the raster is a column of the image). With such a TIFF library and file, you must use -byrow to get correct output. -
Before Netpbm 10.11 (October 2002), tifftopnm always did Row +
Before Netpbm 10.11 (October 2002), tifftopnm always did Row By Row. Netpbm 10.12 always tried Whole Image first. -byrow came in with Netpbm 10.13 (January 2003). @@ -230,18 +234,18 @@ that have an orientation other than the common one.
Print extra messages to Standard Error about the conversion. -
-headerdump +
-headerdump -
Dump TIFF file information to stderr. This information may be useful +
Dump TIFF file information to stderr. This information may be useful in debugging TIFF file conversion problems. -
+
-
NOTES
+
NOTES
-
Fillorder
+
Fillorder
-
+
There is a piece of information in the header of a TIFF image called "fillorder." The TIFF specification quite clearly states that this value tells the order in which bits are arranged in a byte @@ -250,42 +254,42 @@ assuming that the image has a format where more than one pixel can be represented by a single byte: 1) the byte is filled from most significant bit to least significant bit going left to right in the image; and 2) the opposite. -
+
However, there is confusion in the world as to the meaning of fillorder. Evidence shows that some people believe it has to do with byte order when a single value is represented by two bytes. -
+
These people cause TIFF images to be created that, while they use a MSB-to-LSB fillorder, have a fillorder tag that says they used LSB-to-MSB. A program that properly interprets a TIFF image will not end up with the image that the author intended in this case. -
-For a long time, tifftopnm did not understand fillorder itself +
+For a long time, tifftopnm did not understand fillorder itself and assumed the fillorder was MSB-to-LSB regardless of the fillorder tag in the TIFF header. And as far as I know, there is no legitimate reason to use a fillorder other than MSB-to-LSB. So users of -tifftopnm were happily using those TIFF images that had +tifftopnm were happily using those TIFF images that had incorrect fillorder tags. -
-So that those users can continue to be happy, tifftopnm today +
+So that those users can continue to be happy, tifftopnm today continues to ignore the fillorder tag unless you tell it not to. (It does, however, warn you when the fillorder tag does not say MSB-to-LSB that the tag is being ignored). -
+
If for some reason you have a TIFF image that actually has LSB-to-MSB fillorder, and its fillorder tag correctly indicates that, you must -use the -respectfillorder option on tifftopnm to get +use the -respectfillorder option on tifftopnm to get proper results. -
-Examples of incorrect TIFF images are at ftp://weather.noaa.gov. They are -apparently created by a program called faxtotiff. +
+Examples of incorrect TIFF images are at ftp://weather.noaa.gov. They are +apparently created by a program called faxtotiff. -
+
This note was written on January 1, 2002. -
Color Separation (CMYK) TIFFs
+
Color Separation (CMYK) TIFFs

Some TIFF images contain color information in CMYK form, whereas PNM images use RGB. There are various formulas for converting between these @@ -307,36 +311,36 @@ Row By Row mode. Y=(1-K)*(1-B) formula always. -
SEE ALSO
+
SEE ALSO
-pnmtotiff, -pnmtotiffcmyk, -pamcomp, -pnm +pnmtotiff, +pnmtotiffcmyk, +pamcomp, +pnm -
AUTHOR
+
AUTHOR

Derived by Jef Poskanzer from tif2ras.c, which is Copyright (c) -1990 by Sun Microsystems, Inc. Author: Patrick J. Naughton (naughton@wind.sun.com). - -
-
Table Of Contents
-
-
SYNOPSIS -
DESCRIPTION +1990 by Sun Microsystems, Inc. Author: Patrick J. Naughton (naughton@wind.sun.com). + +
+
Table Of Contents
+
+
SYNOPSIS +
DESCRIPTION +
+
TIFF Capability +
Output Image +
+
OPTIONS +
NOTES
-
Tiff Capability -
Output Image -
-
OPTIONS -
NOTES -
-
Fillorder -
Color Separation (CMYK) TIFFs -
-
SEE ALSO -
AUTHOR -
- - +
Fillorder +
Color Separation (CMYK) TIFFs +
+
SEE ALSO +
AUTHOR +
+ + diff --git a/winicon.html b/winicon.html index 81748bf9..71c83b4d 100644 --- a/winicon.html +++ b/winicon.html @@ -73,11 +73,11 @@ invented in the mid-eighties for Windows 1:

Windows 1 used monochrome 32x32 icons only.
Windows 3.0 added color icons with bpp values up to 8. -
Windows 4.0 (a.k.a. Windows95) added support for 32-bpp images and +
Windows 4.0 (a.k.a. Windows95) added option for 32-bpp images and resolutions up to 256 by 256. -
NT 5.1 (a.k.a. Windows XP) added support for the 8-bit +
NT 5.1 (a.k.a. Windows XP) added option for the 8-bit transparency channel in the unused bits of 32-bpp images. -
NT 6.0 (a.k.a. Windows Vista) added support for PNG +
NT 6.0 (a.k.a. Windows Vista) added option for PNG encoded images
-- cgit 1.4.1

OPTIONS

SEE ALSO

hpcdtoppm

NAME

hpcdtoppm

NAME

SYNOPSIS

DESCRIPTION

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS

Postcript Output

POSTSCRIPT OUTPUT

Limitations

LIMITATIONS

SEE ALSO

SEE ALSO

VERSION

VERSION

AUTHOR

AUTHOR

Table Of Contents

Table Of Contents

icontopbm

icontopbm

NAME

NAME

SYNOPSIS

SYNOPSIS

DESCRIPTION

DESCRIPTION

Jbigtopnm

jbigtopnm

NAME

NAME

SYNOPSIS

SYNOPSIS

DESCRIPTION

DESCRIPTION

OPTIONS

OPTIONS

STANDARDS

STANDARDS

AUTHOR

AUTHOR

SEE ALSO

SEE ALSO

LICENSE

LICENSE

Table Of Contents

Table Of Contents

JPEGTOPNM

jpegtopnm

NAME

NAME

SYNOPSIS

SYNOPSIS

DESCRIPTION

DESCRIPTION

OPTIONS

OPTIONS

EXAMPLES

EXAMPLES

HINTS

HINTS

ENVIRONMENT

ENVIRONMENT

SEE ALSO

SEE ALSO

AUTHOR

AUTHOR

Table Of Contents

Table Of Contents

DESCRIPTION

pam

pam

GENERAL

GENERAL

The Confusing Universe of Netpbm Formats