SXPM(1) General Commands Manual SXPM(1)NAME
sxpm - Show an XPM (X PixMap) file and/or convert XPM 1 or 2 files to XPM 3.
SYNOPSIS
sxpm [-d displayname] [-g geometry] [-hints] [-icon filename] [-plaid | filename | -] [-o filename | -o -] [-pcmap] [-closecolors] [-nod]
[-nom] [-mono | -grey4 | -grey | -color] [-sc symbol color] [-sp symbol pixel] [-cp color pixel] [-rgb filename] [-v]
DESCRIPTION
The sxpm program can be used to view any XPM (version 1, 2, or 3) file and/or to convert a file from XPM1 or XPM2 to XPM version 3. If sxpm
is run with any dummy option specified, the usage is displayed. If no geometry is specified, the show window will have the size of the read
pixmap. Pressing the key Q in the window will quit the program.
OPTIONS -d display
Specifies the display to connect to.
-g geom Window geometry (default is pixmap's size).
-hints Set ResizeInc for window.
-icon filename
Set icon to pixmap created from the file filename.
-plaid Show the plaid pixmap which is stored as data.
filename
Read from the file filename and from standard input if filename is '-'. If no input is specified sxpm reads from standard input.
-o filename
Write to the file filename (overwrite if it already exists) and to standard output if filename is '-'.
-mono Use the colors specified for a monochrome visual.
-grey4 Use the colors specified for a 4 color greyscale visual.
-grey Use the colors specified for a greyscale visual.
-color Use the colors specified for a color visual.
-pcmap Use a private colormap.
-closecolors
Try to use "close colors" before reverting to other visuals.
-nod Do not display the pixmap in a window. (Useful when using as converter)
-nom Do not use the clipmask if there is any.
-sc symbol colorname
Override default color to symbol to colorname.
-sp symbol pixelvalue
Override default color to symbol to pixelvalue.
-cp colorname pixelvalue
Override default color to colorname to pixelvalue.
-rgb filename
Search color names in the file filename and write them out instead of the rgb values.
-v Verbose - to print out extensions (stderr).
KNOWN BUGS
Some window managers may not accept a pixmap which is not a bitmap as icon because this does not respect ICCCM, many of the well known ones
will accept it though.
AUTHOR
Arnaud Le Hors (lehors@sophia.inria.fr)
Bull Research France
Copyright (C) 1989-95 by Groupe Bull.
SXPM(1)
Check Out this Related Man Page
ppmtoxpm(1) General Commands Manual ppmtoxpm(1)NAME
ppmtoxpm - convert a portable pixmap 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 specify
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 output. If not specified, will
default to the filename (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 produces the color specifications in the
#RGB, #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal format.
-alphamask=pgmfile
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. ppmtoxpm 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 software and its documentation for any purpose and without fee is hereby granted, pro-
vided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in sup-
porting 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 available 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
Upgraded to XPM version 3 by
Arnaud Le Hors (lehors@mirsa.inria.fr)
Tue Apr 9 1991
Tue Apr 9 1991 ppmtoxpm(1)