wmsetbg(1)

NAME

   wmsetbg - sets the background on the X11 display

SYNOPSIS

   wmsetbg  [-display  display]  [--update-domain  domain|--update-wmaker]
   [options] [image]

DESCRIPTION

   wmsetbg reads the specified image  (in  any  format  supported  by  the
   WRaster  library)  and  puts it on the root window. It can either scale
   the image or tile it to make it fit the root window. Window Maker  uses
   this command internally to set the root window image on start up.

OPTIONS

   --back-color|-b color
          the  specified  color  is  used  as the background color for the
          texture.  Window Maker temporary sets  the  background  to  this
          color while loading and processing the texture.  You can specify
          colors using their X11 names or as an  RGB  triplet  (either  as
          "rgb:RR/GG/BB"  or  "#RRGGBB") (reference to appropriate manpage
          should be here).  In the later case color is a quoted string.

   --center|-e
          centers the image in the screen

   --colors|-c count
          limit the number of colors per channel to use for the image

   -display display
          connect to the X display

   --dither|-d
          enable color dithering on image

   --fillscale|-f
          scales the specified  image  to  fill  screen  while  preserving
          aspect ratio

   --help|-h
          print a help message with the list of options

   --match|-m
          use  the  best-matching-color algorithm when converting image to
          indexed color palette

   --maxscale|-a
          scales the specified image to fit inside the  screen  preserving
          its aspect ratio

   --parse|-p texture
          parses the specified texture as a proplist style texture

   --scale|-s
          scales the specified image to fill the screen (default)

   --smooth|-S
          use a smooth scaling algorithm when resizing image

   --tile|-t
          tiles the specified image

   --update-domain|-D domain
          updates the specified domain database

   --update-wmaker|-u
          updates the Window Maker defaults database

   --version|-v
          print the version of Window Maker from which the program comes

   --workspace|-w workspace
          update background only for the specified workspace

   --xinerama|-X
          stretch image across Xinerama heads

INDEXED COLOR SCREENS

   If  your screen is not in a True Color configuration (generally sold as
   16,777,216 colors) but in a indexed color mode (256 colors, 16  colors,
   ...  which  are  based  on  a  ColorMap)  then Window Maker may need to
   process the image to convert it to a limited number  of  colors  before
   using it for a background image.

   There are two options to choose what algorithm you want to use:

   --match or -m
          Search for the closest matching color from the current colormap;
          this is the fastest algorithm but may lead to less  good-looking
          result.

   --dither or -d
          Use  a more complex algorithm which modify surrounding pixels to
          get a closer-looking  color  on  average;  this  is  slower  but
          provides better looking images.

   If  none  is  specified, then it is Window Maker's configuration choice
   that will be used.

   You can also use the option --colors to  reduce  the  total  number  of
   colors  from  the  image  before  the  algorithm is applied.  The value
   specified with the option defines the number  of  possible  values  for
   each  primary  color  (red, green and blue), for example 8 would reduce
   the image to use only 8*8*8=512 colors before applying  the  conversion
   algorithm.

SEE ALSO

   wmaker(1)

AUTHOR

   This man page was written by Marcelo Magallon <mmagallo@debian.org>.

   Window     Maker     was     written     by     Alfredo    K.    Kojima
   <kojima@windowmaker.info>.   wmsetbg   was   written   by   Dan   Pascu
   <dan@windowmaker.info>

                              April 2015                        wmsetbg(1)

---

Free and Open Source Software