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

This HowTo shows one solution to create a good working OSG build environment on a windows operating system.

Prerequisites

• Install CMAKE from ​http://www.cmake.org/cmake/resources/software.html
• Download OSG sources
• Download prebuild 3rdParty libraries from ​http://www.openscenegraph.org/projects/osg/wiki/Downloads/Dependencies . Use precompiled 3rdParty libs because building them takes many many hours :/ Attention: Use the right version for your compiler, the wrong version can cause unpredicatlbe linking and runtime errors'''
• Download the example data from ​http://www.osgvisual.org/projects/osgvisual/wiki/Downloads

Directory structure

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