1FvwmBacker(1)                    Fvwm Modules                    FvwmBacker(1)
2
3
4

NAME

6       FvwmBacker - the fvwm background changer module
7

SYNOPSIS

9       Module FvwmBacker
10
11       FvwmBacker can only be invoked by fvwm.  Command line invocation of the
12       FvwmBacker module will not work.
13
14

DESCRIPTION

16       The FvwmBacker module provides functionality to change  the  background
17       when  changing  desktops.   Any  command  can be executed to change the
18       backgrounds.  Actually, any arbitrary command can be sent  to  fvwm  to
19       execute,  so  you  could  also do things such as changing window border
20       colors, etc.
21
22

COPYRIGHTS

24       The FvwmBacker module is the original work of Mike Finger.
25
26       Copyright 1994, Mike Finger. The author makes  no  guarantees  or  war‐
27       ranties  of  any kind about the use of this module.  Use this module at
28       your own risk.  You may freely use this module or any portion of it for
29       any purpose as long as the copyright is kept intact.
30
31

INITIALIZATION

33       During  initialization,  FvwmBacker gets config info from fvwm's module
34       configuration database (see fvwm(1), section MODULE COMMANDS).   Avail‐
35       able options are discussed in a later section.
36
37

INVOCATION

39       FvwmBacker  can  be  invoked by fvwm during initialization by inserting
40       the line
41
42       AddToFunc StartFunction I Module FvwmBacker
43
44       in the .fvwm2rc file.
45
46       FvwmBacker can be  started  using  a  'Module  FvwmBacker'  command  or
47       stopped  using  a 'KillModule FvwmBacker' command at any time when fvwm
48       is running.
49
50       FvwmBacker must reside in a directory that is listed in the  ModulePath
51       option of fvwm for it to be executed by fvwm.
52
53

CONFIGURATION OPTIONS

55       The following options can be placed in the .fvwm2rc file
56
57
58       *FvwmBacker: Command (Desk d, Page x y) command
59              Specifies  the  command to execute when the viewport matches the
60              arguments for the desk d, page x coordinate  and  y  coordinate.
61              Any or all of these three numeric arguments can be replaced with
62              an asterisk (*) to indicate that any value matches, in this case
63              Desk or Page parts can be skipped.
64
65              If either the Desk or the Page parts are omitted, the command is
66              not executed if only the desk or the page is switched.  If  nei‐
67              ther is given, the command is executed only once when the module
68              is started.  This is not the same as using asterisks for the nu‐
69              meric  arguments:   if asterisks are used, the command is always
70              executed when only the desk or page changes, if the  correspond‐
71              ing part is omitted, the command is never executed when only the
72              desk or page changes.
73
74              If the command is -solid FvwmBacker uses the next argument as  a
75              color  in  the  X database and sets the background to that color
76              without generating a system call to xsetroot (only  single  word
77              color names may be used).
78
79              If the command is colorset FvwmBacker uses the background speci‐
80              fied in colorset n for the given desk.  Please refer to the fvwm
81              man page for details about colorsets.
82
83              Otherwise the command is sent to fvwm to execute.
84
85
86       *FvwmBacker: RetainPixmap
87              Causes  FvwmBacker  to  retain and publish the Pixmap with which
88              the background has been set. This works only for the  -solid  or
89              colorset commands. This is useful for applications which want to
90              use the root Pixmap on the background to  simulate  transparency
91              (for  example,  Eterm  and  Aterm  use this method). This option
92              should also be used for  the  RootTransparent  colorset  option.
93              Note:  with  a colorset background this command may add a lot of
94              memory to the X server. For example, this adds the pixmap  width
95              times  height bytes with a TiledPixmap image, screen_width times
96              screen_height bytes with a Pixmap image or a C,B,D,R,S or Y Gra‐
97              dient  and  screen_width bytes with a VGradient or screen height
98              bytes with an HGradient.
99
100
101       *FvwmBacker: DoNotRetainPixmap
102              Cancels the effect of the previous option. This is the default.
103
104

RUN-TIME CONFIGURATION

106       It it possible to replace FvwmBacker's configuration at  run-time,  al‐
107       though  it  is not yet possible to remove existing configuration lines.
108       This is done by simply removing the old configuration from within  fvwm
109       and then read a new one.  This can be done in many ways, for example by
110       using an fvwm function or one of the modules  FvwmCommand  or  FvwmCon‐
111       sole.
112
113       Example:
114
115
116       DestroyModuleConfig FvwmBacker*
117       *FvwmBacker: Command (Desk 0) -solid black
118       *FvwmBacker: Command (Desk 1) -solid blue
119
120
121

OLD-STYLE OPTIONS

123       There is continued support for the now deprecated option:
124
125
126       *FvwmBacker: Desk d command
127
128              It  is  functionally equivalent to omitting the page coordinates
129              with *FvwmBacker: Command:
130
131
132              *FvwmBacker: Command (Desk Id) command
133
134
135

SAMPLE CONFIGURATION

137       The following are excerpts from an .fvwm2rc file which  describe  Fvwm‐
138       Backer initialization commands:
139
140
141       ####
142       # Set Up Backgrounds for different desktop pages (2 desks, 3x2 pages).
143       ####
144       *FvwmBacker: Command (Page 2 *) -solid steelblue
145       *FvwmBacker: Command (Desk 0, Page 0 0) Exec fvwm-root $[HOME]/bg2.xpm
146       *FvwmBacker: Command (Desk 0, Page 0 1) -solid midnightblue
147       *FvwmBacker: Command (Desk 0, Page 1 *) -solid yellow
148       *FvwmBacker: Command (Desk 1, Page * 0) -solid navy
149       *FvwmBacker: Command (Desk 1, Page * 1) Colorset 5
150
151
152

AUTHOR

154       Mike Finger (mfinger@mermaid.micro.umn.edu)
155                   (Mike_Finger@atk.com)
156                   (doodman on IRC, check the #linux channel)
157

Modified by

159       Andrew Davison (davison@cs.monash.edu.au)
160
161       Michael Han (mikehan@best.com)
162
163       Mikhael Goikhman (migo@homemail.com)
164
165
166
1673rd Berkeley Distribution   19 October 2022 (2.7.0)              FvwmBacker(1)
Impressum