/***************************************************************************\
 *                                                                         * 
 *         Electronic Documentation for NeonJax3D Example Scenes           * 
 *                                                                         * 
 *                               Version 1.0                               * 
 *                                                                         * 
 *                             July 9th, 2002                              * 
 *                                                                         * 
 *                 Copyright (c) 2002 by Richard Goedeken                  * 
 *                                                                         * 
 *                                                                         * 
 *                  A product of Fascination Software Co.                  * 
 *                                                                         * 
\***************************************************************************/
-----------------------------------------------------------------------------
Legal Stuff:

This software (NeonJax3D SDK Version 1.0) is copyrighted software.  I give
you (the LICENSEE) permission to freely copy and distribute this software in
any manner to anyone (the RECIPIENTS) as long as the following two conditions
are met:

A) The LICENSEE may not charge the RECIPIENTS more than us$1 over and above
   the media and duplication costs for copies of this software.
B) Any copies made by the LICENSEE must retain all of the original files and
   the original file structure from the ZIP file distributed by Fascination
   Software. (NeonJax3D-SDK.zip)

Fascination Software, and Richard Goedeken, are not in any way liable for any
damages incurred by the use of this software.  The user assumes full
responsibility for the use of this software.
-----------------------------------------------------------------------------

 *************************************************************************** 
 **                             TheScenes.txt                             ** 
 *************************************************************************** 

This file contains information regarding the usage of the example scenes
included with NeonJax3D.   There are 5 demo scenes included, which
collectively demonstrate all of the features available on the NeonJax3D demo
engine.  These example scenes are described below.

The user may use any of the included example source code (Objects, Palettes,
Paths, or Items) in his or her own NeonJax3D demos.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Example_1.txt  (Big Example World)

This example file contains the code for 8 3D Objects, 6 Palettes, and one
Path.  It also contains example code for using each of the 12 available
Point Morph effects.  There are only 3 Items used in this Scene (Diamond,
SpikeStar, and Points) but the user may easily change these Items to
different Objects to begin playing with the NeonJax3D World Compiler.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Example_2.txt  (Cubes)

This NeonJax3D example demo is composed entirely of cubes!  There are two
cube Items with two-tone palettes, and a Points object which alternates
between the EmptyCube, FilledCube, and BouncingCubes effects.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Example_3.txt  (Snow Field)

This is a bare-bones example.  It contains no Objects or Palettes, just a
single Points Item which continuously displays the SnowField effect.  The
snow field is placed at a slight angle to the viewer to achieve the best
viewing experience.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Example_4.txt  (Wandering Planets)

This is a small example of a possible solar system - it includes a star, and
three planets orbiting around the sun.  The Points object is set to the
SaturnRings effect and is placed around the green planet.

This example file would serve as an excellent starting point for a true Solar
System model demo.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Example_5.txt  (The Tori)

This example file includes two toroidal objects that were generated with the
Torus3D.bas program (see Torus3D.bas section for more information).  These
doughnut-shaped Objects are used with two unique palettes in this Scene.
One palette is reflective purple and gold, while the other is 'glitchy'-
looking and blue. This example file does not use the Points object.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                          Testing The Scenes                           ||
 ++-----------------------------------------------------------------------++

Your file/directory structure should be set up as described in the Readme.txt
file in the root directory of this SDK.  To test an example Scene file, just
run the corresponding batch file from the command prompt or the Windows
Explorer.  For example, in order to test 'Example_5.txt', execute the
'Example_5_Compile.bat' program.  This batch file will compile the Scene file
(and pause if there was an error), then it will display the 'Example_5.J3D'
demo using the DX3 version of the NeonJax3D Screen Saver.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                         Modifying The Scenes                          ||
 ++-----------------------------------------------------------------------++

You may use any text editor to modify the Example_*.txt files and test your
modifications as described above.  Refer to the "J3DComp.txt" file in the
'Compiler\' directory for detailed information about the NeonJax3D World
Compiler and features available to the NeonJax3D Scene designer.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                             Torus3D.bas                               ||
 ++-----------------------------------------------------------------------++

There is a text file included in this directory with the Scene files called
'Torus3D.bas'.  This is a QuickBasic 5.1 program which was used to generate
the toroidal Objects in 'Example_5.txt'.  Users may modify this program to
easily create their own 3D objects.

The 'Torus3D.bas' program was designed to be compiled by Microsoft QuickBasic
and run from the command line, piping the output to a text file like this:
'Torus3D.exe > TorusObjects.txt'.  If the user does not have a Basic compiler
but does have an interpreter (such as Basica or GWBasic), it should be easy
to add the necessary code to 'Torus3D.bas' to output the Object data to a
disk file instead of the screen.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                               Contact                                 ||
 ++-----------------------------------------------------------------------++

To contact Fascination Software, point your web browser at:

                        www.fascinationsoftware.com

And follow the links...

-----------------------------------------------------------------------------
EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF EOF
-----------------------------------------------------------------------------