home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0400 / CCE_0449.ZIP / CCE_0449.PD / EYES.DOK < prev   
Encoding:
Text File  |  1991-05-01  |  6.5 KB  |  135 lines
  1. ****************************************************************
  2. *                                                              *
  3. *                    EYES       V 1.00                         *
  4. *                                                              *
  5. * Public domain accessory fuer Atari ST (monochrom und Farbe)  *
  6. *                                                              *
  7. *                          von                                 *
  8. *                                                              *
  9. *                    Peter Kirchgessner                        *
  10. *                    Laubenheimer Str. 78                      *
  11. *                    W6500 Mainz-Weisenau                      *
  12. *                                                              *
  13. * Kurzbeschreibung: Zwei Augen beobachten den Mauszeiger       *
  14. * Entwicklungsumgebung: Atari Mega ST 1, Blitter TOS,          *
  15. *   Laser C V2.0 und Turbo C V2.0                              *
  16. * Ablaufumgebung: alle Atari ST, (STE, TT ?)                   *
  17. ****************************************************************
  18.  
  19. Das Accessory umfasst folgende Dateien:
  20.  
  21.    EYES.ACC      Das uebersetzte Accessory
  22.    EYES.C        C-Quelltext (V 1.00)
  23.    EYES.DOK      Diese Dokumentation
  24.    EYES.MKE      Make-Datei fuer Laser C V2.0
  25.    EYES.PRJ      Projekt-Datei fuer Turbo C V2.0
  26.  
  27. Alle Dateien sind Public Domain, duerfen aber nur zusammen
  28. und unveraendert weitergegeben werden. Fuer den eigenen Gebrauch
  29. duerfen die Dateien beliebig modifiziert werden.
  30.  
  31. Herkunft:
  32. =========
  33. Das Vorbild von EYES ist ein Programm, das waehrend der
  34. CeBIT 90 auf Workstations von Silicon Graphics ablief.
  35. Nachdem auf der CeBIT 91 auch solche Programme bei Commodore
  36. auftauchten, war es hoechste Zeit, zur Tat zu schreiten.
  37.  
  38.  
  39. Arbeitsweise:
  40. =============
  41. In einem Fenster werden zwei Ellipsen gezeichnet. In jeder
  42. Ellipse bewegt sich ein Rechteck derart, dass es immer auf
  43. der Strecke Ellipsenzentrum - Mauszeiger liegt. Da das ganze
  44. aber aussieht wie zwei Augen mit Pupillen, sei im folgenden
  45. auch von Augen die Rede.
  46. Damit die Augen dem Mauszeiger folgen koennen, wird das Accessory
  47. alle 0.15 Sekunden aktiviert (Timer-event von event_multi).
  48. Hat sich die Position des Mauszeigers nicht veraendert, wird
  49. gleich wieder 0.15 Sekunden gewartet. Ansonsten berechnet
  50. das Accessory die neue Position der Augen und aendert sie falls
  51. noetig. Damit die Augen ohne eigenes zutun staendig sichtbar sind,
  52. muss das Accessory das Fenster automatisch oeffnen koennen.
  53. In diesem Fall wird auch bei geschlossenem Fenster mittels des
  54. Timer-events von event_multi eine zeitlang gewartet, und dann
  55. das Fenster automatisch geoeffnet. Um die Arbeitsumgebung nicht
  56. zu veraendern, wird das Fenster, das vor dem automatischen Oeffnen
  57. das "Top-Window" war, wieder restauriert. Sollten die Augen, oder
  58. genauer gesagt das gesamte Fenster, verdeckt sein, sucht das
  59. Accessory einen freien Platz. Das Fenster wird dann an diese Stelle
  60. positioniert. Diese Positionierung findet nur bei einer (verdeckten)
  61. Aenderung der Augenpositionen und einem dadurch verursachten
  62. "Neuzeichnen" statt. Wer das beobachten moechte, muss also die
  63. Maus verschieben.
  64. Zum eigenhaendigen Bewegen muss erst innerhalb des Fensters geclickt
  65. werden, um es zum Top-window zu machen. Danach kann es mit
  66. gedrueckter linker Maustaste bewegt werden. Bei einem Doppelclick
  67. wird das Fenster geschlossen und auch nicht mehr automatisch
  68. geoeffnet. Das Accesssory wartet jetzt nur noch auf die Aktivierung
  69. seines Menueeintrages. Mit einer Aktivierung wird auch das auto-
  70. matische Oeffnen wieder zugelassen.
  71.  
  72.  
  73. Verschiedenes
  74. =============
  75. Das Accessory kann nach Umbenennung in EYES.PRG als normales
  76. Programm gestartet werden.
  77. Da das Fenster keine Titelzeile benutzt, sieht man ihm nicht an,
  78. ob es das Top-window ist. Dies kann zu Problemen fuehren, wenn man
  79. das aktuelle Fenster anhand seiner grauen Titelzeile sucht. Bei
  80. Unklarkeiten das gewuenschte Fenster anclicken.
  81. Das Programm wurde auf einem Mega 1 unter Blitter TOS entwickelt
  82. und in den dort verfuegbaren 3 Aufloesungen erfolgreich getestet.
  83. Da es sich nur an AES und VDI orientiert, sollte es auch auf
  84. STE und TT laufen. Bei Programmen die Grafikausgabe ohne Fenster-
  85. technik machen kann es aufgrund des automatischen Oeffnens zu
  86. Problemen kommen. U.U. sollte das Accessory vorher stillgelegt
  87. werden (Doppelclick).
  88. Ein weiteres Problem soll nicht verschwiegen werden. Durch das
  89. automatische Oeffnen wird das Fenster mit den Augen zwangslaeufig
  90. (?) kurzfristig zum Top-window. Wird genau zu diesem Zeitpunkt
  91. ein Resize auf einem anderen Fenster eingeleitet, scheint der
  92. Rechner zu haengen. Ein Click auf die alte Position der Size box
  93. laesst den Rechner weiterlaufen. Wer eine Loesung zu diesem Problem
  94. hat oder auch andere Anmerkungen zu dem Accessory, wende sich bitte
  95. an die oben angegebene Adresse.
  96.  
  97.  
  98. Programminterna
  99. ===============
  100.  
  101. Der Quelltext laesst sich ohne Aenderung mit Megamax Laser C V2.0
  102. und Borland Turbo C V2.0 uebersetzen. Die entsprechenden Make- oder
  103. Projektdateien koennen dabei verwendet werden. Der Stack wird auf
  104. 1400 Byte begrenzt. Das Programm wurde nur der besseren Typpruefung
  105. wegen unter Turbo C entwickelt. Wegen des Editors, der noch nicht
  106. einmal Marken beherrscht, sicherlich nicht. Vielleicht wird das 
  107. ja in einer der naechsten Versionen besser.
  108. Einige Anpassungen des Accessories lassen sich recht einfach am
  109. Quelltext und an der Datei EYES.ACC direkt durchfuehren:
  110.  
  111. Initialisierung   | Offset in |
  112. im Quelltext      | EYES.ACC  | Wert und Bedeutung
  113. =================================================================
  114. long magic        |  0x1314   | 0x31415926 Magische Zahl
  115. int work_x_origin |  0x1318   | 0x0055 x-Position des Fensters
  116. int work_y_origin |  0x131A   | 0x0014 y-Position des Fensters
  117. int win_components|  0x131C   | 0x0000 Komponenten des Fensters
  118. int auto_open     |  0x131E   | 0x0001 Automatisches Oeffnen
  119.  
  120. Dies sind Werte die fuer den ersten Start des Accessories gelten.
  121. Die Startposition wird bezueglich des Arbeitsbereiches des Desktops
  122. angegeben. Wer lieber ein Fenster mit Titelzeile und Close box
  123. haben will, kann fuer die Fensterkomponenten 0x000B angeben.
  124. Das Fenster laesst sich dann auch auf die uebliche Art und Weise
  125. bewegen und schliessen. Gibt man fuer auto_open den Wert 0x0000 an,
  126. wird das Fenster nach dem Rechnerstart nicht automatisch geoeffnet.
  127. Die Offset-Werte gelten nur fuer die beigefuegte Originaldatei
  128. EYES.C.
  129.  
  130.  
  131. Viel Spass mit dem Accessory
  132.  
  133.  
  134.     Peter Kirchgessner
  135.