[[TracNav(TracNav/TOC)]]

= OSG & VPB Build Environment in Windows as Step-By-Step Tutorial =

[[toc]]

+ OSG-Entwicklungsumgebung installieren

++ Vorbedingungen

* cmake Installieren: http://www.cmake.org/cmake/resources/software.html
* OSG-Sources runterladen
* 3rdParty- Libraries herunterladen von http://www.openscenegraph.org/projects/osg/wiki/Downloads/Dependencies (Da sie schon vorkompiliert sind: die richtigen für die verwendete Visual Studio Version verwenden!!)
* Example-Data installieren

++ Verzeichnisstruktur

Die Verzeichnisstruktur soll anhand einer Installation auf D: erläutert werden:

|| Verzeichnis || Inhalt || Quelle ||
|| D:\OpenSceneGraph || Wurzelverzeichnis des OSG-Frameworks || - ||
|| D:\OpenSceneGraph\gdal-1.6.2 || gdal-1.6.2 || Herunterladen und selber kompilieren oder von andenre Projekten hineinkopieren ||
|| D:\OpenSceneGraph\3rdParty || Verzeichnis für die Libraries von Dritten (Aus OSG-SVN fertig beziehbar))|| http://www.openscenegraph.org/projects/osg/wiki/Downloads/Dependencies ||
|| D:\OpenSceneGraph\Data || Modelle und Bilder für die kompilierten Beispiele || http://www.openscenegraph.org/projects/osg/wiki/Downloads/SampleDatasets ||
|| D:\OpenSceneGraph\OpenSceneGraph-2.9.8 || Verzeichnis in dem das eigentliche OSG-Framework (bin lib include etc.)liegt || Neueste Version aus SVN ||
|| D:\OpenSceneGraph\VirtualPlanetBuilder || Verzeichnis für die Installation des VPB. || Neueste Version aus SVN ||


++ Umgebungsvariablen setzen

Es sind folgende Umgebunsvariablen nötig:
* OSG               D:\OpenSceneGraph\OpenSceneGraph-2.9.8\bin;D:\OpenSceneGraph\3rdParty\bin;D:\OpenSceneGraph\gdal-1.6.2\bin
* OSG_FILE_PATH     D:\OpenSceneGraph\Data;D:\OpenSceneGraph\Data\Images
* PATH              erweitern mit ;%OSG%
* OSG_SCREEN        0    Nummer des Bildschirms, den OSG verwenden soll. es wird angefangen bei 0 zu zählen.
* OSG_NOTIFY_LEVEL  Notify-Level für die Konsolen-Ausgabe, z.B.: WARN
* OSG_ROOT          OSG-Wurzelverzeichnis, z.B.: D:\OpenSceneGraph\OpenSceneGraph-2.9.8

++ GDAL kompilieren

* Download GDAL SDK-Package (bottom of the page) from http://vbkto.dyndns.org/sdk/
* Open in VS2005 SP1 and compile.
* Create new gdal directory structure
<code>
gdal-1.x.x
 - bin
 - include
 - data
 - lib
</code>
* If you have compiled successfully, populate this directories:
|| data || Content from SDK-Package/<GDAL>/data ||
|| include || All includes files from SDK-Package/<GDAL>   -- cpl_config.h will reside in different folders with different size, use the bigger one. ||
|| bin || Copy all .exe and.dll into this directory ||
|| lib || Copy gdal_i.lib into this directory ||
* Delete your downloaded SDK to avoid that cmake will found this folder instead your build.

++ OSG Kompilieren

Die Reihenfolgedes kompilieren lautet
* CMAKE starten und Sourcecode wählen
 * Sourcecode Verzeichnis:  D:/OpenSceneGraph/OpenSceneGraph-2.9.8
 * Build Binaries Verzeichnis: D:/OpenSceneGraph/OpenSceneGraph-2.9.8
* Optionen für gewähltes Sourcecodeverzeichnis einstellen
 * ACTUAL_3RDPARTY_DIR   D:/OpenSceneGraph/3rdparty
 * CMAKE_INSTALL_PREFIX  D:/OpenSceneGraph/OpenSceneGraph-2.9.8
 * BUILD_MFC_EXAMPLES    true    (Diese Option erscheint erst, wenn BUILD_OSG_EXAMPLE auf true gesetzt wurde und einmal ein "Configure" ausgeführt wurde)
 * BUILD_WRAPPER         true    
* configure ausführen, bei Fehlern diese beseitigen
* Generate ausführen -> MS Visual Studio Solution wird erzeugt
* D:/OpenSceneGraph/OpenSceneGraph-2.9.8 betreten und OpenSceneGraph.sln öffnen
* BUILD_ALL einmal als Debug und einmal als Release kompilieren ( Bei Fehlern immer wieder OHNE Aufräumen kompilieren bis alle Fehler weg sind und der Compile gelingt)

Fertig! :)

Sollte beim Compile nicht gegen wldap32.lib gelinkt werden können: http://www.mail-archive.com/osg-users@lists.openscenegraph.org/msg20490.html