home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d532 / bootpic.lha / BootPic / BootPic_Anleitung < prev    next >
Text File  |  1991-08-26  |  13KB  |  269 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV1.1                                 *
  4. *                                                                             *
  5. *                         © 1991 by Andreas Ackermann                         *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  10. SHAREWARE-BEDINGUNGEN:
  11.  
  12.     BootPic ist SHAREWARE. BootPic darf nur unter folgenden Bedingungen weiter-
  13.     gegeben werden:
  14.  
  15.     o  BootPic darf nicht verändert sein
  16.     o  Dieses DOC-File muß mitkopiert werden
  17.     o  Es darf keine Gebühr erhoben werden (außer Aufwandsentschädigung fürs
  18.        kopieren, Disketten, etc.)
  19.  
  20.     Wenn Ihnen BootPic gefällt und Sie es öfters benutzen oder wenn Sie Teile
  21.     des Source-Codes in eigenen Programmen verwenden (z.B. die Fading-Routinen)
  22.     dann bitte ich um eine kleine Unterstützung in Höhe von ca. 5$ oder 5DM.
  23.  
  24.     Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist mei-
  25.     ne schriftliche Einwilligung erforderlich.
  26.  
  27.     Meine Adresse:         Andreas Ackermann
  28.                            Lorenz-Summa-Str.10
  29.                            W-8679 Oberkotzau
  30.                            Deutschland
  31.                            Tel.:09286/6399
  32.  
  33. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  34. Bitte beachten Sie:
  35. Ich schrieb dieses Programm anstatt einen Ferienjob anzunehmen. Wenn ich auf
  36. diese Weise ein wenig Geld verdienen kann, werden weitere Programme und Updates
  37. folgen (z.B. Colorcycling, oder wie wär's mit einem Programm, das ein Library
  38. resetfest installiert [wäre hilfreich bei der ARP-Library].
  39.  
  40. INHALT:_________________________________________________________________________
  41.  
  42.  
  43.        1. Einleitung
  44.        2. Aufruf
  45.        3. Zum Parser
  46.        4. Kompatibilität
  47.        5. Was passiert nach einem Reset ?
  48.        6. Mögliche Fehlerquellen
  49.        7. Programmierung
  50.  
  51. ________________________________________________________________________________
  52.  
  53.  
  54.                               EINLEITUNG
  55.  
  56. Gehören Sie auch zu denjenigen Leuten, die die Workbenchhand, die nach jedem
  57. Reset erscheint, langweilig und einfallslos finden ?
  58. Dann ist dieses Programm genau das Richtige für sie. Mit BootPic können sie
  59. (fast) jedes IFF-ILBM-Bild anstelle der «Hand» laden. (Overscan,HAM,HalfBright,
  60. etc.) Es muß lediglich in komprimierter Form vorliegen, ansonsten wäre die Sache
  61. eine reine Speicherverschwendung. (Außer CraphiCraft speichern meines Wissens
  62. alle bekannten Programme ihre Bilder komprimiert,z.B. DPaint I,II,II)
  63. Das installierte Programm verbraucht ca. 1K mehr Speicher, als das IFF-File lang
  64. ist, wobei, falls vorhanden, Fast-Memory verwendet wird.
  65.  
  66.                                  AUFRUF
  67.  
  68. BootPic kann sowohl über die Workbench, als auch via CLI gestartet werden.
  69.  
  70. Wird BootPic von der Workbench aus gestartet, öffnet es ein Fenster mit drei
  71. Gadgets:
  72.  
  73.  Load Picture : Klicken sie dieses Gadget an, so erscheint ein Fenster mit einem
  74.                 Stringgadget, in welches sie den Namen eines IFF-Files eingeben
  75.                 können. Haben Sie sich's doch anders überlegt, können sie mit
  76.                 Cancel wieder zurück. Drücken sie jedoch RETURN, so versucht
  77.                 BootPic das angegebene Bild zu laden. Haben Sie die ARP-Library
  78.                 installiert, so verwendet BootPic den ARP-Filerequester.
  79.                 Wurde Bootpic mit der «erweiterten Auswahl» gestartet, d.h.
  80.                 Sie haben BootPic durch Halten der SHIFT-Taste zusammen mit
  81.                 einem anderen Icon activiert, so steht im Stringgadget des File-
  82.                 Requesters bereits der Name dieser Datei, so daß Sie, um diese
  83.                 zu laden, nur RETURN zu drücken brauchen.
  84.  Remove Picture :
  85.                 Entfernt ein etwaig installiertes Bild aus dem Speicher.
  86.  Info :         Gibt einen kurzen Info-Text aus.
  87.  
  88.  Die Farbe, zu der nach der Darstellung des Bildes ausgeblendet wird, entspricht
  89.  der Hintergrundfarbe des Bildschirms zum Zeitpunkt der Installation.
  90.  
  91.  Die möglichen Fehlermeldungen sind exakt die gleichen wie beim Start vom CLI.
  92.  
  93. BEISPIEL:
  94. ­­­­­­­­   Um das auf dieser Diskette mitgelieferte Demo-Bild zu installieren,
  95.            gehen Sie bitte folgendermaßen vor:
  96.            Öffnen Sie die BootPic-Schublade dieser Diskette. Klicken Sie einmal
  97.            auf das Icon «Demo.pic» und klicken sie nun 2x auf das Icon von
  98.            BootPic während Sie die SHIFT-Taste gedrückt halten.
  99.            Klicken Sie auf das Gadget «Load Picture» und anschließend RETURN.
  100.            Entfernen Sie nun eine etwaig eingelegte Disk in df0: und lösen einen
  101.            Reset aus. Wenn alles glatt ging können Sie nun das Demo-Bild be-
  102.            trachten.
  103.  
  104.  
  105. Beim Start vom CLI erfolgt die Steuerung wie üblich über CommandLine-Parameter.
  106. Jedoch wird, falls keine Parameter angegeben werden,  das oben beschriebene
  107. Fenster geöffnet.
  108.  
  109. Es gilt folgender Syntax:
  110.  
  111.                 BootPic -e | -l{IFF-File} [-s][-r][-c rgb]
  112.  
  113. -l{IFF-File}  Löscht, falls vorhanden, ein bereits installiertes Bild und ver-
  114.               sucht dann an dessen Stelle ein neues zu laden.
  115.  
  116.               Erfolgsmeldung:
  117.               «Picture successfully installed. Have Fun !»
  118.  
  119.               Mögliche Fehler:
  120.               «Couldn't open Picture-File»
  121.               BootPic konnte den angegebenen File nicht öffen (z.B. weil er
  122.               nicht vorhanden war)
  123.               «This is not an ILBM-Picturefile»
  124.               Der angegebene File war kein IFF-Bild.
  125.               «Picture is not compressed»
  126.               Das Bild war nicht komprimiert.[Es gibt Tools die unkomprimierte
  127.               Bilder konvertieren.]
  128.               «Warning:Couldn't find CAMG-Chunk»
  129.               CAMG-Chunk nicht gefunden: Hier ist der Viewmodus festgehalten
  130.               [z.B. Hires oder Interlace etc.]. Bis Kickstart V1.3 einschließ-
  131.               lich wird das Bild aber trotzdem korrekt dargestellt.
  132.               [AUSNAHME: statt des Halfbright-Modus wird der HAM-Modus einge-
  133.               schaltet]
  134.               «BODY-Chunk not found»
  135.               Das ILBM-File enthielt keine Bilddaten (sollte niemals vorkommen)
  136.               «Memlist corrupt. Something went totally wrong»
  137.               Bedeutung siehe bei -e
  138.               «Not enough Memory»
  139.               Der Speicher hat nicht ausgereicht.
  140.  
  141. -e            löscht, falls vorhanden, ein bereits installiertes Bild und gibt
  142.               den belegten Speicher frei.
  143.  
  144.               Erfolgsmeldung:
  145.               «Removed BootPic from List»
  146.  
  147.               Mögliche Fehler:
  148.               «BootPic not installed. Couldn't remove it»
  149.               Es war kein Bild geladen und somit konnte auch nichts gelöscht
  150.               werden.
  151.               «Memlist corrupt. Something went totally wrong»
  152.               BootPic hat zwar seinen Speicherbereich entdeckt, konnte aber sei-
  153.               nen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte nie
  154.               passieren.) Falls diese Meldung erscheint, funktioniert entweder
  155.               BootPic fehlerhaft, oder ein anderes Programm, z.B. ein Virus, hat
  156.               sich an den Einsprungaddressen zu schaffen gemacht.
  157.  
  158.               Die folgenden Parameter funktionieren nur zusammen mit der -l
  159.               Option:
  160.  
  161. -s            lädt das unter -l angegebene Bild nur, falls noch kein Bild
  162.               installiert wurde. So ist es möglich, BootPic in der Startup-
  163.               -Sequence zu installieren.
  164.  
  165.               War bereits ein Bild installiert meldet sich BootPic so:
  166.               «BootPic already installed. Changed nothing.»
  167.  
  168. -r            BootPic führt nach dem Laden des Bildes ein Reset aus (nicht
  169.               notwendig)
  170.  
  171. -c            hier können Sie die Farbe angegeben, die nach dem Anzeigen des
  172.               Bildes eingeblendet werden soll. Normalerweise ist dies die Hin-
  173.               tergrundfarbe Ihres Workbench-Screens. Die Werte von r,g und
  174.               b müssen hexadezimal angegeben werden, also sind Werte von 0-9 und
  175.               A-F erlaubt, wobei 0 bedeutet, daß diese Komponente gar nicht und
  176.               F, daß sie mit maximaler Intensität vorhanden ist.
  177.               (z.B. -c000 für schwarz,-ce50 für orange). Andere Werte werden
  178.               zwar auch akzeptiert, aber dann ist das Resultat sicher nicht so
  179.               wie erwartet.
  180.               Voreingestellt ist 05a [Amiga-Blau].
  181.  
  182.  
  183.  
  184.                                 ZUM PARSER
  185.  
  186.  Alle Parameter können sowohl in Klein- als auch in Großschreibung angegeben
  187.  werden. Jeder Parameter MUSS mit einem «-» beginnen, die Reihenfolge der Pa-
  188.  rameter ist beliebig. Zwischen den einzelnen Parametern können beliebig viele
  189.  Leerzeichen stehen. Logischerweise müssen die Farbwerte nach -c stehen und
  190.  der Filename hinter -l.
  191.  Gültige Aufrufe wären z.B.:
  192.  
  193.   bootpic  -l  df0:meinbild -R   -c  7aB
  194.  
  195.   bootpic -E
  196.  
  197.   bootpic -cAE3  -S -ldf0:meinbild
  198.  
  199.  Wird -e oder -l nicht angegeben, oder stimmt sonst etwas nicht, gibt BootPic
  200.  den Syntax aus.
  201.  Werden -l und -e zusammen angegeben verhält sich BootPic so, als hätte man nur
  202.  -e angegeben.
  203.  
  204.                               KOMPATIBILITÄT
  205.  
  206.  BootPic installiert sich «schonend», d.h. möglicherweise schon vorher vorhande-
  207.  ne resetfeste Programme werden auch weiterhin ausgeführt, z.B. Guardian, CARD:,
  208.  aber auch Viren und sonstige Scherze.
  209.  Genau so sauber entfernt es sich auch wieder (sollte es zumindest).
  210.  
  211.                        WAS PASSIERT NACH EINEM RESET ?
  212.  
  213.  Haben sie BootPic erfolgreich installiert, wird, wannimmer sich nach dem Reset
  214.  keine bootfähige Diskette in DF0: befindet, die geladene Grafik weich einge-
  215.  blendet. Sobald sie eine bootfähige Diskette einlegen, gehen die Farben weich
  216.  in die unter -c angegebene Farbe über und Ihr System fährt wie gewohnt hoch.
  217.  [Das Ein-und Ausblenden von HAM-Bildern sieht ein wenig merkwürdig aus; hier-
  218.  zu wäre eine eigene Routine notwendig, wofür sich aber der Programmieraufwand
  219.  nicht lohnt.]
  220.  Wenn Sie während das Bild am Bildschirm ist die linke Maustaste drücken, er-
  221.  scheint die gewohnte Workbench-Hand. [z.B. hilfreich um zu überprüfen, ob
  222.  Guardian noch installiert ist.]
  223.  
  224.                            MÖGLICHE FEHLERQUELLEN
  225.  
  226.  Normalerweise bleibt ein einmal geladenes Bild solange im Speicher, bis Sie es
  227.  mit -e [Remove Picture] entfernen oder den Amiga ausschalten.
  228.  Allerdings gibt es einige Ausnahmen:
  229.  
  230.   a.)  Wenn Sie ein Programm benutzen, das meint der gesammte Speicher gehöre
  231.        ihm alleine (viele Spiele tun dies), kann es passieren, daß der von
  232.        BootPic reservierte Speicher überschrieben wird, und das Bild nicht mehr
  233.        erscheint.
  234.   b.)  Viele Viren überschreiben einfach die Resetvektoren. Dann bekommen Sie
  235.        Ihr Bild ebenfalls nicht mehr zu Gesicht.
  236.   c.)  Manche Viruskiller (z.B. ATool) sind der Meinung, alle Programme die re-
  237.        setfest sind, seien Viren (da macht BootPic keine Ausnahme).
  238.  
  239.  Sollte einer dieser drei Fälle eintreten, KANN es vorkommen, daß nach dem
  240.  Reset eine GURU-Meditation erscheint, die sich auch durch Drücken der linken
  241.  Maustaste nicht beseitigen läßt. In solchen Fällen hilft nur Ausschalten.
  242.  
  243.                                PROGRAMMIERUNG
  244.  
  245.  BootPic wurde zu 100% in Assembler verfaßt [Devpac2.14D] , daraus resultiert
  246.  auch die geringe Programmgröße von weniger als 9K.
  247.  Vielen Dank auch an JM Forgeas für den einmaligen Editor AZ V1.50.
  248.  
  249.  Die Version 1.1 unterscheidet sich von der V1.0 nur durch das Intuiton-
  250.  Interface, was 4K zusätzlichen Binärcode bedeutet. Aus diesem Grund habe ich
  251.  darauf verzichtet, den Sourcecode beizufügen. Für diejenigen, die BootPic
  252.  nur im CLI benutzen wollen, befindet befindet sich auf dieser Disk noch-
  253.  mals die Version 1.0, die ja schließlich nur halb so lang ist.
  254.  
  255.  Allerdings finde ich es ein wenig schade, daß ich bis heute [19.7.1991]
  256.  nicht mehr als 2x Post erhalten habe !
  257.  [Positiv: Es scheint keine BUGS zu geben.]
  258.  
  259.  BootPic läuft sowohl unter Kickstart Version 1.2 als auch 1.3. Leider war es
  260.  mir nicht möglich es unter Kickstart 2.0 zu testen.
  261.  Für Kritik, Lob, Anregungen und vorallem BUG-Reports bin ich sehr dankbar.
  262.  
  263.                          Viel Spaß wünscht Ihnen
  264.  
  265.   Oberkotzau, den 19.7.1991                      Andreas Ackermann [*10.07.1974]
  266.  
  267.  
  268.  
  269.