Updates to the documentation.
This commit is contained in:
Robert Osfield
parent
b1717dc898
commit
7a76be4465
7
README
7
README
@ -1,8 +1,9 @@
|
||||
Welcome to the OpenSceneGraph (OSG).
|
||||
|
||||
Documention is located in doc/, this includes documention on compiling
|
||||
and installing, the OpenSceneGraph.
|
||||
For information on the project, this distribtion, how to compile and
|
||||
run libraries and demos, and for documention see open up index.html
|
||||
in your perfered html browser.
|
||||
|
||||
Robert Osfield.
|
||||
robert@openscenegraph.com
|
||||
May 2001.
|
||||
April 2002.
|
||||
|
||||
@ -7,13 +7,24 @@
|
||||
</head>
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
<br><a href="install.html">Installation </a> <a href="#Contents of distribution">Contents
|
||||
of Distribution</a> <a href="documentation.html">Documentation</a> <a href="dependencies.html">Plugin
|
||||
Dependencies</a> <a href="data.html">Data Sources</a>
|
||||
<a href="#Contacts">Contacts</a>
|
||||
|
||||
<h3>
|
||||
<a NAME="../Contents of distribution"></a><u>Contents of distribution</u></h3>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h2><u>Contents of distribution</u></h2>
|
||||
./ Root directory.
|
||||
<blockquote><tt><a href="../README">README</a> </tt>text
|
||||
bare bones readme file.
|
||||
|
||||
@ -7,8 +7,24 @@
|
||||
</head>
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
<h3>
|
||||
<a NAME="Data Sources"></a>Data Sources</h3>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h2><u>Data Sources</u></h2>
|
||||
|
||||
<ul>
|
||||
|
||||
@ -17,13 +33,13 @@
|
||||
|
||||
<br>
|
||||
<br>
|
||||
<li>Terrain models in OpenFlight .flt and TerraPage format at Terrex:</li>
|
||||
<a href="http://www.terrex.com/downloads/index.htm">http://www.terrex.com/downloads/index.htm</a>
|
||||
<li>Terrain models in OpenFlight .flt and TerraPage format go to the download page at </li>
|
||||
<a href="http://www.terrex.com">http://www.terrex.com</a>
|
||||
|
||||
<br>
|
||||
<br>
|
||||
<li>Terrain models in OpenFlight .flt format at Grime:</li>
|
||||
<a href="http://www.grime.net/sim/default.htm">http://www.grime.net/sim/default.htm</a>
|
||||
<a href="http://www.grime.net">http://www.grime.net</a>
|
||||
|
||||
<br>
|
||||
<br>
|
||||
|
||||
@ -8,12 +8,27 @@
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2>
|
||||
<a NAME="Running the demos"></a><u>Running the demos</u></h2>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><img src="images/sgv_cow.jpg" width=128 height=100 border=0> </td>
|
||||
<td><a href="sgv.html"><img src="images/sgv_cow.jpg" width=128 height=100 border=0></a> </td>
|
||||
<td><b>sgv cow.osg</b></td>
|
||||
<td>The scene graph viewer demo uses osgGLUT::Viewer to bring up a basic viewer. To find out what
|
||||
command line arguments it takes simply run sgv without any arguments. To load a model simple
|
||||
@ -23,10 +38,10 @@
|
||||
of key presses and mouse interaction read the <a href="sgv.html">sgv</a> documentaion.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><img src="images/sgv_stereo.jpg" width=128 height=100 border=0> </td>
|
||||
<td><a href="stereo.html"><img src="images/sgv_stereo.jpg" width=128 height=100 border=0></a> </td>
|
||||
<td><b>sgv -stereo cessna.osg</b></td>
|
||||
<td>The scene graph viewer also supports anaglyphic, quad buffered, and split screen stereo modes,
|
||||
for a full list of options and environmental variables see the <a href="stereo.html">sgv</a> documentaion.</td>
|
||||
for a full list of options and environmental variables see the <a href="stereo.html">stereo</a> documentaion.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><img src="images/hangglide.jpg" width=128 height=100 border=0> </td>
|
||||
|
||||
@ -8,6 +8,21 @@
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2>
|
||||
<a NAME="Scene graph dependencies"></a><u>Scene graph dependencies</u></h2>
|
||||
<p>The OpenSceneGraph is composed of core scene graph libraries, plugins libraries and demo programs. The core scene
|
||||
|
||||
@ -9,17 +9,27 @@
|
||||
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<h1>
|
||||
<b><i><u>Documentation</u></i></b></h1>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2>
|
||||
<u>Reference Guides</u></b></h2>
|
||||
|
||||
The documentation on the OSG is still in its early stages, and far from
|
||||
complete. If you can't find your answers in what documentation there currently
|
||||
is, please feel free to post the question on the OSG mailing list.
|
||||
<p><u><a href="../index.html">Introduction, distribution contents and contacts</a></u>
|
||||
<p><u>User documention</u>
|
||||
<blockquote><a href="sgv.html">sgv</a>
|
||||
Documentation on key binding in sgv (Scene Graph Viewer.)</blockquote></p>
|
||||
<blockquote><a href="stereo.html">stereo</a>
|
||||
Details on how to run osg applications in stereo.</blockquote></p>
|
||||
<p><u>Reference guides (automatically generated using doc++)</u>
|
||||
<blockquote><a href="doc++/osg/HIER.html">osg/</a>
|
||||
core scene graph reference guide.
|
||||
|
||||
@ -9,38 +9,71 @@
|
||||
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<h1>
|
||||
<b><i><u>Documentation</u></i></b></h1>
|
||||
The documentation on the OSG is still in its early stages, and far from
|
||||
complete. If you can't find your answers in what documentation there currently
|
||||
is, please feel free to post the question on the OSG mailing list.
|
||||
<p><u><a href="../index.html">Introduction, distribution contents and contacts</a></u>
|
||||
<p><u>User documention</u>
|
||||
<blockquote><a href="sgv.html">sgv</a>
|
||||
Documentation on key binding in sgv (Scene Graph Viewer.)</blockquote></p>
|
||||
<blockquote><a href="stereo.html">stereo</a>
|
||||
Details on how to run osg applications in stereo.</blockquote></p>
|
||||
<p><u>Reference guides (automatically generated using doc++)</u>
|
||||
<blockquote><a href="doc++/osg/HIER.html">osg/</a>
|
||||
core scene graph reference guide.
|
||||
<br><a href="doc++/osgUtil/HIER.html">osgUtil/</a>
|
||||
scene graph utilities reference guide.
|
||||
<br><a href="doc++/osgDB/HIER.html">osgDB/</a>
|
||||
scene graph database utilities reference guide.
|
||||
<br><a href="doc++/osgText/HIER.html">osgText/</a>
|
||||
scene graph text reference guide.
|
||||
<br><a href="doc++/osgGLUT/HIER.html">osgGLUT/</a>
|
||||
simple GLUT based viewer base classes reference guide.</blockquote>
|
||||
<p>Doxygen-generated tarballs are available for <a href="http://www.openscenegraph.org/download/dox/">download</a> from the website</p>
|
||||
<p><u>UML Diagrams</u>
|
||||
<blockquote><a href="UML/osg.png">osg</a>
|
||||
UML diagram of the osg core library
|
||||
<br><a href="UML/osgutils.png">osgUtil</a>
|
||||
UML diagram of the osg utilities library</blockquote></p>
|
||||
<p><u>Mind Maps</u>
|
||||
<blockquote><a href="MindMaps/DesignPatterns/DesignPatterns.html">Design
|
||||
Pattern used in the OSG.</a>
|
||||
<br><a href="MindMaps/Mission/Mission.html">Mission Statement for OSG.</a></blockquote></p>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2>
|
||||
<u>Index</u></b></h2>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td>Introduction to Scene Graph in general, the OpenSceneGraph project itself and how to use it.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td>A list of the directories in the distribution.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td>A guide of how to compile and install on all the supported platforms.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td>Listing of all the dependancies of the project, with links of where to download them.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td>Thumbnails and info on all the demo applications which come with this distribution.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td>List of websites where one can download interesting and useful data from.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td>List of key bindings support by the osgGLUT::Viewer and hence sgv and the rest of demos.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td>Documentation on the commandline paramters and environmential variables which control stereo.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
<td>Reference guides of the core libraries.</td>
|
||||
</td>
|
||||
|
||||
</table>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
@ -8,8 +8,22 @@
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<h2>
|
||||
<a NAME="Compiling and installing the OpenSceneGraph"></a><u>Compiling and installing the OpenSceneGraph</u></h2>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2><u>Compiling and installing the OpenSceneGraph</u></h2>
|
||||
|
||||
|
||||
<p>
|
||||
@ -84,8 +98,8 @@ For platform specific details:
|
||||
</ul>
|
||||
<hr>
|
||||
|
||||
<h2>
|
||||
<u><a name="Compiling under Windows with Visual Studio">Compiling under Windows with Visual Studio.</a></u></h2>
|
||||
<h3>
|
||||
<u><a name="Compiling under Windows with Visual Studio">Compiling under Windows with Visual Studio.</a></u></h3>
|
||||
<p>The Microsoft Visual C++ 6.0 workspace file is VisualStudio.dsw located
|
||||
in the VisualStudio below the OSG this root directory. The OSG will compile
|
||||
with the basic VisualC++6.0, but, and this is a big but, the STL version which
|
||||
@ -126,14 +140,14 @@ to help the location of datafiles. For example :
|
||||
<p>To help compilation of the image reader plugins, various image libraries
|
||||
have been zipped up for your convienice, your find these on the OSG release
|
||||
download directory.
|
||||
<h2>
|
||||
Using Visual Studio .NET</h2>
|
||||
<h3>
|
||||
Using Visual Studio .NET</h3>
|
||||
<p>
|
||||
Looks like Microsoft have eventually got their act together on the compiler front,
|
||||
the compiler looks Standard C++ compilient with a solid STL implement, so this is
|
||||
the recommend route.</p>
|
||||
<h2>
|
||||
Using Dinkumware STL</h2>
|
||||
<h3>
|
||||
Using Dinkumware STL</h3>
|
||||
<p>
|
||||
The basic jist is that you'll need to download their STL implementation, and follow their
|
||||
instructions of how toforce VisualStudio to pick up the new STL implementation. More details
|
||||
@ -148,8 +162,7 @@ The #ifdef is smart enough to do this automatically when using VIsualStudio .NET
|
||||
modification by hand won't be required. Unfortunately there doesn't seem to be a special define associated
|
||||
with the Dinkumware STL for the #ifdef to pick up on.
|
||||
</p>
|
||||
<h2>
|
||||
Using STLport</h2>
|
||||
<h3>Using STLport</h3>
|
||||
</p>
|
||||
The OSG has been tested under Windows with STLport-4.5, which allows the
|
||||
users to configure the type of STL support required for STLport itself.
|
||||
@ -172,7 +185,7 @@ list, thus overriding MS's own STL implementations.
|
||||
<hr>
|
||||
|
||||
|
||||
<h2><u><a name="Linux">Compiling under Linux</a></u></h2>
|
||||
<h3><u><a name="Linux">Compiling under Linux</a></u></h3>
|
||||
Compile, from the OSG root directory, ('%' is UNIX csh prompt) type:
|
||||
<blockquote><tt>% make</tt></blockquote>
|
||||
Note, make should automatically detect linux and build optimized targets
|
||||
@ -189,8 +202,8 @@ distribtions are upto date even recent ones. If you have problems compiling
|
||||
osgText due to GLU problems then check out the details at the bottom of
|
||||
this file, under the title RedHat7.1 & GLU1.3 for a quick way of installing
|
||||
GLU1.3 in the right place.
|
||||
<h2>
|
||||
RedHat 7.2 & GLU1.3</h2>
|
||||
<h3>
|
||||
RedHat 7.2 & GLU1.3</h3>
|
||||
I have posted a simple fix for those of us who have been unable to correctly
|
||||
build OSG 0.8.43 on Redhat 7.2. You can download it at http://www.openscenegraph.org/download/dependencies/ReadHat7.2_fixglu.tar.gz
|
||||
To install it, follow these steps:
|
||||
@ -217,7 +230,7 @@ osgText.) Good luck everyone. - Clay
|
||||
<br>
|
||||
<hr>
|
||||
|
||||
<h2><u><a name="Free BSD">Compiling under FreeBSD</a></u></h2>
|
||||
<h3><u><a name="Free BSD">Compiling under FreeBSD</a></u></h3>
|
||||
Compile, from the OSG root directory, ('%' is UNIX csh prompt) type:
|
||||
<blockquote><tt>% make</tt></blockquote>
|
||||
Note, make should automatically detect linux and build optimized targets
|
||||
@ -233,7 +246,7 @@ To get full details of make options, type:
|
||||
<br>
|
||||
<hr>
|
||||
|
||||
<h2><u><a name="IRIX">Compiling under IRIX</a></u></h2>
|
||||
<h3><u><a name="IRIX">Compiling under IRIX</a></u></h3>
|
||||
Since the OSG uses Standard C++ features such as STL it is important to
|
||||
have an up to date version of the MIPSPro compilers, ie. 7.3 or later.
|
||||
Support for MIPSPro7.2.1 has now been dropped since it was becoming to
|
||||
@ -253,7 +266,7 @@ To get full details of make options, type:
|
||||
|
||||
<hr>
|
||||
|
||||
<h2><u><a name="Solaris">Compiling under Solaris</a></u></h2>
|
||||
<h3><u><a name="Solaris">Compiling under Solaris</a></u></h3>
|
||||
Compile, from the OSG root directory, ('%' is UNIX csh prompt) type:
|
||||
<blockquote><tt>% make</tt></blockquote>
|
||||
Note, make should automatically detect linux and build optimized targets
|
||||
@ -268,7 +281,7 @@ To get full details of make options, type:
|
||||
|
||||
<hr>
|
||||
|
||||
<h2><u><a name="Mac OSX">Compiling under MacOS X (instructions written by Phil Atkin)</a></u></h2>
|
||||
<h3><u><a name="Mac OSX">Compiling under MacOS X (instructions written by Phil Atkin)</a></u></h3>
|
||||
For anyone who's ever used a Unix box for development it really is so simple
|
||||
it's insane.
|
||||
<p>You need to have installed the Developer tools from the CD that comes
|
||||
@ -331,7 +344,7 @@ forewarned is forearmed.
|
||||
|
||||
<hr>
|
||||
|
||||
<h2><u><a name="Cygwin">Compiling under Cygwin</a></u></h2>
|
||||
<h3><u><a name="Cygwin">Compiling under Cygwin</a></u></h3>
|
||||
To compile, from the OSG root directory, type: make Note, make should automatically
|
||||
detect your system and build optimized targets for your system. And if
|
||||
you wish to install the OSG type: make install Note that make symbolic
|
||||
@ -347,22 +360,6 @@ Add the following to your .cshrc (note paths seperated by colon's): setenv
|
||||
OSGFILEPATH ./:${OSGDATA}:${OSGDATA}/Images Or the following if you're
|
||||
using a sh compatible shell : export OSGFILEPATH=./:${OSGDATA}:${OSGDATA}/Images:
|
||||
Or under windows (note paths seperated by semi-colon's) : SET OSGFILEPATH=./:${OSGDATA};${OSGDATA}/Images
|
||||
<br>
|
||||
<br>
|
||||
<hr>
|
||||
|
||||
<h2>
|
||||
Running the demos</h2>
|
||||
To run the viewer demo type (you made need to type rehash first under Unix)
|
||||
:
|
||||
<br>%sgv cow.osg sgv lz.rgb or sgv Spinnercar.flt sgv Alley.3ds sgv town_ogl_pfi.pfb
|
||||
or sgv -stereo cow.osg (see doc/stereo.html for further details) or sgv
|
||||
-stencil cow.osg (to turn on use of the stencil buffer and enable the overdraw
|
||||
stats mode.) or sgv (with no arguments prints out usage to console.) Other
|
||||
run other demos type osgcube or hangglide hangglide master.flt or osgreflect
|
||||
cow.osg or osgconv Alley.3ds Alley.osg or osgtexture lz.rgb tree.rgb or
|
||||
osgimpostor cow.osg or osgviews glider.osg (Note: the file is picked up
|
||||
by checking the directories pointed to by $OSGFILEPATH)
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@ -7,7 +7,22 @@
|
||||
|
||||
<img src="images/OpenSceneGraphBanner_Distribution.jpg" width=640 height=77 border=0>
|
||||
|
||||
<h2>Introduction to the OpenSceneGraph</h2>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2><u>Introduction to the OpenSceneGraph</u></h2>
|
||||
|
||||
<p>Welcome to OpenSceneGraph project!
|
||||
</p>
|
||||
@ -18,13 +33,15 @@ what scene graphs are, why graphics developers use them, and details about the O
|
||||
project, how to learn how to use it and contribute to the OpenSceneGraph community.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<i>Robert Osfield,
|
||||
Project Lead.
|
||||
April 2002.</i>
|
||||
</p>
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>What is a Scene Graph?</h2>
|
||||
<h3><u>What is a Scene Graph?</u></h3>
|
||||
<p>Its a tree! Quite simply one the best and most reusable data structures invented.Typically drawn schematically as
|
||||
root at the top, leaves at the bottom. It all starts with a topmost root node which
|
||||
encompasses your whole virtual world, be it 2D or 3D. The world is then broken down
|
||||
@ -45,7 +62,7 @@ programs.
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>Why use a Scene Graph - Performance, Productivity, Portability and Scalability.</h2>
|
||||
<h3><u>Why use a Scene Graph - Performance, Productivity, Portability and Scalability</u>.</h3>
|
||||
|
||||
<ol>
|
||||
<li>
|
||||
@ -98,7 +115,7 @@ framework of the scene graph handles the differnt underlying hardware configurat
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>So what about the OpenSceneGraph project?</h2>
|
||||
<h3><u>So what about the OpenSceneGraph project?</u></h3>
|
||||
|
||||
<p>
|
||||
The OpenSceneGraph is an Open Source Scene Graph, and our goal is make the benifits
|
||||
@ -199,7 +216,7 @@ already adopted their projects, and are from all over the world.
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>Getting started</h2>
|
||||
<h3><u>Getting started</u></h3>
|
||||
|
||||
<p>
|
||||
The first thing is to select the distribution which suits you, there are binary, development and
|
||||
@ -235,7 +252,7 @@ libraries that parts of the OpenSceneGraph is dependant upon such as glut, check
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>How to learn to use the OpenSceneGraph</h2>
|
||||
<h3><u>How to learn to use the OpenSceneGraph</u></h3>
|
||||
|
||||
<p>
|
||||
The OpenSceneGraph distribution comes with a reference guide for each of the componet libraries - osg, osgDB,
|
||||
@ -265,7 +282,7 @@ and OpenGL reference guide 'Blue Book'. The main <a href="http://www.opengl.org
|
||||
</p>
|
||||
<hr>
|
||||
|
||||
<h2>Support and discussion - the <i>openscenegraph-news</i> mailing list</h2>
|
||||
<h3><u>Support and discussion - the <i>openscenegraph-news</i> mailing list</u></h3>
|
||||
<p>
|
||||
For scene graph related questions, bug reports, bug fixes, and general design and development discussion one should
|
||||
join the <a href="http://lists.sourceforge.net/mailman/listinfo/openscenegraph-news">openscenegraph-news</a> mailing list,
|
||||
|
||||
35
doc/sgv.html
35
doc/sgv.html
@ -2,15 +2,29 @@
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<meta name="GENERATOR" content="Mozilla/4.72 [en] (X11; U; Linux 2.2.15-3SGI_39 i686) [Netscape]">
|
||||
<meta name="GENERATOR" content="Mozilla/4.75C-SGI [en] (X11; I; IRIX64 6.5 IP27) [Netscape]">
|
||||
<title>OSG Documentation</title>
|
||||
</head>
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#3333FF" vlink="#993399" alink="#FF0000">
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000">
|
||||
|
||||
<blockquote> </blockquote>
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<center>
|
||||
<h1>
|
||||
Scene Graph Viewer (sgv) keyboard bindings:</h1></center>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2><u>osgGLUT::Viewer / Scene Graph Viewer (sgv) keyboard bindings:</u></h2>
|
||||
|
||||
<p><br>
|
||||
<table BORDER COLS=2 WIDTH="100%" NOSAVE >
|
||||
@ -220,12 +234,19 @@ x and mouse y position and delete the nearest interesected geoset.</td>
|
||||
|
||||
<tr>
|
||||
<td>
|
||||
<center><b><font size=+1>'o'</font></b></center>
|
||||
<center><b><font size=+2>'o'</font></b></center>
|
||||
</td>
|
||||
|
||||
<td>Output the loaded scene to 'saved_model.osg'.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td>
|
||||
<center><b><font size=+2>'O'</font></b></center>
|
||||
</td>
|
||||
|
||||
<td>Snap a screen shot image and write it out 'screenshot.bmp'.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
<center><b><font size=+2>'?'/'h'</font></b></center>
|
||||
|
||||
@ -1,15 +1,30 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
||||
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
||||
<html>
|
||||
<head>
|
||||
<title>stereo</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<meta name="GENERATOR" content="Quanta Plus">
|
||||
<meta name="GENERATOR" content="Mozilla/4.75C-SGI [en] (X11; I; IRIX64 6.5 IP27) [Netscape]">
|
||||
<title>OSG Documentation</title>
|
||||
</head>
|
||||
<body text="#000000" bgcolor="#ffffff" link="#0000ee" vlink="#551a8b" alink="#ff0000">
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000">
|
||||
|
||||
<img src="images/OpenSceneGraphBanner_Distribution.jpg" width=640 height=77 border=0>
|
||||
<img SRC="images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<h2>Native Support for Stereo</h2>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="index.html">Index</a> </td>
|
||||
<td><a href="introduction.html">Introduction</a> </td>
|
||||
<td><a href="contents.html">Contents</a> </td>
|
||||
<td><a href="install.html">Install</a> </td>
|
||||
<td><a href="dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="demos.html">Demos</a> </td>
|
||||
<td><a href="data.html">Data</a> </td>
|
||||
<td><a href="sgv.html">Viewer</a> </td>
|
||||
<td><a href="stereo.html">Stereo</a> </td>
|
||||
<td><a href="documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2><u>Native Support for Stereo</u></h2>
|
||||
|
||||
<p>The OSG has support for anaglyphic stereo
|
||||
(i.e. red/green or red/cyan glasses), quad buffered stereo (i.e. active stereo using shutter glasses,
|
||||
|
||||
433
index.html
433
index.html
@ -2,395 +2,78 @@
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<meta name="GENERATOR" content="Mozilla/4.6 [en-gb]C-CCK-MCD NetscapeOnline.co.uk (Win95; I) [Netscape]">
|
||||
<title>OSG Distribution</title>
|
||||
<meta name="GENERATOR" content="Mozilla/4.75C-SGI [en] (X11; I; IRIX64 6.5 IP27) [Netscape]">
|
||||
<title>OSG Documentation</title>
|
||||
</head>
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
|
||||
<img SRC="doc/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
<br><a href="INSTALL">Installation </a> <a href="#Contents of distribution">Contents
|
||||
of Distribution</a> <a href="doc/index.html">Documentation</a> <a href="#Plug-in dependencies">Plugin
|
||||
Dependencies</a> <a href="#Data Sources">Data Sources</a>
|
||||
<a href="#Contacts">Contacts</a>
|
||||
<p>The Open Scene Graph (OSG) is an Open Source (LGPL), Standard C++, OpenGL
|
||||
based scene graph for cross platform 3D real-time visualisation.
|
||||
The OSG is simply a scene graph and by design does not attempt to encompass
|
||||
application frame works and user interface, the design is kept focused
|
||||
on the issues of representing a 3D scene and rendering it in real-time.
|
||||
The OSG currently supports Linux, IRIX, Windows and FreeBSD platforms with
|
||||
the potential of support for further platforms. A Mac port is already underway.
|
||||
<p>The OSG is composed of a core scene graph library (osg) which is the
|
||||
basis for all osg apps, an optional scene graph utility library (osgUtil)
|
||||
which can be used for higher level functionality such cullers and renderers
|
||||
and a database utility library (osgDB) coupled with a set of plug-ins
|
||||
(osgPlugins) which are dynamically loaded by the osgDB library to support
|
||||
the reading and writing of file formats or node toolkits. Support for
|
||||
rendering of true type fonts is supplied by the osgText library, this
|
||||
is optional, you only need to compile it if you require font rendering.
|
||||
<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000">
|
||||
|
||||
<p>There are also support libraries such as osgGLUT for bringing up a basic
|
||||
UI, however this is not the focus of the OSG. For more sophisticated
|
||||
user interfaces it is recommended to integrate the OSG graphics with a
|
||||
fully fledge UI toolkit, this has already been done by users for most of the
|
||||
leading UI toolkits, see the bazaar section on the
|
||||
<a href="http://www.openscenegraph.org/download">http://www.openscenegraph.org/download</a>
|
||||
for examples of SDL,QT,FLTK,MFX and WX viewers.
|
||||
<img SRC="doc/images/OpenSceneGraphBanner_Distribution.jpg" height=77 width=640>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="doc/index.html">Index</a> </td>
|
||||
<td><a href="doc/introduction.html">Introduction</a> </td>
|
||||
<td><a href="doc/contents.html">Contents</a> </td>
|
||||
<td><a href="doc/install.html">Install</a> </td>
|
||||
<td><a href="doc/dependencies.html">Dependencies</a> </td>
|
||||
<td><a href="doc/demos.html">Demos</a> </td>
|
||||
<td><a href="doc/data.html">Data</a> </td>
|
||||
<td><a href="doc/sgv.html">Viewer</a> </td>
|
||||
<td><a href="doc/stereo.html">Stereo</a> </td>
|
||||
<td><a href="doc/documentation.html">Reference Guides</a> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>For the purpose of demonstating the functionality of the osg, ten demo
|
||||
apps are provided, sgv (a scene graph viewer), osgconv (a command line
|
||||
utility for converted multiple input files into a native .osg target file),
|
||||
hangglide (a flight simulation demo over small hang gliding site), osgcube
|
||||
(a very simple demo of an animated cube) and osgreflect (a demo of how planar
|
||||
reflections can be achieved), osgtexture (a demo of some of the various
|
||||
texture modes that the OSG supports), osgimpostor (a demo of impostors in
|
||||
action) and osgviews (a demo of using mulitple viewports on the same or
|
||||
multiple scenes). Finally there is the osgtext demo which illustrates
|
||||
the different types of font rendering support by the osgText library.
|
||||
<h2>
|
||||
<u>Index</u></b></h2>
|
||||
|
||||
<p>This release is a ALPHA version, and is under continuous development
|
||||
with the API and features subject to change. Although this disclaimer sounds
|
||||
severe you'll probably find the OSG pretty competitive feature and maturity
|
||||
wise, even with well established commericial scene graphs. If you plan to use the OSG
|
||||
then please join the mailing list and provide us with feedback on how
|
||||
you're getting on or the problems that you come across. This helps keep
|
||||
the OSG development going in the right direction and ensures the problems
|
||||
are fixed as early on in the development as possible.</p>
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="doc/introduction.html">Introduction</a> </td>
|
||||
<td>Introduction to Scene Graph in general, the OpenSceneGraph project itself and how to use it.</td>
|
||||
</td>
|
||||
|
||||
<p>For instructions of how to compile, install the osg libraries and to
|
||||
run the demos please read the <a href="INSTALL">INSTALL</a> file.
|
||||
<tr>
|
||||
<td><a href="doc/contents.html">Contents</a> </td>
|
||||
<td>A list of the directories in the distribution.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="doc/install.html">Install</a> </td>
|
||||
<td>A guide of how to compile and install on all the supported platforms.</td>
|
||||
</td>
|
||||
|
||||
<p>Robert Osfield.
|
||||
<p>robert@openscenegraph.com.
|
||||
<br>Feburaru 2002.
|
||||
<p>
|
||||
<hr WIDTH="100%">
|
||||
<p><a NAME="Contacts"></a><u>Contacts</u>
|
||||
<p>The OSG's web site is <a href="http://www.openscenegraph.org/">http://www.openscenegraph.org/</a>
|
||||
<p>The OSG's mailing list and mirror of downloads can be accessed at
|
||||
<br>source forge - <a href="http://sourceforge.net/projects/openscenegraph">http://sourceforge.net/projects/openscenegraph</a>
|
||||
<p>Bugs, patches, queries can be sent to the <a href="mailto:robert@openscenegraph.com">robert@openscenegraph.com</a>
|
||||
or to the mailing list.
|
||||
<p>Patches are best sent as complete files, as tarball if numerous file
|
||||
changes have been made.
|
||||
<p>
|
||||
<hr WIDTH="100%">
|
||||
<h3>
|
||||
<a NAME="Contents of distribution"></a><u>Contents of distribution</u></h3>
|
||||
./ Root directory.
|
||||
<blockquote><tt><a href="README">README</a> </tt>text
|
||||
bare bones readme file.
|
||||
<br><tt><a href="INSTALL">INSTALL</a> </tt>text file
|
||||
containing guide of how to get the OSG compiling, and running the demos.
|
||||
<br><tt><a href="COPYING">COPYING</a> </tt>text
|
||||
file containing the details of the OSG's Open Source LGPL license.
|
||||
<br><tt><a href="AUTHORS">AUTHORS</a> </tt>text file
|
||||
containing names of contributors to the osg.
|
||||
<br><tt><a href="NEWS">NEWS</a> </tt>text
|
||||
file listing coarse grained changes between releases.
|
||||
<br><tt><a href="ChangeLog">ChangeLog</a> </tt>text file listing
|
||||
fine grained changes between releases.
|
||||
<br><tt><a href="TODO">TODO</a> </tt>text
|
||||
file listing left to implement/extend/rewrite.
|
||||
<br><tt><a href="FAQ">FAQ</a>
|
||||
</tt>text file listing Frequently asked questions.
|
||||
<br><tt><a href="Makefile">Makefile</a> </tt>Unix makefile.
|
||||
<br><tt>index.html </tt>This file!</blockquote>
|
||||
<tr>
|
||||
<td><a href="doc/dependencies.html">Dependencies</a> </td>
|
||||
<td>Listing of all the dependancies of the project, with links of where to download them.</td>
|
||||
</td>
|
||||
|
||||
<p><br><a href="doc/">doc/</a> Documentation directory
|
||||
<blockquote><tt><a href="doc/index.html">index.html</a>
|
||||
</tt>Documentation index
|
||||
<br><tt><a href="doc/doc++/osg/HIER.html">osg/</a>
|
||||
</tt>Scene graph reference guide.
|
||||
<br><tt><a href="doc/doc++/osgUtil/HIER.html">osgUtil/</a>
|
||||
</tt>Scene graph utilities reference guide.
|
||||
<br><tt><a href="doc/doc++/osgDB/HIER.html">osgDB/</a>
|
||||
</tt>Scene graph database utilities reference guide.
|
||||
<br><tt><a href="doc/doc++/osgText/HIER.html">osgText/</a>
|
||||
</tt>Scene graph text reference guide.
|
||||
<br><tt><a href="doc/doc++/osgGLUT/HIER.html">osgGLUT/</a>
|
||||
</tt>Simple GLUT based viewer base classes reference guide.</blockquote>
|
||||
<tr>
|
||||
<td><a href="doc/demos.html">Demos</a> </td>
|
||||
<td>Thumbnails and info on all the demo applications which come with this distribution.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="doc/data.html">Data</a> </td>
|
||||
<td>List of websites where one can download interesting and useful data from.</td>
|
||||
</td>
|
||||
|
||||
<p><a href="include/">include/</a> External includes
|
||||
(i.e. files which would be installed in /usr/include)
|
||||
<blockquote><tt><a href="include/osg">include/osg/</a>
|
||||
</tt>The OSG library header files.
|
||||
<br><tt><a href="include/osgUtil">include/osgUtil/</a> </tt>The OSG
|
||||
Util library header files.
|
||||
<br><tt><a href="include/osgDB">include/osgDB/</a> </tt>The
|
||||
OSG Database library header files.
|
||||
<br><tt><a href="include/osgText">include/osgText/</a> </tt>The
|
||||
OSG text library header files.
|
||||
<br><tt><a href="include/osgGLUT">include/osgGLUT/</a> </tt>The OSG
|
||||
GLUT utiltiy library header files.</blockquote>
|
||||
<tr>
|
||||
<td><a href="doc/sgv.html">Viewer</a> </td>
|
||||
<td>List of key bindings support by the osgGLUT::Viewer and hence sgv and the rest of demos.</td>
|
||||
</td>
|
||||
|
||||
<tr>
|
||||
<td><a href="doc/stereo.html">Stereo</a> </td>
|
||||
<td>Documentation on the commandline paramters and environmential variables which control stereo.</td>
|
||||
</td>
|
||||
|
||||
<p><a href="src/">src/</a> source files (including internal
|
||||
includes)
|
||||
<blockquote><tt><a href="src/osg">src/osg</a>
|
||||
</tt>The OSG library source files.
|
||||
<br><tt>
|
||||
</tt>Contains all core osg classes, including reader/writer support for
|
||||
<br><tt>
|
||||
</tt>the .osg ascii format, and sgi's rgb image format.
|
||||
<p><tt><a href="src/osgUtil">src/osgUtil</a> </tt>The OSG utility
|
||||
library source files.
|
||||
<br><tt>
|
||||
</tt>Contains useful utility classes such as for setting
|
||||
<br><tt>
|
||||
</tt>up and rendering/draw.
|
||||
<p><tt><a href="src/osgDB">src/osgDB</a> </tt>The OSG
|
||||
database utility library source files.
|
||||
<br><tt>
|
||||
</tt>Contains useful utility classes such as for reading
|
||||
<br><tt>
|
||||
</tt>and writing 3D databases and image files.
|
||||
<p><tt><a href="src/osgText">src/osgText</a> </tt>The OSG
|
||||
text library source files.
|
||||
<br><tt>
|
||||
</tt>Contains true type font rendering classes.
|
||||
<p><tt><a href="src/osgGLUT">src/osgGLUT</a> </tt>The OSG GLUT library
|
||||
source files.
|
||||
<br><tt>
|
||||
</tt>Contains basic GLUT viewer base classes used by
|
||||
<br><tt>
|
||||
</tt>demo programs to bring up window and provide keyboard
|
||||
<br><tt>
|
||||
</tt>and mouse interaction.
|
||||
<p><tt><a href="src/osgPlugins/">src/osgPlugins/</a>
|
||||
</tt>Import/Export/Node kit plug-ins to the OSG.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/osg/">osg/</a>
|
||||
</tt>.osg native ASCII reader/write plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/flt/">flt/</a>
|
||||
</tt>.flt Open Flight reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/lib3ds/">lib3ds/</a>
|
||||
</tt>.3ds Auto Studio Maxx reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/lwo/">lwo/</a>
|
||||
</tt>.lwo Light Wave binary (.lwo,.lw & .geo) reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/obj/">obj/</a>
|
||||
</tt>.obj Alias Wavefront reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/pfb">pfb/</a>
|
||||
</tt>.pfb (and others) Performer reader and writer plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/dw/">dw/</a>
|
||||
</tt>.dw Design Workshop reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/rgb">rgb/</a>
|
||||
</tt>.rgb RGB image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/png">png/</a>
|
||||
</tt>.png PNG image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/gif">gif/</a>
|
||||
</tt>.gif GIF image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/jpeg/">jpeg/</a>
|
||||
</tt>.jpg JPEG image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/pic">pic/</a>
|
||||
</tt>.pic PIC image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/tga">tga/</a>
|
||||
</tt>.tga TGA image file format reader plugin.</tt>
|
||||
<br><tt> <a href="src/osgPlugins/tiff">tiff/</a>
|
||||
</tt>.tif TIFF image file format reader plugin.</tt>
|
||||
<p><tt><a href="src/Demos/">src/Demos/</a> <a href="src/Demos/sgv">sgv/</a>
|
||||
</tt>A basic scene graph viewer for the OSG which is loads .osg files and
|
||||
above formats.
|
||||
<br><tt> <a href="src/Demos/osgconv">osgconv/</a>
|
||||
</tt>A program which reads input files into a single scene graph and outputs
|
||||
the results.
|
||||
<br><tt> <a href="src/Demos/hangglide/">hangglide/</a>
|
||||
</tt>A program which of creates a flying site and allows users to fly over
|
||||
the scene.
|
||||
<br><tt> <a href="src/Demos/osgtexture">osgtexture/</a>
|
||||
</tt>A simple program which demonstrates how to use various textures modes.
|
||||
<br><tt> <a href="src/Demos/osgcube/">osgcube/</a>
|
||||
</tt>A basic animation of an oscillating cube.
|
||||
<br><tt> <a href="src/Demos/osgreflect/">osgreflect/</a>
|
||||
</tt>A demonstration of multi-pass stencil buffer based planar reflections.
|
||||
<br><tt> <a href="src/Demos/osgimpostor/">osgimpostor/</a>
|
||||
</tt>A basic demo to show how to use the osg::Impostor node.
|
||||
<br><tt> <a href="src/Demos/osgviews/">osgviews/</a>
|
||||
</tt>A demo of multiple views of the same or multiple scenes.
|
||||
<br><tt> <a href="src/Demos/wxsgv/">wxsgv/</a>
|
||||
</tt>A demo of wxWindows viewer integrated with the OSG.
|
||||
<br><tt> <a href="src/Demos/osgtext/">wxsgv/</a>
|
||||
</tt>A demo of true type fonts support provided by osgText.
|
||||
</blockquote>
|
||||
<tr>
|
||||
<td><a href="doc/documentation.html">Reference Guides</a> </td>
|
||||
<td>Reference guides of the core libraries.</td>
|
||||
</td>
|
||||
|
||||
<p><br><tt><a href="lib/">lib/</a>
|
||||
</tt>The local repository for the OSG library and plugins (files to be
|
||||
installed in /usr/lib/ or<tt> </tt>/usr/local/lib)
|
||||
<p><tt><a href="lib/osgPlugins/">lib/osgPlugins/</a> </tt>The local
|
||||
repository for the OSG plugins (files to be installed in /usr/lib/osgPlugins
|
||||
or<tt> </tt>/usr/local/lib/osgPlugins)
|
||||
<p><tt><a href="bin/">bin/</a>
|
||||
</tt>The local repository for the OSG binary files (files to be installed
|
||||
in /usr/bin or /usr/local/bin)
|
||||
<p><tt><a href="Make/">Make/</a>
|
||||
</tt>Unix platform specific make rules and dependencies.
|
||||
<p><tt><a href="VisualStudio/">VisualStudio/</a> </tt>MS
|
||||
VisualC++ 6.0 Make/Workspace files for Windows.
|
||||
<p><tt><a href="Metrowerks/">Metrowerks/</a>
|
||||
CodeWarroir's</tt> Make/Workspace files for Mac.
|
||||
<p><tt><a href="dist/">dist/</a>
|
||||
</tt>Distribution make files for RedHat Linux and IRIX.
|
||||
<br>.
|
||||
<br>
|
||||
<hr WIDTH="100%">
|
||||
<h3>
|
||||
<a NAME="Scene graph dependencies"></a><u>Scene graph dependencies</u></h3>
|
||||
Currently the only dependancy of the core scene graph libraries (osg,osgUtil
|
||||
and osgDB) is Standard C++ and OpenGL. The osgText library, osgGLUT
|
||||
have the following dependancies, these arn't core libraries so arn't needed
|
||||
to be compiled unless you need that feature. The demos do however require
|
||||
osgGLUT so its likely that you will typically need it when trying out the osg.
|
||||
The osgtext demo adds an osgText dependancies as well, you only need to compile
|
||||
them if you need to a demo of those features.
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
src/osgText</li>
|
||||
|
||||
<br>The osgText library supports true type fonts via the freetype library :
|
||||
<ul><i><a href="http://www.freetype.org/">http://www.freetype.org/</a></i>
|
||||
</ul>
|
||||
|
||||
<li>
|
||||
src/osgGLUT</li>
|
||||
|
||||
<br>The osgGLUT library depends upon, you guessed it, glut :
|
||||
<ul><i><a href="http://www.opengl.org/developers/documentation/glut/index.html">http://www.opengl.org/developers/documentation/glut/index.html</a></i>
|
||||
</ul>
|
||||
</ul>
|
||||
|
||||
<br>
|
||||
<br>
|
||||
<hr WIDTH="100%">
|
||||
<h3>
|
||||
<a NAME="Plug-in dependencies"></a><u>Plug-in dependencies</u></h3>
|
||||
Follows is the list of depedencies which some of the osgPlugins require,
|
||||
note the core osg and viewer do not need the following dependencies, you
|
||||
only need the following if you require each specific plugin. Note,
|
||||
the flt, 3ds, pic, tga, do not have any dependencies other than Standard
|
||||
C++ so will compile straight of the bag. Under Linux the majority
|
||||
of the depedancies below come as standard
|
||||
<br>with distributions so you may not need to download them at all.
|
||||
Its best to try out a straight compile of the osg, if you get missing includes/libs
|
||||
errors then chase up the below.
|
||||
<ul>
|
||||
<li>
|
||||
src/osgPlugins/pfb</li>
|
||||
|
||||
<br>There is a Performer plugin in this distribution for converting from
|
||||
Performer to OSG and from OSG to Performer. This plugin requires
|
||||
Performer to be installed and therefore is not compiled by default. If
|
||||
you have Performer (available under Linux and IRIX) then edit src/osgPlugins/Make
|
||||
to compile under the plugin. Performer can be downloaded from :
|
||||
<ul><i><a href="http://www.sgi.com/">http://www.sgi.com/</a></i>
|
||||
<br><i><a href="http://www.sgi.com/"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/png</li>
|
||||
|
||||
<br>The png plugin depends upon the libpng and zlib (for compression) libraries,
|
||||
if you don't already have it installed, you'll need to download, compile
|
||||
and install it. Project home pages are:
|
||||
<ul><i><a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a></i>
|
||||
<br><i><a href="http://www.info-zip.org/pub/infozip/zlib/">http://www.info-zip.org/pub/infozip/zlib/</a></i>
|
||||
<br><i><a href="http://www.info-zip.org/pub/infozip/zlib/"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/gif</li>
|
||||
|
||||
<br>The gif plugin depends upon the libungif library, if you don't already
|
||||
have it installed, you'll need to download, compile and install it. Project
|
||||
home page is:
|
||||
<ul><i><a href="http://prtr-13.ucsc.edu/~badger/software/libungif/">http://prtr-13.ucsc.edu/~badger/software/libungif/</a></i>
|
||||
<br><i><a href="http://prtr-13.ucsc.edu/~badger/software/libungif/"></a></i> </ul>
|
||||
Ftp download at :
|
||||
<ul><i><a href="ftp://prtr-13.ucsc.edu/pub/libungif/">ftp://prtr-13.ucsc.edu/pub/libungif/</a></i>
|
||||
<br><i><a href="ftp://prtr-13.ucsc.edu/pub/libungif/"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/jpeg</li>
|
||||
|
||||
<br>The jpeg plugin depends upon the libjpeg library, if you don't already
|
||||
have it installed, you'll need to download, compile and install it. Project
|
||||
home page is:
|
||||
<ul><i><a href="http://www.ijg.org/">http://www.ijg.org/</a></i>
|
||||
<br><i><a href="http://www.ijg.org/"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/tiff</li>
|
||||
|
||||
<br>The tiff plugin depends upon the libtiff library, if you don't already
|
||||
have it installed, you'll need to download, compile and install it. Project
|
||||
home page is:
|
||||
<ul><i><a href="http://www.libtiff.org">http://www.libtiff.org</a></i>
|
||||
<br><i><a href="http://www.libtiff.org"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/zip</li>
|
||||
|
||||
<br>The zip compressed archive plugin depends upon the unzip executable
|
||||
being available on your system. If it is not then you'll be able
|
||||
to find binaries at:
|
||||
<ul><i><a href="http://www.freesoftware.com/pub/infozip/">http://www.freesoftware.com/pub/infozip/</a></i>
|
||||
<br><i><a href="http://www.freesoftware.com/pub/infozip/"></a></i> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/tgz</li>
|
||||
|
||||
<br>The tgz compressed archive plugin depends upon the unzip executable
|
||||
being available on your system. If it is not then you'll be able
|
||||
to find binaries at:
|
||||
<ul><i><a href="http://www.gzip.org/">http://www.gzip.org/</a></i>
|
||||
<br><a href="ftp://prep.ai.mit.edu/pub/gnu/tar/">ftp://prep.ai.mit.edu/pub/gnu/tar/</a>
|
||||
<br><a href="ftp://prep.ai.mit.edu/pub/gnu/tar/"></a> </ul>
|
||||
|
||||
<li>
|
||||
src/osgPlugins/osgtgz</li>
|
||||
|
||||
<br>Has the same dependencies as the tgz plugin above.</ul>
|
||||
|
||||
<p><br>
|
||||
<hr WIDTH="100%">
|
||||
<h3>
|
||||
<a NAME="Data Sources"></a>Data Sources</h3>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
Open scene graph .osg demo data set can downloaded here:</li>
|
||||
|
||||
<br><i><a href="http://www.openscenegraph.org/downloads/osg_data-0.8-24.tar.gz">http://www.openscenegraph.org/downloads/osg_data-0.8-25.tar.gz</a></i>
|
||||
<br>
|
||||
<li>
|
||||
Various 3d models, many in .3ds format at 3D Cafe.</li>
|
||||
|
||||
<br><i><a href="http://www.3dcafe.com">http://www.3dcafe.com</a></i>
|
||||
<br>
|
||||
<li>
|
||||
Various 3d models, many in .3ds format at 3D Rocket Fuel.</li>
|
||||
|
||||
<br><i><a href="http://www.3drocketfuel.com">http://www.3drocketfuel.com</a></i>
|
||||
<br>
|
||||
<li>
|
||||
Character models in OpenFlight .flt format from MultiGen (www.multigen.com)</li>
|
||||
|
||||
<br>Select the download link on their homepage or go directly to
|
||||
<br><a href="ftp://ftp.ca.com/pub/multigen/ftp2-multigen/downloads/models">ftp://ftp.ca.com/pub/multigen/ftp2-multigen/downloads/models</a>
|
||||
<br>
|
||||
<li>
|
||||
Vehicle models in OpenFlight .flt format at Full Sail (spinnercar &
|
||||
veritech):</li>
|
||||
|
||||
<br><a href="http://www.fullsail.com/loader/models.html">http://www.fullsail.com/loader/models.html</a>
|
||||
<br>
|
||||
<li>
|
||||
Terrain models in OpenFlight .flt format at Grime:</li>
|
||||
|
||||
<br><a href="http://www.grime.net/sim/default.htm">http://www.grime.net/sim/default.htm</a>
|
||||
<br>
|
||||
<li>
|
||||
Terrain models in OpenFlight .flt format at Terrex:</li>
|
||||
|
||||
<br><a href="http://www.terrex.com/downloads/index.htm">http://www.terrex.com/downloads/index.htm</a></ul>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user