SXPM(1) General Commands Manual SXPM(1)

# [NAME](#NAME)

sxpm - Show an XPM (X PixMap) file and/or convert XPM 1 or 2 files to XPM 3.

# [SYNOPSIS](#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](#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](#OPTIONS)

[**-d *display***](#d)

Specifies the display to connect to.

[**-g *geom***](#g)

Window geometry (default is pixmap's size).

[**-hints**](#hints)

Set ResizeInc for window.

[**-icon *filename***](#icon)

Set icon to pixmap created from the file *filename*.

[**-plaid**](#plaid)

Show the plaid pixmap which is stored as data*.*

[***filename***](#filename)

Read from the file *filename* or from standard input if *filename* is '-'. If no input is specified sxpm reads from standard input.

[**-o *filename***](#o)

Write to the file *filename* (overwrite if it already exists) and to standard output if *filename* is '-'.

[**-mono**](#mono)

Use the colors specified for a monochrome visual.

[**-grey4**](#grey4)

Use the colors specified for a 4 color greyscale visual.

[**-grey**](#grey)

Use the colors specified for a greyscale visual.

[**-color**](#color)

Use the colors specified for a color visual.

[**-pcmap**](#pcmap)

Use a private colormap.

[**-closecolors**](#closecolors)

Try to use "close colors" before reverting to other visuals.

[**-nod**](#nod)

Do not display the pixmap in a window. (Useful when using as converter)

[**-nom**](#nom)

Do not use the clipmask if there is any.

[**-sc *symbol colorname***](#sc)

Override default color to *symbol* to *colorname*.

[**-sp *symbol pixelvalue***](#sp)

Override default color to *symbol* to *pixelvalue*.

[**-cp *colorname pixelvalue***](#cp)

Override default color to *colorname* to *pixelvalue*.

[**-rgb *filename***](#rgb)

Search color names in the file *filename* and write them out instead of the rgb values.

[**-v**](#v)

Verbose - to print out extensions (stderr).

# [KNOWN BUGS](#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](#AUTHOR)

Arnaud Le Hors (lehors@sophia.inria.fr)  
Bull Research France  
Copyright (C) 1989-95 by Groupe Bull.

libXpm 3.5.19 X Version 11

---

Document: sxpm(1) from libxpm 3.5.19-r4 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxpm.git