*******************************************************************************
*                                                                             *
*                                 BootPicV1.2                                 *
*                                                                             *
*                          1991 by Andreas Ackermann                         *
*                                                                             *
*******************************************************************************


SHAREWARE-BEDINGUNGEN:

    BootPic ist SHAREWARE. BootPic darf nur unter folgenden Bedingungen weiter-
    gegeben werden:

    o  BootPic darf nicht verndert sein
    o  Dieses DOC-File mu mitkopiert werden
    o  Es darf keine Gebhr erhoben werden (auer Aufwandsentschdigung frs
       kopieren, Disketten, etc.)

    Wenn Ihnen BootPic gefllt und Sie es fters benutzen oder wenn Sie Teile
    des Source-Codes in eigenen Programmen verwenden (z.B. die Fading-Routinen)
    dann bitte ich um eine kleine Untersttzung in Hhe von ca. 5$ oder 5DM.

    Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist mei-
    ne schriftliche Einwilligung erforderlich.

    Meine Adresse:         Andreas Ackermann
                           Lorenz-Summa-Str.10
                           W-8679 Oberkotzau
                           Deutschland
                           Tel.:09286/6399





INHALT:_________________________________________________________________________


       1. Einleitung
       2. Aufruf
       3. Zum Parser
       4. Kompatibilitt
       5. Was passiert nach einem Reset ?
       6. Mgliche Fehlerquellen
       7. nderungen
       8. Programmierung

________________________________________________________________________________


                              EINLEITUNG

Gehren Sie auch zu denjenigen Leuten, die die Workbenchhand, die nach jedem
Reset erscheint, langweilig und einfallslos finden ?
Dann ist dieses Programm genau das Richtige fr sie. Mit BootPic knnen sie
(fast) jedes IFF-ILBM-Bild anstelle der Hand laden. (Overscan,HAM,HalfBright,
etc.) Es mu lediglich in komprimierter Form vorliegen, ansonsten wre die Sache
eine reine Speicherverschwendung. (Auer CraphiCraft speichern meines Wissens
alle bekannten Programme ihre Bilder komprimiert,z.B. DPaint I,II,II)
Das installierte Programm verbraucht ca. 1K mehr CHIP-Memory, als das IFF-File
lang ist. [ Sorry, mit Fastmem gab's leider Probleme !]

                                 AUFRUF

BootPic kann sowohl ber die Workbench, als auch via CLI gestartet werden.

Wird BootPic von der Workbench aus gestartet, ffnet es ein Fenster mit drei
Gadgets:

 Load Picture : Klicken sie dieses Gadget an, so erscheint ein Fenster mit einem
                Stringgadget, in welches sie den Namen eines IFF-Files eingeben
                knnen. Haben Sie sich's doch anders berlegt, knnen sie mit
                Cancel wieder zurck. Drcken sie jedoch RETURN, so versucht
                BootPic das angegebene Bild zu laden. Haben Sie die ARP-Library
                installiert, so verwendet BootPic den ARP-Filerequester.
                Wurde Bootpic mit der erweiterten Auswahl gestartet, d.h.
                Sie haben BootPic durch Halten der SHIFT-Taste zusammen mit
                einem anderen Icon activiert, so steht im Stringgadget des File-
                Requesters bereits der Name dieser Datei, so da Sie, um diese
                zu laden, nur RETURN zu drcken brauchen.
 Remove Picture :
                Entfernt ein etwaig installiertes Bild aus dem Speicher.
 Check all drives :
                Ist dieses Gadget whrend sie ein Bild laden aktiviert,
                [ wiederholtes Anklicken deaktiviert dieses Gadget !]
                berprft BootPic whrend es das Bild anzeigt, smtliche
                angeschlossenen Laufwerke auf bootfhige Disketten [ auch
                FFS-formatierte werden erkannt !].
                Diese Option ist nur unter Verwendung von OS 2.0 sinnvoll, da
                hier von jedem Laufwerk aus gebootet werden kann.
                Ist dieses Gadget deaktiviert, wird nur das interne Laufwerk
                berprft.
                Achtung: Es ist entscheidend, welchen Status dieses Gadget hat,
                BEVOR Load Picture angeklickt wird. Auf ein bereits geladenes
                Bild hat dieses Gadget keinen Einflu mehr !
 Color-Cycling :
               Ist dieses Gadget aktiviert, schaltet BootPic das Color-Cycling
               ein, falls das Bild entsprechende Daten enthlt.
               Fr die Aktivierung dieses Gadgets gilt dasselbe wie fr
               Check all Drives.
 Info :         Gibt einen kurzen Info-Text aus.

 Die Farbe, zu der nach der Darstellung des Bildes ausgeblendet wird, entspricht
 der Hintergrundfarbe des Bildschirms zum Zeitpunkt der Installation.

 Die mglichen Fehlermeldungen sind exakt die gleichen wie beim Start vom CLI.

BEISPIEL:
   Um das auf dieser Diskette mitgelieferte Demo-Bild zu installieren,
           gehen Sie bitte folgendermaen vor:
           ffnen Sie die BootPic-Schublade dieser Diskette. Klicken Sie einmal
           auf das Icon Demo.pic und klicken sie nun 2x auf das Icon von
           BootPic whrend Sie die SHIFT-Taste gedrckt halten.
           Klicken Sie auf das Gadget Load Picture und anschlieend RETURN.
           Entfernen Sie nun eine etwaig eingelegte Disk in df0: und lsen einen
           Reset aus. Wenn alles glatt ging knnen Sie nun das Demo-Bild be-
           trachten.


Beim Start vom CLI erfolgt die Steuerung wie blich ber CommandLine-Parameter.
Jedoch wird, falls keine Parameter angegeben werden,  das oben beschriebene
Fenster geffnet.

Es gilt folgender Syntax:

                BootPic -e | -l{IFF-File} [-s][-r][-c rgb][-k][-y]

-l{IFF-File}  Lscht, falls vorhanden, ein bereits installiertes Bild und ver-
              sucht dann an dessen Stelle ein neues zu laden.

              Erfolgsmeldung:
              Picture successfully installed. Have Fun !

              Mgliche Fehler:
              Couldn't open Picture-File
              BootPic konnte den angegebenen File nicht ffen (z.B. weil er
              nicht vorhanden war)
              This is not an ILBM-Picturefile
              Der angegebene File war kein IFF-Bild.
              Picture is not compressed
              Das Bild war nicht komprimiert.[Es gibt Tools die unkomprimierte
              Bilder konvertieren.]
              Warning:Couldn't find CAMG-Chunk
              CAMG-Chunk nicht gefunden: Hier ist der Viewmodus festgehalten
              [z.B. Hires oder Interlace etc.]. Bis Kickstart V1.3 einschlie-
              lich wird das Bild aber trotzdem korrekt dargestellt.
              [AUSNAHME: statt des Halfbright-Modus wird der HAM-Modus einge-
              schaltet]
              BODY-Chunk not found
              Das ILBM-File enthielt keine Bilddaten (sollte niemals vorkommen)
              Memlist corrupt. Something went totally wrong
              Bedeutung siehe bei -e
              Not enough Memory
              Der Speicher hat nicht ausgereicht.

-e            lscht, falls vorhanden, ein bereits installiertes Bild und gibt
              den belegten Speicher frei.

              Erfolgsmeldung:
              Removed BootPic from List

              Mgliche Fehler:
              BootPic not installed. Couldn't remove it
              Es war kein Bild geladen und somit konnte auch nichts gelscht
              werden.
              Memlist corrupt. Something went totally wrong
              BootPic hat zwar seinen Speicherbereich entdeckt, konnte aber sei-
              nen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte nie
              passieren.) Falls diese Meldung erscheint, funktioniert entweder
              BootPic fehlerhaft, oder ein anderes Programm, z.B. ein Virus, hat
              sich an den Einsprungaddressen zu schaffen gemacht.

              Die folgenden Parameter funktionieren nur zusammen mit der -l
              Option:

-s            ldt das unter -l angegebene Bild nur, falls noch kein Bild
              installiert wurde. So ist es mglich, BootPic in der Startup-
              -Sequence zu installieren.

              War bereits ein Bild installiert meldet sich BootPic so:
              BootPic already installed. Changed nothing.

-r            BootPic fhrt nach dem Laden des Bildes ein Reset aus (nicht
              notwendig)

-c            hier knnen Sie die Farbe angegeben, die nach dem Anzeigen des
              Bildes eingeblendet werden soll. Normalerweise ist dies die Hin-
              tergrundfarbe Ihres Workbench-Screens. Die Werte von r,g und
              b mssen hexadezimal angegeben werden, also sind Werte von 0-9 und
              A-F erlaubt, wobei 0 bedeutet, da diese Komponente gar nicht und
              F, da sie mit maximaler Intensitt vorhanden ist.
              (z.B. -c000 fr schwarz,-ce50 fr orange). Andere Werte werden
              zwar auch akzeptiert, aber dann ist das Resultat sicher nicht so
              wie erwartet.
              Voreingestellt ist 05a [Amiga-Blau].

-k            BootPic berprft alle angeschlossenen Laufwerke auf eine boot-
              fhige Diskette

-y            Color-cycling wird eingeschaltet

                                ZUM PARSER

 Alle Parameter knnen sowohl in Klein- als auch in Groschreibung angegeben
 werden. Jeder Parameter MUSS mit einem - beginnen, die Reihenfolge der Pa-
 rameter ist beliebig. Zwischen den einzelnen Parametern knnen beliebig viele
 Leerzeichen stehen. Logischerweise mssen die Farbwerte nach -c stehen und
 der Filename hinter -l.
 Gltige Aufrufe wren z.B.:

  bootpic  -l  df0:meinbild -R   -c  7aB

  bootpic -E

  bootpic -cAE3  -S -ldf0:meinbild

 Wird -e oder -l nicht angegeben, oder stimmt sonst etwas nicht, gibt BootPic
 den Syntax aus.
 Werden -l und -e zusammen angegeben verhlt sich BootPic so, als htte man nur
 -e angegeben.

                              KOMPATIBILITT

 BootPic installiert sich schonend, d.h. mglicherweise schon vorher vorhande-
 ne resetfeste Programme werden auch weiterhin ausgefhrt, z.B. Guardian, CARD:,
 aber auch Viren und sonstige Scherze.
 Genau so sauber entfernt es sich auch wieder (sollte es zumindest).
 BootPic sollte zumindest auf allen Amigas mit Kick 1.2/1.3 laufen;
 zudem wurde es erfolgreich auf dem A500 Plus mit OS 2.0 getestet.
 Keine Gewhr fr den A3000 !!!

                       WAS PASSIERT NACH EINEM RESET ?

 Haben sie BootPic erfolgreich installiert, wird, wannimmer sich nach dem Reset
 keine bootfhige Diskette in DF0: befindet, [ bzw. in einem anderen Laufwerk ]
 die geladene Grafik weich eingeblendet. Sobald sie eine bootfhige Diskette
 einlegen, gehen die Farben weich in die unter -c angegebene Farbe ber und Ihr
 System fhrt wie gewohnt hoch. [Das Ein-und Ausblenden von HAM-Bildern sieht
 ein wenig merkwrdig aus; hierzu wre eine eigene Routine notwendig, wofr sich
 aber der Programmieraufwand nicht lohnt.]
 Wenn Sie whrend das Bild am Bildschirm ist die linke Maustaste drcken, er-
 scheint die gewohnte Workbench-Hand. [z.B. hilfreich um zu berprfen, ob
 Guardian noch installiert ist.]

                           MGLICHE FEHLERQUELLEN

 Normalerweise bleibt ein einmal geladenes Bild solange im Speicher, bis Sie es
 mit -e [Remove Picture] entfernen oder den Amiga ausschalten.
 Allerdings gibt es einige Ausnahmen:

  a.)  Wenn Sie ein Programm benutzen, das meint der gesammte Speicher gehre
       ihm alleine (viele Spiele tun dies), kann es passieren, da der von
       BootPic reservierte Speicher berschrieben wird, und das Bild nicht mehr
       erscheint.
  b.)  Viele Viren berschreiben einfach die Resetvektoren. Dann bekommen Sie
       Ihr Bild ebenfalls nicht mehr zu Gesicht.
  c.)  Manche Viruskiller (z.B. ATool) sind der Meinung, alle Programme die re-
       setfest sind, seien Viren (da macht BootPic keine Ausnahme).

 Sollte einer dieser drei Flle eintreten, KANN es vorkommen, da nach dem
 Reset eine GURU-Meditation erscheint, die sich auch durch Drcken der linken
 Maustaste nicht beseitigen lt. In solchen Fllen hilft nur Ausschalten.


                                 CHANGES

 Check all Drives und Color-Cycling, siehe bei AUFRUF

 Seit der Version 1.1 wurden einige Fehler behoben :

 Resetfeste Programme mssen im Chip-RAM liegen; im Fast-Ram funktionieren
 sie nur, wenn es sich um die interne 512k-Erweiterung handelt [ ab Adresse
 $C00000 ]. Nun hlt sich BootPic an diese Regel. Sorry ...

 Prinzipiell htte bereits BPic1.0 auf dem A500+ funktioniert, wenn es nicht
 nach dem Ausblenden abgestrzt wre. Dieses 'kleine' Manko wurde jetzt be-
 seitigt.

 BootPic 'verkraftet' jetzt auch IFF-Graphiken, mit denen mehr als 32 Farben
 gespeichert wurden ( z.B. HAM-Demobilder von DPaint IV )

 Brushes werden nun korrekt dargestellt.


                               PROGRAMMIERUNG

 BootPic wurde zu 100% in Assembler verfat [Devpac2.14D] , daraus resultiert
 auch die geringe Programmgre von weniger als 9K.
 Vielen Dank auch an JM Forgeas fr den einmaligen Editor AZ V1.50.
 Ein Dankeschn verdient auch Markus Herpich, der mich freundlicherweise
 einen ganzen Nachmittag an seinem A500+ rumwerkeln lie.

 Ein riesiges Dankeschn auch den 10(! richtig, zehn, nicht mehr ! [seit Juni
 1991]) Leuten, die so ehrlich waren, die 5 DM zu entrichten bzw. mich ber
 einige Fehler informierten.
 Vielleicht knnten sich ja doch noch ein Paar mehr Mann aufraffen ...

 Weitere Plne:
 Vielleicht eine Routine, die Colorcycling whrend des Fadings erlaubt,
 besseres Fading, noch weniger Bugs ( es gibt sicher noch genug ...)
 Nein - bitte - keine Animationsuntersttzung !!!

 Fr Kritik, Lob, Anregungen und vorallem BUG-Reports bin ich sehr dankbar.
 Falls Fehler auftreten sollten ...
 BITTE, schreibt was fr ein System ihr habt ( A500/1000/2000/3000..., Fest-
 platte, Kickstart, Speichererweiterung ...) und falls es Gurus gibt, die
 Nummer, bzw. wie sich der Fehler uert ( z.B. strzt der Amiga ab, nachdem
 das Bild ausgeblendet wurde, kommt kein Bild zum Vorschein , geht alles glatt
 wenn whrend des Resets eine bootfhige Disk im Laufwerk ist etc. )
 Somit ist es manchmal leichter den Fehler nchzuvollziehen bzw. einzugrenzen.
 Danke.

                         Viel Spa wnscht Ihnen

  Oberkotzau, den 29.12.1991                      Andreas Ackermann [*10.07.1974]



