splash version 0.1 (initial release) 1999/04/14  Peter Hartshorn

Disclaimer
==========

There is no warranty with this program. If the program breaks your computer,
you are responsible for it. If you don't agree with this, don't use the program.


Overview
========

This program is for people who want the penguin when booting, but do not have
a frame buffer compatible video card. This program will display a penguin and
a scrolling color bar (like the windows one) while init is running, ie after
the kernel is loaded, disks are mounted and checked, and init has started.


Install
=======

To use this program you need the SVGAlib libraries.

Edit the Makefile to your situation
make
make install


How to use
==========

Options:

	-l 	This displays the scrolling bar at the 
		bottom of the screen.

	-i	Displays the information about the computer
		and the current run level.


To get the splash to display while init is running, place the following in
your rc files.

in rc.sysinit: (The first rc script run)

/opt/bin/splash {-il} & 

NOTE: this MUST be run in background or it will lock your system!

in rc.local: (The last rc script run)

killall -HUP splash


Custom Splash Screens
=====================

Well the format for the image is a non compressed windows bitmap (I know,
but the windows bitmap format was the only one I had access to that was 
uncompressed and contained the palette).

The image details is 320x200x248. The program DOES NOT check the size of the
image, it just assumes that the size is correct. HINT: the file size for the
default splash.bmp is 65078

Another thing about the bitmap, Windows stores the bitmap from bottom to top,
svgalib draws from top to bottom, so the image is inverted. To fix this, simply
save the image upside down.


TODO
====
My todo list:
* More command line arguments
* Custom configuration file
* Multiple splash screens
* and anything else anyone can think of


Contacting me
=============

If you want to say hello I can be reached via the following:

c9605069@cs.newcastle.edu.au
peter.hartshorn@studentmail.newcastle.edu.au


Copyright
=========

All code is copyright 1999 Peter Hartshorn. 
Except function getrunlevel() Copyright 1991-1996 Miquel van Smoorenburg.
from the program "runlevel".

