
    HeadUp V1.4
    -----------

******************************************************************************
********************    Was ist HeadUp ?   ***********************************
******************************************************************************

    HeadUp Version 1.4 ist ein Tool, das auf der Workbenchoberflaeche
    laeuft. Es zeigt neben der aktuellen Uhrzeit auch das freie Chip -
    bzw. Fastram an. Zudem koennen Textdateien, IFF-Bilder und mit
    "Power Packer" gepackte Dateien angezeigt werden. Auch einige
    DFUe-Packer werden unterstuetzt.

              (c) 1991 by Stefan Magin

    Das Programm 'HeadUp' ist SHAREWARE. Sollte Ihnen dieses
    Programm gefallen und Sie es benutzen, so senden Sie bitte
    DM  10,- an die Adresse des Autors. 

    Dieses Programm darf FREI verteilt werden, solange es zusammen
    mit diesem Textfile kopiert wird und der Copyright-Vermerk
    vorhanden und intakt ist.

    Jede kommerzielle Nutzung des Programmes ohne ausdrueckliche
    schriftliche Genehmigung des Autors ist untersagt.
    Der Autor besitzt weiterhin alle Rechte an 'HeadUp'.
    Fuer Schaeden, die durch Benutzung von HeadUp entstehen,
    kann der Autor nicht verantwortlicht gemacht werden.

    Kritiken, Anregungen, Verbesserungsvorschlaege und Tips
    sind jederzeit gerne willkommen.

    Meine Adresse :

            Stefan Magin
            Hambacher Str.6
            D-6701 Dannstadt 1
            Germany

    oder via DFUe:  Mailbox "M" - ++49-621-801685 - 1200-9600 Baud HST
                                  FIDO-Node: @2:247/55
                                  Sperr- und Pollzeiten vom 3:00-4:00 nachts
                                  ansonsten 24 Stunden online




******************************************************************************
********************    Was kann HeadUp ?  ***********************************
******************************************************************************

   HeadUp kann anzeigen, anzeigen und nochmals anzeigen
   und zwar:

   - die aktuelle Uhrzeit in einem Window auf der Workbench

   - den freien Speicher (Chip-/Fast-RAM)

   - mittels des komfortablen Dateirequesters Disketten-Inhalte

   - Textdateien
     + im Standard-ASCII-Format
     + mit dem "Power-Packer" gepackte

   - Programmdateien (Hierbei jedoch nur die lesbaren ASCII-Zeichen.)

   - IFF Bilder
     + in allen moeglichen Aufloesungen
     + auch wenn sie mit dem "Power Packer" gepackt wurden
       (Auch wenn ich das Packen von IFF-Bilder fuer nicht sinnvoll halte.
        Der IFF Standard wurde entwickelt, damit jedes Malprogramm diese
        Bilder lesen und verarbeiten kann, was nach dem Komprimieren illu-
        sorisch wird. Ausserdem braucht HeadUp beim Anzeigen solcher Bilder
        den DOPPELTEN Speicher, da sie zuerst im RAM: entpackt und dann in
        den Bildschirmspeicher transferiert werden. Dieser "Umweg" ist bei
        herkoemmlichen Bildern nicht noetig. Darum: Sollte es Probleme mit
        gepackten Bildern bei 512 KB Amigas geben, so kennen Sie nun den
        Grund ....)

   - Archivinhalte (speziell fuer die Freunde der DFUe)

     1) LhArc  (________.LZH)
     2) ZOO    (________.ZOO)
     3) ARC    (________.ARC)

     Gezeigt werden: Namen und die Groessen der gepackten Dateien im Archiv

     Allerdings muessen

        -      die Archive die Endung 'ZOO', 'ARC' oder 'LZH' haben.
        -      die Programme LHarc,ARC bzw ZOO sich im C-Ordner befinden.

     3) DMS    (________.DMS)

     Gezeigt wird: dessen Status

     Allerdings muss

        - das Archiv muss die Endung 'DMS' haben
        - das Hauptprogramm DMS muss im C-Ordner sein


Sofern diese externen Programme eine TEST-Option implementiert haben, kann
diese durch Anklicken des Gadgets "ARCHIV LIST" auf "ARCHIV TEST" umgestellt
werden.

Beendet werden kann die abgeschlosse Anzeige/der abheschlossene Test mit der
ESCape-Taste.


******************************************************************************
********************        Anleitung :        *******************************
******************************************************************************

I. STARTEN

  Start vom CLI
  -------------

        Das Programm wird mit 'HeadUp' gestartet und bindet sich
        dann selbst als Process in das System ein. HeadUp muss (!!)
        ohne 'run' oder 'runback' gestartet werden. Es loest sich
        vom aufrufenden CLI und arbeitet als selbstaendiger Process
        (Task) weiter.

        Syntax: "HeadUp {xPos yPos} {-US}" oder
                "HeadUp {Dateiname}"

        Parameter:

        1) xPos   Entfernung vom linken Bildschirm-Rand
           yPos   Entfernung vom oberen Bildschirm-Rand

        2) -U     Uhrenanzeige wird abgeschaltet
           -S     Speicherplatzanzeige wird abgeschaltet
           -US    (sowohl als auch)

           Beispiel:

           HeadUp 0 11 -S

           startet HeadUp ohne Speicheranzeige, ganz links
           direkt unter der WorkBench-Leiste

           Standard-Werte fuer die Bildschirmposition sind
           XPos = 152 und YPos = 0.

        3) Dateiname

           Wollen Sie nur mal kurz ein Bild oder eine Datei ansehen,
           so rufen Sie HeadUp, gefolgt von dem Namen der anzuzeigenden
           Datei, auf. Beispiel : 'HeadUp S:Startup-Sequence'
           zeigt die Startup-Sequence der System-Diskette an.
           Nach dem Anzeigen wird HeadUp beendet.
           Sollte die Datei nicht gefunden werden, so wird eine Datei
           mit der Endung '.pp' (PowerPacker) gesucht.
           


  Start von der Workbench
  -----------------------

     1) Das Programm wird durch Anklicken des Icons gestartet, eine
        Uebergabe der Fensterposition ist nicht moeglich, es kann
        jedoch mit Hilfe der Maus verschoben werden.

     2) Sie koennen es jedoch auch anstelle von "More", "PPMore", "PPView"
        oder "MuchMore" benutzt werden. Dabei muss im Icon der anzusehenden
        Datei im Feld 'Default Tool' der Zugriffspfad auf "HeadUp" eingetragen
        sein. werden und wo sich HeadUp befindet.

        Beispiel: "C:HeadUp"

        Hierbei wird HeadUp im C: Ordner gesucht (und hoffentlich auch ge-
        funden), geladen und danach die Datei zum Icon angezeit.
        Sollte die Datei die Endung '.pp' haben, wird diese geladen.
        Selbst dann, wenn das Icon nicht diese Endung besitzt.

        Nach dem Anzeigen wird HeadUp beendet und aus dem Speicher entfernt.

     3) Sie koennen auch Dateien ueber die Workbench ansehen, indem Sie
        das Icon 1mal (!) anklicken und dann bei gehaltener 'Shift-Taste'
        die anzusehende Datei mit einem Doppelklick anwaehlen.


II. HANDHABUNG

        Nach dem Starten des Programms befindet sich die Titelleiste
        auf der Workbench-Oberflaeche.

        Durch einen Klick mit der linken Maustaste auf die Titelleiste
        (zum Aktivieren des Windows - entfaellt, wenn Sie SunMouse oder
        ein aehnliches Util benuetzen, um das jeweils unter dem Mauszeiger
        stehende Window aktiv zu machen !) und einem sofort nachfolgenden
        Klick mit der rechten Maustaste erscheint ein grosses Filerequester,
        mit dessen Hilfe Sie sich ueber die vorhandenen Verzeichnisse bzw.
        Dateien, welche sich auf einer Diskette, Festplatte oder aehnliches
        befinden, informieren.

        Links werden die Dateien und die Unterverzeichnisse angezeigt,
        rechts die Devices, die Sie durch einfachen Mausklick anwaehlen
        koennen.

        Mit der rechten Maustaste kommen Sie in das jeweils uebergeordnete
        Verzeichnis ("PARENT") zurueck.

        Der Rollbalken am oberen Requesterrand ermoeglicht ein bequemes
        Ansehen von Dateigroesse, Datum und Uhrzeit der letzten Aenderung,
        den DateiFlags und evetueller FileComments.

        Wollen Sie das Filerequester schliessen, so koennen Sie dies tun,
        indem Sie das Schliess-Symbol oben links anwaehlen oder aber
        'Vergiss es' im unterem Teil des Filerequesters.

        Mit 'Prg. Ende' wird HeadUp vom System entfernt und das File-
        requester geschlossen.



  Anwaehlen von Dateien
  --------------------

        Moechten Sie gerne den Inhalt einer Datei sehen, so klicken Sie

        a) den gewuenschten Dateinamen mit der linken Maustaste 1x
           an und dann mit der Maus 'OK' in der unteren Requesterhaelfte

        oder

        b) 2x auf den Dateinamen

  Anzeigen von Textdateien
  ------------------------

     + mit der Maus

       Druecken Sie nach dem Laden bitte 1mal die linken Maustaste.
       Je nachdem, wo auf dem Schirm sich Ihr Mauszeiger befindet, rollt
       der Text langsamer oder schneller nach oben oder unten. Stoppen
       koennen Sie ihn durch ein Klick mit der linken Maustaste oder indem
       Sie den Zeiger in die Bildschirmmitte bringen.


     + mit den Cursortasten

       Mit den Tasten 'Cursor runter'/'Cursor hoch' laesst sich seiten-
       weise durch den Text blaettern.

       Hinweis : Es empfiehlt sich, hierfuer einmal die linke Maustaste
                 druecken, um das Scrollen durch die Maus auszuschalten !


     + durch Gadgets

       Durch die Anwahl eines der acht am unteren Bildschirmand
       angebrachten Gadgets.

       Funktion der Gadgets ( von links nach rechts ) :
       '<--'           = zeige Dateiende an
       'Seite +'       = zeige naechste Seite an
       'Zeile +'       = zeige naechste Zeile an
       'Datei drucken' = Druckt geladene Datei aus
       'Seite drucken' = Druckt angezeigte Seite aus
       'Zeile -'       = zeige vorherige Zeile an
       'Seite -'       = zeige vorherige Seite an
       '-->'           = zeige Dateianfang an


        Weitere Funktionen beim Anzeigen
        --------------------------------

        Im Text-Anzeigemodus werden links oben der Dateiname der gerade
        angezeigten Datei und die aktuelle/letzte Bildschirmseite ausgegeben.

        Verlassen der Textanzeige durch MausKlick auf das Schliess-Symbol
        oben links oder Druck aufber einfach 'Escape' druecken.


  Anzeigen von IFF - Bildern
  --------------------------

        Sollte die anzuzeigende Datei ein IFF-Bild sein, so wird dieses
        erkannt und das Bild wird dargestellt. Beenden der Anzeige
        durch Druck auf die linke Maustaste.


******************************************************************************
********************        Allgemeines:        *******************************
******************************************************************************

  Programmiersprachen :
  ---------------------


        In der Hauptsache "C" (Lattice C-Compiler), einige Unterprogramme
        allerdings der hoeheren Geschwindikeit wegen in Assembler (DevPac).

  Danksagung (-:
  --------------

        Ein ganz besonderes Dankeschoen geht an Ralf von der Heiden, dem
        Sysop der 'M' Mailbox ( Telefon und Parameter siehe oben ).

        Durch viele Verbesserungsvorschlaege trug er dazu bei, dass aus
        HeadUp ein brauchbares Programm wurde.
        Der Vorschlag, dass auch Lharc- und Zoo-Archive angezeigt
        werden koennen, stammte unter anderem auch von ihm ( Unglaublich, wie
        vielseitig doch so ein Sysop sein kann !! (-: )

        Ein weiteres Dankeschoen geht an Andreas Manewaldt, den neuen
        Herausgeber der PD Serie 'Taifun' fuer seine Verbesserungs-
        vorschlaege.



        Stefan Magin
        ============

