OpenSceneGraph: Difference between revisions

Jump to navigation Jump to search
updated content structure/ordering
(updated content structure/ordering)
Line 5: Line 5:
[[Image:Flightgear uml associations class diagram.png|thumb|270px|An [[UML Diagrams|UML]] class diagram disclosing the associations between some classes of the FlightGear source code.]]
[[Image:Flightgear uml associations class diagram.png|thumb|270px|An [[UML Diagrams|UML]] class diagram disclosing the associations between some classes of the FlightGear source code.]]


== Getting OpenSceneGraph ==
= Downloading OpenSceneGraph =
 
=== OSG version from svn ===


== Downloading Stable OpenSceneGraph ==
The OpenSceneGraph project uses  [http://svnbook.red-bean.com/nightly/en/index.html Subversion (SVN)].
The OpenSceneGraph project uses  [http://svnbook.red-bean.com/nightly/en/index.html Subversion (SVN)].


(Note: The source code should not be downloaded to the build.osg directory, or the build will not work correctly. See below.)
'''Note''': The source code should not be downloaded to the build.osg directory, or the build will not work correctly. See below.


To check out the '''latest stable version''' of OpenSceneGraph:
To download the '''latest stable version''' of OpenSceneGraph use:


     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-2.8.3
     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-2.8.3


Otherwise, you can also use the latest '''development release''' of OpenSceneGraph:
'''Manual Download''': If you don't want to use SVN, you can also pick a stable release from the OSG download page:
 
http://www.openscenegraph.org/projects/osg/wiki/Downloads
 
If the main OSG site is down (frequently) you can also use one of its various mirrors:
 
http://www.freebsd.org/cgi/pds.cgi?ports/graphics/osg
 
== OpenSceneGraph developer versions ==
FlightGear developers may want to use the latest '''development release''' of OpenSceneGraph:


     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-2.9.10
     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-2.9.10
Line 23: Line 31:
You can replace the "2.9.10" by future development OSG versions (if known to be compatible with FlightGear).
You can replace the "2.9.10" by future development OSG versions (if known to be compatible with FlightGear).


Finally, you can also download sources of '''today's OSG development'''.
Alternatively, developers interested in '''today's OSG development''' can download the current OSG trunk.


'''WARNING''': The sources of current OSG development aren't always compatible with FlightGear. Only use these if you're interested in OSG development or developing new OSG features for FlightGear:
'''WARNING''': The sources of current OSG development aren't always compatible with FlightGear. Only use these if you're interested in OSG development or developing new OSG features for FlightGear:
Line 29: Line 37:
     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/trunk OpenSceneGraph  
     svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/trunk OpenSceneGraph  


The OpenSceneGraph repository includes all parts of OSG you need.
= Compiling OpenSceneGraph =
 
'''Manual Download'''
Pick a stable release from the OSG download page:
http://www.openscenegraph.org/projects/osg/wiki/Downloads
 
'''Various mirrors in case the main OSG site is down (frequently)'''
 
http://www.freebsd.org/cgi/pds.cgi?ports/graphics/osg
 
== Compiling OpenSceneGraph ==


OpenSceneGraph uses cmake. Since OSG version 2.7.3 (8th Oct 2008) to build it there is a relatively new version of cmake needed. According to OSGs CMakeLists.txt it's 2.6.1 but cmake 2.6.0-5 from [http://backports.org/dokuwiki/doku.php backports.org] for Debian/Etch does the trick.
OpenSceneGraph uses cmake. Since OSG version 2.7.3 (8th Oct 2008) to build it there is a relatively new version of cmake needed. According to OSGs CMakeLists.txt it's 2.6.1 but cmake 2.6.0-5 from [http://backports.org/dokuwiki/doku.php backports.org] for Debian/Etch does the trick.
Line 62: Line 60:
* You don't need to build the examples, wrappers or applications.
* You don't need to build the examples, wrappers or applications.


=== Installing OpenSceneGraph and FlightGear with --prefix ===
== Installing OpenSceneGraph and FlightGear with --prefix ==


If you use --prefix to choose were to install FlightGear and do not want to install OSG globally on the system this can be done with the following method:
If you use --prefix to choose were to install FlightGear and do not want to install OSG globally on the system this can be done with the following method:
Line 92: Line 90:




 
= Features and issues =


== Regressions in CVS/HEAD ==
== Regressions in CVS/HEAD ==
Line 153: Line 151:
http://www.donburns.net/OSG/Articles/OSGMP/"
http://www.donburns.net/OSG/Articles/OSGMP/"


== Getting the PLIB Code ==
= Getting the PLIB Code =


Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.
Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.
Line 176: Line 174:
The data directory should be the CVS HEAD version. Some aircraft, however, have a PRE_OSG_PLIB_20061029 branch that works better with FlightGear/plib, e.g Hawker Hunter.
The data directory should be the CVS HEAD version. Some aircraft, however, have a PRE_OSG_PLIB_20061029 branch that works better with FlightGear/plib, e.g Hawker Hunter.


== External link ==
= External link =
* http://www.openscenegraph.org/
* http://www.openscenegraph.org/


159

edits

Navigation menu