home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 October / Amiga_Games_Extra_CD_10-96.bin / userbox / publicdomain / lupe / lupe.dok < prev    next >
Text File  |  1996-06-19  |  6KB  |  151 lines

  1.  
  2.             Lupe
  3.  
  4.             Version :   1.5a
  5.             Datum   :   13.6.96
  6.             Autor   :   Frank Toepper
  7.  
  8.  
  9. COPYRIGHT
  10.  
  11. Lupe ist Public Domain, jedermann kann es also ohne irgendwelche Gebühren
  12. benutzen und nach Belieben weiterkopieren.
  13.  
  14.  
  15. EINFÜHRUNG
  16.  
  17. Das Programm stellt einen Teil des Screens vergrößert in einem seperaten
  18. Fenster dar.
  19.  
  20.  
  21. BENUTZUNG
  22.  
  23. Das Programm kann von der Workbench oder vom CLI aus gestartet werden.
  24. Es wird immer versucht folgende Tooltypes auszuwerten:
  25.  
  26. CX_PRIORITY    : Eine Zahl zwischen -128 und 127 die die Priorität des
  27.                   Commodities angibt. Hiermit entscheidet das System in
  28.                   welcher Reihenfolge die Commodities die Nachrichten
  29.                   (z.B. MOUSEMOVE wenn die Mouse bewegt wurde) erhalten.
  30.                   Das Commodity mit der größten Priorität erhält die
  31.                   Nachricht als erstes.
  32.                   Voreingestellt ist 0.
  33. FAST           : Das Fenster wird öfter neu gezeichnet.
  34.                   Voreingestellt ist NO.
  35. SCALEFACTOR    : Der Vergrößerungsfaktor.
  36.                   Voreingestellt ist 5.
  37. MAXSCALEFACTOR : Der maximale Vergrößerungsfaktor (zwischen 5 und 30)
  38.                   Voreingestellt ist 15.
  39. COORDINATES    : Im unteren Fensterrahmen werden die Mousekoordinaten
  40.                   angezeigt.
  41.                   Voreingestellt ist NO.
  42. CROSSHAIR      : Ein Fadenkreuz visualisiert die Position der Mouse.
  43.                   Voreingestellt ist NO.
  44. FIXED          : Ist dieses Flag YES/ON wird der Mittelpunkt des zu
  45.                   vergrößernden Ausschnitts nicht durch die aktuellen
  46.                   Mousekoordinaten beschrieben, sondern ist solange fest,
  47.                   bis mit der linken Mousetaste in das Fenster geklickt
  48.                   wird. Nun kann bei gehaltener Taste der Abschnitt
  49.                   verschoben werden, bis die Taste losgelassen wird.
  50.                   Voreingestellt ist NO.
  51. SETORIGINKEY   : Ein Hotkey um einen imaginären Ursprung zu setzen.
  52.                   Voreingestellt ist 'lalt o'.
  53. RESETORIGINKEY : Ein Hotkey um den imaginären Ursprung wieder auf 0,0
  54.                   zurückzusetzen.
  55.                   Voreingestellt ist 'lalt r'.
  56. SHOWHIDEKEY    : Ein Hotkey um das Fenster zu öffnen/schließen.
  57. WINLEFT
  58. WINTOP
  59. WINWIDTH
  60. WINHEIGHT      : Diese Werte bescheiben die Position und Dimension des
  61.                   Fensters.
  62. HIDE           : Das Fenster wird nicht geöffnet.
  63. HIDEONCLOSE:   : Beim drücken des Schließknopfes wird das Fenster
  64.                  geschlossen, aber das Programm nicht beendet.
  65.  
  66. Beim Start vom CLI kann man diese Argumente angeben und gegebenenfalls die
  67. Werte der Tooltypes überladen:
  68.  
  69. "CX_PRIORITY=P/N/K, FAST=F/S/K, MAXSCALEFACTOR=M/N/K, SCALEFACTOR=S/N/K,
  70.  WINLEFT=L/N/K, WINTOP=T/N/K, WINWIDTH=W/N/K, WINHEIGHT=H/N/K,
  71.  COORDINATES=C/S/K, CROSSHAIR=R/S/K, SETORIGINKEY=O/K, RESETORIGINKEY=K/K,
  72.  FIXED=D/S/K, SHOWHIDEKEY=SH/K, HIDE/S/K, HIDEONCLOSE/S/K"
  73.  
  74. Die Werte entsprechen den Tooltypes.
  75.  
  76. Der Vergrößerungsfaktor läßt sich mit dem Proportionalgadget im rechten
  77. Fensterrahmen einstellen.
  78.  
  79. Das Menü:
  80.  
  81. Jump           : Springt zum nächsten Screen.
  82. Jump To Screen : Ein Untermenu mit den zur Zeit offenen Screens. Der
  83.                   angewählte Screen wird direkt angesprungen.
  84. Enable         : Hier kann die Lupe aktiviert oder deaktiviert werden.
  85. Fixed          : Schalted den Fixed-Mode ein/aus.
  86.                   Ist es eingeschalet wird der Mittelpunkt des zu
  87.                   vergrößernden Ausschnitts nicht durch die aktuellen
  88.                   Mousekoordinaten beschrieben, sondern ist solange fest,
  89.                   bis mit der linken Mousetaste in das Fenster geklickt
  90.                   wird. Nun kann bei gehaltener Taste der Ausschnitt
  91.                   verschoben werden, bis die Taste losgelassen wird.
  92. Fast           : Schalted den Fast-Mode ein.
  93. Coordinates    : Schaltet die Anzeige der Mousekoordinaten im unteren
  94.                   Fensterrahmen ein.
  95. Crosshair      : Schaltet das Fadenkreuz ein.
  96. About          : Zeigt Informationen zum Programm.
  97. Hide On Close  : Ist es eingeschaltet beendet sich das Programm beim
  98.                  betätigen des Schließknopfes nicht.
  99. Hide           : Schließt das Fenster. Es kann mit dem Hotkey oder mit dem
  100.                   Programm 'Exchange' wieder geöffnet werden.
  101. Quit           : Beendet das Programm.
  102.  
  103. Die Tastaturbelegung:
  104.  
  105. '+'      : Vergrößerungsfaktor + 1
  106. '-'      : Vergrößerungsfaktor - 1
  107. 'J'      : Sprung zum nächsten Screen.
  108. 'E'      : aktiviert/deaktiviert die Lupe.
  109. 'F'      : Fast-Mode ein/aus.
  110. 'C'      : Anzeige der Koordinaten ein/aus.
  111. 'R'      : Fadenkreuz ein/aus.
  112. 'O'      : setzt den imaginären Ursprung auf die aktuellen
  113.             Mousekoordinaten.
  114. 'K'      : setzt den imaginären Ursprung zurück auf 0,0.
  115. 'D'      : Schaltet den Fixed-Mode ein/aus.
  116. '?','A'  : Zeigt Informationen über das Programm.
  117. 'I'      : Das Programm beendet sich beim betätigen des Schließknopes
  118.             nicht.
  119. 'H'      : Schließt das Fenster.
  120. 'Q',ESC  : Beendet das Programm.
  121. Zusätzlich kann im Fixed-Mode der Ausschnitt mit den Cursortasten bewegt
  122. werden. Wobei der Ausschnitt bei gleizeitig gedrückter Shift-Taste um
  123. eine 'Seite', bei gleichzeitig gedrückter alt-Taste zu den Extrema und
  124. sonst um ein Pixel bewegt wird.
  125.  
  126.  
  127. DISCLAIMER
  128.  
  129. Du benutzt Lupe auf eigenes Risiko. Ich kann für keinerlei Schäden, die
  130. durch Benutzung von Lupe entstehen, zur Rechenschaft gezogen werden.
  131.  
  132.  
  133. AUTOR
  134.  
  135. Bugreports oder was auch immer an:
  136.  
  137.    Frank Toepper
  138.    Maxim Gorki Straße 5A
  139.    Greifswald
  140.    17491
  141.    Deutschland
  142.  
  143. oder via e-Mail (bevorzugt): toepper@rz.uni-greifswald.de
  144.  
  145.  
  146. CREDITS
  147.  
  148. Mein Dank geht an Thomas Byrer und Allan Odgaard für die Ideen und
  149. Anregungen und an die Betatester Ralph Wermke und Ronny Dudeck von
  150. Digital Innovations, sowie Michael Knoke.
  151.