StonerviewW32 is a port of StonerView by Andrew Plotkin availabe for Linux and Mac
to the win32 Platform.

The original StonerView is Copyright 1998-2001 by Andrew Plotkin (erkyrath@eblong.com)
http://www.eblong.com/zarf/stonerview.html

Stonerview itself is based on ideas of Electropaint by Silicon Graphics which was
shipped with the Iris Indigo machines (and maybe it is still shipped with
newer SGI machines - I don't know)

Many thanks go to Rachel Grey (lemming@alum.mit.edu) for her tutorial on how
to write a windows openGL screensaver (http://www.cityintherain.com/howtoscr.html). Parts of her
source code are in here.
Another thank you goes to Jeff Molofee (http://nehe.gamedev.net)for the openGL tutorial bringing
me right to the point.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. (It should be a document entitled "Copying.txt".)

INSTALLATION
In the binary bundle you'll find a file named 'StonerViewW23.scr'. Copy this
file to where all the screensavers reside (usually something like C:\WINDOWS\system32).
After that you should be able to choose 'StonerViewW32' in the list of screensavers.

Compatibility issues:
- Tested on a WinXP home SP1 (inclusive dual head setup)
- Work on Win2k as well.

The settings dialog offers an option for selecting rendering to a bitmap. This is based on 
an article in the MS knowledge base concerning a bug in the general implemention of OpenGL
shipped with 2k and xp. So if you are experiencieng some kind of flickering - try this option!
It will however slow the screensaver down.

 
PROPERTIES
There are some little configurations you can make in the properties dialog of the
screensaver:

- wireframe: if selected only wireframes are drawn
- draw edges/width: if selected the edges will be drawn usin g the given width (raneg 1 to 100)
- use backfaceculling: if selected only one side of the polygons is filled
  (only affecting the visual appearance if you select one of the rotation modes)
- delay: guess!
- number of objects: obvious isn't it?
- compatibility: if checked rendering is performed to a bitmap so it's slower but may reduce strange flicker
  effects caused by an error in the general openGL implementation
- Rotation: select a rotation of the whole story about the selected axis. This leeds
  to seeing the polygons from ther back side so the setting "backfaceculling" gets important

The properties are stored in the windows registry


COMPILE/BUILD (sourcecode bundle)

The source code is not that nice as I would like it to be. Don't think of it
as nice tutorial code! In fact I'm a professional Java developer (and I like to do Java!)
and got mostly around coding  on the MS Windows platform till now (ok, ok I did some 
coding but this screensaver contains my first windows dialog)

Maybe I'll be doing the cleaunp another time.

The sources have to be linked to 
ScrnSave.Lib
opengl32.lib
glu32.lib
ComCtl32.Lib

The dialog resource built by Microsoft Visual Studio is included (so I think you'll need this to compile ...)
The compiled StonerViewW32.exe has to be renamed to StonerViewW32.scr telling Windows it's a screensaver.


Revision History
	03/03/2003 V1.2 - more options
					- do not use rendering to bitmap if not configured
	01/26/2003 V1.1 added a configuration dialog and some options
	01/25/2003 V1.0 the basic port of StonerView works
