360 lines
20 KiB
HTML
360 lines
20 KiB
HTML
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
|
<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>
|
|
</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 dependancies">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.
|
|
<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 FLTK, SDL,
|
|
WxWindows, Qt and X, with the potential for many more. For example, osgWX is
|
|
also included to assist integration of wxWindows with the OSG and demonstrated
|
|
in the wxsgv demo, however both these libraries are not compiled by default
|
|
since most systems won't have wxWindows installed. Check the mailing list
|
|
archives for info on these developments.
|
|
<p>For the purpose of demonstating the functionality of the osg, nine 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), and finally wxsgv a viewer demostrating osg integration
|
|
with wxWindows applications (not compiled by default.)
|
|
<p>This release is a ALPHA version, and is under continuous development
|
|
with the API and features subject to change. 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>
|
|
|
|
<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.
|
|
|
|
|
|
<p>Robert Osfield.
|
|
<p>robert@openscenegraph.com.
|
|
<br>August 2001.
|
|
<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>
|
|
|
|
<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++/osgGLUT/HIER.html">osgGLUT/</a>
|
|
</tt>Simple GLUT based viewer base classes reference guide.
|
|
<br><tt><a href="doc/doc++/osgWX/HIER.html">osgWX/</a>
|
|
</tt>wxWindows integration classes reference guide</blockquote>
|
|
|
|
|
|
<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/osgGLUT">include/osgGLUT/</a> </tt>The OSG
|
|
GLUT utiltiy library header files.
|
|
<br><tt><a href="include/osgWX">include/osgWX/</a> </tt>The OSG
|
|
WX utiltiy library header files.</blockquote>
|
|
|
|
|
|
<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/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/osgWX">src/osgWX</a> </tt>The OSG WX library
|
|
source files.
|
|
<br><tt>
|
|
</tt>Contains WXEventAdapter to assist integration of wxWindnows with the OSG.
|
|
<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.
|
|
</blockquote>
|
|
|
|
<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="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>
|
|
|
|
</body>
|
|
</html>
|