1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 2K.1beta (1.50)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>uwmrc - the central UWM configuration file</TITLE>
<META NAME="description" CONTENT="uwmrc - the central UWM configuration file">
<META NAME="keywords" CONTENT="manual">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="LaTeX2HTML v2K.1beta">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="manual.css">
<LINK REL="next" HREF="node14.html">
<LINK REL="previous" HREF="node12.html">
<LINK REL="up" HREF="node12.html">
<LINK REL="next" HREF="node14.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html194"
HREF="node14.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.gif"></A>
<A NAME="tex2html190"
HREF="node12.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.gif"></A>
<A NAME="tex2html184"
HREF="node12.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.gif"></A>
<A NAME="tex2html192"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html195"
HREF="node14.html">Menu definition files</A>
<B> Up:</B> <A NAME="tex2html191"
HREF="node12.html">Configuration</A>
<B> Previous:</B> <A NAME="tex2html185"
HREF="node12.html">Configuration</A>
  <B> <A NAME="tex2html193"
HREF="node1.html">Contents</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION05010000000000000000">
<I>uwmrc</I> - the central <SMALL>UWM</SMALL> configuration file</A>
</H1>
<I>uwmrc</I> is uwms basic configuration file. It is loaded at startup and behavoir and outfit of <SMALL>UWM</SMALL> are controlled by this file as well. A typical <I>uwrmc</I>-line looks like this:
<P>
<TT>BorderWidth=10</TT>
<P>
As you can see it consists of a keyword, a '<TT>=</TT>' and finally a number which represents an argument.
<P>
Please note that there are several context-sensitive lines in <I>uwrmc</I> i.e. they have different meanings on different places.
<P>
Here's a description of all <I>uwmrc</I>-Keywords:
<P>
<DL COMPACT>
<DT>BorderWidth = <nr>
<DD>sets the width of window borders to <TT><nr></TT> pixels. Defaults to 10
<P>
<DT>TitleHeight = <nr>
<DD>sets the number of pixels the northern border is wider than the other ones. Defaults to 0.
<P>
<DT>ScreenColor = <col>
<DD>sets the current workspace's screen background color.
<P>
<DT>ScreenPixmap = <filename>
<DD>sets the current workspace's screen background image to the image file defined by <TT><filename></TT>. Overrides <TT>ScreenColor</TT> if set. Currently xpm and jpeg file formats are supported.
<P>
<DT>InactiveWin = <col>
<DD>sets the color of inactive windows' borders on the current workspace.
<P>
<DT>ActiveWin = <col>
<DD>sets the color of the active window's border on the current workspace.
<P>
<DT>MenuFont = <font>
<DD>sets the font used in menus.
<P>
<DT>BackColor = <col>
<DD>sets the current workspace's background color.
<P>
<DT>FontColor = <col>
<DD>sets the current workspace's default color for standard text.
<P>
<DT>MenuFile = <filename>
<DD>makes uwm reading its application menu from <TT><filename></TT>. Please note that uwm reads exactly one menu file after finishing reading <TT>uwmrc</TT>. This means that a <TT>MenuFile</TT> line overwrites any previous <TT>MenuFile</TT> lines. If you want to merge several menu files into one application menu, please use the features menu files offer to do this.
<P>
<DT>StartScript = <filename>
<DD>sets uwms StartScript to <TT><filename></TT>. The file must be an executable or a shell script for /bin/sh. If set, this file will be executed when uwm starts. A <TT>StartScript</TT> line overrides any previous <TT>StartScript</TT> lines.
<P>
<DT>RubberMove = {0|1}
<DD>enables (0) or disables (1) opaque window movement.
<P>
<DT>MenuSize = <triple>
<DD>sets ude's menu layout: <TT>#1</TT> defines the width of menu bevels, <TT>#2</TT> and <TT>#3</TT> define the label's x- and y-offset.
<P>
<DT>NarrowBorderWidth = <nr>
<DD>defines the widht of so-called transient window's borders. Most applications mark requesters and other dialogue windows etc. as transient.
<P>
<DT>UWMMenuButton = {1|2|3}
<DD>defines the button which starts the <I>UWM Menu</I> from the root window. Since uwm doesn't check if all root window menus are accessible, this option should always be used together with <TT>DeiconifyButton</TT> and <TT>AppMenuButton</TT> to make sure all three menus can be reached. Defaults to 1.
<P>
<DT>DeiconifyButton = {1|2|3}
<DD>defines the button which starts the <I>Windows Menu</I> from the root window. Since uwm doesn't check if all root window menus are accessible, this option should always be used together with <TT>UWMMenuButton</TT> and <TT>AppMenuButton</TT> to make sure all three menus can be reached. Defaults to 2.
<P>
<DT>AppMenuButton = {1|2|3}
<DD>defines the button which starts the <I>Application Menu</I> from the root window. Since uwm doesn't check if all root window menus are accessible, this option should always be used together with <TT>DeiconifyButton</TT> and <TT>DeiconifyButton</TT> to make sure all three menus can be reached. Defaults to 3.
<P>
<DT>TransientMenues = {0|1}
<DD>lets you choose if you want your menus disappear when you release the mouse pointer (1) or if you want them to stay until you either select an item or click somewhere outside of the menu (0). Defaults to 1.
<P>
<DT>WinMenuButton = <triple>
<DD>lets you change the button behavior for hex menus. <TT>#1</TT> specifies the button to make the hex menu appear, <TT>#2</TT> specifies the button used to move the window to the previous workspace and <TT>#3</TT> specifies the button used to move the window to the next workspace. Defaults to <TT>1;2;3</TT>. <B>The use of this option is disencouraged!</B>
<P>
<DT>DragButtons = <triple>
<DD>lets you change the button behavior for dragging windows. <TT>#1</TT> specifies the button to enter dragging mode, <TT>#2</TT> specifies the button to raise windows and <TT>#3</TT> specifies the button for lowering windows. Defaults to <TT>2;1;3</TT>. <B>The use of this option is disencouraged!</B>
<P>
<DT>ResizeButtons = <triple>
<DD>specifies the button behaviour for resizing windows. <TT>#1</TT> specifies the button to enter resizing mode, <TT>#2</TT> specifies the button for autoraising and <TT>#3</TT> specifies the button to quit autoraise mode and to activate the 'oldsize'-function. Defaults to <TT>3;1;2</TT>. <B>The use of this option is disencouraged!</B>
<P>
<DT>WorkSpaces = <nr>
<DD>lets you specify the number of workspaces you want.
<P>
<DT>WorkSpaceName = <string>
<DD>lets you specify a name for the current workspace.
<P>
<DT>WorkSpaceNr = <nr>
<DD>sets the current workspace. Any options that take effect on the 'current workspace' apply to the workspace set to be the current workspace most recently.
<P>
<DT>PlacementStrategy = {0-7}
<DD>defines the placement strategy to be used. There are the following possibilities:
<BR><TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT">0</TD>
<TD ALIGN="LEFT">no placement strategy</TD>
</TR>
<TR><TD ALIGN="LEFT">2</TD>
<TD ALIGN="LEFT">agressive gradient-placement (place <B>all</B> windows automatically)</TD>
</TR>
<TR><TD ALIGN="LEFT">1 or 3</TD>
<TD ALIGN="LEFT">gradient-placement (automatic placement)</TD>
</TR>
<TR><TD ALIGN="LEFT">4</TD>
<TD ALIGN="LEFT">agressive interactive placement (place <B>all</B> windows semi-automatically)</TD>
</TR>
<TR><TD ALIGN="LEFT">5</TD>
<TD ALIGN="LEFT">interactive placement (semi-automatic placement)</TD>
</TR>
<TR><TD ALIGN="LEFT">6</TD>
<TD ALIGN="LEFT">agressive user placement (place <B>all</B> windows manually)</TD>
</TR>
<TR><TD ALIGN="LEFT">7</TD>
<TD ALIGN="LEFT">user placement (manual placement)</TD>
</TR>
</TABLE>
<P>
<DT>PlacementThreshold = <nr>
<DD>defines the overlapping value in pixels from which on you want to place your windows manually in interactive placement stratrgy. This is useless in other placement strategies. In most other WMs 0 is used here without any comments or a way to change. 0 is the default value. If you want this option to make sense your values shouldn't be too small (I tried out 100000 to be quite a good value at a screen-size of <!-- MATH
$1200\times1024$
-->
1200 x 1024).
<P>
<DT>ScreenCommand = <string>
<DD>defines a command line which is run when the current workspace is entered and killed when it is left. You can e.g. use this to have xearth on the background of one workspace while xsnow makes it winter on another one. Nice toy...
<P>
<DT>ReadFrom = <filename>
<DD>reads another config file in <TT>uwmrc</TT> format immediately. The file is interpreted as if it was inserted at the place of the corresponding <TT>ReadFrom</TT> line.
<P>
<DT>BevelFactor = <float>
<DD>defines how extreme bevels are drawn. A value of 1 draws no bevels, values <!-- MATH
$0<\texttt{<float>}<1$
-->
0<<TT><float></TT><1 draw deep bevels and values greater than 1 draw usual high bevels. A <TT>BevelFactor</TT> setting affects all 3d-color definitons between itself and the next <TT>BevelFactor</TT> line.
<P>
<DT>FrameBevelWidth = <nr>
<DD>specifies the bevel width used for window frames.
<P>
<DT>OpaqueMoveSize = <nr>
<DD>specifies the size in pixels from which on windows are no longer moved opaquely but transparently. A value of 0, which is also the default, means move always opaque, any other value means move transparent from that size on. Values greater than 0 might be useful on slower machines with some applications. You should try out your favourite value or if e.g. transparent movement for all windows works better on your machine with your frequently used applications.
<P>
<DT>TitleFont = <font>
<DD>specifies the font used for window titles.
<P>
<DT>ActiveTitle = <col>
<DD>specifies the color the name of active windows is drawn with.
<P>
<DT>InactiveTitle = <col>
<DD>specifies the color the name of inactive windows is drawn with.
<P>
<DT>FrameFlags = <nr>
<DD>specifies the layout and behaviour of window titles and borders. Expects a sum of the following values:
<BR><TABLE CELLPADDING=3>
<TR><TD ALIGN="RIGHT">1</TD>
<TD ALIGN="LEFT">Groove</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>draw the groove on window borders if there's enough space.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="RIGHT">2</TD>
<TD ALIGN="LEFT">Line</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>draw a black separation line along the inside of window borders.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="RIGHT">4</TD>
<TD ALIGN="LEFT">Inactive Title</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>display inactive windows' titles.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="RIGHT">8</TD>
<TD ALIGN="LEFT">Active Title</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>display active window's title.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="RIGHT">16</TD>
<TD ALIGN="LEFT">Dodgy Title</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>hide active window's title when hit by the mouse pointer.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="RIGHT">32</TD>
<TD ALIGN="LEFT">Center Title</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>display titles in the center of the top border instead of the northeastern corner.</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
</TABLE>
<BR>
E.g. use a value of 1+2+4+32=39 if you want titles in the center position disappearing when the window is activated and grooves drawn on your window borders.
<P>
<DT>BehaviourFlags = <nr>
<DD>specifies parts of uwm's behaviour. Expects a sum of the following values:
<BR><TABLE CELLPADDING=3>
<TR><TD ALIGN="RIGHT">1</TD>
<TD ALIGN="LEFT">AllMouse</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=198>do not ignore mouse events passed on to uwm by some client windows (e.g. xosview can be moved easily clicking somewhere in the window using this option).</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
</TABLE>
<BR>
<P>
<DT>OtherWMs = <string>
<DD>expects a comma seperated list of shell command lines used to start other window managers out of uwm.
<P>
<DT>MaxWinWidth = <nr>
<DD>defines the maximum window width allowed during this session. This is useful on displays with low resolutions. Unfortunately there might be some problems with applications not regarding the most basic X11 specifications.
<P>
<DT>MaxWinHeight = <nr>
<DD>defines the maximum window height allowed during this session. This is useful on displays with low resolutions. Unfortunately there might be some problems with applications not regarding the most basic X11 specifications.
<P>
<DT>StopScript = <filename>
<DD>sets uwms StopScript to <TT><filename></TT>. The file must be an executable or a shell script for /bin/sh. If set, this file will be executed when uwm starts. A <TT>StopScript</TT> line overrides any previous <TT>StopScript</TT> lines.
<P>
<DT>WarpPointerToNewWinH = <nr>
<DD>allows you to make uwm warp the pointer to any newly mapped window. Any value between 0 and 100 defines the X-position in the window (in percent) the pointer is warped to. A value of -1 means don't warp the pointer and a value of -2 means warp the pointer to the upper left corner of the window's border. Only takes effect if <TT>WarpPointerToNewWinV</TT> is set between 0 and 100.
<DT>WarpPointerToNewWinV = <nr>
<DD>allows you to make uwm warp the pointer to any newly mapped window. Any value between 0 and 100 defines the Y-position in the window (in percent) the pointer is warped to. A value of -1 means don't warp the pointer and a value of -2 means warp the pointer to the upper left corner of the window's border. Only takes effect if <TT>WarpPointerToNewWinH</TT> is set between 0 and 100.
<DT>InactiveText = <col>
<DD>defines the color of any inactive text.
<DT>HighlightedText = <col>
<DD>sets font used for highlighted text.
<DT>HighlightedBgr = <col>
<DD>sets the background color of highlighted text.
<DT>TextColor = <col>
<DD>sets the text color for text windows, e.g. editors, terminals etc.
<DT>TextBgr = <col>
<DD>sets the background color for text windows, e.g. editors, terminals etc.
<DT>BevelWidth = <nr>
<DD>sets the width of bevels for ude applications (will be used in the library)
<DT>ResourceFile = <filename>
<DD>uwm can read a file with the format described in section <A HREF="node15.html#urdb"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.gif"></A> to set workspace specific application colors etc.
<DT>SnapDistance = <nr>
<DD>sets the distance (in pixels) from which a window snaps to another window's or the screen's border when being moved.
<DT>HexPath = <string>
<DD>sets the path where uwm first looks for a set of hex icons. The icons must be of <I>.xpm</I> format, and the named directory must contain a complete set of hex icons with the following names and meanings:
<BR><TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT">Normal State</TD>
<TD ALIGN="LEFT">Selected State</TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>Meaning</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>autorise.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>autorises.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>autorise or resize the window</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>back.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>backs.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>lower the window</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>close.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>closew.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>close the window</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>iconify.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>iconifys.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>iconify/minimize the window</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>kill.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>kills.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>shut down the application's connection to the x-server</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>menu.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>menus.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>open the window menu</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
<TR><TD ALIGN="LEFT"><TT>really.xpm</TT></TD>
<TD ALIGN="LEFT"><TT>reallys.xpm</TT></TD>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142>security button that X-Server connection gets killed by accident</TD>
<TD ALIGN="LEFT"> </TD>
</TR>
</TABLE>
<P>
<DT>TextFont = <font>
<DD>sets the font used for text windows such as editors or terminals etc. The use of a fixed width font is highly recommended here.
<DT>HighlightFont = <font>
<DD>sets the font for highlighted text.
<DT>InactiveFont = <font>
<DD>sets the font for inactive elements such as buttons or menu items etc.
<P>
</DD>
</DL>
<P>
In this description the following data types are being used as arguments for the options:
<DL COMPACT>
<DT><nr>
<DD>is an integer number with the range specified in the option's description.
<DT><string>
<DD>represents a usual text line. it may contain any desired characters, whitespace etc. and is terminated by a linebreak.
<DT><font>
<DD>is an X11 font definition string. The most easy way to get such a string is to paste it directly from xfontsel into the file.
<DT><filename>
<DD>is the name of a file. The file is searched in the way described above and in most cases passed through the c preprocessor.
<DT><col>
<DD>represents an X11 color definition string. For the exact format of these strings please take a look at the man page of <TT>XQueryColor</TT>. All colors can be set for any workspace seperately.
<DT><triple>
<DD>represents a set of three semicolon seperated integers.
<DT><float>
<DD>represents a floating point number. Please note that the decimal expected seperation character may differ with the internationalized version of (g)libc with different <TT>LANG</TT>-environments set (e.g.<TT>.</TT> as default but <TT>,</TT> for <TT>LANG=de</TT>). Admins of multilingual systems say thanx to the big internationalisationers of libc for this feature.
<DT>{X|Y|Z}
<DD>means one out of <TT>X</TT>, <TT>Y</TT> or <TT>z</TT>.
</DD>
</DL>
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html194"
HREF="node14.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.gif"></A>
<A NAME="tex2html190"
HREF="node12.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.gif"></A>
<A NAME="tex2html184"
HREF="node12.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.gif"></A>
<A NAME="tex2html192"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html195"
HREF="node14.html">Menu definition files</A>
<B> Up:</B> <A NAME="tex2html191"
HREF="node12.html">Configuration</A>
<B> Previous:</B> <A NAME="tex2html185"
HREF="node12.html">Configuration</A>
  <B> <A NAME="tex2html193"
HREF="node1.html">Contents</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
The <a href="http://udeproject.sourceforge.net">ude</a> project
</ADDRESS>
</BODY>
</HTML>
|
