*******************************************************************************
*                                                                             *
*                                 BootPicV2.1                                 *
*                                                                             *
*                          1991,92 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-Routi-
    nen) dann bitte ich um eine kleine Untersttzung in Hhe von ca. 5$ oder
    5DM. Fr weitere 5 DM gibt es ein Update & den kompletten Source-Code
    (Allerdings nur sehr sparsam dokumentiert. Am besten vorher anrufen,
    ob berhaupt schon eien neue Version fertig ist !).
    Falls Sie gerne eine Antwort htten, legen sie doch BITTE Rckporto bei !

    Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist
    meine schriftliche Einwilligung erforderlich.

    Meine Adresse:  Andreas Ackermann          Meine Bankverbindung:
                    Lorenz-Summa-Str.10
                    W-8679 Oberkotzau          Sparkasse Oberkotzau
                    Deutschland                Blz:    780 530 40
                    Tel.:09286/6399            KtoNr.: 240802272

    Ab dieser Version (2.0c) darf sich BootPic auf keiner Diskette befinden,
    fr die mehr als DM 7.- (oder ein entsprechender Betrag einer anderen
    Whrung) verlangt wird. Sollten Sie BootPic auf einer Diskette erhalten
    haben, fr die Sie mehr als DM 7.- gezahlt haben, so teilen Sie mir das
    bitte mit !!!.
    Die Firma Rex-Datentechnik bentigt meine SCHRIFTLICHE Einwilligung, falls
    sie dieses Programm, in welcher Form auch immer( auch im Rahmen der
    Fish-Disks), verwerten will. Das gleiche gilt fr Stefan Ossowski.





INHALT:________________________________________________________________________


       1. Einleitung
       2. Aufruf
       3. Zum Parser
       4. Kompatibilitt
       5. Was passiert nach einem Reset ?
       6. Mgliche Fehlerquellen
       7. History
       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 !]
Seit der Version 2.0 gibt es nun auch die einzigartige Mglichkeit, ein
MED-Modul abzuspielen, whrend das Bild angezeigt wird. MED ist ein Musikpro-
gramm vergleichbar mit dem Soundtracker. Die Version 3.00 gibt es z.B. auf der
Fish 476. Beim Abspeichern der Musikstcke mu darauf geachtet werden, da dies
im Format 'MED-Module' geschieht, da BootPic nur dieses Format untersttzt.
(brigens: Mit MED lassen sich auch SoundTrackermodule laden und als MED-Module
 abspeichern !!! )
Da solche Module i.d.R. recht lang sind, knnen auch mit dem PowerPacker
(z.B. Fish 253) gecrunchte Module geladen werden (bitte als Daten crunchen ).
Leider lassen sich meistens nur ca. 20% der ursprnglichen Lnge sparen.

( In dieser Schublade befindet sich ein Demo-Modul. )

                                 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 fnf
Gadgets:

 Load Pic&Music : 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-Filere-
                quester.
                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
                Filerequesters bereits der Name dieser Datei, so da Sie, um
                diese zu laden, nur RETURN zu drcken brauchen.
                Daraufhin mssen Sie entscheiden, ob Sie auch ein Modul laden
                mchten.
                Wenn ja erscheint, wieder das Stringgadget bzw. der File-
                requester. Die Auswahl erfolgt analog der des Bildes.
                Sollte whrend des Ladens des Bildes ein Fehler auftreten, so
                wird nichts resetfest installiert; tritt dagegen beim Laden des
                Moduls ein Fehler auf, so wird trotzdem das Bild installiert.
                Es ist nicht mglich, nur ein MED-Modul zu installieren !
                Sollten Sie ein gecrunchtes Modul laden, so kann BootPic nicht
                berprfen, ob es sich tatschlich um ein Modul handelt.
 Remove Picture :
                Entfernt ein etwaig installiertes Bild (& MED-Modul ) aus dem
                Speicher.
 Check only df0 :
                Ist dieses Gadget whrend Sie ein Bild laden aktiviert,
                [ wiederholtes Anklicken deaktiviert dieses Gadget !]
                wird, wie blich, nur vom internen Laufwerk aus gebootet.
                ( Auch unter OS 2.0 !
                Ist es aber nicht aktiviert, kann von jedem beliebigen
                Laufwerk aus gebootet werden !!! (Auch unter Kick 1.2/1.3 !).
                Das Laufwerk, in dem zuerst eine bootfhige Disk erkannt wird,
                wird dann als df0: angesprochen, und das interne Laufwerk
                erhlt dessen Bezeichnung
                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, ent-
 spricht 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.
           Beantworten Sie die nun folgende Frage mit 'Yes'.
           Geben Sie 'Demosong.mod' gefolgt von RETURN ein.
           Entfernen Sie nun eine etwaig eingelegte Disk in df0: und lsen ei-
           nen Reset aus. Wenn alles glatt ging knnen Sie nun das Demo-Bild
           betrachten und nach ca. 7s hren Sie die Musik.


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} [-m{MED-Module}][-s][-r][-c rgb][-k][-y]
                                 [-d time]

-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). Es wird nichts installiert !
              This is not an ILBM-Picturefile. Didn't load Music either.
              Der angegebene File war kein IFF-Bild. Auch die Musik wird
              nicht geladen.
              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, um das Bild zu installieren.
              Couldn't open Module / Not a MED-Module.
              Beim Laden des Moduls trat ein Fehler auf:
               - entweder gab es zu wenig Speicher
               - oder es war kein MED-Modul
               - oder die angegebene Datei existierte nicht.
              Das Bild selbst wurde aber trotzdem installiert !
-e            lscht, falls vorhanden, ein bereits installiertes Bild
              (& MED-Modul) 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
              seinen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte
              nie passieren.) Falls diese Meldung erscheint, funktioniert ent-
              weder 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:

-m            ldt zustzlich zum Bild noch ein MED-Modul. Kann es nicht ge-
              laden werden, so wird nur das Bild installiert.

-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 ( wie bei OS 2.0)( das Angeben von -k entspricht
              einem DEAKTIVIERTEN 'Check only df0:'- Gadget)

-y            Color-cycling wird eingeschaltet

-d time       zeigt das Bild nur eine bestimmte Zeit lang an und fhrt dann
              mit dem Bootvorgang fort. Das ist besonders dann hilfreich,
              wenn man eine Festplatte besitzt, und trotzdem bei jedem Reset
              ein Bild z.B. 5 s lang betrachten will
              ACHTUNG: 'time' MU einstellig sein.
              TIP: es knnen auer Ziffern auch Buchstaben eingegeben werden;
                   es zhlt der ASCII-Code des Zeichens - $30
                   z.B. ist A eine Verzgerung von 17 Sekunden !
                            B  18 Sekunden etc.

                                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 -d 8

 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 vorhan-
 dene 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.
 Auch auf dem A3000 scheint BootPic problemlos zu laufen !

 NEU: Ab jetzt luft BootPic auch mit 1MB ChipMem und Kickstart 1.3.
      Solange BootPic installiert ist, sollten auch andere resetfeste
      Programme laufen.
 ACHTUNG: Mglicherweise vertrgt sich diese Routine nicht mit Setpatch !!!
      (Setpatch knnte die Routine berschreiben !)
      Solange Bootpic selbst den Fehler patcht, blinkt der Bildschirm nach
      dem Reset kurz rot auf.
      Sollten sie zusammen mit BootPic ein anderes Programm, das den Cold-
      Capture-Vektor benutzt, verwenden, wird diese Routine berschrieben.
      Auch manche ltere Viren benutzen diesen Vektor, so da diese Routine
      evtl. nicht ausgefhrt wird.

                       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. Wurde zustzlich ein MED-Modul gela-
 den, wird dieses abgespielt, solange das Bild angezeigt wird. Ist das Modul
 gepackt, kann es u.U. bis zu 10s dauern, bis es entpackt ist. In dieser Zeit
 reagiert der Amiga nur auf die linke Maustaste, was dann zur Folge hat, da
 die normale Workbench-Hand wieder angezeigt wird. Stellt sich nach dem Ent-
 packen heraus, da es doch kein MED-Modul war, so ist das nicht weiter
 schlimm; man hrt halt keine Musik.
 Mit der rechten Maustaste knnen Sie brigens den Soundfilter ein- bzw. aus-
 schalten. 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.


                                 HISTORY

 V1.0 - erste Version, nur Cli-Untersttzung
 V1.1 - jetzt mit Intuitioninterface
 V1.2 - die Optionen Check all Drives und Color-Cycling wurden hinzugefgt
      - Resetfeste Programme mssen im Chip-RAM liegen; im Fast-Ram funktio-
        nieren 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 beseitigt.
      - 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.
 V2.0 - Untersttzung von MED-Modulen.
 V2.0b- Delay-Parameter
 V2.0c- luft nun auch mit 1MB Chip-Mem
 V2.0d- ein glitzkleiner Bug wurde behoben: nun sollte es auch mit Kickstart-
        umschalteplatinen keine Probleme mehr geben.
 V2.1 - nun ist eine BootSelektor fr Kick 1.2/1.3 eingebaut.

                               PROGRAMMIERUNG

 BootPic wurde zu 100% in Assembler verfat [Devpac2.14D].
 Vielen Dank auch an JM Forgeas fr den einmaligen Editor AZ V1.50.
 Die Sound-Routinen stammen von MEDV3.0 von Teijo Kinnunen.
 [ Files: loadmod.i und modplayer.i ] Sie sind wirklich einfach zu benutzen;
 auch unerfahrene Assembler-Programmierer ( wie ich einer bin !)
 knnen Sie leicht in eigene Programme einbauen !
 Die Decrunchroutine unterliegt dem opyright von Nico Francois. Sie wurde
 der Fish 253 entnommen.

 Ein Dankeschn verdient auch Markus Herpich, der mich freundlicherweise
 einen ganzen Nachmittag an seinem A500+ rumwerkeln lie.

 Ein riesiges Dankeschn auch den 17(! richtig, siebzehn, 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 ...

 Ich glaube, das ist fr die nchste Zeit einmal die letzte Version von
 BootPic: es tut alles, was ich von diesem Programm erwarte:
 es luft jetzt endlich auf JEDEM Amiga, es ist relativ sicher und zudem ist
 die Bedienung uerst einfach.
 Die neueste Anregung ist noch die, einen kleinen Scrolltext mit unterzu-
 bringen - schreibt bitte, ob ihr das ntzlich findet; wenn es genug Leute
 wollen, dann gibt es sicherlich auch mal eine V2.2 !!!

 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 nachzuvollziehen bzw. einzugrenzen.
 Danke.
 Falls ihr schreibt, bitte verwendet nach Mglichkeit Sondermarken !
 [ Dann freut sich nmlich mein Opa ! ]

                         Viel Spa wnscht Ihnen

  Oberkotzau, den 31.7.1992                    Andreas Ackermann [*10.07.1974]



