ppmtoxpm (1)

SYNOPSIS

ppmtoxpm [-name <xpmname>] [-rgb <rgb-textfile>] [<ppmfile>]

DESCRIPTION

Reads a portable pixmap as input. Produces X11 pixmap (version 3) as output which can be loaded directly by the XPM library.

The -name\f option allows one to specify the prefix string which is printed in the resulting XPM output. If not specified, will default to the filename (without extension) of the <ppmfile> argument. If -name\f is not specified and <ppmfile> is not specified (i.e. piped input), the prefix string will default to the string "noname".

The -rgb\f option allows one to specify an X11 rgb text file for the lookup of color name mnemonics. This rgb text file is typically the /usr/lib/X11/rgb.txt of the MIT X11 distribution, but any file using the same format may be used. When specified and a RGB value from the ppm input matches a RGB value from the <rgb-textfile>, then the corresponding color name mnemonic is printed in the XPM's colormap. If -rgb\f is not specified, or if the RGB values don't match, then the color will be printed with the #RGB, #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal format.

All flags can be abbreviated to their shortest unique prefix.

For example, to convert the file "dot" (found in /usr/include/X11/bitmaps), from xbm to xpm one could specify

xbmtopbm dot | ppmtoxpm -name dot

or, with a rgb text file (in the local directory)

xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt