/***************************************************************************\
 *                                                                         * 
 *          Electronic Documentation for NeonJax3D Screen Saver            * 
 *                           (Full SDK Version)                            * 
 *                                                                         * 
 *                               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.
-----------------------------------------------------------------------------

 *************************************************************************** 
 **                              Readme.txt                               ** 
 *************************************************************************** 

This Readme.txt file contains information about the files included in the
NeonJax3D-SDK.zip distribution.  This distribution of NeonJax3D includes the
screen saver and all the tools necessary to create your own 3D demos.
Fascination Software also has a free NeonJax3D Screen Saver-only version,
which is available for download at the www.fascinationsoftware.com website.

Please verify that the following files were included in the
"NeonJax3D-SDK.zip" file:


Readme.txt                       - this is the file that you are reading
Compiler\
         J3DComp.exe             - NeonJax3D World Compiler
         J3DComp.txt             - Documentation for NeonJax3D World Compiler
PathFind\
         nuclear.gif             - Sample image from the web
         Nuclear1-4.bmp          - Increasingly processed images
         Nuclear.txt             - Output Path data
         Nuclear-Path-Create.bat - Batch file for creating Path output file
         PathFind.exe            - NeonJax3D Path Crawler
         PathFind.txt            - Documentation for NeonJax3D Path Crawler
Saver\
      DX3\NeonJax3D.scr          - DirectX 3 version of NeonJax3D
      DX3\NeonJax3D_DX3.txt      - Documentation for DX3 NeonJax3D
      DX7\NeonJax3D.scr          - DirectX 7 version of NeonJax3D
      DX7\NeonJax3D_DX7.txt      - Documentation for DX7 NeonJax3D
Worlds\
       Example_1-5.j3d           - Binary output J3D Scene files (These may
                                   be viewed with the NeonJax3D screen saver)
       Example_1-5.txt           - Text NeonJax3D world description files 
       Example_1-5_Compile.bat   - Batch files for compiling and testing the
                                   examples
       TheScenes.txt             - Documentation for the Scene files
       Torus3D.bas               - QuickBasic 5.1 program for creating the 3D
                                   structure of a doughnut

The user may create 3D demos by writing a text description of the 3-D scene
in a simple C-like language created for NeonJax3D.  There are 5 examples
provided which collectively demonstrate all of the features of the NeonJax3D
engine.  Users may take objects from the examples given or create their own
objects for their demos.  The NeonJax3D World Compiler is used to validate
and translate these Scene Description Files into binary J3D files.  The
NeonJax3D screen saver can load and display the 3D demos from the binary J3D
files.

The "Compiler\" directory contains the NeonJax3D World Compiler executable
and documentation.  Refer to the "J3DComp.txt" file for more information.

The "PathFind\" directory contains a special NeonJax3D Path Crawler which
is a tiny assembly language program that can read BMP images and create a
special text description of all the curves found.  The output of this program
can be cut and pasted into a Scene Description File and used in the
"Hollywood Marquee" effect for the object which is composed of 1,000 Points
of Light.   Refer to the "PathFind.txt" documentation for more information.

The "Saver\" directory contains the actual NeonJax3D screen saver.  There are
two versions included: one for DirectX 3, and one for DirectX 7.The DirectX 3
version of NeonJax3D is for users of Windows NT 4.0.  Users of all other
operating systems (Windows 95/98/Me, Windows 2000, Windows XP) should use the
DirectX 7 version.  The only feature missing from NeonJax3D in the DX3
version is the ability to view the 3D demo in simulated three-dimensional
mode with 3D LCD goggles.  Using the DX7 version of NeonJax3D and an
Nvidia-based video card with compatible LCD goggles such as the ELSA 3D
Revelator (TM) glasses, the user may activate the Stereo 3D mode from the
NeonJax3D settings and view the 3D demo in true 3D.  Further instructions
regarding this function are available in the "NeonJax3D.txt" documentation
files.

The "Worlds\" directory contains the example Scene Description Files, the
example binary J3D output files, and the batch files used to compile and test
the examples. Also in this directory is the "TheScenes.txt" file which offers
descriptions of each of the 3D examples and instructions for modifying and
testing them.  Finally the text file "Torus3D.bas" is also included.  This
file is a QuickBasic 5.1 (TM) program which was used to generate the 3-D data
for the doughnut objects in Example #5.  It may be modified and used to
generate 3D data for other objects.  Refer to the "TheScenes.txt" file for
information on creating your own Scenes.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                             Installation                              ||
 ++-----------------------------------------------------------------------++

To install the NeonJax3D screen saver, simply use the Windows file explorer
to copy the appropriate NeonJax3D.scr file from the Saver\ directory in this
distribution into your Windows Root Directory.  For  Windows 95/98/Me this
is usually "C:\Windows", and for Windows NT, 2000, or XP this should be
"C:\Winnt".

When you have the correct NeonJax3D.scr file in the Windows Root Directory,
right-click the Windows desktop and select "Properties" from the drop-down
context list.  Select the "Screen Saver" tab at the top of the window that
appears, then pull down the drop-down list and select "NeonJax3D" from the
list of screen savers.  You may now press "OK" to close this window, or you
may press the "Settings" button to further customize NeonJax3D.

All of the other tools and batch files included with this distribution should
run from their current location on your hard drive (the directory to which
WinZip extracted the "NeonJax3D-SDK.zip" archive).  They do not need to be
moved or set up.

Further instructions regarding the installation and use of NeonJax3D is
available in the "NeonJax3D.txt" documentation files.

A complete specification for the NeonJax3D Scene Source File format is
available in 'Compiler\J3DComp.txt'.

-----------------------------------------------------------------------------
 ++-----------------------------------------------------------------------++
 ||                               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
-----------------------------------------------------------------------------