root/OpenSceneGraph/trunk/doc/dependencies.html @ 1912

Revision 1912, 6.9 kB (checked in by robert, 10 years ago)

Updates to docs.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
2<html>
3<head>
4   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5   <meta name="GENERATOR" content="Mozilla/4.77 [en] (X11; U; Linux 2.4.3-20mdk i686) [Netscape]">
6   <title>Compilation dependencies</title>
7</head>
8<body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990066" alink="#FF0000">
9<img SRC="images/OpenSceneGraphBanner_Distribution.jpg">
10<table>
11<tr>
12<td><a href="index.html">Index</a></td>
13
14<td><a href="introduction.html">Introduction</a></td>
15
16<td><a href="contents.html">Contents</a></td>
17
18<td><a href="install.html">Install</a></td>
19
20<td><a href="dependencies.html">Dependencies</a></td>
21
22<td><a href="examples.html">examples</a></td>
23
24<td><a href="data.html">Data</a></td>
25
26<td><a href="osgviewer.html">Viewer</a></td>
27
28<td><a href="stereo.html">Stereo</a></td>
29
30<td><a href="plan.html">Plan</a></td>
31
32<td><a href="documentation.html">Reference Guides</a></td>
33</tr>
34</table>
35
36<h2>
37<a NAME="Scene graph dependencies"></a><u>Scene graph dependencies</u></h2>
38The OpenSceneGraph is composed of core scene graph libraries, plugins libraries
39and demo programs. The core scene graph libraries (osg, osgDB, osgUtil, osgText, osgParticle, osgSim)
40are only dependent upon OpenGL and Standard C++ so should compile straight
41out of the box on most systems. To run the examples one will also need to
42compile osgProducer which adds the dependency of Producer, and if true type text
43is required then the freetype library will be required. The plugins which
44are used to read and write various file formats have their own sets of
45dependencies listed below, some have no dependencies at all. A plugin is
46only needed if you need to load that specific file format, so it is not
47critical if you don't have all the required dependencies.
48<br>
49<hr>
50<h3>
51<a NAME="Windows dependency arhives"></a><u>Windows dependency archives</u></h3>
52To make life easier for Windows users, we have put together a .zip archives
53with all the required dependencies which can be download and installed
54somewhere in you system. You'll need to set VisualStudio to pick up on
55the include and libs, and the PATH set to pick up in the dll's. Alternatively,
56a more hacky but simpler solution is to unpack this archive inside you
57OpenSceneGraph distribution, so that all the include files drop into OpenSceneGraph/include,
58and the libs drop into OpenSceneGraph/lib, and all the dll's drop into
59OpenSceneGraph/bin, this way VisualStudio will pick up the files simpler
60through the paths set up inside the workspace and project files. The archives
61can be downloaded here: . .
62<ul>
63<li>
64freetype, libpng, libungif, libtiff, libjpeg &amp; zlib includes, libs
65and dll.</li>
66
67<ul><i><a href="http://www.openscenegraph.org/download/dependencies/OsgWin32Dependencies.zip">http://www.openscenegraph.org/download/dependencies/OsgWin32Dependencies.zip</a></i></ul>
68
69
70<hr>
71<h3>
72<a NAME="Core library dependencies"></a><u>Core library dependencies</u></h3>
73
74<ul>
75
76<li>
77src/osgProducer - The osgProducer library depends upon, you guessed it, Producer...</li>
78
79<ul><i><a href="http://www.andesengineering.com/Producer">http://www.andesengineering.com/Producer</a></i></ul>
80<br>
81The examples which are included with the distribution depend upon osgProducer (and hence Producer)
82but if you don't need the examples or osgProducer you need to compile them, and can remove
83references to osgProducer and the examples by editing your VisualStudio workspace files or
84Make/makedirdefs approrpiately.
85</ul>
86
87<hr>
88<h3>
89<a NAME="Plug-in dependencies"></a><u>Plug-in dependencies</u></h3>
90Follows is the list of dependencies which some of the osgPlugins require,
91note the core osg and viewer do not need the following dependencies, you
92only need the following if you require each specific plugin. Note, the
93flt, 3ds, pic, tga, do not have any dependencies other than Standard C++
94so will compile straight of the bag. Under Linux the majority of the dependencies
95below come as standard with distributions so you may not need to download
96them at all. Its best to try out a straight compile of the osg, if you
97get missing includes/libs errors then chase up the below.
98<br>
99<ul>
100
101<br>
102<li>
103src/osgPlugins/freetype - The osgText library supports true type fonts via the freetype
104library.</li>
105
106<ul><i><a href="http://www.freetype.org/">http://www.freetype.org/</a></i></ul>
107<br>
108
109<li>
110src/osgPlugins/pfb</li>
111
112<br>There is a Performer plugin in this distribution for converting from
113Performer to OSG and from OSG to Performer. This plugin requires Performer
114to be installed and therefore is not compiled by default. If you have Performer
115(available under Linux and IRIX) then edit src/osgPlugins/Make to compile
116under the plugin. Performer can be downloaded from :
117<ul><i><a href="http://www.sgi.com/">http://www.sgi.com/</a></i></ul>
118
119<br>
120<li>
121src/osgPlugins/png</li>
122
123<br>The png plugin depends upon the libpng and zlib (for compression) libraries,
124if you don't already have it installed, you'll need to download, compile
125and install it. Project home pages are:
126<ul><i><a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a></i>
127<br><i><a href="http://www.info-zip.org/pub/infozip/zlib/">http://www.info-zip.org/pub/infozip/zlib/</a></i></ul>
128
129<br>
130<li>
131src/osgPlugins/gif</li>
132
133<br>The gif plugin depends upon the libungif library, if you don't already
134have it installed, you'll need to download, compile and install it. Project
135home page is:
136<ul><i><a href="http://prtr-13.ucsc.edu/~badger/software/libungif/">http://prtr-13.ucsc.edu/~badger/software/libungif/</a></i></ul>
137Ftp download at :
138<ul><i><a href="ftp://prtr-13.ucsc.edu/pub/libungif/">ftp://prtr-13.ucsc.edu/pub/libungif/</a></i></ul>
139
140<br>
141<li>
142src/osgPlugins/jpeg</li>
143
144<br>The jpeg plugin depends upon the libjpeg library, if you don't already
145have it installed, you'll need to download, compile and install it. Project
146home page is:
147<ul><i><a href="http://www.ijg.org/">http://www.ijg.org/</a></i></ul>
148
149<br>
150<li>
151src/osgPlugins/tiff</li>
152
153<br>The tiff plugin depends upon the libtiff library, if you don't already
154have it installed, you'll need to download, compile and install it. Project
155home page is:
156<ul><i><a href="http://www.libtiff.org">http://www.libtiff.org</a></i></ul>
157
158<br>
159<li>
160src/osgPlugins/zip</li>
161
162<br>The zip compressed archive plugin depends upon the unzip executable
163being available on your system. If it is not then you'll be able to find
164binaries at:
165<ul><i><a href="http://www.freesoftware.com/pub/infozip/">http://www.freesoftware.com/pub/infozip/</a></i></ul>
166
167<br>
168<li>
169src/osgPlugins/tgz</li>
170
171<br>The tgz compressed archive plugin depends upon the unzip executable
172being available on your system. If it is not then you'll be able to find
173binaries at:
174<ul><i><a href="http://www.gzip.org/">http://www.gzip.org/</a></i>
175<br><a href="ftp://prep.ai.mit.edu/pub/gnu/tar/">ftp://prep.ai.mit.edu/pub/gnu/tar/</a></ul>
176
177<br>
178<li>
179src/osgPlugins/osgtgz</li>
180
181<br>Has the same dependencies as the tgz plugin above.</ul>
182
183</body>
184</html>
Note: See TracBrowser for help on using the browser.