Go to file
Robert Osfield 6ff9810be1 From Mihai Radu, "After someone asked for a fix for non-textured object appearing black
with the shader for textured objects. This works very well in cases
where there could be a mix of textured and non-textured objects in the
scene, and it makes the initialization more robust.
The idea is from PSSM, to add a 1pixel texture to the main rendering  as
to provide white for any objects missing textures."
2007-12-09 16:06:14 +00:00
applications Updated ChangeLog, NEWS and AUTHORS file for 2.1.15 release 2007-10-03 23:44:24 +00:00
CMakeModules From Jean-Sebastien Guay, "Attached you will find an expanded FindOpenVRML.cmake file, as well as a fixed CMakeLists.txt file for the VRML plugin ." 2007-09-26 14:44:22 +00:00
doc/Doxyfiles Changed SHORT_NAMES = NO to SHORT_NAMES = YES to avoid crappy Windows problems 2007-05-29 07:25:13 +00:00
examples From Peter Hrenka, "Due to popular demand I would like to submit this 2007-12-08 16:37:05 +00:00
include From David Callu, added DBase attribute support for shapefiles 2007-12-09 15:43:49 +00:00
packaging/pkgconfig Updated version for 2.2 release 2007-10-04 10:05:20 +00:00
src From Mihai Radu, "After someone asked for a fix for non-textured object appearing black 2007-12-09 16:06:14 +00:00
VisualStudio Removed more of the old VisualStudio build system 2007-04-10 13:12:58 +00:00
Xcode Added missing files for qt plugin 2007-11-10 03:43:23 +00:00
AUTHORS.txt Updated version for 2.2 release 2007-10-04 10:05:20 +00:00
ChangeLog Updated ChangeLog for 2.2 release 2007-10-04 11:24:09 +00:00
CMakeLists.txt Updated version for 2.2 release 2007-10-04 10:05:20 +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 Updated wrappers 2007-09-30 15:24:43 +00:00
LICENSE.txt Added missing LGPL section to LICENSE.txt 2006-11-20 10:12:57 +00:00
NEWS.txt Updated version for 2.2 release 2007-10-04 10:05:20 +00:00
README.txt Updated version, authors and change log for the 2.1.14 release 2007-10-03 12:49:02 +00:00
runexamples.bat Removed now redundent osgshadowtexture and osgdepthshadow examples 2007-08-12 13:10:07 +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.

Robert Osfield.
Project Lead.
3rd October 2007.

--

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