xpmroot - Online in the Cloud

PROGRAM:

NAME

fvwm-root - Sets the root window of the current X display to image

SYNOPSIS

fvwm-root [--retain-pixmap|-r] [--no-retain-pixmap] [--dummy|-d] [--no-dummy] [--dither]
[--no-dither] [--color-limit [ncolors] ] [--no-color-limit] [--help|-h|-?] [--version|-V]
image_file

DESCRIPTION

fvwm-root reads the image file specified in the command line and displays it in the root
window. The supported image formats are XBM, XPM, PNG and SVG if appropriated libraries
are compiled in.

SVG rendering options (as described in the ICONS AND IMAGES section of the main fvwm
documentation) can be utilized.

OPTIONS

These command line options are recognized by fvwm-root:

--retain-pixmap | -r
Causes fvwm-root to retain and publish the Pixmap with which the background has
been set (the ESETROOT_PMAP_ID and _XROOTPMAP_ID properties are used). This is
useful for applications which want to use the root Pixmap on the background to
simulate transparency (for example, Eterm and Aterm use this method). This option
should also be used for the RootTransparent colorset option, refer to the COLORSETS
section of fvwm(1). If this option is not used, fvwm-root sets the _XSETROOT_ID
property to None, and some programs, like fvwm modules, may use this to update
their background if the background is transparent (Transparent colorset).

Note, a well behaved program, like fvwm, should listen to both _XSETROOT_ID and
_XROOTPMAP_ID property changes and update itself correspondingly. However some
programs listen only to one of them, so you should either use this option or not
depending on what part is implemented by these programs. You should also use this
option to get fast root-transparent menus in fvwm.

--no-retain-pixmap
This is a default. May be useful to explicitly force the default even if "--retain-
pixmap" is specified earlier.

--dummy | -d
Causes fvwm-root NOT to set the background, but to only free a memory associated
with the ESETROOT_PMAP_ID property (if any). In any case the _XSETROOT_ID property
is set to None.

--no-dummy
This is a default. May be useful to explicitly force the default even if "--dummy"
is specified earlier.

--dither
Causes fvwm-root to dither images for "smoother" rendition on displays with color
depth of 16 or lower. This the defaut with color depth less or equal to 8.

--no-dither
Causes fvwm-root NOT to dither images. This is the default with color depth greater
than 8.

--color-limit ncolors
Causes fvwm-root to limit its color use to ncolors (if specified). This option is
taken in account only with color depth less or equal to 8 (and a TrueColor or
GrayScale visual). The default is to use the same color limit as fvwm. So in normal
situation this option is not useful. However, if fvwm use a private colors map, as
fvwm-root always use the default colors map you should use this option for limiting
colors correctly. If ncolors is not specified a default is used.

--no-color-limit
Causes fvwm-root NOT to limit its color use.

--help Shows a short usage.

--version
Shows a version number.

COMPATIBILITY

In the past this utility was called xpmroot. This name is still supported as a symlink.

Use xpmroot online using onworks.net services