OpenSceneGraph

Go to file

Robert Osfield dd13893861 From Farshid Lashkari, "I noticed some problems when setting up CameraNodes that inherit viewport settings in stereo mode. It seems that the SceneView::cull() method will pass the full size viewport to the left/right cullvisitors, instead of the modified stereo viewport. I made quite a few changes to SceneView to fix the issue. The SceneView::cullStage() method will now receive the viewport as an argument, instead of using the global viewport. The SceneView::cull() method will pass the modifed viewport to cullStage when rendering in stereo. There are 2 new private methods computeLeftEyeViewport() and computeRightEyeViewport() that will compute the stereo viewports. I also modified the draw() function so it applies the correct viewport to the prerender stages. These changes are only necessary for horizontal/vertical split stereo."		2008-06-19 14:29:38 +00:00
applications	Updated authors and version file for 2.5.1 dev release	2008-05-30 21:23:49 +00:00
CMakeModules	From Mathias Froehlich, OpenThreads::Atomic support	2008-06-17 17:43:59 +00:00
doc/Doxyfiles	From Jean-Christophe Lombardo and Robert Osfield, added	2008-01-28 18:29:38 +00:00
examples	From Paul Melis, "Here is a reworked version of the osgviewerWX example. It changes the GraphicsWindowWX to only inherit from osgViewer::GraphicsWindow and adds a standalone widget, called OSGCanvas, that derives from wxGLCanvas. This solves a problem with the GraphicsWindowWX instance being destructed twice (see "Crash in osgviewerWX" of June 12th on osg-users). At program exit, the main frame deletes all of its children widgets and therefore calls GraphicsWindowWX's destructor, bypassing OSG's reference counting. The GraphicsWindowWX instance is then later destructed a second time when the reference held by osg::Camera goes to zero. This bug isn't exposed by the example directly, but if people are going to use the example as a basis (like the poster in the mentioned thread) they very likely will run into this problem.	2008-06-19 13:49:36 +00:00
include	From Farshid Lashkari, "I noticed some problems when setting up CameraNodes that inherit	2008-06-19 14:29:38 +00:00
packaging/pkgconfig	Updated versions for 2.5.2 dev release	2008-06-06 17:45:33 +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	From Farshid Lashkari, "I noticed some problems when setting up CameraNodes that inherit	2008-06-19 14:29:38 +00:00
Xcode	updated XCode project	2008-04-17 09:04:29 +00:00
AUTHORS.txt	Updated wrappers, authors and readme for 2.5.2 dev release	2008-06-06 19:57:56 +00:00
ChangeLog	Updated ChangeLog	2008-06-06 19:41:28 +00:00
CMakeLists.txt	Updated versions for 2.5.2 dev release	2008-06-06 17:45:33 +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 to fix OpenThreads::Atomic build issues.	2008-06-19 13:28:33 +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 wrappers, authors and readme for 2.5.2 dev release	2008-06-06 19:57:56 +00:00
runexamples.bat	From Paul Martz, added osgocclussionquery and osgthirdpersonview examples	2008-04-13 14:29:22 +00:00

README.txt

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.
6th June 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