1wmsetbg(1) General Commands Manual wmsetbg(1)
2
6 wmsetbg - sets the background on the X11 display
7
9 wmsetbg [-display display] [--update-domain domain|--update-wmaker]
10 [options] [image]
11
13 wmsetbg reads the specified image (in any format supported by the
14 WRaster library) and puts it on the root window. It can either scale
15 the image or tile it to make it fit the root window. Window Maker uses
16 this command internally to set the root window image on start up.
17
19 --back-color|-b color
20 the specified color is used as the background color for the tex‐
21 ture. Window Maker temporary sets the background to this color
22 while loading and processing the texture. You can specify col‐
23 ors using their X11 names or as an RGB triplet (either as
24 "rgb:RR/GG/BB" or "#RRGGBB") (reference to appropriate manpage
25 should be here). In the later case color is a quoted string.
26 --center|-e
28 centers the image in the screen
29 --colors|-c count
31 limit the number of colors per channel to use for the image
32 -display display
34 connect to the X display
35 --dither|-d
37 enable color dithering on image
38 --fillscale|-f
40 scales the specified image to fill screen while preserving
41 aspect ratio
42 --help|-h
44 print a help message with the list of options
45 --match|-m
47 use the best-matching-color algorithm when converting image to
48 indexed color palette
49 --maxscale|-a
51 scales the specified image to fit inside the screen preserving
52 its aspect ratio
53 --parse|-p texture
55 parses the specified texture as a proplist style texture
56 --scale|-s
58 scales the specified image to fill the screen (default)
59 --smooth|-S
61 use a smooth scaling algorithm when resizing image
62 --tile|-t
64 tiles the specified image
65 --update-domain|-D domain
67 updates the specified domain database
68 --update-wmaker|-u
70 updates the Window Maker defaults database
71 --version|-v
73 print the version of Window Maker from which the program comes
74 --workspace|-w workspace
76 update background only for the specified workspace
77 --xinerama|-X
79 stretch image across Xinerama heads
80
82 If your screen is not in a True Color configuration (generally sold as
83 16,777,216 colors) but in a indexed color mode (256 colors, 16 colors,
84 ... which are based on a ColorMap) then Window Maker may need to
85 process the image to convert it to a limited number of colors before
86 using it for a background image.
87 There are two options to choose what algorithm you want to use:
89 --match or -m
91 Search for the closest matching color from the current colormap;
92 this is the fastest algorithm but may lead to less good-looking
93 result.
94 --dither or -d
96 Use a more complex algorithm which modify surrounding pixels to
97 get a closer-looking color on average; this is slower but pro‐
98 vides better looking images.
99 If none is specified, then it is Window Maker's configuration choice
101 that will be used.
102 You can also use the option --colors to reduce the total number of col‐
104 ors from the image before the algorithm is applied. The value speci‐
105 fied with the option defines the number of possible values for each
106 primary color (red, green and blue), for example 8 would reduce the
107 image to use only 8*8*8=512 colors before applying the conversion algo‐
108 rithm.
109
111 wmaker(1)
112
114 This man page was written by Marcelo Magallon <mmagallo@debian.org>.
115 Window Maker was written by Alfredo K. Kojima <kojima@window‐
117 maker.info>. wmsetbg was written by Dan Pascu <dan@windowmaker.info>
118 April 2015 wmsetbg(1)