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  back-
	 ground  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  _XSET-
	 ROOT_ID  and  _XROOTPMAP_ID  property	changes and update itself corre-
	 spondingly. However some programs listen only to one of  them,  so  you
	 should  either  use this option or not depending on what part is imple-
	 mented 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  cor-
	 rectly. 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.

				   2026-06-27			    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+15.1.quarterly>

home | help