                         -------------------
                     -=  sysVWM version 6.2  =-
                         -------------------
Thanks goes to jugg(jugg@dylern.com) for creating this build.
---------------
I: Installation
---------------

LoadModule c:\litestep\sysvwm.dll

Or inside wharf, add this line (still loading wharf.dll):

*Wharf "sysVWM" .none @sysvwm.dll

Recycle litestep, and you are good to go!

II: Features
---------------
Mouse functions

VWMMouseRight #
Defines which functions right mouse button do. Defaults to 1.
VWMMouseLeft #
Defines which functions left mouse button do. Defaults to 2.
VWMMouseMiddle #
Defines which functions middle mouse button do. Defaults to 0.

Valid entries for the above are: 0 - disables mouse button, 1 - button
will switch to the vwm that you click on, 2 - button will drag the 
miniwindows and the vwm.

Drag and drop is also supported. You can drop a file on sysVWM, and the 
file will open inside the virtual desktop that you drop it on.

COMMANDS (step.rc and !bang)
In addition to the normal "undocked" mode, sysVWM can be loaded as a wharf
module, allowing you to use the more advanced options even while docked 
inside the wharf. Some options are disabled when on the wharf, like the 
ability to specify your own height, width, and x,y positioning. Generally,
if an option doesn't make sense to be available to a wharf module, then it
has probably been disabled. Rollup is disabled, Reset does nothing, etc. 

	*Wharf "sysVWM" .none @sysvwm.dll

The module does not load anything out of the bitmap parameter, but it is 
still needed so that wharf.dll will load sysVWM. sysVWM will use its 
regular method for displaying bitmaps. 

VWMNoSwitchOnFocus
Prevents automatic virtual desktop switching when the system focus changes
to a window that is outside the current desktop.

VWMFocusCenter
Sets your system focus to whatever window is in the center of the screen 
when you switch desktops.

VWMNoShow
Sets initial mode for !VWMRollup to hidden. In other words, the vwm will 
be hidden when this option is used. !VWMRollup would be used to display 
the vwm.

VWMNoGathering
Prevents automatic "gathering" of all windows to the first virtual desktop
upon a recycle of litestep.

VWMNoMove
Disables the ability to drag the vwm around.

VWMShowIcons
sysVWM will paint an icon inside each miniwindow. The icon associated 
with the task that the miniwindow represents will be used.

VWMIconSize #
Specifies size of each icon. Default is 16.

VWMAutohide
Enables autohide features. Autohide will work only when the vwm is docked 
against one of the sides of the screen. If you drag the vwm away from the 
side it is docked on, autohide will be turned off until the vwm is 
returned to the side of the screen again.

VWMAutohideDistance #
When autohide features are enabled, this value is used to determine how 
close to the edge of the screen you must be to show the vwm. This value 
will default to 3 if not used.

VWMAutoSwitch
This feature will allow sysVWM to automatically switch desktops when your 
mouse cursor reaches the edge of the screen. For example, if you move your
mouse to the right edge of your screen, then sysVWM will switch to the 
next desktop to the right.

VWMAutoSwitchDistance #
This value determines how far from the edges of the screen your cursor 
needs to be before VWMAutoSwitch kicks in and changes your desktop. This 
setting defaults to 1.

VWMAutoSwitchDelay #
When VWMAutoSwitch is enabled, this value determines the approximate 
number of milliseconds to wait before switching vwm's when the mouse 
reaches the edge of the screen. Default is 50. 

VWMTitlebars
Enables the titlebars on the windows in the miniview.

VWMTitlebarMod #
sysVWM will use this modifier when calculating the height of the titlebars.
sysVWM will divide the height of the desktop by this modifier, then 
display a titlebar at that ratio. So if you specified VWMTitlebarMod 2, 
then your titlebars would be half the height of each virtual window. This 
setting defaults to 16.

VWMBevel
Enables the bevel on windows in the miniview. The bevel highlight will 
use the color specified in VWMForeColor, and the shadow will use 
VWMBorderColor. The windows will then be filled with the color specified 
in VWMWinColor.

VWMSnapWidth #
When dragging the vwm window around, it will snap to the edge of the 
screen when it comes within the number of pixels specified in #.

VWMAlwaysOnTop
Keeps the vwm window above all other windows. If this is not specified, 
sysVWM will be below all other windows.

*VWMSticky <text>
Enables and defines sticky settings. When you switch desks, sysVWM will 
match the <text> against the window titles and classes in your current 
virtual desktop, and any windows that match will be carried to the new 
desktop.

VWMForeColor ######
Sets the color of the "mini-windows" that represent an open window.

VWMBackColor ######  Sets the color of the background for sysVWM.

VWMSelBackColor ######  Sets color of shading applied to selected desktop.

VWMBorderColor ######
Used for the border of the "mini-windows", and the dividing lines between 
each desktop window.

VWMWinColor ######
Sets the color of the background of the windows when VWMBevel is specified.

VWMUseInitialDesk
Allows usage of VWMInitialDesk.

VWMInitialDesk #
Starts the VWM on the specified desktop.

VWMDesksX #  Number of desktops on the X axis.

VWMDesksY #  Number of desktops on the Y axis.

VWMx #
Tells sysVWM how many pixels down from the top of the screen you want the 
vwm to be placed at. Negative numbers are also valid, and will make 
sysVWM use the bottom of the screen.

VWMy #
Tells sysVWM how many pixels across from the left side of the screen you 
want the vwm to be placed at. Negative numbers are also valid, and will 
make sysVWM use the right side of the screen.

VWMwidth #
The width of the entire vwm.

VWMheight #
The height of the entire vwm.

VWMBackBmp <bitmap>
sysVWM will use this bitmap instead of the color specified in VWMBackColor.
VWMBackBmp .snapshot will take a snapshot of the desktop to use as the 
background here.

VWMSelBmp <bitmap>
Makes sysVWM ignore the VWMSelBackColor and use this bitmap to paint on 
the background of the selected virtual window.

VWMTitlebarBmp <bitmap>
Uses a bitmap for the titlebar representations in the miniviews. If a 
bitmap is not specified here, then VWMBorderColor will be used to fill 
the titlebars.

VWMWinBmp <bitmap>
This bitmap will be used for the tiny windows in the miniviews. 
VWMForeColor will be used if no bitmap is specified here.

!VWMUp, !VWMDown, !VWMLeft, !VWMRight
Using these bang commands will change the active desktop, moving one 
desktop over in the direction specified.

!VWMDesk #
Changes the active desktop, moving your focus to the desktop specified 
with #.

!VWMRollup
You can hide sysVWM by using the bang command !VWMRollup. This command 
will hide and show the vwm, acting as a toggle.

!VWMReset
This will reload the step.rc settings for the vwm. Useful for when you 
drag the vwm to a place where you can't get at it anymore. Just hit 
!VWMReset, and it reloads the vwm at the coordinates you set in the 
step.rc.

!VWMGather
Brings all open windows to your current desktop. This command functions 
independently of VWMNoGathering.

!VWMOpen <desk> <command> <parameters>
Opens the file or program specified in <command> with the given 
<parameters> within the virtual desktop specified in <desk>. For example, 
the command !VWMOpen 0 notepad will open notepad in the top left vwm.

!VWMMoveApp <direction>
This command will move the active window one virtual desktop over in the 
direction you specify for <direction>. Valid directions are Up, Down, 
Left, and Right. 

EOF