/mitsuba-renderer

A mirror of the upstream mercurial repository plus some own modifications.

Primary LanguageC++

Kompilieren unter Windows
=========================

Das Projekt nutzt SCons [1] als Buildsystem. Das ist ein kleines Pythonscript
und damit wird zusätzlich noch Python benötigt. Python (in der Version 2.7)
sollte zuerst installiert werden. Außerdem nutzt das Programm das SCM-Werkzeug
Git [3]. Unter Windows bietet sich der Einsatz von MSysGit [4] und (wenn man
nicht so gern die Kommandozeilen nutzt) TortoiseGit [5] an (obgleich sich Git
sehr gut mit der Kommandozeile bedienen lässt).

Im Kern arbeitet Mitsuba [7] als Renderer und Bereitsteller für verschiedene
Infrastruktur. Damit dies erfolgreich möglich ist, werden weitere Abhängigkeiten
benötigt. Mittels Mercurial [8] müssen diese (unter Windows und Mac OSX) in
das den Ordner "dependencies" im Wurzelverzeichnis den Projekts geklont [9]
werden. Außerdem werden noch die numeric-bindings [11] von Boost und damit
Lapak [12] benötigt.

Für die GUI ist es notwendig das QT-Framework [10] zu installieren. Aber danach
sollte einem nichts mehr im Wege stehen um das Projekt kompilieren zu können.

Schritt für Schritt
-------------------

1. Python 2.7 [2] installieren
2. Production-Version von SCons [1] installieren. Beachten, dass sich der
   Installer nicht um Rechte kümmert. Python wurde aber (vermutlich) als
   Administrator installiert und da SCons Zugriff auf Python braucht ist es
   mit den selben (oder mehr) Rechten zu installieren.
3. Für Git MSysGit [4] installieren (aktuelle Preview-Version) 
5. Mittels Git das (öffentlich lesbare) Programm-Repository [6] klonen
6. Aus dem Unterordner config eine passende Konfiguration ins Wurzelverzeichnis
   kopieren und diese in "config.py" umbenennen. (z.B. config-msvc2008-win32.py)
7. Mercurial [8] installieren, nach belieben mit TortoiseHG
8. Mittels Merurial (hg), die Abhängigkeiten für Mitsuba auflösen indem das
   entsprechende Repository [9] in den Ordner "dependencies" im Projektordner
   geklont wird.
9. QT [10] installieren. Es wird von SCons nach der Umgebungsvariable QTDIR gesucht.
10. Die Numeric-Bindings von Boost unter [11] herunterladen und in den Odner
    "dependencies/boost" entpackes. Die Bibliotheken aus [12] müssen in den
    entsprechenden Ordner der Windows-Version (e.g. "dependencies\windows\lib32")
11. Es wird die Windows-DLL vcomp90.dll [13] benötigt
12. Mittels einer Kommandozeile in den Projektordnor wechseln und SCons aufrufen.
    Unter Windows ist dies mit dem installierten Script im Pythonordner
    "Scripts" zu finden. (z.B. E:\bin\Python26\Scripts\scons.bat)

Referenzen
----------

[1] http://www.scons.org/
[2] http://www.python.org/
[3] http://git-scm.com/
[4] http://code.google.com/p/msysgit/downloads/list?can=3
[5] http://code.google.com/p/tortoisegit/
[6] git://git.assembla.com/mitsuba-renderer.git
[7] http://www.mitsuba-renderer.org
[8] http://mercurial.selenic.com/wiki/Download#Windows
[9] https://www.mitsuba-renderer.org/hg/dependencies
[10] http://qt.nokia.com/downloads/
[11] http://mathema.tician.de/dl/software/boost-bindings
[12] http://icl.cs.utk.edu/lapack-for-windows/lapack/#librairies
[13] http://www.dll-files.com/pop.php?dll=vcomp90