pgmtoppm(1)pgmtoppm(1)NAMEpgmtoppm - colorize a portable graymap into a portable
pixmap
SYNOPSISpgmtoppm colorspec [pgmfile]
pgmtoppm colorspec1-colorspec2 [pgmfile]
pgmtoppm-map mapfile [pgmfile]
DESCRIPTION
Reads a portable graymap as input. Colorizes it by multi-
plying the the gray values by specified color or colors,
and produces a portable pixmap as output.
If only one color is specified, black in the pgm file
stays black and white in the pgm file turns into the spec-
ified color in the ppm file. If two colors (separated by
a dash) are specified, then black gets mapped to the first
color and white gets mapped to the second.
The color can be specified in five ways:
o A name, assuming that a pointer to an X11-style
color names file was compiled in.
o An X11-style hexadecimal specifier: rgb:r/g/b,
where r g and b are each 1- to 4-digit hexadecimal
numbers.
o An X11-style decimal specifier: rgbi:r/g/b, where r
g and b are floating point numbers between 0 and 1.
o For backwards compatibility, an old-X11-style hex-
adecimal number: #rgb, #rrggbb, #rrrgggbbb, or
#rrrrggggbbbb.
o For backwards compatibility, a triplet of numbers
separated by commas: r,g,b, where r g and b are
floating point numbers between 0 and 1. (This
style was added before MIT came up with the similar
rgbi style.)
Also, the -map flag lets you specify an entire colormap to
be used. The mapfile is just a ppm file; it can be any
shape, all that matters is the colors in it and their
order. In this case, black gets mapped into the first
color in the map file, and white gets mapped to the last.
SEE ALSOrgb3toppm(1), ppmtopgm(1), ppmtorgb3(1), ppm(5), pgm(5)AUTHOR
Copyright (C) 1991 by Jef Poskanzer.
11 January 1991 1
