Lupe

            Version :   1.4
            Date    :   7-Apr-96
            Autho   :   Frank Toepper


COPYRIGHT

This program is Public Domain, everybody can use it without any charges
and you can copy it freely.


INTRODUCTION

This program magnifies an area of the screen and displays it in a seperate
window.


USAGE

This program can be started from Workbench or CLI.
It was tried to evaluate the following tooltypes:

CX_PRIORITY    : A number between -128 and 127 which set the priority of
                  the commodity. With that the system decides in which
                  succession the commodities gets the messages.
                  The commodity with the highest priority gets the message
                  first.
                  Default is 0.
FAST           : The window will often redrawn.
                  Default is NO.
SCALEFACTOR    : Default is 5.
MAXSCALEFACTOR : The maximum scalefactor (between 5 and 30)
                  Default is 15.
COORDINATES    : In the bottom border the mouse coordinates will be
                  displayed.
                  Default is NO.
CROSSHAIR      : A crosshair visualised the position of the mouse.
                  Default is NO.
FIXED          : When this flag is YES/ON the center of the magnified area
                  was not described by the mouse coordinates but it's fixed
                  until you clicked into the window.
                  Now with the holded left mousebutton you can move the area.
                  Default is NO.
SETORIGINKEY   : A hotkey to set an imaginary origin.
                  Default is 'lalt o'.
RESETORIGINKEY : A hotkey to reset the imaginary origin to 0,0.
                  Default is 'lalt r'.
WINLEFT
WINTOP
WINWIDTH
WINHEIGHT      : This values describes the position and dimension of the
                  window.

By starting from CLI you can specify these arguments and overload the
tooltypes.

"CX_PRIORITY=P/N/K,FAST=F/S/K,MAXSCALEFACTOR=M/N/K,SCALEFACTOR=S/N/K,
WINLEFT=L/N/K,WINTOP=T/N/K,WINWIDTH=W/N/K,WINHEIGHT=H/N/K,
COORDINATES=C/S/K,CROSSHAIR=R/S/K,SETORIGINKEY=O/K,RESETORIGINKEY=K/K,
FIXED=D/S/K"

The values are the same as the tooltypes.

The scalefactor can be set with the proportional gadget nested in the right
windowborder.

The menu:

Jump           : Jumps to the next screen.
Jump To Screen : A submenu with the actually opened screens. The window was
                  opened on the selected screen.
Enable         : Here you can enable or disable the lens.
Fixed          : Switches the Fixed-mode on/off.
                  If it's on the center of the magnified area was not
                  described by the mouse coordinates but it's fixed
                  until you clicked into the window.
                  Now with the holded left mousebutton you can move the area.
Fast           : Switches to the Fast mode.
Coordinates    : Shows the mouse coordinates in the bottom windowborder.
Crosshair      : Switches the crosshair ON/OFF.
About          : Shows program information.
Quit           : Leaves the program.

The keys:

'+'      : Scalefactor + 1
'-'      : Scalefactor - 1
'J'      : Jump to next screen.
'E'      : activates/deactivates the lens.
'F'      : Fast-mode on/off.
'C'      : Coordinates on/off.
'R'      : Crosshair on/off.
'O'      : set the imaginary origin to the actuall mouse coordinates.
'K'      : reset the imaginary origin to 0,0.
'D'      : Switches the Fixed-mode on/off.
'?','A'  : Shows program information.
'Q',ESC  : Leaves the program.
Additionally in Fixed-mode the area can be moved by the cursorkeys.
Whereby the area will be moved by one 'page' with pressed shift-key, to
the extremity with pressed alt-key or else 1 pixel.


DISCLAIMER

Allright, here it is : you use Lupe at your own risk. I cannot be
responsible to any damage happening when using it.


AUTOR

Bugrepots or what ever you want to:

   Frank Toepper
   Maxim Gorki Straße 5A
   Greifswald
   17491
   Germany

or via e-Mail (prefered): toepper@rz.uni-greifswald.de


CREDITS

Thanks go to Thomas Byrer for his ideas and to the betatester Ralph Wermke
and Ronny Dudeck of Digital Innovations and Michael Knoke.