179 lines
6.8 KiB
Plaintext
179 lines
6.8 KiB
Plaintext
The following is a very basic intro of how to get the OSG going under Linux,
|
|
IRIX and Windows. Each intro mentions OpenSceneGraph-Data, it is recommended
|
|
that you also download it alongside this source distribution.
|
|
|
|
The scene graph depends upon Standard C++, STL and OpenGL so you need a C++
|
|
compiler up to the task and OpenGL or Mesa installed. The viewer depends upon
|
|
GLUT which you'll need to download and install from the GLUT website. The
|
|
OSG has it own native ascii file format, and .rgb image reader inbuilt which
|
|
allows you read the example data with any dependancies othe then C++, STL and
|
|
OpenGL.
|
|
|
|
The OSG also has several plug-ins which support non-native 3d database and
|
|
image formats, several have no dependancies on external libraries (flt,fly,
|
|
tga & pic), while others (pfb,jpeg,gif,tiff) require other libraries to be
|
|
installed to compile them. If you don't already have them installed then
|
|
don't worry, you'll still be able to use the OSG. The core osg library and
|
|
viewer is designed has been designed to load the plug-ins at run-time only
|
|
and if they are required to load a specific data set. If you don't need them
|
|
for your datasets then it won't matter that you havn't been able to compile
|
|
all the plug-ins. A full list of dependancies and where to download the
|
|
required libraries are near the bottom of this file.
|
|
|
|
If you're comming across the OSG for the first time and want to get started
|
|
quickly, go right ahead and follow the compilation instructions. You can always
|
|
later download the libraries which the plug-ins require if you eventually need
|
|
them.
|
|
|
|
If you havn't already checked it out, for a list of distribution contents,
|
|
contacts and links to documentation check out index.html.
|
|
|
|
|
|
Compiling under Linux :
|
|
-----------------------
|
|
|
|
Add the following to your .cshrc :
|
|
|
|
setenv OSGHOME <location of OSG root>
|
|
setenv OSGDATA <location of OSG data root>
|
|
setenv OSGFILEPATH ./:${OSGDATA}:${OSGDATA}/Images:
|
|
setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${OSGHOME}/lib
|
|
setenv PATH ${PATH}:${OSGHOME}/bin
|
|
|
|
Or the following if you're using a sh compatible shell :
|
|
|
|
export OSGHOME=<location of OSG root>
|
|
export OSGDATA=<location of OSG data root>
|
|
export OSGFILEPATH=./:${OSGDATA}:${OSGDATA}/Images:
|
|
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${OSGHOME}/lib
|
|
export PATH=${PATH}:${OSGHOME}/bin
|
|
|
|
To compile, from the OSG root directory, type :
|
|
|
|
make
|
|
|
|
Note, make should automatically detect linux and copy the
|
|
Make/makerules.linux and Make/makedefs.linux over the
|
|
default Make/makerules and Make/makedefs. If autodetection
|
|
does not work type 'make linux'.
|
|
|
|
|
|
Compiling under IRIX :
|
|
----------------------
|
|
|
|
Add the following to your .cshrc :
|
|
|
|
setenv OSGHOME <location of OSG root>
|
|
setenv OSGDATA <location of OSG data root>
|
|
setenv OSGFILEPATH ./:${OSGDATA}:${OSGDATA}/Images:
|
|
setenv LD_LIBRARYN32_PATH ${LD_LIBRARYN32_PATH}:${OSGHOME}/lib
|
|
setenv PATH ${PATH}:$OSGHOME/bin
|
|
|
|
Or the following if you're using a sh compatible shell :
|
|
|
|
export OSGHOME=<location of OSG root>
|
|
export OSGDATA=<location of OSG data root>
|
|
export OSGFILEPATH=./:${OSGDATA}:${OSGDATA}/Images:
|
|
export LD_LIBRARYN32_PATH=${LD_LIBRARYN32_PATH}:${OSGHOME}/lib
|
|
export PATH=${PATH}:$OSGHOME/bin
|
|
|
|
Since the OSG uses Standard C++ features such as STL it is important
|
|
to have an up to date version of the MIPSPro compilers. The library
|
|
has been tested under MIPSPro7.3 & MIPSPro7.2.1, and *may* compile
|
|
under previous versions but has yet to be tested. It is recommened
|
|
to use MIPSPro7.3.1.1m.
|
|
|
|
To compile, from the OSG root directory, type :
|
|
|
|
make
|
|
|
|
Note, make should automatically detect IRIX and copy the
|
|
Make/makerules.irix and Make/makedefs.irix over the
|
|
default Make/makerules and Make/makedefs. If autodetection
|
|
does not work type 'make linux'.
|
|
|
|
|
|
Compiling under Windows :
|
|
-------------------------
|
|
|
|
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 its recommended that you use
|
|
Service Pack 4 to fix MS compiler bugs which affect the OSG.
|
|
|
|
To execute the viewer the file path for the .dll's and .exe, both compiled
|
|
into the OSG's bin directory, need to be setup, such as by adding the PATH
|
|
to your autoexec.bat, its also useful to add the OSGFILEPATH to your
|
|
autoexec.bat to help the location of datafiles. For example :
|
|
|
|
SET OSGFILEPATH=D:\OpenSceneGraph-Data;D:\OpenSceneGraph-Data\Images
|
|
SET PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;C:\Oglsdk\lib;D:\OpenSceneGraph-0.8\bin;
|
|
|
|
|
|
Running the viewer
|
|
------------------
|
|
To run the viewer demo type (you made need to type rehash first under Unix) :
|
|
|
|
sgv dumptruck.osg
|
|
sgv cow.osg
|
|
sgv e-s-bike.osg
|
|
sgv flight_park.fly
|
|
sgv lz.rgb
|
|
|
|
Other run other demos type
|
|
|
|
cube
|
|
|
|
(Note: the file is picked up by checking the directories pointed to
|
|
by $OSGFILEPATH)
|
|
|
|
|
|
Plug-in dependancies
|
|
--------------------
|
|
|
|
src/osgPlugins/pfb
|
|
|
|
There is Peformer 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 http://sgi.com
|
|
|
|
For further information about the Performer plugin please read the
|
|
src/osgPlugin/pfb/READEME.txt.
|
|
|
|
src/osgPlugins/png
|
|
|
|
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:
|
|
http://www.libpng.org/pub/png/libpng.html
|
|
http://www.info-zip.org/pub/infozip/zlib/
|
|
|
|
src/osgPlugins/gif
|
|
|
|
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:
|
|
http://prtr-13.ucsc.edu/~badger/software/libungif/
|
|
Ftp download at :
|
|
ftp://prtr-13.ucsc.edu/pub/libungif/
|
|
|
|
|
|
src/osgPlugins/jpeg
|
|
|
|
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:
|
|
http://www.ijg.org
|
|
|
|
src/osgPlugins/tiff
|
|
|
|
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:
|
|
http://www.libtiff.org
|
|
|