Ogre-Installation mit Visual Studio Express

Ogre3d unterstützt die Betriebssysteme Windows, Linux und Mac OSX. Das Entwicklungspaket Ogre SDK (Software Development Kit) enthält die bereits kompilierten Programmbibliotheken. Das Ogre SDK steht für die IDE/Compiler-Kombination Code::Blocks + MinGW + STLPort sowie für die Microsoft Compiler Visual C++ .Net 2003 (7.1) und Visual C++ .Net 2005 (8.0) zur Verfügung. Eine spezielle Variante des SDK ist PyOgre. Dieses Ogre SDK macht die Nutzung für Python-Anwender möglich. Die zugrundeliegende Ogre-Version ist allerdings nicht die Neueste.

Neben den vorkompilierten Entwicklungspaketen kann der komplette Quellcode von Ogre für Linux und Mac OSX oder für Windows heruntergeladen werden. Wer mit den Quellcode-Paketen für Ogre startet, muss die Engine selbst kompilieren. Entsprechend ist der Start etwas aufwändiger.

Schnell und völlig unkompliziert ist die Installation von Ogre3d für die Nutzer der neueren Entwicklungsumgebungen von Microsoft: Visual C++ ab VC7.1 (2003). Ein Hinweis für die Fans von Visual C++ 6.0: Die Ogre-Versionen ab 1.2.0 unterstützen diesen Compiler sowie den VC7.0 (2002) nicht mehr. Wer Ogre mit Visual Studio 6.0 nutzen will, muss auf ältere Pakete zurückgreifen und unter anderem auf die Aktualisierung der STL achten. Ohne Einbindung der STLPort-Bibliothek wird es nicht funktionieren.

Für die nachfolgende Beschreibung der Ogre-Installation mit der frei verfügbaren Entwicklungsumgebung (IDE) Visual C++ Studio 2005 Express Edition∞ wird vorausgesetzt, dass die IDE korrekt funktioniert und dass das Microsoft Platform SDK (PSDK) komplett und erfolgreich eingerichtet ist. Wer dies zuvor bewerkstelligen muss, findet auf dieser Seite∞ die Anleitung zur Integration des PSDKs in VC++ Express.

Ogre-Schnellstart am Beispiel von Visual Studio Express 2005

Wunderbar einfach ist die Installation von Ogre seitdem es das Hilfsprogramm AppWizard gibt. AppWizard (Application Wizard) lässt sich frei übersetzen als Zauberkünstler für die Anwendung, in diesem Fall ist es tatsächlich ein Zauberwerkzeug für die Ogre-Installation. Und so funktioniert es: Für die Installation in Kombination mit Visual C++ Studio 2005 müssen zwei Zip-Dateien heruntergeladen werden:

1. das für den Compiler passende SDK (41 Megabyte)

OGRE 1.2.0 SDK for Visual C++ .Net 2005 (8.0)∞

2. das für den Compiler passende Hilfswerkzeug AppWizard (69,3 KB)

Ogre SDK 1.2.x Application Wizard v.1.2 for VC8.0∞

Hinweis: Der AppWizard muss mit der Version des OgreSDK übereinstimmen und nicht für die Quellcode-Pakete ausgerichtet sein. Die AppWizards für die Quellcode-Pakete (Ogre Source) stehen auf der Website ebenfalls zur Verfügung.

Ein Klick auf die Datei OgreSDKSetup1.2.0_VC80 installiert Ogre auf dem Windows-Rechner. Danach ist die Umgebungsvariable OGRE_HOME eingerichtet, die auf den Ort verweist, an dem das OgreSDK sich befindet.

Bei Übernahme der voreingestellten Verzeichnisse liegen die Ogre-Dateien nun unter: C:\OgreSDK

Ob OGRE_HOME korrekt übernommen wurde, lässt sich über das Start-Menü überprüfen:

Start => Systemsteuerung => System



Im Fenster Systemeigenschaften den Reiter Erweitert wählen und dort im unteren Bereich die Auswahloption Umgebungsvariablen aktivieren. Jetzt erscheint das Fenster, in dem die Variable OGRE_HOME auf das entsprechende OgreSDK-Verzeichnis zeigt.

Nun kommt der Anwendungs-Zauberkünstler zum Einsatz. Die Dateien von ogre12xSDKwizard80_v1_1.zip werden in einen Ordner an sicherem Platz entpackt. Der Ordner muss sich nicht unmittelbar im Projektverzeichnis der späteren-Ogre-Arbeit oder an einem bestimmten Ort des SDK-Verzeichnisses befinden.



Ein Doppelklick auf die Datei VC8_Express_Setup.js genügt schon. Zur Bestätigung erscheint das folgende Fenster und dokumentiert die erfolgreiche Arbeit des AppWizards.



Fix und Foxi. Das war es schon. Ab jetzt können neue Ogre-Projekte vom Compiler aus erstellt werden.



Nach dem Start von Visual Studio Express über Datei => Neu => Projekt erscheint jetzt zur Auswahl die von Visual Studio Express bereits installierte Vorlage Ogre SDK Application.



Nach der Auswahl können jetzt die vom AppWizard bereitgestellten Optionen genutzt werden:



Im zweiten Fenster des AppWizards muss die Option Postbuild Copy markiert sein.



Nach der Auswahl des Finish-Buttons ist das komplette Ogre-Projekt eingerichtet. Es kann kompiliert werden.



Vor dem ersten Build-Prozess benötigt der Compiler lediglich noch die Einstellungen für den Include-Pfad zu den Beispieldateien von Ogre. Eine Fehlermeldung kann an dieser Stelle durch die Codezeile #include "ExampleApplication.h" ausgelöst werden. Damit der Compiler die Beispielprogramme (Samples) von Ogre finden kann, muss noch der entsprechende Pfad eingetragen werden.



Als zusätzliches Includeverzeichnis wird $(OGRE_HOME)\Samples\include eingefügt.



Ein Druck auf F7, und das Projekt sollte jetzt problemlos Kompilieren und Linken.



OK? 0 Fehler. 0 Warnungen. So muss es sein.



Die .exe-Datei befindet sich jetzt im Verzeichnis OgreSDK/bin/debug



Ogre3d läuft! Das allseits geliebte Ungeheuer (Ogre) glubbert uns aus dem Monitor heraus an.



Das Grundgerüst für dieses Tutorial basiert auf dem „Complete Blanks Guide To Using The OGRE SDK AppWizard“ von Jacmoe. Die Downloadseite des AppWizards in der neuen Version 1.2 befindet sich jetzt bei SourceForge.net, entsprechend wurde der Link im Tutorial aktualisiert. (5. September 2006)

---

CategoryOgre3d