Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
FVWM-ROOT(1)							  FVWM-ROOT(1)

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 default 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.

BUGS
       Repeated	use of fvwm-root with different	xpm pixmaps will use up	slots
       in your color table pretty darn fast.

AUTHOR
       Rob Nation

       Rewritten and enhanced by fvwm-workers.

				  2023-08-29			  FVWM-ROOT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fvwm-root&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help