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