NAME¶
olvwm - OPEN LOOK virtual window manager for X11 and OpenWindows
SYNOPSIS¶
olvwm [
options ]
DESCRIPTION¶
olvwm is a virtual window manager for the X Window System that implements
parts of the OPEN LOOK graphical user interface.
olvwm differs from
olwm in that olvwm manages a virtual desktop which is larger than the
actual screen. However,
olvwm is equivalent in all other respects to,
and supports all the features of
olwm. This manual page discusses only
the changes between
olvwm and
olwm, most of which deal
specifically with the virtual desktop. For details on how
olwm
operates, including its host of options, see
olwm(1).
OPTIONS¶
There is one new option to
olvwm.
- -allowSynthetic
- Allow the receipt of synthetic events. Note that this argument only
permits synthetic events to be enabled; whether or not synthetic events
are delivered is controlled via the SyntheticEvents resource
variable.
TERMINOLOGY¶
Throughout this manual, the following terms are used:
- Screen:
- This refers to a specific monitor; essentially, there is one screen for
every monitor run by your workstation. Each monitor has a view into a
particular desktop. In X terminology, this is the screen component of a
particular display.
- Desktop:
- This refers to the entire area in which windows can reside on a given
screen. In non-virtual window managers, a desktop and a screen are the
same size. In a virtual window manager, though, a desktop is larger than
the screen.
- VDM
- or Virtual Desktop Manager is the window which represents visually
the entire desktop: it provides a scaled-down version of the entire
desktop.
- Logical Screen:
- If the desktop is running in default mode, it will display a grid, each
square of which maps to the size of the monitor. Each square is termed a
logical screen.
- Current View:
- is that part of the desktop which is currently displayed on the screen;
this will usually (but need not always) correspond to a logical
screen.
- Virtual Window:
- is a small rectangle displayed in the VDM; every window on the desktop has
a corresponding Virtual Window in the VDM.
VIRTUAL DESKTOP MANAGER¶
When it is started,
olvwm displays a virtual desktop manager window. The
VDM is a reduced display of all windows active on the desktop at any time. The
current view is outlined in the virtual desktop manager. The VDM always
appears on the screen.
By default, the VDM (and hence the desktop) is divided into a grid; each square
of the grid represents a screen size. The dividing lines between each logical
screen are represented by dashed lines in the VDM. This division into logical
screens is purely informational: if you like, windows can straddle these
boundaries, the current view into the desktop can straddle these boundaries,
and window can be moved at will between these boundaries. However, by default,
most actions in the VDM will keep the current view along these boundary lines.
EVENTS IN THE VDM¶
The processing of events within the VDM depends on whether the mouse is pointing
to the background area of the VDM or to a particular virtual window within the
VDM.
EVENTS ON VIRTUAL WINDOWS¶
Events which occur in a particular virtual window behave just as if they were
delivered to the corresponding application's frame. Thus, pressing the MENU
button over a virtual window will bring up the frame menu and allow the real
(and virtual) windows to be opened, closed, resized, etc. Pressing the SELECT
button will select that real (and virtual) window; pressing the ADJUST button
will add (or subtract) that window from the selection list. Pressing the FRONT
or OPEN keys will raise/lower or open/close the real (and virtual) window.
SELECTing and dragging one or more virtual windows will move the real and
virtual windows (just as in
olwm). Note that if you drag the mouse
outside of the VDM, the window can be moved onto to the screen. Conversely,
when dragging a window on the screen, if the mouse moves into the VDM, the
window will then be moved to the location on the displayed within the VDM.
However, if part of the VDM is obscured, you cannot move a window into that
part of the VDM.
Note that events are delivered ONLY to the real application's frame. Thus,
typing characters or the COPY/CUT/PASTE keys has no effect.
It is possible to drop something onto a virtual window as if it were dropped
onto the corresponding application; this allows you to, for example, drag a
file from the mailtool on the screen to a file manager on another part of the
desktop.
EVENTS ON THE VDM BACKGROUND¶
Events on the VDM background all work to change the current view, bringing
windows which were formerly outside of the current view onto the screen (and
moving windows which were on the screen outside of the current view). Keyboard
events are described given the default Sun Type-4 keyboard mappings, but you
can use xmodmap to set up your particular keyboard.
- Keyboard Events:
- The arrow keys (and other keys) can be used to shift the current view in
the direction specified. See the section on ADDITIONAL KEY BINDINGS below.
Keyboard events are also active if they occur on the root window in
addition to the VDM background.
- SELECT
- mouse events: SELECTing on the VDM background allows you to drag the
current view within the VDM. If the VirtualGrid resource is set to Visible
or Invisible, movement of the visible region will be constrained to
logical screen boundaries unless the CTRL button is pressed before and
held while dragging the mouse. If the VirtualGrid resource is set to None,
movement of the visible region will be unconstrained unless the CTRL
button is pressed before and held while dragging the mouse.
- DOUBLE CLICK
- SELECT events: Double clicking the SELECT button on an area in the VDM
background will move the current view to the logical screen containing the
point where the mouse was double-clicked.
- MENU
- mouse events: The MENU button brings up a (pinnable) menu which will allow
movement based on full screen sizes in the direction indicated.
RESIZING THE VIRTUAL DESKTOP¶
You can use the resize corners on the VDM to resize the virtual desktop at will.
If you make the virtual desktop smaller, windows which might be off the new
virtual desktop will NOT be moved (though they will not be lost, either, and
you can get them back by resizing the desktop again). Space added or
subtracted is always done so from the right and bottom of the desktop
(regardless of which resize corner you used).
STICKY WINDOWS¶
You'll notice that the virtual desktop manager never moves on your screen if you
change views into the desktop. That's because the VDM is permanently
"sticky."
Windows which are "sticky" never move position on the screen when you
change your view into the desktop. To set a particular window as sticky,
simply select "Stick" in its frame menu. You may similarly unstick
the window via its menu.
[Note: Only base frames--those which can be iconified, as opposed to those which
have a pushpin--are eligible to become sticky; other frames inherit the
stickyness of their base frames. Thus, for most applications, either all
windows are sticky or none of them are. The exception to this is applications
which create two or more base frames; all base frames will be originally
created as "unsticky" (but see the VirtualSticky resource below).]
The window menu of all windows has all the tools defined in
olwm. In
addition, the menu of base windows has the following command
- Stick/Unstick
- Affect the stickyness of the particular window. Windows which are sticky
will always appear in the same place on the screen no matter which part of
the virtual desktop you're looking at. Windows which are not sticky (by
default, all windows except the VDM) will move when you change the current
view on the virtual desktop.
The following additional keywords can be used in the command field of a root
menu menu item:
- COLUMNS
- This specifies the number of columns you'd like the menu to have. Each
column within a menu will be filled in order of the items in the menu. The
menu name must appear before this keyword, and the keyword itself must
appear before the end of the menu.
- STICK_UNSTICK_SELN
- This specifies that the sticky state of the selected windows should be
toggled.
- WINMENU
- brings up a pull-right menu containing the name of every window on the
current monitor (if olvwm is managing multiple monitors, only
windows on the current monitor will be shown). Windows which are iconified
are preceded with a graphic symbol. Selecting one of these windows causes
the view into the desktop to shift so that the selected window is visible;
the selected window will be opened if iconic and raised to the top of the
stacking order. This behavior can be altered; see olvwmrc(5) for
more details. You may specify the number of columns in the pull-right menu
by using a number after the WINMENU keyword. By default, the order of the
menu is alphabetic; see the SortMenuType resource below for more
options.
- DIRMENU
- brings up a pull-right menu containing the name of every file given in the
named directory. This allows you to use a local programs directory for a
tool repository; whenever tools are added to the directory, users will see
the new choices. The directory name may contain environmental variables
(e.g. $OPENWINHOME). You may also specify a regular expression as the file
part of DIRMENU; e.g. $OPENWINHOME/bin/x* would display only those
programs in the openwindows bin directory which begin with an x. Regular
expressions do not apply to the directory name; $OPENWINHOME/b*/x* is an
invalid DIRMENU entry.
- X11 Bitmaps and Pixmaps
- can be specified in the menu by specifying a filename enclosed in <>
brackets. The filename specified must be in X11 bitmap form, XPM2 form
(produced by IconEdit), XPM3 form, or Gif format. You can mix bitmap and
string entries within a menu, though perhaps menus look better if you do
not.
- MOVE_DESKTOP
- specifies that olvwm should move the view to either the logical
screen specified after the MOVE_DESKTOP entry (e.g. MOVE_DESKTOP 3 moves
to the third logical screen) or to the logical screen containing the point
specified after the MOVE_DESKTOP entry (e.g. MOVE_DESKTOP 2304 0 also
moves to the third logical screen in a default configuration).
Here is a version of the example
olwm root menu specification: the
programs menu will have 2 columns; there will be a way to find particular
windows off the "Find" submenu (and that menu will have 3 columns);
whatever local tools are available can be found in /usr/local; and the cmdtool
option will be displayed as an icon:
"My Custom Menu" TITLE
Programs MENU
Programs COLUMNS 2
</usr/openwin/include/X11/bitmaps/terminal> DEFAULT cmdtool
"Text Editor" textedit
Mail mailtool
"File Manager" filemgr
Other MENU
"Other Tools" TITLE
"Shell Tool" shelltool
"Icon Editor" iconedit
Clock clock
"Perf Meter" DEFAULT perfmeter
Other END
"Local Tools" DIRMENU /usr/local
Programs END PIN
"Repaint Screen" REFRESH
"Properties ..." PROPERTIES
"Find" WINMENU 3
Exit EXIT
MISCELLANEOUS NEW FEATURES¶
This section describes miscellaneous window manager features which are not
directly related to the virtual nature of
olvwm.
Upon receiving a USR1 signal,
olvwm will execute a RESTART function just
like the restart function available from the root menu.
The root workspace will not be repainted on exit if the PaintWorkspace resource
is False.
The
olwm resource DefaultIconImage will now accept either an X11 Bitmap
file, a version 2 or 3 XPM image file or a GIF file. If you use an image file,
remember that the DefaultIconMask must still be a X11 Bitmap; generally you
will want to create a full mask in that case.
The
olwm resource WorkspaceBitmap will accept X11 Bitmap files, version 2
or 3 XPM image files, or GIF files. The MaxMapColors resource can restrict the
number of colors
olvwm uses for each GIF file to help with colormap
problems, but in general, specifying more than 1 GIF file will lead to
colormap problems.
RESOURCES TO CONTROL THE VIRTUAL DESKTOP¶
See the man page for
olwm for a complete description of resources. All
resources of class OpenWindows and olwm described there are supported by
olvwm. In addition, for
olvwm only, resources of instance
"olvwm" are also read. You can thus name the following resources as
olvwm.<resource>, olwm.<resource>, or as
OpenWindows.<resource> depending on your naming preference.
Resources marked with an * may be specified on a screen-by-screen basis; e.g.
olvwm.screen0.resource and olvwm.screen1.resource, following the pattern in
olwm.
- VirtualDesktop (string)*
- Specifies the size of the virtual desktop. You can specify this in terms
of screen sizes, so that a virtual desktop of 3 screens across and 2
screens high would appear as the string 3x2. You may also specify this in
terms of absolute pixel sizes, e.g. 3800x1800, as long as the pixel size
is greater than the size of your framebuffer. Default value:
3x2
- PannerScale (int)*
- Sets the scale in which the virtual desktop manager will be drawn.
Default value: 15.
- VirtualGeometry (string)*
- Specifies the geometry string of the desktop manager in standard X11
format (wxh+x+y). The width and height, if specified, are ignored, but the
x and y can be used to specify the initial location of the desktop
manager. Default value: +0+0
- VirtualIconGeometry (string)*
- Specifies the geometry string of the desktop manager icon in standard X11
format (wxh+x+y). The width and height are ignored, but the x and y can be
used to specify the initial location of the desktop manager icon.
Default value: +0+0
- VirtualIconic (Boolean)*
- If true, the virtual desk manager will come up iconic. Default value:
False
- AllowMoveIntoDesktop (Boolean)
- If true, allows windows to be moved from the screen into the VDM and vice
versa. Otherwise, moving a window on the screen will only allow it to be
placed in the visible screen; and moving a window in the desktop manager
will not let it be dragged onto the screen. Default value:
True
- AllowArrowInRoot (Boolean)
- If true, then key events in the root window will affect the VDM and thus
move the view into the desktop (if the appropriate key is pressed).
Otherwise, only key events when the VDM has the input event focus will
have an effect. Default value: True
- VirtualFont (string)*
- The font name used to display title of windows within the virtual desktop
manager. Default value: 5x8
- VirtualFontColor (color specification)*
- The color of the title within the virtual windows of the virtual desktop
manager. Default value: Black
- VirtualBackgroundColor (color specification)*
- The color of the background of the virtual desktop manager. Default
value: Based on the frame color of your desktop.
- VirtualForegroundColor (color specification)*
- The color of the virtual windows in the virtual desktop manager.
Default value: The frame color of your desktop.
- VirtualBackgroundMap (Pixmap filename)*
- The name of a file containing a pixmap to use as the background of the
virtual desktop manager. This will be drawn with the
VirtualBackgroundColor as its background color and the VirtualPixmapColor
as its foreground color. The file can be either an X bitmap file, a Z
Pixmap file, or a Gif file. Color reduction can be carried out on these
images by specifying the MaxMapColors resource. If the file is NOT a
bitmap file the virtual desktop window title is changed to be the filename
part of the file and the Maximum Size window hint is set to the dimensions
of the pixmap. Default value: unused
- MaxMapColors (number of colors)*
- This integer value specifies the maximum number of colors that olvwm will
try and allocate for the VirtualBackgroundMap. If the actual number of
colors in the pixmap is greater, the colors are remapped to this number
using a 'best match' algorithm (Heckbert Median Cut). Default value:
200
- VirtualPixmapColor (color specification)*
- See above; this value only applies when the VirtualBackgroundMap has depth
1. Default value: white
- VirtualSticky (list of strings)
- The list of windows which should be sticky by default. Like the olwm
MinimalDecor, this should be the list windows which should be sticky when
they are created. The matching of these strings is done by the first word
of the window's WM_NAME (string in its title bar), or by its WM_CLASS
class/instance variables. Default value: Null
- RelativePosition (Boolean)
- If true, then user-specified window co-ordinates are assumed to be
relative to the current view into the desktop; otherwise they are absolute
with respect to the desktop. Setting to true will not allow you to bring
up windows outside your current view (unless you specify very large or
negative numbers), and setting to false will break some programs which
save window states in an odd manner. You can defeat this variable on
startup of applications by specifying which screen they should start on;
see olvwmrc(5). Default value: True
- VirtualGrid (Visible, Invisible, or None)*
- This controls two aspects of the VDM: If it's visible or invisible, the
grid is on (but it's only drawn if it's visible). If it's None, the grid
is off. If the grid is on, the VDM may only be resized in logical
screen-sized increments. Otherwise, it may resized to arbitrary sizes. If
the grid is on, SELECT/dragging the mouse within the VDM will constrain
the move to logical screens (unless the CTRL button is held down); if the
grid is off, moving the visible screen region with SELECT/drag will be
unconstrained (unless the CTRL button is held down). Default
value: Visible
- VirtualGridColor (color specification)
- If the VirtualGrid is Visible, it will be drawn in this color. Default
value: Same as VirtualFontColor
- VirtualRaiseVDM (Boolean)
- If this is true, the VDM will always appear on top of the stacking order,
never to be obscured by other windows. Default value: False
- VirtualMoveGroup (Boolean)
- If true, then whenever a window is moved to a different logical screen,
then all followers of that window will also be moved a similar amount:
this affects the window's icon and popups. In this way, icons and popups
will always appear on the same logical screen as their corresponding base
frame. Otherwise, only the selected windows will move when you move them,
and related windows could possibly appear on different logical screens in
the desktop. The trigger for changing between logical screens is the
window's mid-point; all windows in the group will appear on the same
logical screen as the mid-point of the moved window. Default
value: True
- UseImages (UseNone, UseVDM, or UseAll)
- If set to UseNone, then window frame menus and the VDM motion menu will be
text-based. If set to UseVDM, the window frame menus will be text-based,
but the VDM motion menu will be a graphic menu. If set to UseAll, the
window frame menus will be text- and image-based, and the VDM motion menu
will be image-based. Default value: UseVDM
- SortMenuType (Enum)
- This option controls how windows appearing in the WINMENU command are
sorted. If it is set to Alphabetic, then windows will be sorted
alphabetically by name. If it is set to Youngest, then windows will be
sorted from youngest to oldest. Default value: Alphabetic
- VirtualDrawSticky (True)
- If this option is set, sticky windows will have their virtual windows
drawn in the VDM just like any other window. If it is false, then sticky
windows will not have their virtual windows drawn in the VDM. Default
value: True
- StickyIcons (Boolean)
- When set, StickyIcons will cause all non-sticky windows to become sticky
when iconified. This makes all icons visible on every screen. All windows
made sticky when iconified will become unsticky when reopened. Default
value: False
- StickyIconScreen (Boolean)
- StickyIconScreen, when used in conjunction with StickyIcons, will cause
all iconified windows that are made sticky to remember the screen on which
they were closed. When one of these windows is reopened the user will be
warped back to the screen from which the window was closed and the window
is made unsticky. Default value: False
- FreeIconSlots (Boolean)
- By default, when an icon is created, it has that icon position forever
(unless it is moved manually), even when the window is not iconified. This
results in potentially large gaps in the icon area when lots of little
programs are run (clocks, load averages, etc) which are rarely iconified.
When this resource is true and a window is opened, if the icon position
what not set manually the slots are freed. The effect is that iconified
windows pack together in the corner specified by IconPlacement. If you
move an icon manually, it maintains that position. Default
value: False
- UniqueIconSlots (Boolean)
- This resource, when set to true, prevents icons from overlapping. If you
move an icon into icon grid slot(s) occupied by other icons, those icons
move. If those other icons were positioned manually, they are no longer
viewed as manually placed (unless, of course, they are subsequently
manually placed) Default value: False
- IconGridHeight (Integer)
- IconGridWidth (Integer) Previously the size of the icon grid
was fixed. An icon takes up a number of grid slots, depending on it's
size, and is aligned with the lower left corner of its lower left grid
slot. Changing the size of the grid changes how icons arrange themselves.
Default value: 13 for each
ADDITIONAL MISCELLANEOUS RESOURCES¶
These resources are not related specifically to the VDM, but are included as new
features within
olvwm.
- InputFocusColor (color specification)*
- Specifying this attribute means that the frame of the window which
currently has the input focus should be drawn in the color specified
instead of in the normal frame color. The appearance of the title bar
(with lines or indentation, depending on your input focus mode) will
remain unchanged. Default value: None (Use standard frame
color)
- RaiseOnMove (Boolean)
- If this is True, then whenever a window is moved, it is also raised to the
top of the stacking order. Default value: False
- AutoShowRootMenu (Boolean)
- If true, the root menu will come up pinned at start up. Default value:
False
- AutoRootMenuX (int)
- If AutoShowRootMenu is true, this is the X location where the menu will
come up. Default value: 0
- AutoRootMenuY (int)
- If AutoShowRootMenu is true, this is the Y location where the menu will
come up. Default value: 0
- FullSizeZoomX (Boolean)
- If this is set to True, then selecting Full Size from the window menu will
zoom the window horizontally as well as vertically. Default value:
False
- NoDecor (list of strings)
- Like Minimal Decor, this attribute takes a list of windows on which to
operate; these windows should not be decorated at all. There is a slight
difference between this attribute and setting the override_redirect flag
on a window: the latter causes olvwm to ignore completely the
window, while this attribute does not adorn the window or give it a menu,
but still allows it to be manipulated via the WINMENU and Hot Key actions.
Normal olwm keys are ignored by these windows, however.
- ResizeMoveGeometry (X geometry string or the word
center)
- This resource only has an effect if ShowMoveGeometry and/or
ShowResizeGeometry is set to True. This string specifies the location of
the geometry box when it is displayed; it should be given as an X geometry
string (wxh+x+y) although the width and height are ignored if specified.
If you want the box to be centered regardless of your monitor resolution,
use the string center instead of a geometry string. Default
value: +0+0
- PaintWorkspace (Boolean)
- If true, olvwm will paint the root workspace with the color of the
WorkspaceColor resource. If False, olvwm will not change root
workspace. Default value: True
- PointerWorkspace (Boolean)
- If true, olvwm will change the cursor when it is over window frames
and other olvwm-owned windows. If False, olvwm will not change the
cursor. This is useful in conjunction with xsetroot -cursor if you
want the specified cursor to be active over frames. Default value:
True
- SaveWorkspaceCmd (String)
- If set, this is the command that will be run when the SAVE_WORKSPACE
command is selected off the main menu. Otherwise, the default command is
run. Default value: owplaces -silent -multi -script -tw -output
$HOME/.openwin-init
- SyntheticEvents (boolean)
- This resource controls the delivery of synthetic events. This resource is
only valid if the -allowSynthetic argument was given to olvwm on startup;
if that argument was present and this resource is set to True, then olvwm
will process synthetic events. Otherwise, synthetic events are ignored.
Default value: False
- ParentScreenPopup (Boolean)
- If true the popups are placed on the same screen as their parent even if
the parent is not currently visible. Otherwise popups always appear on the
current screen. A suggested method is to place the following lines at the
end of your .xinitrc file (before the final wait command):
xrdb -merge <<'EOF'
olvwm.ParentScreenPopup: False
EOF
In this way, your session will initialize with all popups with their parents
but subsequenct popups will appear on the current screen. Default
value: True
CURSOR RESOURCES¶
These set of resources change the default cursors the window manager gives
certain classes it creates, such as resize buttons, close buttons, frames,
icons, etc. The <cursor string> is described as follows:
- <cursor font name> <cursor index> [<fore color>
[<back color>]]
where options enclosed in []'s are optional. If the <back color> is left
out, the default back color (which, in this version of OLVWM, is white) is
used. If the <fore color> is left out, then the default cursor
(foreground) color is used, which is black by default, unless set by the
cursorColor resource (see below). Note that to supply the <back color>,
you must supply the <fore color>. Also, if the color name you provide is
invalid, OLVWM will return to the default colors, as described above. As per
usual with resources, no errors are reported. The cursor font is assumed to be
encoded so that the valid mask for the cursor follows the cursor index in the
font; this is the usual behavior for font files.
There is an alternate form of <cursor string>:
- <cursor name> [<fore color> [<back color>]]
where <cursor name> is either the name of the X cursor as defined in
cursorfont.h (eg: XC_X_cursor, XC_cross, etc.), or the name of an OPEN LOOK
cursor as defined in olcursor.h (e.g.: OLC_basic, OLC_busy).
The valid <cursor>s are:
- CursorBasic
- Specify the root window cursor. Default: Basic Pointer (arrow pointing
NW)
- CursorMove
- Specify the cursor when a window is moved. Default: Basic
Pointer
- CursorBusy
- Specify the cursor for when a window is "busy". Default: Busy
Pointer (pocket watch)
- CursorIcon
- Specify cursor for the icon windows. Default: Basic Pointer
- CursorResize
- Specify cursor for the resize buttons and when window is being
"rubber-band" resized. Default: Bull's Eye
- CursorMenu
- Specify cursor for menu windows. Default: Basic Pointer
- CursorTarget
- Specify cursor for window frames. Default: Basic Pointer
- CursorCloseUp
- Specify cursor for close button, when NOT pressed (the button is UP).
Default: Basic Pointer
- CursorCloseDown
- Specify cursor for close button, when pressed (the button is DOWN).
Default: Basic Pointer
- CursorSpecialResize <Bool> [<fg corner> <bg
corner> <fg move> <bg move>]
- This is a special Cursor resource which turns on specialized resize
cursors. If <Bool> is false, then the cursor for the resize button
decorations and the "rubber-band" window are all specified by
"Cursor.Resize" as discussed above. If <Bool> is true,
then the following modifications are turned on: When the cursor is within
the resize button decorations on a frame, the cursor becomes a corner of
the appropriate orientation. When the button is selected and the window is
being "rubber-band" resized, the cursor becomes the appropriate
corner with an appropriately oriented arrow. The colors that you can
specify are limited to prevent an obscene number of resources. You can
specify the colors (foreground and background) of the cursors when placed
in the resize decoration without the mouse button down (described above as
<fg corner> and <bg corner>), and you can specify the colors
of the cursors when the mouse button is down the window is being resized
(described above as <fg move> and <bg move>). Note that you
must specify either all four colors or no colors.
ADDITIONAL KEY BINDINGS¶
Like
olwm, olvwm uses key bindings for certain actions: all actions
specified in
olwm as well as an additional set of actions to control
the view into the desktop. In the following list, the key mentioned in
parentheses is the default binding for the given action; items marked with a
plus sign '+' are items which exist in
olwm; they are included here to
describe what action they have when they occur on the root window or within
the VDM. All other bindings are specific to
olvwm; those items marked
with an asterisk '*' involve keyboard grabs. Bindings which involve a keyboard
grab (those with an asterisk) are always active, no matter where the input
focus is; otherwise the action occurs only if the root window or the VDM has
the input focus.
It's possible to change each of these bindings, see the
olwm man page for
more details.
- GrabVirtualKeys " (Boolean)"
- This resource controls whether the keys below marked as involving grabs
will be active or not. If this resource is set to False, then none of the
bindings marked below with an asterisk will ever be active. Default
value: True
- Up (up-arrow) +
- Move the view up one screen.
- JumpUp (up-arrow+Ctrl) +
- Move the view up ten screens.
- HalfUp (up-arrow+Shift)
- Move the view up one-half screen.
- VirtualUp (up-arrow+Meta) *
- Move the view up one screen.
- VirtualJumpUp (up-arrow+Ctrl+Meta) *
- Move the view up ten screens.
- VirtualHalfUp (up-arrow+Shift+Meta) *
- Move the view up one-half screen.
- Down (down-arrow) +
- Move the view down one screen.
- JumpDown (down-arrow+Ctrl) +
- Move the view down ten screens.
- HalfDown (down-arrow+Shift)
- Move the view down one-half screen.
- VirtualDown (down-arrow+Meta) *
- Move the view down one screen.
- VirtualJumpDown (down-arrow+Ctrl+Meta) *
- Move the view down ten screens.
- VirtualHalfDown (down-arrow+Shift+Meta) *
- Move the view down one-half screen.
- Left (left-arrow) +
- Move the view left one screen.
- JumpLeft (left-arrow+Ctrl) +
- Move the view left ten screens.
- HalfLeft (left-arrow+Shift)
- Move the view left one-half screen.
- VirtualLeft (left-arrow+Meta) *
- Move the view left one screen.
- VirtualJumpLeft (left-arrow+Ctrl+Meta) *
- Move the view left ten screens.
- VirtualHalfLeft (left-arrow+Shift+Meta) *
- Move the view left one-half screen.
- Right (right-arrow) +
- Move the view right one screen.
- JumpRight (right-arrow+Ctrl) +
- Move the view right ten screens.
- HalfRight (right-arrow+Shift)
- Move the view right one-half screen.
- VirtualRight (right-arrow+Meta) *
- Move the view right one screen.
- VirtualJumpRight (right-arrow+Ctrl+Meta) *
- Move the view right ten screens.
- VirtualHalfRight (right-arrow+Shift+Meta) *
- Move the view right one-half screen.
- GoHome (R11)
- Move the view to the upper left corner.
- VirtualHome (R11+Meta) *
- Move the view to the upper left corner.
- UpLeft (Home, R7) +
- Move the view NorthWest one screen.
- JumpUpLeft (R7+Ctrl) +
- Move the view NorthWest ten screens.
- HalfUpLeft (R7+Shift)
- Move the view NorthWest one-half screen.
- VirtualUpLeft (R7+Meta) *
- Move the view NorthWest one screen.
- VirtualJumpUpLeft (R7+Ctrl+Meta) *
- Move the view NorthWest ten screens.
- VirtualHalfUpLeft (R7+Shift+Meta) *
- Move the view NorthWest one-half screen.
- DownLeft (End, R13) +
- Move the view SouthWest one screen.
- JumpDownLeft (R13+Ctrl) +
- Move the view SouthWest ten screens.
- HalfDownLeft (R13+Shift)
- Move the view SouthWest one-half screen.
- VirtualDownLeft (R13+Meta) *
- Move the view SouthWest one screen.
- VirtualJumpDownLeft (R13+Ctrl+Meta) *
- Move the view SouthWest ten screens.
- VirtualHalfDownLeft (R13+Shift+Meta) *
- Move the view SouthWest one-half screen.
- UpRight (R9)
- Move the view NorthEast one screen.
- JumpUpRight (R9+Ctrl)
- Move the view NorthEast ten screens.
- HalfUpRight (R9+Shift)
- Move the view NorthEast one-half screen.
- VirtualUpRight (R9+Meta) *
- Move the view NorthEast one screen.
- VirtualJumpUpRight (R9+Ctrl+Meta) *
- Move the view NorthEast ten screens.
- VirtualHalfUpRight (R9+Shift+Meta) *
- Move the view NorthEast one-half screen.
- DownRight (R15, PgDn)
- Move the view SouthEast one screen.
- JumpDownRight (R15+Ctrl)
- Move the view SouthEast ten screens.
- HalfDownRight (R15+Shift)
- Move the view SouthEast one-half screen.
- VirtualDownRight (R15+Meta) *
- Move the view SouthEast one screen.
- VirtualJumpDownRight (R15+Ctrl+Meta) *
- Move the view SouthEast ten screens.
- VirtualHalfDownRight (R15+Shift+Meta) *
- Move the view SouthEast one-half screen.
- Screen1 (F1)
- Move to the first logical screen in the desktop.
- VirtualScreen1 (F1+Meta) *
- Move to the first logical screen in the desktop.
- Screen2 (F2)
- Move to the second logical screen in the desktop.
- VirtualScreen2 (F2+Meta) *
- Move to the second logical screen in the desktop.
- Screen3 (F3)
- Move to the third logical screen in the desktop.
- VirtualScreen3 (F3+Meta) *
- Move to the third logical screen in the desktop.
- Screen4 (F4)
- Move to the fourth logical screen in the desktop.
- VirtualScreen4 (F4+Meta) *
- Move to the fourth logical screen in the desktop.
- Screen5 (F5)
- Move to the fifth logical screen in the desktop.
- VirtualScreen5 (F5+Meta) *
- Move to the fifth logical screen in the desktop.
- Screen6 (F6)
- Move to the sixth logical screen in the desktop.
- VirtualScreen6 (F6+Meta) *
- Move to the sixth logical screen in the desktop.
- Screen7 (F7)
- Move to the seventh logical screen in the desktop.
- VirtualScreen7 (F7+Meta) *
- Move to the seventh logical screen in the desktop.
- Screen8 (F8)
- Move to the eighth logical screen in the desktop.
- VirtualScreen8 (F8+Meta) *
- Move to the eighth logical screen in the desktop.
- Screen9 (F9)
- Move to the ninth logical screen in the desktop.
- VirtualScreen9 (F9+Meta) *
- Move to the ninth logical screen in the desktop.
- Screen10 (F10)
- Move to the tenth logical screen in the desktop.
- VirtualScreen10 (F10+Meta) *
- Move to the tenth logical screen in the desktop.
- SaveWorkspace (F10+Meta+Alt+Shift) *
- Execute a Save Workspace command
- ToggleDragWindows (F6+Alt+Shift) *
- Toggles the setting of the DragWindow resource
- ToggleMoveGroups (g+Alt) *
- Toggles the setting of the VirtualMoveGroup resource
- ToggleSizeFullZoomX (F3+Alt+Shift) *
- Toggles the setting of the FullSizeZoomX resource
- ToggleSticky (s+Alt) *
- Toggles the sticky state of the window with input focus.
ADVANCED USAGE¶
olvwm will read a resource file ($HOME/.olvwmrc) for special
customizations. These customizations allow the following:
- HOT KEYS
- You can specify that when a certain key (or, more likely, key in
combination with modifiers) is pressed that certain actions are performed:
you can warp to a particular application, open, raise, or close
applications, execute applications, and quit applications.
- SCREEN BINDINGS
- You can specify that certain applications will always start on a
particular logical screen.
- MENU OPTIONS
- You can alter the behaviour of WINMENU selections on a particular
window.
Please see
olvwmrc(5) for details of these options.
COPYRIGHTS¶
The X Window system is a trademark of the Massachusetts Institute of Technology.
OPEN LOOK is a trademark of AT&T.
OpenWindows is a trademark of Sun Microsystems, Inc.
Portions (c) Copyright 1989-1991 Sun Microsystems, Inc. Sun design patents
pending in the U.S. and foreign countries. OPEN LOOK is a trademark of
AT&T. Used by written permission of the owners.
Portions (c) Copyright Bigelow & Holmes 1986, 1985. Lucida is a registered
trademark of Bigelow & Holmes. Permission to use the Lucida trademark is
hereby granted only in association with the images and fonts described in this
file.
Portions may be (c) 1990 Solbourne Computers.
Portions not covered under the above copyrights are (c) 1991 Scott Oaks.
Please see the LEGAL_NOTICES file for full disclosure of copyright information.
CREDITS¶
Most of the code in this application comes from release 3.0 of olwm, authored at
Sun Microsystems and distributed in the contrib section of MIT's X11R5. [Note
that nothing in xview3 or release 3.0 requires R5; they will happily run on R4
and exist in R5 simply because that's when they were released.]
The virtual desktop section was authored by Scott Oaks, who is responsible for
its maintenance. Please direct any comments to scott.oaks@sun.com. This code
is not supported by Sun Microsystems in any way.
Notwithstanding the above, the staff at Sun Microsystems, and especially Stuart
Marks, deserve credit as original author of olwm for most of the work
contained in this application.
Innumerable people have made fixes and enhancements to olvwm, and I'm very bad
at listing them all (but drop me a note and I'll do better in a future release
:-)). Thus, the following list is by no means comprehensive, but these people
have all provided something to olvwm: Tor Arntsen, Paul Andrews, Rich Berlin,
David Boyd, David Chase, John Durand, Alexander Dupuy, Paul Eggert, Eric
Fifer, Duane Gibson, Jimmy Guggemos, Orest Jarosiewicz, Russel Kegley, Murray
Laing, Tom McConnell, Blair MacIntyre, Chuck Musciano, Matthias Pfuetzner,
David Plotkin, Harry Protoolis, Nir Samburski, Andreas Stolcke, Hinrich
Tobaben, Larry Virden, Ken West, and Ron Winacott.