
====================
= THE GGI DEMODISK =
====================

Pre-Release V 0.50. 


 1. Usage
----------

In the directory/archive where you found this package there should be the
following files :

demodisk.dsk  The actual demodisk image for 1.44MB 3.5" drives
demodisk.sig  A PGP 2.6.3 signature for the above file
dowrite       A unix sh-script to write the image to disk
rawrite.c     Source code for a DOS utility to do the same
rawrite.doc   Documentation for it
rawrite.exe   The utility executable
readme        This file

You will not need all of those files depending on what operating system you 
will use to make the disk.


 1.1. Creating the disk
------------------------

Under MSDOS start the RAWRITE program. Do so by simply entering its name
from the DOS prompt and pressing ENTER in the directory where the
rawrite.exe program is located.

You will then prompted for the image to write to disk.

Enter source file name: [demodisk.dsk]
Enter destination drive: [A:]

The values in [] have to be typed by you. The program will now prompt you to
insert a formatted diskette into drive A:. Do so and press ENTER.

The image will be written to disk. If you get any error messages in this
process, chances are good, that the disk is damaged. Try reformatting it
using "format a: /U". If this shows any errors, use another disk.


Under UNIX, you will probably know how to make a disk image. The "dowrite"
script shows one possible way to do it under some common flavours of unix. 
You might need to adjust the device name.


 1.2. Using the disk
---------------------

The disk is a bootdisk that will start up a KGI enabled Linux kernel (though
a rather old one, as I hadn't much time to prepare this package) and show
some demos.

You need not be afraid for things like boot viri, as long as you check the
PGP signature of the bootdisk. The public key to which it corresponds can be
found on my personal webpage http://sunserver1.rz.uni-duesseldorf.de/~becka/. 
Its fingerprint is AB 55 83 D3 74 70 E0 D5  F3 BB B7 A7 B8 9A 16 06.

The paranoid can disconnect the harddrives. They are not needed.

So stick the disk into the boot drive (A:) and turn on the computer.

The computer will now boot Linux from the disk. At the LILO prompt, you can
enter additional options, but this should not be necessary and you should 
know what you are doing in that case.

An exception might be, if you own an SMP board (you will know it, if you
do). In that case, please enter smp<ENTER> at the LILO prompt.

LILO will now load the kernel, start it (a bootup logo will appear and
diagnostic messages will scroll - you can ignore that) and Linux will
then read an execute the rest of the Disk.

The demos are automatically started and loop. The first thing that happens,
is that the KGI VGA driver is loaded. 

ATTENTION: THIS MAY FAIL ON MATROX CARDS. This is due to the fact, that
Matrox uses a nonstandard timing and nonstandard clocks on the standard
VGA ports. This is detected by the VGA driver and it refuses to load to
Make sure the monitor is not damaged (which isn't at all likely, but ...)
This does not indicate, that Matrox cards or the VGA driver are broken -
they are just incompatible when the monitor is set to "strict VGA".
Matrox cards are supported fine using the KGI driver for Matrox. Please
get the full GGI distribution if you own a Matrox card.

 1.3. The demos
----------------

The disk will cycle through the following demos:

1. Warp : realtime image distortion

2. 3D demo : A realtime 3D rotating penguin (yeah, I know, this ain't
             the official one ...).

   This can be controlled by the user with the following keys :
   <SPACE>   turn autorotation on/off.
   <CRSR>    rotate
   <KEYPAD>  move/zoom
   There are a few more keys, but they are actually for debugging ...

3. Plasma : some nice whirling pattern

4. Lens : several 3D mapping effects

5. planet : planet surface generator. <a> toggles animation

6. dots : whirling dots

7. stars : rotating starfield

8. titler : our internal slideshow system showing a few effects.

9. testpattern : show some image-tests <q> aborts

10. demo : drawing primitives tester.

11. mode-tests. See 9. <q> aborts. Shows all standard VGA modes.

You can skip to the next demo using <Esc> or <q> in most cases.
Pressing Ctrl-Alt-Del will cause a reboot and thus exit the demo.

 2. Warranty/Legal aspects
---------------------------

This software is provided as is without any implied warranties. 
The user takes full responsibility for running this software.

Copyright:
All software on that disk is under the GNU General Public License or
the LGPL (Library General Public License). The copyright is retained
by the individual authors as stated within the programs and/or sources.

We encourage you to copy and distribute the disk. Show it to your 
friends or anyone else interested.

 3. Contact information
------------------------

The contents of the disk have been prepared by people from the GGI project. 
You can find more information about the project, its goals and the source 
code at

http://www.ggi-project.org/


The writer of this document is Andreas Beck, andreas.beck@ggi-project.org.
