OpenSceneGraph

Go to file

Robert Osfield ae303e38e9 From Paul Melis, "Here is an update to the osgviewerWX example. Keyboard events were not always received because the GraphicsWindowWX wasn't receiving focus. It now receives focus when the mouse enters the window. * I split the mouse handling from a monolithic method to separate ones, slightly cleaner than a whole bunch of if()'s, especially with another case of the mouse entering the canvas. * I changed the EVT_KEY_DOWN handler to an EVT_CHAR handler, although that now makes the up and down handler assymetric. The new down-handler returns translated key codes, so when you press the S key (without anything else), it actually returns 's' and not 'S' as the EVT_KEY_DOWN did. This means that statistics can be called up in the viewer window, while the example previously only printed a "Stats output:" line to the console. I'm not truly happy that the up handler returns _untranslated_ key codes. But solving this completely would probably mean adding some table that translated from wxWidgets' untranslated key codes to OSG's internal ones. This might be interesting to add, as anyone using OSG + wxWidgets in any serious manner would also have to add this. * I commented out the evt.Skip()'s in the keyboard handlers as these would only be necessary if there were some key events that are not handled. But currently all key events are simply forwarded. * I changed the handling of a mouse drag to a more general mouse move"		2008-05-26 21:09:54 +00:00
applications	Fixed lat/long ordering	2008-05-13 18:28:26 +00:00
CMakeModules	From Garrett Potts and Robert Osfield, changes to build against Collada DOM 2.x	2008-05-08 12:36:07 +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 an update to the osgviewerWX example. Keyboard events were not always received because the GraphicsWindowWX wasn't receiving focus. It now receives focus when the mouse enters the window.	2008-05-26 21:09:54 +00:00
include	Added continuous recording of the animation path to the RecordAnimationPathHandler	2008-05-26 17:30:43 +00:00
packaging/pkgconfig	Updated version number for 2.5.0 dev release	2008-05-12 11:01:54 +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 Colin McDonald, "I had to tighten a declaration in OpenFlight/FltWriteResult.h, as the Solaris SunStudio 11 compiler was being picky and wouldn't compile."	2008-05-26 21:04:47 +00:00
Xcode	updated XCode project	2008-04-17 09:04:29 +00:00
AUTHORS.txt	Updated AUTHORS for 2.5.0 release	2008-05-12 12:16:14 +00:00
ChangeLog	Update ChangeLog and wrappers for 2.5.0 dev release	2008-05-12 12:16:58 +00:00
CMakeLists.txt	Added check for pkg-config so that build only use related package checks when	2008-05-25 11:21:40 +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	Update NEWS and README to 2.4 stable release	2008-04-25 12:40:14 +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.
25th April 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