******************************************************************************* * * * BootPicV1.2 * * * * © 1991 by Andreas Ackermann * * * ******************************************************************************* CONTENTS:______________________________________________________________________ 1. About shareware 2. Introduction 3. Installation of a picture 4. About the Parser 5. Kompatibility 6. What happens after resetting the machine ? 7. Possible sources of errors 8. Changes since V1.1 9. About the programming _______________________________________________________________________________ ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ SHAREWARE-CONDITIONS: BootPic is SHAREWARE. You are allowed to copy BootPic as long as the following conditions are kept : o BootPic mustn't be changed o This DOC-file must be included o It mustn't be charged any fee (besides fees for copying or disks etc.) If you like BootPic and if you use it regularly or if you include parts of the source in your own programms (e.g. the fading-routines) please send me a small donation of 5$ or 5DM. If you want to use BootPic as part of a commercial programme, you need my written permission. My Address: Andreas Ackermann Lorenz-Summa-Str.10 W-8679 Oberkotzau GERMANY Tel.:09286/6399 ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ INTRODUCTION Do you belong to the group of people who think the «Workbench-hand» that appears after every reset to be boring ? Then BootPic is the right thing for you. It allows you to load (nearly) any IFF-ILBM-picture instead of the «hand». (Overscan, HAM, Halfbright, etc.) It just has to be in compressed form. (e.g. DPaint saves its pictures in compressed form ). The installed programme uses 1K more memory than the length of the picture-file. [ V1.2 uses CHIP-Mem to avoid complications ! ] INSTALLATION BootPic can be started either from Workbench or CLI. If started from WB an intuition-style window with three gadgets will open : Load Picture : If you click on this gadget a window with a striggadget will open and asks you to enter a filename. If you press RETURN, BootPic will try to load this Picture, clicking on Cancel will stop any action. If you've got the ARP-Library installed, you'll get the ARP-Filerequester. If you selected BootPic together with another icon (see at example) you'll find its name already written in the string- gadget when opening the filerequester. Remove Picture : Does nothing but that. Check all Drives : If this gadget is active when loading a picture, BootPic will check any connected drive for a bootable disk while displaying the picture. FFS-formatted disks also will be recognized. This switch is useful with OS 2.0 which allows to boot from any drive. If it's inactive, only df0: is checked. IMPORTANT: The state of this gadget is significant BEFORE loading an pic- ture. Toggling it after loading doesn't have any effect on the picture. Color-Cycling: If it's active, it enables Color-Cycling if the corresponding information is saved with the picture ( CRNG-chunk ) Info : Displays an info-message. The error-messages are exactly the same as described below. The color used to fade to after displaying the picture is taken from the background color of the workbench screen at the moment it is being installed. EXAMPLE: ­­­­­­­­ To install the picture that is included on this Disk, do the following steps: Open the BootPic-drawer. Click on the demo.pic icon. Then double- click on the BootPic icon while holding the SHIFT-key. Click on the Load Picture -gadget and press RETURN. After resetting and removing any disks in df0: you can watch the picture. When started from CLI, BootPic is controlled by commandline parameters as usual. If no parameters are specified, a window as described above will open. The syntax is as follows : BootPic -e | -l{IFF-File} [-s][-r][-c rgb][-k][-y] -l{IFF-File} Removes, if present, an old picture and then tries to install a new one instead. Message if it had success: «Picture successfully installed. Have Fun !» Possible faults: «Couldn't open Picture-File» «This is not an ILBM-Picturefile» «Picture is not compressed» «Warning:Couldn't find CAMG-Chunk» CAMG-Chunk not found : The viewmodes are saved in this chunk [e.g. Hires or Interlace etc.]. Until Kickstart 1.3 the picture will be shown correctly despite of CAMG's missing. [RESTRICTION: instead of Halfbright, HAM will be selected.] «BODY-Chunk not found» ILBM-File didn't contain image-data (should never happen). «Memlist corrupt. Something went totally wrong» Meaning see at -e «Not enough Memory» -e Removes, if present, an old picture. Message if successful: «Removed BootPic from List» Possible faults: «BootPic not installed. Couldn't remove it» «Memlist corrupt. Something went totally wrong» BootPic discovered its memory, but it couldn't find its entry in the resident table (should never happen). The following parameters work only together with -l : -s loads the file specified by -l only if BootPic is not yet installed. In this way it is possible to use BootPic in the Startup-Sequence. If BootPic was already installed it prints out : «BootPic already installed. Changed nothing.» -r BootPic resets the machine after loading the picture. -c here you can specify the color which should be faded in after showing the picture. Normally this is the background color of your Workbench-Screen. The values of r,g and b must be specified hexadecimal, so values from 0-9 and a-f are valid. [0 means that this component isn't there at all and f means that it is there at maximum idensity. (e.g. -c000 for black, -ce50 for orange). Invalid values are accepted but the result will be other than expected. Default: 05a [Amiga-blue] -k enables checking of all drives [see above] -y enables color-cycling [see above] ABOUT the PARSER All parameters may be specified either as small or capital letters. Every parameter MUST start with «-», the order is at pleasure. Between the single parmeters any number of spaces may be typed . Valid calls would be : bootpic -l :BootPic/demo.pic -R -c 7aB bootpic -E bootpic -cAE3 -S -l:bootpic/demo.pic If -e or -l aren't specified, or if something else was typed wrong, BootPic shows the usage. If -e AND -l are specified, BootPic acts as if just -e was specified. KOMPATIBILTY BootPic installs itself in a «kindly» way, that means that any other resident programme won't be removed, e.g. Guardian, CARD:, but also viruses. In the same careful way it removes itself. It should run on every Amiga with Kick 1.2 or 1.3. It also runs on the A500+ with OS 2.0, but I'm not sure about the A3000. What happens after RESETTING the machine ? When BootPic was successfully installed, the loaded picture will be faded in softly whenever there's no bootable disk in df0: [or any other drive] . When inserting a bootable disk the colors will be faded softly to the color specified under -c and your system starts as usual . [The fading of HAM-pictures looks a little bit curious but that's NO bug.] If you press the left mouse button while the picture is shown, the usual workbench-hand appears. Possbile SOURCES of ERRORS Normally a picture that was once installed, stays in memory until you remove it with -e [Remove Picture] or till you switch off your Amiga. But there are some exceptions: a.) If you play a game that believes all the memory belongs to itsself, it is possible that the memory allocated by BootPic is overwritten. Then you won't see the picture any more. b.) Many viruses simply overwrite the reset-vectors. In this case BootPic will be gone, too. c.) Some virusdedectors (e.g. ATool) are of the opinion that every resident programme is a virus, so BootPic will be removed, too. If one of these cases should arise, it may be possible, that you get a GURU after a reset. If you can't remove it by clicking the left mousebutton, switching off the Amiga is the only thing you can do. CHANGES Color-Cycling and Check all Drives. See above ! Bug Fixes: Resident Code and Data MUST be placed in Chip-Mem [only Exception: internal Expansions of 512k at location $C00000 (e.g. I've this one)]. Now it uses Chip-Mem. Sorry, I didn't know about this limitation. There was some code that caused BootPic to guru on the A500 Plus with OS 2.0 after displaying the picture. Now it works ... ******************************************************************************* * * * BootPicV1.2 * * * * © 1991 by Andreas Ackermann * * * ******************************************************************************* Survey: BootPic allows you to install, instead of the Workbench-hand that appears after every reset, nearly any picture you like. BootPic can be started either from Workbench or CLI. When starting from WB a window with five gadgets will open: Install Picture : A stringgadget will be displayed, where you can enter the name of an ILBM-file. If you started BootPic by activating BootPic ,then holding the SHIFT-key and choosing an IFF-file, its name will be displayed and all you have to do is to press RETURN. Remove Picture : Does exactly that. !!! NEW: Check all drives : if this gadget is active, BootPic will check any connected drive for a bootable disk. [ only makes sense with OS 2.0 ] !!! NEW: Color-Cycling : Enables color-cycling Info : Displays a little Info-window. The following parameters are accepted when starting from CLI : [If no parameters are specified, the intuition-window will open.] BootPic -e | -l{IFF-File} [-s][-r][-c rgb][-k][-y] -l{IFF-file} removes, if there, an already installed picture and tries to load a new one. -e removes, if there, an already installed picture The following parameters just work with -l : -s loads the picture specified by -l only if there wasn't yet installed a picture. -r resets the Amiga after loading the picture. -c specifies color that is faded in after showing the picture. (r, g and b MUST be entered hexadecimal, so values from 0-9 and A-F are valid.) !!! NEW: -k enables checking of all drives -y enables color-cycling IMPORTANT: !!!!!!!!!!!!!!!!!!!!!!!!!! BootPic is SHAREWARE. !!!!!!!!!!!!!!!!!!!!!!!!!!!! More about this and a detailed documentation is to be found in BootPic.doc. Fixed one bug that caused serious errors when loading IFF-files with more than 32 colors saved ( like the HAM-Demo-pics of DPaintIV ). Brushes now are handled correctly. PROGRAMMING BootPic was written with the Devpac 2.14D - Assembler, that's the reason for its small code size [less than 9K ]. Many thanks go to JM Forgeas for the wonderful editor AZ V1.50. Thanks Markus Herpich who provided me his brandnew A500+ for a whole afternoon. Also greetings to the 10 ( really ten, not more [since june 1991] !) kind people who sent me the demanded fee or bug reports. Hope there'll be more in future ... Future Versions: Less bugs (I don't know any more, but there surely are ... ) Improved fading; color-cycling while fading; improved code But remember: future improvements depend on YOUR support !!! I am very thankful for critics, propositions and BUG-reports. ENJOY ! Oberkotzau, december 29th 1991 Andreas Ackermann [*10.07.1974] [ excuse my mistakes !!! ]