@DATABASE BootShow1.0.guide
@AUTHOR "Trevor Morris"
@WIDTH 80

@NODE "MAIN" "BootShow V1.0 Guide         26-03-95"
@NEXT "MAIN"

 @{b}-----------------------------------------------------------------@{ub}
 @{fg shine}   BootShow V1.0 by Cléo Saulnier (Guide file by Trevor Morris)@{fg text}
 @{b}-----------------------------------------------------------------@{ub}
 Finally, a bootpic shower that does what a bootpic shower should!




 @{"‘" LINK "DnLd"}   What the heck did I just download?
 @{"‘" LINK "Inst"}   How do I get this thing running?
 @{"‘" LINK "Make"}   What did you use to make this thing?

 @{"‘" LINK "Mail"}   This is MAILWARE!
 @{"‘" LINK "Cntc"}   Where you can reach me
 @{"‘" LINK "ToDo"}   To Do...
 
 @{"‘" LINK "Disc"}   Disclaimer




 @{fg fill}This archive is freely distributable, BUT please have the courtesy to
 distribute this archive with all of its files and documentation, as these
 are intended to help the people who obtain this piece of software. Thanx!@{fg text}
@ENDNODE

@NODE "DnLd" "What the heck did I just download?"

 @{b}What the heck did I just download?@{ub}


 @{fg fill}BootShow V1.0@{fg text}

 This is something I put together as a @{"request" LINK "Poag"} so that you'd be able to display
 pictures on bootup (as opposed to watching all that extremely interesting text
 and stuff flying around on the screen!!). The only drawback is that if your
 startup involves any requesters, they will bring the workbench screen to the
 front (so get rid of the damb requesters...I will soon be fixing this problem,
 since even my own computer has requesters on boot-up).

 Currently supported Resolutions:
 
 Resolutions supported:
     @{b}ECS:  2-32 colors   AGA: 2-256 colors@{ub}

           @{fg fill}320x200            320x200
           640x200            640x200
           320x400            320x400
           640x400            640x400@{fg text}

 as well as any overscan variation of these resolutions.
 (Although not tested, PAL resolutions should work as well ;)
 
 Interlace modes on AGA machines will try to open up a Double NTSC/PAL screen.
 If unsuccessful, normal interlace will be used.
@ENDNODE

@NODE "Inst" "How do I get this thing running?"

 @{b}How do I get this thing running?@{ub}

 BootShow should be copied into your @{b}c:@{ub} (or c2: directory if you have one).
 As well, you should call Bootshow from your @{b}startup-sequence@{ub} or @{b}user-startup@{ub}
 before the loawb command (a good spot for it is right after all the system
 assigns and setup (the stuff setup by Commodore) - see the examples below).

 @{b}USAGE:@{ub} @{fg shine}BootShow @{fg fill}[options] <filename.iff>@{fg text}

 @{b}OPTIONS:@{ub}

    @{fg fill}F #@{fg text}               # is number of frames that a certain intensity of
                      the fade is uses.  (3 produces a nice effect ;)
    @{fg fill}T #@{fg text}               # of seconds that the picture stays on screen.
    @{fg fill}P <filename.iff>@{fg text}  filename of the palette you want to use.
                      (This is used if you want to override the picture's
                      true palette)

    Options may be used in any order.

 Two examples are provided:
 @{"                     How to use Bootshow                    " LINK "Boot"}
 @{"How to use Bootshow with a random palette and random picture" LINK "RdPx"}
@ENDNODE

@NODE "Boot" "How to use Bootshow"
@TOC "Inst"

 @{b}EXAMPLE:@{ub}

 .
 .
 .
 Resident Execute REMOVE  
 Resident Assign REMOVE    @{fg shine}(these two lines are setup by Commodore)@{fg text}
 ;
 @{fg fill}c:bootshow F 3 T 16 P Work:Graphics/Pals/Palette1 Work:Graphics/Pix/Start1.pic@{fg text}
 .
 .
 (the rest of your startup)

 This example is provided as ASCII in the s: drawer (@{b}Boot_s-s@{ub}) if you wish to
 just cut, paste and modify it.
@ENDNODE

@NODE "RdPx" "How to use Bootshow"
@TOC "Inst"

 @{b}EXAMPLE:@{ub}

 .
 .
 .
 Resident Execute REMOVE  
 Resident Assign REMOVE    @{fg shine}(these two lines are setup by Commodore)@{fg text}
 ;
 @{fg fill}SET RANDPIC sys:prefs/extras/Startup`c:rand 1 4`.pic
 SET RANDPAL sys:prefs/extras/Palette`c:rand 1 12`
 c:bootshow F 3 T 16 P $RANDPAL $RANDPIC
 UNSET RANDPIC
 UNSET RANDPAL@{fg text}
 .
 .
 (the rest of your startup)

 @{b}NOTE:@{ub} In order to use the method above you will have to copy Rand (in the c
 drawer of this archive) into your c: drawer.
 @{"Rand" LINK "Rand"} is a random number generator written by Troy Morehouse (using SAS/C).

 This example is provided as ASCII in the s: drawer (@{b}Random_s-s@{ub}) if you wish to
 just cut, paste and modify it.
@ENDNODE

@NODE "Rand" "Rand by Troy Morehouse"
@TOC "RdPx"

 @{b}Rand by Troy Morehouse@{ub}


 To use rand, just type the command followed by a lower and upper bound:
 
 New Shell process 9
 9.@{fg shine}System3.0:@{fg text}> Rand 5 23
 @{fg fill}13@{fg text}
 
 or to use it in conjuction with a filename:
 
 New Shell process 9
 9.@{fg shine}System3.0:@{fg text}> echo "Printing the number `Rand 5 23`"
 @{fg fill}Printing the number 10@{fg text}
 
 where the @{b}`@{ub} is the @{b}tilde quote@{ub} (VERY IMPORTANT).
@ENDNODE

@NODE "Make" "What did you use to make all this stuff?"

 @{b}What did you use to make all this stuff?@{ub}


 The enclosed programs were coded by @{"Cléo Saulnier" LINK "Cntc"} using SAS/C® 6.51 on a
 A4000/040 with 10M RAM under OS3.1.
 Bootshow was tested on: - A4000/040 10M RAM (OS3.1)
                         - A3000/030 14M RAM (OS3.0)
                         - A2000/030 10M RAM (OS3.1)
 
 hopefully this works on @{b}@{i}all machines@{ui}@{ub} (should you find a bug...yeah right ;)...
 then feel free to contact @{"me" LINK "Cntc"}.

 Thise guide file was written by @{"Trevor Morris" LINK "Trev"} on the above mentioned
 A3000.
@ENDNODE

@NODE "Mail" "This is MAILWARE!"

 @{b}This is MAILWARE!@{ub}

 What the hell is MAILWARE?  Well, if you like and use this piece of software,
 then you @{b}MUST@{ub} send @{"me" LINK "Cntc"} some email.  Even if it is just to say "Hey, I'm using
 your program!"
 Comments, suggestions and bug reports are encouraged!
@ENDNODE

@NODE "Cntc" "Where you can reach me"

 @{b}Where you can reach me@{ub}


 Programmer of BootShow V1.0

 @{b}-------------@{ub}
 @{fg shine}Cléo Saulnier
 p8uu@unb.ca@{fg text}
 @{b}-------------@{ub}

 If you have found a bug or want to get a copy of the source or just simply
 want to discuss some aspect of programming which I've done in the past, just
 e-mail me (at the above address).  Of course, we all know that I, as a
 programmer, never have any bugs in my programs...especially not in the first
 version ;)
 
 Suggestions, recommendations, requests...welcome!

 Also, if you would like the source code for the included progs, no problem!
 Just email me and request them!

 ALSO LOOK FOR @{fg fill}MAGICWB1.3@{fg text} - magicworkbench on OS1.2+ !
                          - icon fix converter (to make them look like they do
                            under OS2.0+)
                          - icon unfix converter (to undo the effects of the
                            fix converter)
                          - a bitplane checker (good for all applications)
 Look in pix/icon on any Aminet site for @{fg fill}MagicWB1.3.lha@{fg text}

 To Programmers:
 If you know how to keep a requester from pulling it's screen to the front,
 or how to answer a requester from a program, I would like to hear from you.
@ENDNODE

@NODE "ToDo" "Future Enhancements"

 @{b}Future Enhancements@{ub}

 - Requesters @{i}NOT@{ui} pulling Workbench to the front.

 - If there is enough request for it, I will put in options for HAM-6 or HAM-8
   and maybe even Extra-Halfbrite.
   
 To Programmers:
 If you know how to keep a requester from pulling it's screen to the front,
 or how to answer a requester from a program, @{"I" LINK "Cntc"} would like to hear from you.
@ENDNODE

@NODE "Disc" "Disclaimer"

 @{b}Disclaimer

 THERE IS NO WARRANTY FOR THE SOFTWARE TO THE EXTENT PERMITTED BY APPLICABLE
 LAW.  EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
 OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
 EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
 ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU.
 SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
 SERVICING, REPAIR OR CORRECTION.

 BLAH, BLAH, BLAH...

 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
 ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE SOFTWARE
 AS PERMITTED BELOW, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
 SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
 INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
 DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
 OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
 SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
 DAMAGES.@{ub}
@ENDNODE

@NODE "Trev" "Trevor Morris"

 @{fg shine}Trevor Morris
 Comp 4, Site 7
 RR#1 Oromocto, NB
 E2V 2G2     Canada
 @{fg fill}Email: a3nb@unb.ca@{fg text}
 
 For lots of pix, icons, and imagedrawers to go with MagicWB, grab up
 @{b}MagicWBStuff3.lha@{ub} from aminet pix/icon!
@ENDNODE

@NODE "Poag" "The Arctangent Archives"
@TOC "DnLd"

 @{b}The Arctangent Archives@{ub}

 @{fg fill}Bootshow V1.0@{fg text} was orginally requested by @{"Trevor Morris" LINK "Trev"} in order to show the
 bootpix drawn by @{b}Bowie J. Poag@{ub}.  These pix are absolutely gorgeous images!
 Currently there are 6 archives (most contain images for every specific
 machine!!).  I believe the archives can be found in pix/icon on any Aminet
 site...but you should talk to:
 
 @{fg shine}Bowie J. Poag
 arctngnt@interaccess.com@{fg text}
 
 Thanx for the great work Bowie...let's keep the Amiga alive!
@ENDNODE