home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / Lupe17.lha / lupe.dok < prev    next >
Encoding:
Text File  |  1996-11-18  |  6.6 KB  |  172 lines
  1.  
  2.             Lupe
  3.  
  4.             Version :   1.7
  5.             Datum   :   18.11.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. ICONIFY        : Das Fenster wird nicht geöffnet.
  63.                   Voreingestellt ist NO.
  64. ICONIFYONCLOSE : Beim drücken des Schließknopfes wird das Fenster
  65.                   geschlossen, aber das Programm nicht beendet.
  66.                   Voreingestellt ist OFF.
  67. GRID           : Schaltet das Gitter ein.
  68.                   Voreingestellt ist OFF.
  69. SHOWRGB        : Zeigt die Farbwerte des aktuellen Pixels im unteren
  70.                   Fensterrahmen an.
  71.                   Voreingestellt ist OFF.
  72. IFFFILE        : Pfad und Name des Iff-Files.
  73.                   Voreingestellt ist 'ram:Lupe.iff'
  74.  
  75.  
  76. Beim Start vom CLI kann man diese Argumente angeben und gegebenenfalls die
  77. Werte der Tooltypes überladen:
  78.  
  79. "CX_PRIORITY=P/N/K, FAST=F/S/K, MAXSCALEFACTOR=M/N/K, SCALEFACTOR=S/N/K,
  80.  WINLEFT=L/N/K, WINTOP=T/N/K, WINWIDTH=W/N/K, WINHEIGHT=H/N/K,
  81.  COORDINATES=C/S/K, CROSSHAIR=R/S/K, SETORIGINKEY=O/K, RESETORIGINKEY=K/K,
  82.  FIXED=D/S/K, SHOWHIDEKEY=SH/K, ICONIFY=I/S/K, ICONIFYONCLOSE=IOC/S/K,
  83.  GRID=G/S/K, SHOWRGB=RGB/S/K, IFFFILE=IF/K"
  84.  
  85. Die Werte entsprechen den Tooltypes.
  86.  
  87. Der Vergrößerungsfaktor läßt sich mit dem Proportionalgadget im rechten
  88. Fensterrahmen einstellen.
  89.  
  90. Das Menü:
  91.  
  92. Jump             : Springt zum nächsten Screen.
  93. Jump To Screen   : Ein Untermenu mit den zur Zeit offenen Screens. Der
  94.                     angewählte Screen wird direkt angesprungen.
  95. Save IFF...      : Speichert den aktuellen Fensterinhalt als Iff-Bild.
  96.                     (nicht im 1:1 Mode)
  97. Enable           : Hier kann die Lupe aktiviert oder deaktiviert werden.
  98. Fixed            : Schaltet den Fixed-Mode ein/aus.
  99.                     Ist es eingeschalet wird der Mittelpunkt des zu
  100.                     vergrößernden Ausschnitts nicht durch die aktuellen
  101.                     Mousekoordinaten beschrieben, sondern ist solange fest,
  102.                     bis mit der linken Mousetaste in das Fenster geklickt
  103.                     wird. Nun kann bei gehaltener Taste der Ausschnitt
  104.                     verschoben werden, bis die Taste losgelassen wird.
  105. Fast             : Schaltet den Fast-Mode ein.
  106. Coordinates      : Schaltet die Anzeige der Mousekoordinaten im unteren
  107.                     Fensterrahmen ein.
  108. Crosshair        : Schaltet das Fadenkreuz ein.
  109. Grid             : Schaltet das Gitter ein/aus.
  110. Show RGB         : Zeigt die Farbwerte des aktuellen Pixels im unteren
  111.                     Fensterrahmen an.
  112. About            : Zeigt Informationen zum Programm.
  113. Iconify On Close : Ist es eingeschaltet beendet sich das Programm beim
  114.                     betätigen des Schließknopfes nicht.
  115. Iconify          : Schließt das Fenster. 
  116. Quit             : Beendet das Programm.
  117.  
  118. Die Tastaturbelegung:
  119.  
  120. '+'      : Vergrößerungsfaktor + 1
  121. '-'      : Vergrößerungsfaktor - 1
  122. 'J'      : Sprung zum nächsten Screen.
  123. 'S'      : IFF-Save.
  124. 'E'      : aktiviert/deaktiviert die Lupe.
  125. 'F'      : Fast-Mode ein/aus.
  126. 'C'      : Anzeige der Koordinaten ein/aus.
  127. 'R'      : Fadenkreuz ein/aus.
  128. 'O'      : setzt den imaginären Ursprung auf die aktuellen
  129.             Mousekoordinaten.
  130. 'K'      : setzt den imaginären Ursprung zurück auf 0,0.
  131. 'D'      : Schaltet den Fixed-Mode ein/aus.
  132. '?','A'  : Zeigt Informationen über das Programm.
  133. 'I'      : Das Programm beendet sich beim betätigen des Schließknopes
  134.             nicht.
  135. 'H'      : Schließt das Fenster.
  136. 'G'      : Schaltet das Gitter ein/aus.
  137. 'W'      : Schaltet die Anzeige der RGB-Werte ein/aus.
  138. 'Q',ESC  : Beendet das Programm.
  139. Zusätzlich kann im Fixed-Mode der Ausschnitt mit den Cursortasten bewegt
  140. werden. Wobei der Ausschnitt bei gleizeitig gedrückter Shift-Taste um
  141. eine 'Seite', bei gleichzeitig gedrückter alt-Taste zu den Extrema und
  142. sonst um ein Pixel bewegt wird.
  143.  
  144.  
  145. DISCLAIMER
  146.  
  147. Du benutzt Lupe auf eigenes Risiko. Ich kann für keinerlei Schäden, die
  148. durch Benutzung von Lupe entstehen, zur Rechenschaft gezogen werden.
  149.  
  150.  
  151. AUTOR
  152.  
  153. Bugreports oder was auch immer an:
  154.  
  155.    Frank Toepper
  156.    Maxim Gorki Straße 5A
  157.    Greifswald
  158.    17491
  159.    Deutschland
  160.  
  161. oder via e-Mail (bevorzugt): toepper@rz.uni-greifswald.de
  162.  
  163. WWW: http://www.user.fh-stralsund.de/~rwermke/di_ger.html
  164.  
  165.  
  166. CREDITS
  167.  
  168. Mein Dank geht an Thomas Byrer, Allan Odgaard, Tilo KÜhn, Troels Walsted
  169. Hansen, Olaf Groener, Philippe Casidy und John Wehler für die
  170. Ideen und Anregungen, an die Betatester Meni Berman, Ralph Wermke und
  171. Ronny Dudeck, sowie Michael Knoke.
  172.