Benutzung der VIGRA-Funktionalität unter Windows mit MS Visual Studio 2005

Für die Nutzung unter Linux, UNIX und Mac OS sei auf folgende Installationsanleitung verwiesen: VIGRA-Reference-Manual (Installation).

Microsoft Visual Studio ist eine kostenpflichtige IDE, die aber im Rahmen der Academic Alliance von MS an Studiende kostenlos verteilt wird, allerdings mit der Auflage des nicht-kommerziellen Einsatzes. Da sie den Microsoft Compiler beinhaltet, tritt leider oft ein abweichendes Verhalten gegenüber dem GCC unter UNIX/LINUX auf. Das heißt z.B.: Andere Fehlermeldungen, anderes Kompilierungsverhalten, kaum mehr Makefiles, dafür Projektdateien etc. Dafür ist der Compiler mittlerweile auch "erwachsen" geworden und sollte theoretisch in der Lage sein, beliebigen C++-konformen Code zu übersetzen. Positiv hingegen ist der sehr gute integrierte Debugger, die automatische Code-Vervollständigung und ein guter Editor mit Syntax-Highlighting um nur einige Vorzüge zu nennen.
Die folgenden Schritte beschreiben die Einrichtung der VIGRA-Bibliothek unter dieser Entwicklungsumgebung.

1. Herunterladen und entpacken

Zuerst einmal muss noch das VIGRA-Paket (1.6.0) inklusive den Sources aller Abhängigkeiten hier heruntergeladen werden.
Nun muss das Zip-Archiv noch entpackt werden, der Pfad spielt dabei absolut keine Rolle! Nehmen wir für diese Anleitung einmal an, dass es in den Ordner
```
C:\development\vigra-1.6.0-complete
```
entpackt wurde.

2. Erstellen der (abhängigen) Bibliotheken

Für diese Anleitung werden alle Abhängigkeiten als statische Bibliotheken erstellt. Dies ist deshalb wichtig, damit die eigentliche VIGRA-Import/Export-Bibliothek sowohl als statische als auch als dynamische Bibliothek erstellt werden kann.

Um den automatischen Erstellungsvorgang zu starten, muss die "BuildAll" Batchdatei aufgerufen werden. Dies kann entweder mit einem Doppelklick geschehen oder in der Eingabeauffordeung mit:

C:\development\vigra-1.6.0-complete\BuildAll.bat

3. Vertrauen ist gut, Kontrolle ist besser

Nur um sicherzugehen, sollte abschließend noch einmal kontrolliert werden, ob wirklich alle erstellten Bibliotheken an Ort und Stelle liegen. Folgende Dateien sollten sich nun in dem Ordner C:\development\vigra-1.6.0-complete\libs befinden:

   libfftw.lib                (fftw  - Release - stat. Bibliothek)
   libjpeg.lib                (jpeg  - Release -                 )
   libpng.lib                 (png   - Release -                 )
   libtiff.lib                (tiff  - Release -                 )
   zlib.lib                   (zlib  - Release -                 )

   vigraimpex.lib             (vigra - Release - stat. Bibliothek)
   vigraimpex_debug.lib       (vigra - Debug   - stat. Bibliothek)

   vigraimpex.dll             (vigra - Release - dyn. Bibliothek )
   vigraimpex.dll.exp         (                - Interface-Def.  )
   vigraimpex_dll.lib         (                - Include Bibl.   )
   vigraimpex_debug.dll       (      - Debug   - dyn. Bibliothek )
   vigraimpex_debug.dll.exp   (                - Interface-Def.  )
   vigraimpex_debug_dll.lib   (                - Include Bibl.   )

Sollte dies nicht der Fall sein, so ist die wahrscheinlichste Ursache, dass die Batch-Datei die Visual Studio Umgebungsvariablen nicht lesen und verarbeiten konnte. In diesem Fall muss Zeile 4 der Batch-Datei so geändert werden, dass der Pfad zur Datei vsvars32.bat gefunden werden kann!

4. Erstellen der Beispiele

Nachdem alle Bibliotheken erfolgreich erstellt worden sind, lassen sich nun auch die VIGRA-Beipiele kompilieren und ausprobieren!