Touchbook Testanwendung für IRTOUCH-Rahmen
Copyright 2009, 2010 Stefan Gehn <stefan@srcbox.net>
Lizenz: GPL Version 2 oder neuer, siehe gpl-2.0.txt


==== Abhängigkeiten ====

Folgende Software wird zur Übersetzung des Sourcecodes benötigt

- C++ Compiler (getestet u.a. mit GCC, i686-apple-darwin9-gcc-4.0.1)

- Qt Framework Version 4.5.x oder neuer (http://qt.nokia.com/)

- Qt Animation Framework Version 2.3
  (http://qt.nokia.com/products/appdev/add-on-products/catalog/4/Utilities/qtanimationframework)
  das Animation Framework seit Qt 4.6 Bestandteil des Qt Frameworks.
  Der vorliegende Sourcecode wurde bisher nur mit Qt 4.5 getestet!)

- QExtSerialPort Snapshot (http://code.google.com/p/qextserialport/)


==== Übersetzung ====

- Erstellung der Projektdateien durch Aufruf von "qmake touchbook.pro"

- Die Übersetzung des Projekts hängt von der verwendeten
  Systemplattform ab. Möglich sind u.A. XCode Projekt, Makefile sowie
  MSVC Projekt. Genaueres ist der QMake Dokumentation des
  QT Frameworks zu entnehmen.
  Im Falle von Makefiles genügt die Eingabe von "make" im
  Sourceverzeichnis.

- Die ausführbaren Anwendungen "touchbook" sowie "irtest" werden im
  Unterverzeichnis "build/debug" erstellt.


==== Verwendung ====

Um die Workbench oder die Fotobuchanwendung zu starten wird im
Verzeichnis der Anwendungen die Konfigurationsdatei "irtouch.ini"
benötigt, welche u.A. die Ausmaße des verwendeten IRTOUCH-Rahmens sowie
den Pfad bzw. Namen der seriellen Schnittstelle angibt.
Eine kommentierte Beispielkonfiguration liegt dem Sourcecode
unter "build/debug" bereits bei. Für die Anwendung "touchbook"
wird außerdem ein Unterverzeichnis "pictures" benötigt, welches die
anzuzeigenden Fotos enthält.

Programmaufruf:
Sowohl "irtest" als auch "touchwindow" kann bei Bedarf ein vorher
aufgenommener Packetdump (ein Dump wird erzeugt, wenn in der
Konfigurationsdatei Record=1 gesetzt ist) übergeben werden. Dieser wird
anstelle der seriellen Schnittstelle als Quelle für Eingabedaten
verwendet.

Innerhalb der Testworkbench "irtest" gelten folgende Tastaturkürzel:
ESC      : Anwendung beenden
1-4      : Ein- Ausblenden von Informationslayern
           (Raw-Werte, Achswerte, Druckpunkte, Achswertabstände)
Alt + 1-4: Ein- Ausblenden von Textlayern
F5       : Screenshot erstellen
F11      : Umschaltung zwischen Vollbild- und Fenstermodus

Innerhalb der Testanwendung "touchbook" gelten folgende Tastaturkürzel:
ESC      : Anwendung beenden
F1       : Ein- Ausblenden von erkannten Druckpunkten (Debuganzeige)
F11      : Umschaltung zwischen Vollbild- und Fenstermodus