﻿=====================================================
1. Installation von IVT, OpenCV, Q.../Free und Visual C++ 2008 Express Edition unter Windows
2. Konfiguration
3. Kompilieren von IVT
4. Funktionstest 
=====================================================

Vorab: Kameratreiber installieren und testen, ob die Kamera in einer mitgelieferten Anwendung oder etwa Skype ein Live-Bild liefert -- falls das nicht klappt, ist der Betrieb der Kamera mit IVT aller Voraussicht nach nicht möglich.


1. Installation
--------------

* OpenCV

Unter http://sourceforge.net/projects/opencvlibrary/ zu "Downloads/Browse all Files" wechseln, dann aus dem Package "opencv-win" die Datei OpenCV_1.0.exe herunterladen und installieren, zum Beispiel in C:\Programme\OpenCV

* Q.../Free

Unter http://sourceforge.net/projects/qtwin/ zu "Downloads/Browse all Files" wechseln, dann aus dem Package "Unofficial Qtwin" neben qt-win-3.3.4-3 auf das Pluszeichen klicken und entweder die Datei setup-qt-win-free-msvc-3.3.4-3.exe oder setup-qt-win-free-msvc.net2003-3.3.4-3.exe herunterladen (mit Visual C++ Express 2008 funktionieren beide Versionen) und installieren, zum Beispiel in C:\Programme\qt-win-free-msvc-3.3.4

* CMU1394 (FireWire, optional)

Unter http://www.cs.cmu.edu/~iwan/1394/download.html den Bedingungen der LGPL zustimmen, dann die neueste Version des Treibers (aktuell 1394camera645.exe) herunterladen und installieren, zum Beispiel in C:\Programme\CMU\1394Camera. Wichtig: Während der Installation bei der Komponentenauswahl ein Häkchen in die Checkbox vor "Development Files" setzen!

* IVT

Unter http://sourceforge.net/projects/IVT/ zu "Downloads/Browse all Files" wechseln, dann aus dem Package "ivt" die neueste Version (aktuell ivt-1.1.4.zip) herunterladen und entpacken, zum Beispiel in C:\Programme. Nach dem Entpacken befinden sich dann unter C:\Programme\IVT
die Unterverzeichnisse doc, examples, files, lib, src und win32.

* Visual C++ 2008 Express Edition

Unter http://www.microsoft.com/germany/express/download/default.aspx die Installationsdatei herunterladen oder unter http://www.microsoft.com/germany/express/download/default.aspx#offlineInstall ein Iso-Image für eine Installations-DVD herunterladen und brennen. Anschließend Visual C++ 2008 Express Edition installieren.


2. Konfiguration
----------------

* Visual C++ starten und über die Menüleiste den Ordner Extras/Optionen öffnen.

* Auf den Pfeil neben "Projekte und Projektmappen" klicken und zum Eintrag "VC++-Verzeichnisse" wechseln. In der Ausklappliste unter "Verzeichnisse anzeigen für" (rechts oben) zum Eintrag "Includedateien" wechseln. 

* Dort folgende Pfade einfügen (bei abweichenden Installationsorten von OpenCV, Qt, IVT und CMU1394  sind die Pfade entsprechend anzupassen):

C:\Programme\OpenCV\cv\include
C:\Programme\OpenCV\cxcore\include
C:\Programme\OpenCV\otherlibs\highgui
C:\Programme\OpenCV\cvaux\include
C:\Programme\OpenCV\otherlibs\cvcam\include
C:\Programme\qt-win-free-msvc-3.3.4\include
C:\Programme\IVT\src
C:\Programme\CMU\1394Camera\include (optional, wenn FireWire installiert ist)

* In der Ausklappliste unter "Verzeichnisse anzeigen für" zum Eintrag "Bibliothekdateien" wechseln und folgende Pfade einfügen (bei abweichenden Installationsorten von OpenCV, Qt, IVT und CMU1394 sind die Pfade entsprechend anzupassen):  

C:\Programme\OpenCV\lib\win32
C:\Programme\qt-win-free-msvc-3.3.4\lib
C:\Programme\IVT\lib\win32
C:\Programme\CMU\1394Camera\lib (optional, wenn FireWire installiert ist)

* Mit der Tastenkombination Windows+Pause die Systemeigenschaften öffnen (unter Vista anschließend in der Aufgaben-Spalte auf "Erweiterte Systemeinstellungen" klicken). Auf dem Karteireiter "Erweitert" auf die Schaltfläche "Umgebungsvariablen" klicken und die Systemvariable PATH um folgende Einträge erweitern (bei abweichenden Installationsorten von OpenCV und Qt sind die Pfade entsprechend anzupassen): 

C:\Programme\OpenCV\bin; C:\Programme\qt-win-free-msvc-3.3.4\bin;


3. IVT-Bibliothek kompilieren
------------------------------

* Im Verzeichnis ...\IVT\win32\IVTLib liegt die Arbeitsbereich-Datei IVTLib.dsw für Microsoft Visual C++ 6.0. Öffnet man diese mit einer neueren Version von Visual C++, werden die Projektdateien (Endung .dsp) nach einem Klick auf den Bestätigungsdialog automatisch ins Format aktueller Projektdateien (Endung .vcproj) konvertiert. Beim nächsten Öffnen meldet Visual C++ 2008 dann, dass bereits aktualisierte Dateien vorliegen und bietet an, gleich diese zu öffnen. 

* Der Arbeitsbereich enthält zwei Konfiguratiionen und zwei Projekte; damit lassen sich insgesamt vier Versionen der Bibliothek erzeugen:

IVTLib – Win32 Release
Hierbei handelt es sich um die Standard-Version der IVT-Bibliothek. Nicht enthalten sind Debug-Informationen. Der Dateiname der Bibliotheksdatei lautet ivt.lib.

IVTLib – Win32 Debug
Die Debug-Version erlaubt den Einsprung in Funktionen und das schrittweise Ausführen der Funktionen innerhalb der IVT-Bibliothek während des Debuggens. Üblicherweise sind Anwendungen, die mit der Debug-Version kompiliert wurden, in der Ausführung deutlich langsamer. Die zu erstellende Bibliothek trägt den Dateinamen ivtd.lib.

IVTQTGUILib – Win32 Release
Mit dieser Auswahl wird eine weitere Bibliothek erstellt. Dabei handelt es sich lediglich um eine Erweiterung für die Standard-Version der IVT-Bibliothek. Diese enthält die vereinfachte Unterstützung für grafische Benutzerschnittstellen mit Qt. Der Dateiname der Bibliothek ist ivtguiqt.lib.

IVTQTGUILib – Win32 Debug
Die Debug-Version der Erweiterungsbibliothek erlaubt wiederum das Debuggen innerhalb des IVT-Quellcodes. Der Dateiname der Debug-Version ist ivtguiqtd.lib.

Um später alle Anwendungen mit IVT fehlerlos kompilieren zu können, sollten alle vier Varianten der IVT-Bibliothek erstellt werden.

* Dazu wählt man über den Menüeintrag "Erstellen/Konfigurations-Manager" für beide Projekte IVTLib und  IVTQTGUILib zunächst die Konfiguration "Debug" und die Plattform "Win32" und stellt sicher, dass beide Checkboxen unter "Erstellen" Haken tragen.  Die Übersetzung startet man über den Menüeintrag "Erstellen/Projektmappe erstellen".

* Anschließend wählt man im Konfigurations-Manager für beide Projekte die Konfiguration "Release" und belässt die Plattform auf "Win32".  Die Übersetzung startet man wieder über den Menüeintrag "Erstellen/Projektmappe erstellen".

* Die kompilierten Bibliotheksdateien landen im Unterverzeichnis ...\IVT\lib\win32


4. Testanwendung
-------------------

* Auf den Menüeintrag "Datei/Öffnen/Projekt/Projektmappe" klicken und ins Verzeichnis IVT\win32\SimpleApp wechseln.

* Die Arbeitsbereich-Datei SimpleApp.dsw öffnen und die Konvertierung abnicken.

* Über "Erstellen/Projektmappe erstellen" Beispielanwendung kompilieren (ggf. die Konfiguration wechseln -- standardmäßig ist "Debug" ausgewählt, diese setzt voraus, dass zuvor die Debug-Versionen der IVT übersetzt worden sind).

* Über die Menüleiste "Projekt/SimpleApp-Eigenschaften öffnen und unter "Konfigurationseigenschaften/Debugging" in der Liste rechts in die Zeile Befehlsargumente klicken; über die Drop-down-Liste "<Bearbeiten...>" auswählen und den Pfad zum Beispielbild "..\..\files\dish_scene_left.bmp" eintippen.

* Ein Druck auf die Taste F5 startet die Anwendung (alternativ auf den grünen Pfeil in der Symbolleiste klicken); nach erfolgreichem Durchlauf des Programms liegt eine per Schwellwertfilter bearbeitete Kopie des Beispielbilds unter IVT\win32\SimpleApp\output.bmp 
