LWB 1.0 , 8 August 1991
                             Little Workbench


I. Motivation

First: I was teached english at school about 5 years ago and i did not used
it very much. So do not wonder about mistakes!	
	
I am used to work on a Sun Workstation at my university under the
twm-Manager of XWindows. It is possible to have a virtual Screen much
larger than the real Monitor-Screen like the AMIGA OS 2.0 supports.
To manage the movement within your large virtual screen you get a small
window in the lower right of the real screen which is a representative of
the whole available virtual screen.
All windows on the virtual screen are drawn in it and you can move them all
by dragging their representatives. 
The shown clipping can be moved, too within this window.

I like this feature very much because you can have a lot of different
windows open without overlapping each other. So i decided to program such a
utility for the AMIGA.




II. Implementation and using

I used the DICE-C-Compiler written by Matt Dillon which is really worth
buying. The OS-2.0 INCLUDE-Files are also included by Matt so there were no
major problems beside my own little knowledge about the AMIGA-OS.

In this first version it is only possible to drag the representative of
your real view and not to drag all visible windows.
You can press and release the left-mouse-button (lmb) at every location of
the LWB-window and soon your real view will show the choosen clipping.
Another method is to press the lmb and hold it down. Now you are able to
move the representative of the real-view within the LWB-window borders.
Release the lmb at the desired location and you will get the correct
clipping.

Attention:
If you (or a program) open a window LWB does not notice this !! You have
to force LWB to update by using the AUTOSCROLL-feature of the Workbench
Screen or by pressing the right-mouse-button within the LWB-window

I would like to get help at this point to make automatic updates of the
representative Workbench window possible (possibly a patch using
SetFunction and OpenWindow could make it but when i replace OpenWindow with
my own code how can i handle the original features of OpenWindow) so please
contact me.



III. Starting LWB

You must start LWB from the CLI (eg. in your startup-sequence) using the
run(back) command (how can i detach a program using DICE??).

The syntax is :
            LWB <virtual_width> <virtual_height> [<correcting>]

where virtual_width and virtual_height are the resolution parameters you
choose in the screen-mode-preferences-program (OS 2.0 only).
Correcting is optional. I included it for those people using utilities 
like 60Hz to increase the refresh-rate of their display. 
I use workbenchscreen->Height to get your visible vertical resolution and
if you use such a utility the workbenchscreen->Height is not changed! So
you must calculate how much lines are lost and use the third option to tell 
LWB about the difference to the resolution I get from the screen-structure.

I could not figure out how to get these values from the AMIGA-OS. If you 
know a solution please post it to me (see address-section).




IV. Copyright
	
This program is written and copyrighted by

                               Jörg Wesemann
                             Auf der Heide 12
                            W 2807 Achim-Baden
                                  Germany
                   Phone: (Germany) - (0) 4202 - 75518


Permission to copy this program freely is givven to Fred Fish. You may even
copy it using FTP-sites, mail-boxes, UUCP and so on, but you must copy the
whole bunch which consists of:
		1. The executable      LWB
		2. The source          LWB.c
		3. The makefile        makefile
		4. The documentation   LWB.doc


                                Attention: 
								==========
PD-dealers must not copy this program if they get more than 5 DM 
(german marks) per disk. Especially german pd-dealers are intended to
follow this restriction!!




V. Addresses

My e-mail addresses are:

                      
                      b15l@dhbrrz41.bitnet (prefered)
                                    or
                      joergw@informatik.uni-bremen.de