########################################
# Delta3D: The Open-Source Game Engine #
########################################

Welcome to Delta3D! We hope to get you up and running with Delta3D as
quickly as possible. If you only wish run pre-built applications and have
already used the Windows installer, you are ready to rock. 

Go ahead and try out the examples by running the executables found in
the build/bin folder.

There are also several useful utitilies also found in the build/bin folder.

Thanks for using Delta3D! Please visit our webpage at http://www.delta3d.org
and don't hesistate to use the forums for any problems you may have. We'll do
our best to respond as quick as possible.

Sincerely,
The Delta3D Team


########################
# Building From Source #
########################

Delta3D uses CMake (http://www.cmake.org) to generate projects for the 
libraries, examples, and utilities.  See 
http://delta3d.org/deltawiki/index.php?title=Tutorials for instructions on
how to build Delta3D from source and which CMake build options are available.

NOTE: You will *not* be able to compile the libraries or utilities
      from the Delta3D SDK package, only the examples.  See the Tutorials
      page for help in deciding which Delta3D download is right for you. 


################
# Dependencies #
################

Delta3D makes use of many different external dependencies; some are
required and some are optional.

If you are on Windows and are using a supported version of 
Visual Studio, we have prepared pre-compiled dependency pacakges for you.
These will live in a folder called 'ext' that should reside inside
your Delta3D directory.

Note: if the external dependency is not found by CMake, the Delta3D
projects that rely on that dependency will not be generated.

Please see the latest information on the External Dependencies at:
http://delta3d.org/deltawiki/index.php?title=Dependencies.


#########################
# Environment Variables #
#########################

Delta3D requires environment variables at runtime (but not at compile-time).
The Windows installer will set these up for you, but if you use the zip
package or are on Linux you need to set them youself.

Microsoft Windows
--------------------
Make sure the Delta3D environment variables are set.  Note: Delta3D
libraries are typically contained under a "build" sub-folder that is
named based on the compiler.  The DELTA_LIB and DELTA_BIN variables
may need to be customized based on the installation.

DELTA_ROOT = "C:\Program Files\delta3d"  (or wherever Delta3D is installed)
DELTA_INC = %DELTA_ROOT%\inc;%DELTA_ROOT%\ext\inc;%DELTA_ROOT%\ext\inc\CEGUI
DELTA_LIB = %DELTA_ROOT%\build\lib;%DELTA_ROOT%\ext\lib
DELTA_DATA = %DELTA_ROOT%\data
DELTA_BIN = %DELTA_ROOT%\build\bin;%DELTA_ROOT%\ext\bin

By adding DELTA_BIN to your PATH environment, all Delta3D applications
will find the Delta3D .dll files.

Once set, these variables can be used in Visual Studio in the project properties
or in the global VC++ directories (Tools->Options->Projects) as shown below:

Include files: $(DELTA_INC)
Library files: $(DELTA_LIB)

Linux
-----
DELTA_ROOT: path to your Delta3D installation
DELTA_DATA: $DELTA_ROOT/data
DELTA_INC: $DELTA_ROOT/inc:$DELTA_ROOT/ext/inc:$DELTA_ROOT/ext/inc:$DELTA_ROOT/ext/inc/CEGUI
DELTA_LIB: $DELTA_ROOT/lib:$DELTA_ROOT/ext/lib:$DELTA_ROOT/ext/lib/osgPlugins

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$DELTA_LIB


########################################
# Build instructions                   #
########################################

   dtHLAGM
   -----
   Requries RTI package to be installed! We cannot distribute RTI with
   Delta3D, so you are on your own. The dtHLAGM module is compiled and tested
   against RTI-S 1.3_D18 although any RTI supporting spec 1.3 should work.


   The Python Bindings
   -------------------
   Building the Delta3D Python bindings requires the following additional 
   packages: Python and Boost.Python. 

   See http://delta3d.org/deltawiki/index.php?title=Tutorials for information on 
   how to compile the non-distributed external dependencies required for 
   the Python bindings.
   

   STAGE
   -----
   Building STAGE requires an additional download of:
   -Qt 4.x, the Windows or Linux open-source release (http://qt-project.org/downloads)
   
   See http://delta3d.org/deltawiki/index.php?title=Tutorials for information on 
   how to compile the non-distributed external dependencies required for 
   building STAGE.