home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_08 / MAGIC4E.LZH / MAGX_2 / EXTRAS / CLOCK / CLOCK.MAN < prev    next >
Text File  |  1991-09-13  |  13KB  |  311 lines
  1.  
  2.  CLOCK.ACC,  Version 1.9e   Copyright 1989-1991 by Stefan Hintz
  3.     ist ein Uhren-Accessory. Es ist Shareware.
  4.  
  5. +   CLOCK.ACC
  6.     läuft in einem rahmenlosen Fenster
  7.     und zeigt die Zeit analog als Ziffernblatt an.
  8.  
  9. +   Die Uhr läuft auch dann korrekt weiter, wenn sie teilweise von
  10.     anderen Fenstern überdeckt wird.
  11.  
  12. +   Mit der 'Help'-Taste kann man zwischen
  13.     folgenden Darstellungen umschalten:
  14.       0. analog
  15.       1. analog und digitales Datum
  16.       2. analog und digitale Uhrzeit und Datum
  17.       3. analog und digitale Uhrzeit
  18.       4. analog, digitale Uhrzeit,Datum und Weckzeit !
  19.       5. digitales Datum
  20.       6. digitale Uhrzeit und Datum
  21.       7. digitale Uhrzeit
  22.  
  23. +   Fenster bewegen:
  24.     Zum Bewegen des Fensters wird die rechte Maustaste gedrückt gehalten;
  25.     das Fenster kann so auch unter oder zwischen
  26.     andere Fenster geschoben werden.
  27.  
  28. +   Status sichern:
  29.     Wenn man 'Control-S' tippt, werden die aktuelle Position und Status in
  30.     der Datei CLOCK.INF auf dem Bootlaufwerk gemerkt.
  31.     Beim nächsten Booten wird dann die gespeicherte Position eingenommen.
  32.  
  33.     Bedeutung einer Beispiel-CLOCK.INF-Datei:
  34.  
  35.         Versionskennung     :   @(#) Clock.Info 1.9
  36.         relative X-Position :   X 10000
  37.         relative Y-Position :   Y 10000
  38.         Breite              :   W 64
  39.         Höhe                :   H 64
  40.         Status              :   S 0
  41.         Objektfarben        :   C 6,1,2,3,7,4,14,9,10,11,15,12
  42.         Auto-Open           :   O 1
  43.         3D-Darstellung      :   D 1
  44.         Weckzeit            :   A 0700
  45.  
  46. +   Fenster schlie₧en:
  47.     Mit 'Control-U' wird das Fenster geschlossen.
  48.  
  49. +   Mit der 'Home'-Taste wird das Fenster in die rechte obere Ecke bewegt.
  50.  
  51. +   Undo:
  52.     Mit der 'Undo'-Taste wird die in CLOCK.INF
  53.     gespeicherte Position und Grö₧e eingenommen.
  54.  
  55. +   Zeiteingabe:
  56.     Mit CLOCK.ACC kann man natürlich auch die Zeit verstellen,
  57.     dazu genügt ein Doppelklick aufs Zifferblatt:
  58.         nun kann man Datum, Uhrzeit und Weckzeit editieren.
  59.     Die 'Return'-Taste beendet die Eingabe.
  60.     Unvollständige oder unsinnige Zeitangaben bewirken kein
  61.     Verstellen der Uhrzeit bzw. des Datums.
  62.     auto-open:
  63.     Das Feld "auto-open" ist mit der Maus an- und abschaltbar.
  64.     Damit lä₧t sich einstellen, ob sich das Uhrenfenster automatisch
  65.     in jedem GEM-Programm öffnen soll oder nur in Programmen, die
  66.     das AV_PROTOKOLL verstehen, also z.B.: in Gemini.
  67. +   Die 'Insert'-Taste führt ebenfalls zur Zeiteingabe.
  68.  
  69. +   Wenn das Uhren-Fenster in einem Programm geöffnet war, so wird
  70.     es nach einem Programmwechsel erneut automatisch geöffnet.
  71.     (siehe auch: "auto-open")
  72.  
  73. +   CLOCK.ACC
  74.     versucht beim automatischen Öffnen seines Fensters, dieses
  75.     Fenster als zweitoberstes zu öffnen.
  76.  
  77. +   Weckzeit:
  78.     CLOCK.ACC kann nun zu einer einstellbaren Zeit an Gemini
  79.     eine Mitteilung schicken, da₧ die Datei CLOCK.MUP auf dem
  80.     Bootlaufwerk ausgeführt wird.
  81.     In die Datei CLOCK.MUP sollte man die zu startenden Programme
  82.     und deren Parameter eintragen.
  83.     So kann man sich z.B. täglich wecken lassen oder eine
  84.     Mailbox automatisch anrufen.
  85.     Das funktioniert nur, wenn Gemini aktiv ist und das Uhrenfenster
  86.     geöffnet ist. Wenn man nicht möchte, da₧ die Weckfunktion aktiv
  87.     ist, so sollte man das Weckzeit-Eingabefeld leer lassen.
  88.     Im Zifferblatt erscheint eine kleine Markierung, wenn die Weckzeit
  89.     gültig ist.
  90.     Nach Ändern der Weckzeit sollte der aktuelle Status mit 'Control-S'
  91.     gespeichert werden, damit die neue Weckzeit bei nächsten Booten
  92.     nicht verloren geht.
  93.  
  94.     Aufbau der Kommandozeile, die an CLOCK.MUP übergeben wird:
  95.         $0  :   enthält den kompletten Namen der CLOCK.MUP-Datei
  96.         $1  :   enthält die Versionsnummer von CLOCK.ACC
  97.         $2  :   enthält den kompletten Namen der CLOCK.INF-Datei
  98.         $3  :   Vier Ziffern der Weckzeit
  99.         $4  :   Sechs Ziffern der Uhrzeit
  100.         $5  :   Acht Ziffern des Datums
  101.  
  102.     In CLOCK.MUP darf man die Dateien CLOCK.INF und CLOCK.MUP durch andere
  103.     Dateien überkopieren, um so z.B. eine neue Weckzeit und ein anderes
  104.     Weckprogramm vorgeben zu können.
  105.     Wenn CLOCK.ACC die Message VA_PROGSTART erhält, reagiert CLOCK.ACC
  106.     wie bei der 'UNDO'-Taste. Die eventuell geänderte CLOCK.INF Datei, wird
  107.     also erneut ausgewertet. Auf diesem Weg ist es z.B. möglich,
  108.     mehrere Programme zu verschiedenen Zeiten an einem einem Tag starten zu
  109.     lassen. Ebenfalls ist auf diese Weise möglich, sich je nach Tag zu
  110.     unterschiedlichen Zeiten wecken zulassen.
  111.  
  112. +   Bei der reinen Analog-Uhr-Darstellung wird der Mauszeiger nur
  113.     dann ausgeschaltet, wenn er sich innerhalb des Fensters befindet;
  114.     dadurch entfällt das störende Flackern des Mauszeigers im Sekundentakt.
  115.  
  116. +   CLOCK.ACC
  117.     läuft in allen Auflösungen aller Atari ST/TT Modelle
  118.     mit allen Grafikkarten, die GEM unterstützen.
  119.  
  120. +   CLOCK.ACC pa₧t die Fensterposition automatisch an die Bildschirmgrö₧e
  121.     an; auch beim Umschalten von AutoSwitch-OverScan.
  122.  
  123. +   CLOCK.ACC
  124.     kann auch in CLOCK.APP umbenannt werden, es läuft dann als Programm.
  125.     Unter MultiGEM wird auch in diesem Fall das AV_PROTOKOLL benutzt.
  126.  
  127. +   CLOCK.ACC reagiert auf die Messagenummer 0x4711
  128.        (VA_START,  wie sie z.B. von Gemini an ACCs verschickt wird,
  129.         wenn man einen Doppelklick das ein ACC-Icon anwählt)
  130.     indem das Fenster geöffnet oder geschlossen wird.
  131.  
  132. +   CLOCK.ACC benutzt das AV_PROTOKOLL.
  133.        Gesendet werden:
  134.         AV_PROTOKOLL, AV_ACCWINDOPEN, AV_ACCWINDCLOSED, AV_SENDKEY
  135.         und AV_STARTPROG
  136.        Empfangen werden:
  137.         VA_START, VA_PROTOSTATUS, VA_PROGSTART
  138.     Die genauere Bedeutung dieser Mitteilungen entnehme
  139.     man bitte der Gemini 1.2 - Dokumentation.
  140.     Soviel sei gesagt; das Ganze dient dazu, Tastendrücke, die vom CLOCK.ACC
  141.     nicht verwendet werden, an die Hauptapplikation weiter zu reichen.
  142.     Au₧erdem wird der Hauptapplikation mitgeteilt, ob CLOCK.ACC sein Fenster
  143.     offen hat, damit das Hauptprogramm beim Wechseln der Fenster
  144.     (in Gemini mit 'Control-W') dieses mit einbeziehen kann.
  145.  
  146. +   Clipboard:
  147.     Mit 'Control-C' wird das aktuelle Datum ins Clipboard als Datei
  148.     SCRAP.TXT geschrieben, aber nur, wenn zuvor ein anderes Programm
  149.      (z.B.: Gemini, Wordplus)
  150.     das Clipboard angelegt hat. Die anderen Dateien SCRAP.* werden
  151.     dabei gelöscht.
  152.  
  153. +   Farbeinstellung:
  154.     Auf mehrfachen Wunsch eines einzelnen Herrn (J.R.)
  155.     kann man nun die Farben des Ziffernblatt frei wählen.
  156.     Diese Funktion ist nur über Tastatur erreichbar.
  157.  
  158.     Hintergrundfarbe:
  159.         'Shift-Cursor-Rechts'   =   Farbindex um 1 erhöhen
  160.         'Shift-Cursor-Links'    =   Farbindex um 1 erniedrigen
  161.  
  162.     Vordergrundfarbe:
  163.         'Control-Cursor-Rechts' =   Farbindex um 1 erhöhen
  164.         'Control-Cursor-Links'  =   Farbindex um 1 erniedrigen
  165.  
  166.     Es sind insgesamt Farben für sechs Objekte einstellbar:
  167.         Zeiger,
  168.         Hintergrund,
  169.         Sekundenzeiger,
  170.         Striche, (das sind die Markierungen für 3,6,9 und 12Uhr.)
  171.         Punkte,  (das sind die Markierungen für die restlichen Stunden.)
  172.         Weckzeit-Markierung
  173.  
  174.     Mit 'Cursor-Hoch' und 'Cursor-Runter' kann man zwischen
  175.     diesen sechs Objekten wählen, um mit
  176.     'Control-Cursor-Rechts' und 'Control-Cursor-Links'
  177.     die Farbe dieser Objekte verstellen zu können.
  178.  
  179.     Farbe auf Schwarz-Wei₧ zurücksetzen:
  180.         'Shift-Home'
  181.  
  182.     Wenn man bestimmte Objekte (z.B.: Sekundenzeiger oder Weckzeit-Markierung)
  183.     nicht sehen möchte, so gibt man ihnen die gleiche Farbe wie dem Hintergrund.
  184.  
  185. +   3D-Darstellung:
  186.     Die 3D-Darstellung ist erst bei Grafikauflösungen mit mindestens
  187.     16 Farben möglich. Die 3D-Darstellung wird durch Licht und Schatten
  188.     an den Objekten erreicht. Daher ist bei jedem der sechs Objekte
  189.     zusätzlich eine Farbe für die beleuchtete Seite einstellbar.
  190.  
  191.     In der diese Darstellung bewirkt 'Shift-Home' ein Zurücksetzen auf
  192.     bunte Farben. Bei Verwendung der Standard-GEM-Farbpalette ergibt sich
  193.     folgendes:
  194.         Zeiger:                 Gelb,   Hellgelb
  195.         Hintergrund:            Schwarz,Dunkelgrau
  196.         Sekundenzeiger:         Rot,    Hellrot
  197.         Striche:                Grün,   Hellgrün
  198.         Punkte:                 Magenta,Hellmagenta
  199.         Weckzeit-Markierung:    Blau,   HellBlau
  200.  
  201.     Die Standard-GEM-Farbpalette für die ersten 16 Farben
  202.     sieht folgenderma₧en aus:
  203.  
  204.         Farbindex:      Farbe:
  205.         0               Wei₧
  206.         1               Schwarz
  207.         2               Rot
  208.         3               Grün
  209.         4               Blau
  210.         5               Cyan
  211.         6               Gelb
  212.         7               Magenta
  213.         8               Hellgrau
  214.         9               Dunkelgrau
  215.         10              Hellrot
  216.         11              Hellgrün
  217.         12              Hellblau
  218.         13              Hellcyan
  219.         14              Hellgelb
  220.         15              Hellmagenta
  221.  
  222. +   CLOCKCOL.CPX
  223.     Um einfacher die Farben von CLOCK.ACC einstellen zu können,
  224.     gibt es nun ein CPX-Modul für das modulare Kontrollfeld XCONTROL.ACC.
  225.     XCONTROL.ACC ist im Lieferumfang von allen neueren MEGA-STE
  226.     und TT-Rechnern enthalten. CLOCKCOL.CPX ist nur mit 16 Farben sinnvoll
  227.     einzusetzen. Obviously, it is silly to have a CPX which controls the
  228.     operation of a desk accessory.
  229.  
  230. +   Grö₧enveränderung des Zifferblattes:
  231.     Bei gedrückter linken Maustaste kann die Grö₧e des Ziffernblatt
  232.     verändert werden. Dazu klickt man entweder auf den Rand des
  233.     Fensters, um eine der vier Kanten zu verschieben
  234.     oder in eine der vier Ecken des Fensters diese zu verändern.
  235.     Wenn au₧er dem analogen Zifferblatt noch die digitale Zeitanzeige
  236.     aktiviert ist, kann die Breite nicht verändert werden.
  237.     Die Grö₧e kann zwischen 16 und 80 Pixeln variiert werden.
  238.     Die Grö₧e wird während der Veränderung in einer kleinen Box
  239.     in der Bildschirmmitte angezeigt.
  240.  
  241. +   Auf einem STE oder TT, welche über digitalen DMA-Sound verfügen,
  242.     ertönt zu jeder vollen Stunde eine kleine Kirchenglocke.
  243.     Sie läutet 1-12 mal, je nach Uhrzeit.
  244.     Zur Lautstärken-,Klangregelung nehme man das XCONTROL.ACC von Atari.
  245.     Der DMA-Sound wird nicht aktiviert, falls jemand auf die Idee
  246.     gekommen sein sollte, CLOCK.ACC ins TT-RAM zuladen.
  247.  
  248. +   Für Leute, die nicht über eine batteriegepufferte System-Uhr verfügen,
  249.     (oder denen die Batterie alle geworden sind) vergleicht CLOCK.ACC
  250.     beim lesen der CLOCK.INF-Datei das Dateidatum mit der Systemzeit.
  251.     Wenn nun das Systemdatum älter als das Dateidatum ist, wird das
  252.     Systemdatum auf das Dateidatum gesetzt. Au₧erdem verändert die Uhr
  253.     in diesem Fall ihr Aussehen, um den Benutzer aufzufordern, die richtige
  254.     Zeit einzugeben. Mit 'Undo' kann dann wieder das eingestellte Aussehen
  255.     erreicht werden. Mit 'Control-S' kann das Dateidatum auf das
  256.     Systemdatum gesetzt werden.
  257.  
  258. +   Übersicht über die verwendeten Tasten:
  259.     Help                    Darstellung umschalten
  260.     Undo                    Einstellungen aus CLOCK.INF lesen
  261.     Insert                  Zeiteingabe
  262.     Home                    Fenster in rechte obere Ecke bewegen
  263.     Shift-Home              Farben auf Schwarzwei₧ zurücksetzen
  264.     Cursor-Up               Farbeinstellung
  265.     Cursor-Down               "
  266.     Shift-Cursor-Right        "
  267.     Shift-Cursor-Left         "
  268.     Control-Cursor-Right      "
  269.     Control-Cursor-Left       "
  270.     Control-S               Einstellungen in CLOCK.INF speichern
  271.     Control-C               Datum ins Clipboard schreiben
  272.     Control-U               Fenster schlie₧en
  273.     Control-D               Umschaltung zwischen Normal- und 3D-Darstellung
  274.  
  275. Wichtiger Hinweis:
  276.     Ich, Stefan Hintz, übernehme keine Haftung für irgendwelche
  277.     direkten oder indirekten Schäden -- einschlie₧lich aber nicht
  278.     beschränkt auf materielle oder finanzielle, die durch die
  279.     Benutzung dieses Programms oder die Untauglichkeit dieses Pro-
  280.     gramms für einen bestimmten Zweck entstehen.
  281.  
  282.  
  283. CLOCK.ACC darf, unter der Bedingung, da₧ dieser Text ebenfalls
  284. mit kopiert wird, an jeden weiter gegeben oder über Mailboxsysteme
  285. öffentlich zugänglich gemacht werden.
  286. Wem CLOCK.ACC gefällt oder es seit einem Monat benutzt, hat die
  287. Shareware-Gebühr zu bezahlen.
  288. Änderungen an diesem Text oder am Programm selbst dürfen nicht
  289. vorgenommen werden. Wer etwas geändert haben möchte,
  290. oder weitere Anregungen hat, kann sich bei mir melden.
  291.  
  292.     Email:  Stefan_Hintz@do.maus.de
  293.  
  294. Dieses Programm darf nicht ohne meine schriftliche Einwilligung
  295. verkauft werden - auch nicht über PD-Händler.
  296.  
  297. CLOCK.ACC ist Shareware.
  298. Der Shareware-Beitrag beträgt 20 DM.
  299. Wer mir 30 DM überweist, bekommt umgehend eine aktuelle Version auf
  300. einer Disk zugeschickt.
  301. Als Verwendungszweck bitte 'Shareware-Beitrag CLOCK.ACC' angeben.
  302.  
  303. Kontonummer:     55 120 66
  304. Bankleitzahl:   330 500 00  Stadtsparkasse Wuppertal
  305.  
  306.     Stefan Hintz
  307.     Baroper Stra₧e 331/611
  308.     4600 Dortmund
  309.  
  310. --
  311.