
Demo programs in this directory:

vgatest

	Mode test program.

fun

	Random moving pixels accumulate in clusters. Uses virtual screens
	for frame animation.

mousetest

	Simple program to test mouse functionality. Left button changes
	color, right button exits.

keytest

	Similar program to test low-level keyboard interface.

scrolltest

	Smooth scrolling demo. Uses three different techniques. Useful for
	testing Mode X functionality (not that I would recommend it over
	320x200x256 linear).

speedtest

	Video memory speed tester.

testgl

	Demo program for vgagl framebuffer library.

testlinear

	Program to test linear addressing on Cirrus cards (and on Mach32).


There's also a 3D demo binary included in this directory. It has been in a
similar state for several months now, but I'm planning to get some work
done (although it probably won't be the amazing multi-player networked
3D lightsource-shaded real-time VGA virtual reality simulation). I'll
release the source code at some point (when it has some degree of
flexibility). I'm sorry that there's no scene description file; it will
come. So now you know you can do this kind of thing in Linux. And it's
practically 100% C code.

You can set the graphics mode to be used with the GSVGAMODE environment
variable (e.g. G640x480x256). All linear 256 color, 32K color and 16M color
modes are supported, with page flipping used if available. Planar 256 color
VGA modes also work. This should do 800x600 full screen 3D animation at near
10 fps with a good system (e.g. DX2/66, VLB Mach32, good cache/motherboard
chipset).

Request: Please report if page flipping goes wrong on a particular chipset
(e.g. ET4000, Trident) in 320x200x256.

The user interface is somewhat primitive at this point:

- Use the mouse to rotate.

- Left button accelerates, right decelerates.

- Press w to move upwards, s to go down again.

- Use r and f to control the zoom factor.

Note that the light source rotates quickly at an infinite distance. This
is not something that will easily occur naturally (as far as I know)...

