ppmtoxpm - convert a PPM iamge into an X11 pixmap
SYNOPSIS
ppmtoxpm [-name=xpmname] [-rgb=rgb-textfile]
[-alphamask=pgmfile] [ppmfile]
Minimum unique abbrevations are acceptable.
DESCRIPTION
Reads a portable pixmap as input. Produces X11 pixmap
(version 3) as output which can be loaded directly by the
XPM library.
For example, to convert the file "dot" (found in
/usr/include/X11/bitmaps), from xbm to xpm one could spec
ify
xbmtopbm dot | ppmtoxpm -name dot
or, with a rgb text file (in the local directory)
xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt
OPTIONS
-name=xpmname
The -name option allows you to specify the prefix
string which is printed in the resulting XPM out
put. If not specified, will default to the file
name (without extension) of the <ppmfile> argument.
If you do not specify -name or ppmfile, (i.e. your
input is from Standad Input), the prefix string
defaults to the string noname.
rgb=rgb-textfile
The -rgb option allows you 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 you don't specify -rgb or
if the RGB values don't match, then ppmtoxpm pro
duces the color specifications in the #RGB,
#RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal
format.
This option names a PGM file to use as an alpha
(transparency) mask. The file must contain an
image the same dimensions as the input image. ppm
toxpm marks as transparent any pixel whose position
in the alpha mask image is at most half white.
If you don't specify -alphamask, ppmtoxpm makes all
pixels in the output opaque.
ppmcolormask is one way to generate an alpha mask
file. You might also generate it by extracting
transparency information from an XPM file with the
-alphaout option to xpmtoppm. There are similar
options on other Netpbm converters that convert
from formats that include transparency information
too.
LIMITATIONS
An option to match the closest (rather than exact) color
name mnemonic from the rgb text would be a desirable
enhancement.
Truncation of the least significant bits of a RGB value
may result in nonexact matches when performing color name
mnemonic lookups.
SEE ALSO
ppmcolormask(1), xpmtoppm(1), ppm(5)
XPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr
AUTHOR
Copyright (C) 1990 by Mark W. Snitily.
Permission to use, copy, modify, and distribute this soft
ware and its documentation for any purpose 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. This software is provided "as is" without
express or implied warranty.
This tool was developed for Schlumberger Technologies, ATE
Division, and with their permission is being made avail
able to the public with the above copyright notice and
permission notice.
Upgraded to XPM2 by
Paul Breslaw, Mecasoft SA, Zurich, Switzerland
(paul@mecazh.uu.ch)
Thu Nov 8 16:01:17 1990
Arnaud Le Hors (lehors@mirsa.inria.fr)
Tue Apr 9 1991
Man(1) output converted with
man2html