Open Scene Graph

The Open Scene Graph (OSG) is an Open Source (LGPL), Stanadard 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.

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 intergrate the OSG graphics with a fully fledge UI toolkit, this has already been done by users for FLTK, WxWindows and X, with the potential for many more.

This release is a ALPHA version, and is subject to continuous development with the API of features subject to change.

For instructions of how to compile, install the osg libraries and to run the demos please read the README file.

Regards,

Robert Osfield.
January 2001.


Contacts

The OSG's website is http://www.openscenegraph.org

The OSG's mailing list and mirror of downloads can be accessed at
source forge -  http://sourceforge.net/projects/openscenegraph

Bugs, patches, querries can be sent to the info@openscenegraph.org or to the mailing list.


Contents of distribution

./        Root directory.

README       text file containing guide of how to get the OSG compiling, and running the demos.
COPYING    text  file containing the details of the Open Source LGPL license which the OSG is released under
AUTHORS    text file containing names of contributors to the osg.
NEWS           text file listing coarsed grained changes between releases.
ChangeLog     text file listing fine grained changes between releases.
TODO           text file listing  left to implement/extend/rewrite.
FAQ              text file listing Fequently asked quesions.
Makefile         Unix makefile.
index.html       This file!


doc/   Documentation directory

index.html      Documentation index.
osg/               core scene graph reference guide.
osgUtil/          scene graph utilities reference guide.
osgGLUT/     simple GLUT based viewer base classes reference guide.


include/     External includes (i.e. files which would be installed in /usr/include)

include/osg/             The OSG library header files.
include/osgUtil/        The OSG Utility library header files.
include/osgGLUT/   The OSG GLUT library header files.


src/    source files (including internal includes)

src/osg           The OSG library source files.
                      Contians all core osg classes, including
                      reader/writer support for the .osg ascii format,
                      and sgi's rgb image format.

src/osgUtil      The OSG utility library source files.
                      Contains useful utility classes such as for setting
                       up and rendering/draw.

src/osgGLUT  The OSG GLUT library source files.
                       Contains basic GLUT viewer base classes used by
                       demo prgrams to bring up window and provide keyboard
                       and mouse interaction.

src/osgPlugins/  Import/Export/Node kit plug-ins to the OSG.
                        flt/      Open Flight reader plugin.
                        fly/      Hang gliding flying site reader plugin.
                        pfb/      Performer reader and writer plugin.
                        png/      PNG image file format reader plugin.
                        gif/      GIF image file format reader plugin.
                        jpeg/     JPEG image file format reader plugin.
                        pic/      PIC image file format reader plugin.
                        tga/      TGA image file format reader plugin.
                        tiff/     TIFF image file format reader plugin.

src/Demos/      sgv/      A basic scene graph viewer for the OSG which is able to load .osg file and above formats.
                       cube/    A basic animation of an oscillating cube.


lib/                         The local repository for the OSG library and plugins (files to be installed in /usr/lib/ or /usr/local/lib)
lib/osgPlugins/        The local repository for the OSG plugins (files to be installed in /usr/lib/osgPlugins or
                             /usr/local/lib/osgPlugins)

bin/                        The local repository for the OSG binary files (files to be installed in /usr/bin or /usr/local/bin)

Make/                    Unix platform specific make rules and dependancies.

VisualStudio/          MS VisualC++ 6.0 Make/Workspace files.

dist/                        Distribution make files for RedHat Linux.

NSPlugin/               Netscape plugin viewer for Linux.