Go to file
2008-06-03 11:28:16 +00:00
applications Updated authors and version file for 2.5.1 dev release 2008-05-30 21:23:49 +00:00
CMakeModules From Mathieu Marache, 2008-05-28 12:49:47 +00:00
doc/Doxyfiles From Jean-Christophe Lombardo and Robert Osfield, added 2008-01-28 18:29:38 +00:00
examples Added unit test to smoke out a thread issue with using ofstream("/dev/null") inside 2008-06-03 11:28:16 +00:00
include Added support for assigning GraphicsContext to individual GUIEventAdapter events, 2008-06-02 17:34:47 +00:00
packaging/pkgconfig Updated packgage number for 2.5.1 developer release 2008-05-30 11:44:06 +00:00
PlatformSpecifics/Windows From Jean-Sebastien Guay, notes on how to enable syntax highlighting in VS. 2008-01-21 18:06:47 +00:00
src Added support for assigning GraphicsContext to individual GUIEventAdapter events, 2008-06-02 17:34:47 +00:00
Xcode updated XCode project 2008-04-17 09:04:29 +00:00
AUTHORS.txt Updated authors and version file for 2.5.1 dev release 2008-05-30 21:23:49 +00:00
ChangeLog Updated ChangeLog 2008-05-30 21:12:44 +00:00
CMakeLists.txt Changed FIND_PACKAGE(PkgConfig) to INCLUDE(FindPkgConfig OPTIONAL) as per 2008-05-31 08:47:15 +00:00
configure Added a basic configure script to allow the setting of Release build by default. 2007-05-26 15:55:26 +00:00
genwrapper.conf Suppressed reflection of problem templates/typedefs 2007-12-26 21:38:11 +00:00
LICENSE.txt Added missing LGPL section to LICENSE.txt 2006-11-20 10:12:57 +00:00
NEWS.txt Update NEWS and README to 2.4 stable release 2008-04-25 12:40:14 +00:00
README.txt Updated authors and version file for 2.5.1 dev release 2008-05-30 21:23:49 +00:00
runexamples.bat From Paul Martz, added osgocclussionquery and osgthirdpersonview examples 2008-04-13 14:29:22 +00:00

Welcome to the OpenSceneGraph (OSG).

For up-to-date information on the project, in-depth details on how to 
compile and run libraries and examples, see the documentation on the 
OpenSceneGraph website:

    http://www.openscenegraph.org
  
For the impatient, read the simplified build notes below. For support 
subscribe to our public mailing list:

    http://www.openscenegraph.org/projects/osg/wiki/MailingLists



Robert Osfield.
Project Lead.
30th May 2008.

--

How to build the OpenSceneGraph
===============================

The OpenSceneGraph uses the CMake build system to generate a 
platform-specific build environment.  CMake reads the CMakeLists.txt 
files that you'll find throughout the OpenSceneGraph directories, 
checks for installed dependenciesand then generates the appropriate 
build system.

If you don't already have CMake installed on your system you can grab 
it from http://www.cmake.org, use version 2.4.6 or later.  Details on the 
OpenSceneGraph's CMake build can be found at:

    http://www.openscenegraph.org/projects/osg/wiki/Build/CMake

Under unices (i.e. Linux, IRIX, Solaris, Free-BSD, HP-Ux, AIX, OSX) 
use the cmake or ccmake command-line utils, or use the included tiny 
configure script that'll run cmake for you.  The configure script 
simply runs 'cmake . -DCMAKE_BUILD_TYPE=Release' to ensure that you 
get the best performance from your final libraries/applications.
 
    cd OpenSceneGraph
    ./configure
    make
    sudo make install
  
Alternatively, you can create an out-of-source build directory and run 
cmake or ccmake from there. The advantage to this approach is that the 
temporary files created by CMake won't clutter the OpenSceneGraph 
source directory, and also makes it possible to have multiple 
independent build targets by creating multiple build directories. In a 
directory alongside the OpenSceneGraph use:

    mkdir build
    cd build
    cmake ../OpenSceneGraph -DCMAKE_BUILD_TYPE=Release
    make
    sudo make install

Under Windows use the GUI tool CMakeSetup to build your VisualStudio 
files. The following page on our wiki dedicated to the CMake build 
system should help guide you through the process:

    http://www.openscenegraph.org/projects/osg/wiki/Support/PlatformSpecifics/VisualStudio

Under OSX you can either use the CMake build system above, or use the 
Xcode projects that you will find in the OpenSceneGraph/Xcode 
directory.

For further details on compilation, installation and platform-specific 
information read "Getting Started" guide:

    http://www.openscenegraph.org/projects/osg/wiki/Support/GettingStarted