Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sxpm(1) [x11r4 man page]

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)
Man Page

Featured Tech Videos