Changeset 3233

Show
Ignore:
Timestamp:
08/04/04 12:22:55 (9 years ago)
Author:
robert
Message:

Added GDAL to dependencies list

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • OpenSceneGraph/trunk/doc/dependencies.html

    r2120 r3233  
    22<html> 
    33<head> 
    4          
    54  <meta http-equiv="Content-Type" 
    65 content="text/html; charset=iso-8859-1"> 
    7          
    86  <meta name="GENERATOR" 
    97 content="Mozilla/4.77 [en] (X11; U; Linux 2.4.3-20mdk i686) [Netscape]"> 
    108  <title>Compilation dependencies</title> 
    119</head> 
    12   <body text="#000000" bgcolor="#ffffff" link="#0000ff" vlink="#990066" 
     10<body text="#000000" bgcolor="#ffffff" link="#0000ff" vlink="#990066" 
    1311 alink="#ff0000"> 
    14   <img src="images/OpenSceneGraphBanner_Distribution.jpg"> 
    15     
     12<img src="images/OpenSceneGraphBanner_Distribution.jpg"> 
    1613<table> 
    1714  <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>  
     15    <tr> 
     16      <td><a href="index.html">Index</a></td> 
     17      <td><a href="introduction.html">Introduction</a></td> 
     18      <td><a href="contents.html">Contents</a></td> 
     19      <td><a href="install.html">Install</a></td> 
     20      <td><a href="dependencies.html">Dependencies</a></td> 
     21      <td><a href="examples.html">examples</a></td> 
     22      <td><a href="data.html">Data</a></td> 
     23      <td><a href="osgviewer.html">Viewer</a></td> 
     24      <td><a href="stereo.html">Stereo</a></td> 
     25      <td><a href="plan.html">Plan</a></td> 
     26      <td><a href="documentation.html">Reference Guides</a></td> 
     27    </tr> 
     28  </tbody> 
    3329</table> 
    34      
    3530<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, 
    38 osgText, osgParticle, osgSim) are only dependent upon OpenGL and Standard 
    39 C++ so should compile straight out of the box on most systems. To run the 
    40 examples one will also need to compile osgProducer which adds the dependency 
    41 of Producer, and if true type text is required then the freetype library 
    42 will be required. The plugins which are used to read and write various file 
    43 formats have their own sets of dependencies listed below, some have no dependencies 
    44 at all. A plugin is only needed if you need to load that specific file format, 
     31The OpenSceneGraph is composed of core scene graph libraries, plugins 
     32libraries and demo programs. The core scene graph libraries (osg, 
     33osgDB, osgUtil, 
     34osgText, osgParticle, osgSim) are only dependent upon OpenGL and 
     35Standard 
     36C++ so should compile straight out of the box on most systems. To run 
     37the 
     38examples one will also need to compile osgProducer which adds the 
     39dependency 
     40of Producer, and if true type text is required then the freetype 
     41library 
     42will be required. The plugins which are used to read and write various 
     43file 
     44formats have their own sets of dependencies listed below, some have no 
     45dependencies 
     46at all. A plugin is only needed if you need to load that specific file 
     47format, 
    4548so 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 and 
    52 libs, and the PATH set to pick up in the dll's. Alternatively, a more hacky 
    53 but simpler solution is to unpack this archive inside you OpenSceneGraph distribution, 
    54 so that all the include files drop into OpenSceneGraph/include,  and the 
    55 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: . .   
     49<hr> 
     50<h3> <a name="Windows dependency arhives"></a><u>Windows dependency 
     51archives</u></h3> 
     52To make life easier for Windows users, we have put together a .zip 
     53archives with all the required dependencies which can be download and 
     54installed somewhere in you system. You'll need to set VisualStudio to 
     55pick up on the include and 
     56libs, and the PATH set to pick up in the dll's. Alternatively, a more 
     57hacky 
     58but simpler solution is to unpack this archive inside you 
     59OpenSceneGraph distribution, 
     60so that all the include files drop into OpenSceneGraph/include, and the 
     61libs drop into OpenSceneGraph/lib, and all the dll's drop into 
     62OpenSceneGraph/bin, this way VisualStudio will pick up the files 
     63simpler through the paths set up inside the workspace and project 
     64files. The archives can be downloaded here: . . 
    5965<ul> 
    60   <li> freetype, libpng, libungif, libtiff, libjpeg &amp; zlib includes, 
    61 libs  and dll.</li> 
    62        
     66  <li> freetype, libpng, libungif, libtiff, libjpeg &amp; zlib 
     67includes, 
     68libs and dll.</li> 
    6369  <ul> 
    64      <i><a 
     70    <i><a 
    6571 href="http://www.openscenegraph.org/download/dependencies/OsgWin32Dependencies.zip">http://www.openscenegraph.org/download/dependencies/OsgWin32Dependencies.zip<br> 
    6672    <br> 
    67     </a></i>    
     73    </a></i> 
    6874  </ul> 
    69         
    70   <hr>     
    71   <h3> <a name="Core library dependencies"></a><u>Core library dependencies</u></h3> 
    72    <br> 
    73     
     75  <hr> 
     76  <h3> <a name="Core library dependencies"></a><u>Core library 
     77dependencies</u></h3> 
     78  <br> 
    7479  <ul> 
    75      <li>src/osgDB + src/osgPlugin/txp + src/osgProducer all depend upon  
     80    <li>src/osgDB + src/osgPlugin/txp + src/osgProducer all depend upon 
    7681OpenThreads library :</li> 
    7782    <br> 
    78          
    79     <ul> 
    80         <i><a href="http://openthreads.sourceforge.net">http:://openthreads.sourceforge.net</a></i>  
    81          
    82     </ul> 
    83   <br> 
    84       <li>src/osgProducer - The osgProducer library depends upon, you guessed  
    85 it, Producer...</li> 
    86     <br> 
    87       
    88     <ul> 
    89        <i><a href="http://www.andesengineering.com/Producer">http://www.andesengineering.com/Producer</a></i>  
    90      
    91     </ul> 
    92    
    93   </ul> 
    94 </ul> 
    95 <blockquote> 
    96   <h3><u>Example dependencies</u></h3> 
    97    The examples which are included with the distribution depend upon osgProducer  
    98 (and hence Producer) but if you don't need the examples or osgProducer you  
    99 need to compile them, and can remove references to osgProducer and the examples  
    100 by editing your VisualStudio workspace files or Make/makedirdefs approrpiately. 
    101      &nbsp; Additionally :<br> 
    102 </blockquote> 
    103 <ul> 
    104   <ul> 
    105     <li>example/slideshow3D depends upon libxml2 :</li> 
    106     <br> 
    107     <a href="http://xmlsoft.org">http://xmlsoft.org/</a> 
    108   </ul> 
    109   <ul> 
    110     <i><a href="http://openthreads.sourceforge.net"></a></i> 
     83    <ul> 
     84      <i><a href="http://openthreads.sourceforge.net">http:://openthreads.sourceforge.net</a></i> 
     85    </ul> 
     86    <br> 
     87    <li>src/osgProducer - The osgProducer library depends upon, you 
     88guessed it, Producer...</li> 
     89    <br> 
     90    <ul> 
     91      <i><a href="http://www.andesengineering.com/Producer">http://www.andesengineering.com/Producer</a></i> 
     92    </ul> 
     93    <br> 
     94    <li>src/osgTerrain - The optional osgTerrain library depends upon GDAL to load large scale imagery and DEM's.</li> 
     95    <br> 
     96    <ul> 
     97      <i><a href="http://www.remotesensing.org/gdal/">http://www.remotesensing.org/gdal/</a></i> 
     98    </ul> 
    11199  </ul> 
    112100</ul> 
    113101<ul> 
     102  <hr> 
     103  <h3> <a name="Plug-in dependencies"></a><u>Plug-in dependencies</u></h3> 
     104Follows is the list of dependencies which some of the osgPlugins 
     105require, note the core osg and viewer do not need the following 
     106dependencies, you 
     107only need the following if you require each specific plugin. Note, the 
     108flt, 
     1093ds, pic, tga, do not have any dependencies other than Standard C++ so 
     110will 
     111compile straight of the bag. Under Linux the majority of the 
     112dependencies 
     113below come as standard with distributions so you may not need to 
     114download 
     115them at all. Its best to try out a straight compile of the osg, if you 
     116get 
     117missing includes/libs errors then chase up the below. <br> 
    114118  <ul> 
    115119    <br> 
    116      
     120    <li> src/osgPlugins/freetype</li> 
     121    <br> 
     122The osgText library supports true 
     123type fonts via the freetype library. 
     124    <ul> 
     125      <i><a href="http://www.freetype.org/">http://www.freetype.org/</a></i> 
     126    </ul> 
     127    <br> 
     128    <li> src/osgTerrain & src/osgPlugins/gdal</li> 
     129    <br> 
     130The GDAL plugin uses GDAL to load large scale imagery and DEM's. 
     131    <ul> 
     132      <i><a href="http://www.remotesensing.org/gdal/">http://www.remotesensing.org/gdal/</a></i> 
     133    </ul> 
     134    <br> 
     135    <li> src/osgPlugins/pfb</li> 
     136    <br> 
     137There is a Performer plugin in this distribution for converting from 
     138Performer to OSG and from OSG to Performer. This plugin requires 
     139Performer to be installed and therefore is not compiled by default. If 
     140you have Performer (available under Linux and IRIX) then edit 
     141src/osgPlugins/Make to compile under the plugin. 
     142Performer can be downloaded from : 
     143    <ul> 
     144      <i><a href="http://www.sgi.com/">http://www.sgi.com/</a></i> 
     145    </ul> 
     146    <br> 
     147    <li> src/osgPlugins/png</li> 
     148    <br> 
     149The png plugin depends upon the libpng and zlib (for compression) 
     150libraries, if you don't already have it installed, you'll need to 
     151download, compile 
     152and install it. Project home pages are: 
     153    <ul> 
     154      <i><a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a></i> 
     155      <br> 
     156      <i><a href="http://www.info-zip.org/pub/infozip/zlib/">http://www.info-zip.org/pub/infozip/zlib/</a></i> 
     157    </ul> 
     158    <br> 
     159    <li> src/osgPlugins/gif</li> 
     160    <br> 
     161The gif plugin depends upon the libungif library, if you don't already 
     162have it installed, you'll need to download, compile and install it. 
     163Project home page is: 
     164    <ul> 
     165      <i><a href="http://prtr-13.ucsc.edu/%7Ebadger/software/libungif/">http://prtr-13.ucsc.edu/~badger/software/libungif/</a></i> 
     166    </ul> 
     167Ftp download at : 
     168    <ul> 
     169      <i><a href="ftp://prtr-13.ucsc.edu/pub/libungif/">ftp://prtr-13.ucsc.edu/pub/libungif/</a></i> 
     170    </ul> 
     171    <br> 
     172    <li> src/osgPlugins/jpeg</li> 
     173    <br> 
     174The jpeg plugin depends upon the libjpeg library, if you don't already 
     175have it installed, you'll need to download, compile and install it. 
     176Project home page is: 
     177    <ul> 
     178      <i><a href="http://www.ijg.org/">http://www.ijg.org/</a></i> 
     179    </ul> 
     180    <br> 
     181    <li> src/osgPlugins/tiff</li> 
     182    <br> 
     183The tiff plugin depends upon the libtiff library, if you don't already 
     184have it installed, you'll need to download, compile and install it. 
     185Project home page is: 
     186    <ul> 
     187      <i><a href="http://www.libtiff.org">http://www.libtiff.org</a></i> 
     188    </ul> 
     189    <br> 
     190    <li> src/osgPlugins/zip</li> 
     191    <br> 
     192The zip compressed archive plugin depends upon the unzip executable 
     193being available on your system. If it is not then you'll be able to 
     194find binaries at: 
     195    <ul> 
     196      <i><a href="http://www.freesoftware.com/pub/infozip/">http://www.freesoftware.com/pub/infozip/</a></i> 
     197    </ul> 
     198    <br> 
     199    <li> src/osgPlugins/tgz</li> 
     200    <br> 
     201The tgz compressed archive plugin depends upon the unzip executable 
     202being available on your system. If it is not then you'll be able to 
     203find binaries at: 
     204    <ul> 
     205      <i><a href="http://www.gzip.org/">http://www.gzip.org/</a></i> <br> 
     206      <a href="ftp://prep.ai.mit.edu/pub/gnu/tar/">ftp://prep.ai.mit.edu/pub/gnu/tar/</a> 
     207    </ul> 
     208    <br> 
     209    <li> src/osgPlugins/osgtgz</li> 
     210    <br> 
     211Has the same dependencies as the tgz plugin above. 
    117212  </ul> 
    118        
    119   <hr>     
    120   <h3> <a name="Plug-in dependencies"></a><u>Plug-in dependencies</u></h3> 
    121   Follows is the list of dependencies which some of the osgPlugins require, 
    122  note the core osg and viewer do not need the following dependencies, you 
    123 only need the following if you require each specific plugin. Note, the flt, 
    124 3ds, pic, tga, do not have any dependencies other than Standard C++ so will 
    125 compile straight of the bag. Under Linux the majority of the dependencies 
    126 below come as standard with distributions so you may not need to download 
    127 them at all. Its best to try out a straight compile of the osg, if you get 
    128 missing includes/libs errors then chase up the below. <br> 
    129       
    130   <ul> 
    131    <br> 
    132   <li> src/osgPlugins/freetype - The osgText library supports true type fonts  
    133 via the freetype library.</li> 
    134          
    135     <ul> 
    136        <i><a href="http://www.freetype.org/">http://www.freetype.org/</a></i>  
    137      
    138     </ul> 
    139   <br> 
    140    <li> src/osgPlugins/pfb</li> 
    141    <br> 
    142  There is a Performer plugin in this distribution for converting from Performer  
    143 to OSG and from OSG to Performer. This plugin requires Performer to be installed  
    144 and therefore is not compiled by default. If you have Performer (available  
    145 under Linux and IRIX) then edit src/osgPlugins/Make to compile under the plugin. 
    146 Performer can be downloaded from :       
    147     <ul> 
    148        <i><a href="http://www.sgi.com/">http://www.sgi.com/</a></i>      
    149     </ul> 
    150    <br> 
    151   <li> src/osgPlugins/png</li> 
    152    <br> 
    153  The png plugin depends upon the libpng and zlib (for compression) libraries, 
    154  if you don't already have it installed, you'll need to download, compile 
    155 and install it. Project home pages are:       
    156     <ul> 
    157        <i><a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a></i> 
    158        <br> 
    159        <i><a href="http://www.info-zip.org/pub/infozip/zlib/">http://www.info-zip.org/pub/infozip/zlib/</a></i>  
    160      
    161     </ul> 
    162    <br> 
    163   <li> src/osgPlugins/gif</li> 
    164    <br> 
    165  The gif plugin depends upon the libungif library, if you don't already have  
    166 it installed, you'll need to download, compile and install it. Project home  
    167 page is:       
    168     <ul> 
    169        <i><a href="http://prtr-13.ucsc.edu/%7Ebadger/software/libungif/">http://prtr-13.ucsc.edu/~badger/software/libungif/</a></i>  
    170      
    171     </ul> 
    172   Ftp download at :       
    173     <ul> 
    174        <i><a href="ftp://prtr-13.ucsc.edu/pub/libungif/">ftp://prtr-13.ucsc.edu/pub/libungif/</a></i>  
    175      
    176     </ul> 
    177    <br> 
    178   <li> src/osgPlugins/jpeg</li> 
    179    <br> 
    180  The jpeg plugin depends upon the libjpeg library, if you don't already have  
    181 it installed, you'll need to download, compile and install it. Project home  
    182 page is:       
    183     <ul> 
    184        <i><a href="http://www.ijg.org/">http://www.ijg.org/</a></i>      
    185     </ul> 
    186    <br> 
    187   <li> src/osgPlugins/tiff</li> 
    188    <br> 
    189  The tiff plugin depends upon the libtiff library, if you don't already have  
    190 it installed, you'll need to download, compile and install it. Project home  
    191 page is:       
    192     <ul> 
    193        <i><a href="http://www.libtiff.org">http://www.libtiff.org</a></i>  
    194      
    195     </ul> 
    196    <br> 
    197   <li> src/osgPlugins/zip</li> 
    198    <br> 
    199  The zip compressed archive plugin depends upon the unzip executable being  
    200 available on your system. If it is not then you'll be able to find binaries  
    201 at:       
    202     <ul> 
    203        <i><a href="http://www.freesoftware.com/pub/infozip/">http://www.freesoftware.com/pub/infozip/</a></i>  
    204      
    205     </ul> 
    206    <br> 
    207   <li> src/osgPlugins/tgz</li> 
    208    <br> 
    209  The tgz compressed archive plugin depends upon the unzip executable being  
    210 available on your system. If it is not then you'll be able to find binaries  
    211 at:       
    212     <ul> 
    213        <i><a href="http://www.gzip.org/">http://www.gzip.org/</a></i> <br> 
    214        <a href="ftp://prep.ai.mit.edu/pub/gnu/tar/">ftp://prep.ai.mit.edu/pub/gnu/tar/</a>  
    215      
    216     </ul> 
    217    <br> 
    218   <li> src/osgPlugins/osgtgz</li> 
    219    <br> 
    220  Has the same dependencies as the tgz plugin above.    
    221   </ul> 
    222      
    223213</ul> 
    224  <br> 
    225  <br> 
     214<br> 
     215<br> 
    226216</body> 
    227217</html>