Lupe

            Version :   1.7
            Date    :   11-November-96
            Author  :   Frank Toepper


COPYRIGHT

This program is Public Domain, everybody can use it without charge 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 will try 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'.
SHOWHIDEKEY    : A hotkey to open/close the window.
WINLEFT
WINTOP
WINWIDTH
WINHEIGHT      : These values describes the position and dimension of the
                  window.
ICONIFY        : The window will not opened.
                  Default is NO.
ICONIFYONCLOSE : If you press the closebutton the program will not be ending.
                  Default is NO.
GRID           : This turns on the grid.
                  Default is OFF.
SHOWRGB        : In the bottom border the color values will be displayed.
                  Default is OFF.
IFFFILE        : Pfad und Name des Iff-Files.
                  Default is 'ram:Lupe.iff'


By starting from CLI you can specify these arguments and override 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, SHOWHIDEKEY=SH/K, ICONIFY=I/S/K, ICONIFYONCLOSE=IOC/S/K,
 GRID=G/S/K, SHOWRGB=RGB/S/K, IFFFILE=IF/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.
Save IFF...      : Saves the actual contents of the window as iff file.
                    (not available in the 1:1 mode)
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.
Grid             : This turns on/off the grid.
Show RGB         : In the bottom border the color values will be displayed.
About            : Shows program information.
Iconify On Close : If you press the closebutton the program will not be ending.
Iconify          : Closes the window. You can open it again by pressing the
                    hotkey or with the program 'Exchange'.
Quit             : Leaves the program.

The keys:

'+'      : Scalefactor + 1
'-'      : Scalefactor - 1
'J'      : Jump to next screen.
'S'      : IFF save.
'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.
'I'      : If you press the closebutton the program will not be ending.
'H'      : Closes the window.
'G'      : Turns on/off the grid.
'W'      : Turns on/off the show RGB.
'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 for any damage happening caused by using it.


AUTHOR

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

WWW: http://www.user.fh-stralsund.de/~rwermke/di_ger.html


CREDITS

Thanks goes to Thomas Byrer, Allan Odgaard, Tilo KÜhn, Troels Walsted
Hansen, Olaf Groener, Philippe Casidy und John Wehler for their
ideas, to the betatesters Meni Berman, Ralph Wermke, Ronny Dudeck and
Michael Knoke.