Home

CitouchW Benutzerhandbuch

1. Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten 37 OCITRON citSetTouchSettings Prototyp Parameter R ckgabe Beschreibung Inquire Prototyp Parameter R ckgabe Beschreibung MouseGetintVect Prototyp Parameter R ckgabe Beschreibung 38 CiTouchW API Referenz der API Funktionen BOOL WINAPI citSetTouchSettings LPTOUCHSETTINGS IpTS LPTOUCHSETTINGS IpTS Zeiger auf eine TOUCHSETTINGS Struktur mit den neuen IRT Parametern TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die IRT Parameter auf die Ubergebene TOUCHSETTINGS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 43 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten WORD WINAPI Inquire LPMOUSEINFO IpMl LPMOUSEINFO IpMI Zeiger auf eine MOUSEINFO Struktur zur Ubernahme der Maustreiberparameter Anzahl der Bytes die in die MOUSEINFO Struktur kopiert wurden Diese Funktion wird von jedem Windows Maustreiber unterst tzt Eine Beschreibung der MOUSEINFO Struktur befindet sich auf Seite 42 WORD WINAPI MouseGetintVect void keine Der von CiTouchW verwendete Interruptvektor Diese Funktion wird von jedem Windows Maustreiber unterst tzt CiTouchW API Referenz der Strukturen Benutzerhandbuch CiTouchW 5 3 Referenz der Strukturen In der Datei CI
2. Der Vorgabewert ist 1046 TimeDown 0 65535 Dieser Eintrag legt die Dauer des Tons der beim Dr cken der Maustaste erzeugt wird in Millisekundenschritten fest Der Vorgabewert ist30 TimeUp 0 65535 Dieser Eintrag legt die Dauer des Tons der beim Loslassen der Maustaste erzeugt wird in Millisekundenschritten fest Der Vorgabewert ist30 51 OCITRON Anhang CTA300 INI 6 2 CTA300 INI In der Datei CTA300 INI speichert die Systemsteuerungs Applikation ihre Parameter Im Folgenden werden die einzelnen Abschnitte und Eintr ge der Datei CTA300 INI in alphabetischer Reihenfolge aufgef hrt Ist ein Eintrag nicht vorhanden wird der in CTAPPLET CPL fest eingespeicherte Vorgabewert verwendet Die folgenden Abschnitte werden in CTA300 INI erkannt Abschnitt Funktion Advanced Einstellungen der Dialogseite Advanced Settings ButtonClick Double Parameter f r Maustastenemulation Dual Touch ButtonClick DoubleExit Parameter f r Maustastenemulation Double Exit ButtonClick Enter Parameter f r Maustastenemulation Enter ButtonClick Exit Parameter fur Maustastenemulation Exit ButtonClick Tap Parameter fur Maustastenemulation Tap ButtonClick Time Parameter fur Maustastenemulation Time ButtonClick TimeTime Parameter f r Maustastenemulation Time Time ButtonClick User1 Parameter f r Maustastenemulation User 1 ButtonClick User2 Parameter f r Maustastenemulation User 2 ButtonClick User3 Para
3. Never Bedingung6 Never 4 1 4 Gl ttung Smoothing Die Aufl sung des IRT im Mode C Kommunikationsprotokoll ist bei Verwendung absoluter Koordinaten nicht ausreichend um jeden Pixel des Bildschirms anzusteuern vielmehr entspricht eine IRT Koordinaten nderung bei einer Bildschirmaufl sung von 640 mal 480 Bildpunkten in etwa 8 Pixel Befindet sich der Ber hrpunkt nun gerade am bergang von einer Koordinate auf die n chste springt der Cursor st ndig einige Pixel hin und her Um diesen st renden Effekt zu vermindern kann hier ein Gl ttungsfaktor eingestellt werden Dabei wird der Mittelwert ber die eingestellte Zahl an IRT Koordinatenmeldungen gebildet Die Anzahl der bei der Mittelwertbildung zu ber cksichtigenden Koordinatenmeldungen kann f r die X und die Y Achse getrennt eingestellt werden CiTouchW Handling Smoothing X Coordinate D NONE Y Coordinate D NONE T Smooth Always Coordinate Skip Count Abbildung 4 9 Dialogseite zur Glattungsfaktoreinstellung Die Bedienelemente dieser Dialogseite lauten im Einzelnen e X Coordinate Gl ttungsfaktor f r die X Koordinate einstellbar von 0 bis 49 e Y Coordinate Glattungsfaktor f r die Y Koordinate einstellbar von 0 bis 49 e Smooth Always Ist dieses K stchen nicht angekreuzt wird mit der Mittelwertbildung nach jeder neuen Unterbrechung des Touchbereichs von neuem begonnen Das bedeutet der Cursor wird zun
4. Ocom _ 5 other Abbildung 4 15 Dialog zum Festlegen der Schnittstellenparameter Die einzelnen Elemente dieser Dialogbox lauten wie folgt e Current Settings Hier werden die gegenwartigen Einstellungen des CiTouchW Treibers angezeigt Die folgenden Texte sind dabei m glich No IRT found an keiner der gefundenen seriellen Schnittstellen wurde ein IRT erkannt IRT probably at port interrupt An der seriellen Schnittstelle mit den angegebenen Parametern wurde ein IRT erkannt Der CiTouchW Treiber ist allerdings nicht initialisiert IRT found port interrupt In der Datei CTW300 INI wurde die angezeigte Eintragung f r die Schnittstellenparameter gefunden Allerdings konnte kein IRT mit diesen Parametern initialisiert werden CiTouchW enabled port interrupt Der CiTouchW Treiber ist initialisiert und an der seriellen Schnittstelle mit den angegeben Parametern befindet sich ein IRT e OK Bei Bet tigung dieser Schaltfl che wrd versucht den CiTouchW Treiber mit den eingestellten Parameters neu zu initialisieren Sollte dies nicht m glich sein wird die Dialogbox nicht geschlossen Andernfalls wird nach R ckfrage Windows neu gestartet 25 e CITRON Konfiguration des CiTouchW Treibers Hardware e Cancel Bei Betatigung dieser Schaltflache werden alle Anderungen verworfen und zum Hauptdialog zur ckgekehrt e Check Bei Betatigung dieser Schaltf
5. chst unmittelbar auf den Ber hrpunkt gesetzt und erst weitere Cursorbewegungen werden gemittelt Ist dieses Kastchen jedoch angekreuzt bleibt der alte Mittelwert nach dem Verlassen des Touchbereichs erhalten Wird der Touchbereich wieder unterbrochen wandert der Cursor ausgehend von seiner alten Position 18 Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW entsprechend dem eingestellten Glattungsfaktor schrittweise zum neuen Ber hrpunkt hin e Coordinate Skip Count In diesem Eingabefeld wird festgelegt wieviel Koordinatenmeldungen des IRT nach dem Unterbrechen des Touchbereichs verworfen werden bevor eine neue Cursorposition gemeldet wird Das Verwerfen der ersten Koordinatenmeldungen ist zum Beispiel dann sinnvoll wenn der IRT in einem gr eren Abstand zur Bildschirmoberfl che angebracht ist Der IRT erkennt in diesem Fall eine g ltige Unterbrechung bevor der Finger die Bildschirmoberfl che ber hrt In der Regel verschiebt sich die Position des Fingers aber auf dem Weg zwischen Unterbrechungserkennung durch den IRT und der Bildschirmoberfl che Der Benutzer erwartet jedoch erst dann eine Ver nderung der Cursorposition wenn er die Bildschirmoberfl che tats chlich ber hrt Durch das Verwerfen der ersten Koordinatenmeldungen kann das erwartete Verhalten des Cursors erzielt werden 4 1 5 Koordinatenmodus Coord Mode Der CiTouchW Treiber kann sowohl mit absoluten als auch mit relativen Koordinaten
6. 3 Installation Bevor mit der Installation begonnen wird mu der IRT an eine serielle Schnittstelle des Rechners angeschlossen werden Dabei ist zu beachten da f r den Betrieb des CiTouchW Treibers unbedingt eine interruptf hige serielle Schnittstelle ben tigt wird Wird eine Citron LDVGA Grafikkarte zusammen mit der LDRI Empf ngerkarte eingesetzt ist ein geeigneter IRT Anschlu bereits ber das Verbindungskabel zur Anzeigeneinheit erfolgt In diesem Fall mu nur noch eine geeignete Basisadresse und ein Interruptkanal f r die SIO1 der LDVGA Karte eingestellt werden Dies erfolgt ber das im LDVGA Handbuch beschrieben Utility LDVINST Die Installation der CiTouchW Software erfolgt vollst ndig unter Windows Zum Start des Installationsvorgangs wird die Installationsdiskette in Laufwerk A oder B eingelegt und im Programmanager unter dem Men punkt Datei gt Ausf hren A SETUP bzw B SETUP eingegeben Nach einer kurzen Wartezeit in der einige Hilfsdateien kopiert und das Zielsystem analysiert wird beginnt der eigentliche Installationsvorgang Dieser l t sich in drei Abschnitte einteilen 1 Kopieren der einzelnen Dateien der CiTouchW Software und Anpassen der SYSTEM INI Datei 2 Einrichten der IRT Hardware 3 Kalibrierung des IRT und Andern der Vorgabeparameter des CiTouchW Treibers Die einzelnen Teile der Installation laufen automatisch in der richtigen Reihenfolge ab Erforderliche Benutzereingaben erfolgen ber Dialogboxen
7. Erzeugung eines Maustastendrucks ist in Kapitel Benutzerdefinierte Tastenemulation auf Seite 16 beschrieben Typ WORD WORD WORD BYTE BYTE BYTE BYTE BYTE BYTE BYTE BYTE Name cmdT1 cmdT2 cmdT3 cmdldleT1 cmdT1 Trigger cmdTriggerT2 cmdT2UpT3 cmdUpT3ldle cmdUpT3 Trigger cmdModeChange cmdReserved1 Beschreibung erste Zeitkonstante in Einheiten von 1 ms zweite Zeitkonstante in Einheiten von 1 ms dritte Zeitkonstante in Einheiten von 1 ms Bedingung 1 Bedingung 2 Bedingung 3 Bedingung 4 Bedingung 5 Bedingung 6 Bedingung f r Wechsel zwischen absoluten und relativen Koordinaten reserviert M gliche Werte f r die Bedingungsbytes sind in der Datei CITOUCHW H als Konstanten mit dem Pr fix BM_ definiert und im Kommentar erl utert F r das Feld cmdModeChange k nnen die Konstanten mit dem Pr fix MC _ verwendet werden 40 CiTouchW API Referenz der Strukturen COORDMODE Benutzerhandbuch CiTouchW Diese Struktur enth lt die Parameter f r die Koordinatenerzeugung Typ BOOL BOOL DIMMING Name cmCoordEnterZ cmCoordSignalZ Beschreibung TRUE Fur die erste Koordinatenmeldung nach dem Eintauchen ist die berschreitung des eingestellten Drucks auf die Frontscheibe erforderlich FALSE Die erste Koordinatenmeldung erfolgt sofort nach dem Eintauchen TRUE F r alle weiteren Koordinatenmeldung ist die berschreitung des eingestellten Drucks auf die Frontscheibe ebenfalls erforderli
8. Maustastenemulationen werden unter Click Mode ausgew hlt Im Folgenden wird jede Emulationsmethode einzeln erl utert Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Vorz ge Nachteile Enter Sobald Koordinaten gemeldet werden wird die emulierte Maustaste gedr ckt Die Taste bleibt so lange gedr ckt bis der Touchbereich wieder verlassen wird keine e Genaues Timing des Maustastendrucks e Einfache Bedienung e Bewegung des Cursors bei gedr ckter Maustaste m glich e Ungenaue Positionierung des Tastendrucks bei Verwendung absoluter Koordinaten e Relative Koordinaten nicht sinnvoll e Geringe Sicherheit gegen Fehlbedienung Exit Sobald der Touchbereich wieder verlassen wird erfolgt ein kurzer Maustastendruck keine e Genaues Timing des Tastendrucks e Einfache Bedienung e Gute Positionierung des Tastendrucks e Relative Koordinaten nicht sinnvoll e Keine Bewegung des Cursors bei gedr ckter Maustaste m glich Tap Wird der Touchbereich verlassen und innerhalb einer einstellbaren Zeit wieder unterbrochen so wird ein Tastendruck emuliert Dieser Vorgang wird als Tap bezeichnet Die Taste bleibt solange gedr ckt bis der Touchbereich erneut verlassen wird Tap Time Zeit innerhalb derer der IRT wieder unterbrochen werden mu um einen Tap zu erzeugen Die Tap Time l t sich in Schritten von 55 ms zwischen 0 ms und 2 s einstel
9. Parameter Anzahl der in die TOUCHHARDWARE Struktur geschriebenen Bytes Es werden die unver nderlichen IRT Parameter die bergebene TOUCHHARDWARE Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 43 WORD WINAPI citGetTouchSettings LPTOUCHSETTINGS IpTS LPTOUCHSETTINGS IpTS 7 Zeiger auf eine TOUCHSETTINGS Struktur zur Ubernahme der ver nderbaren IRT Parameter Anzahl der in die TOUCHSETTINGS Struktur geschriebenen Bytes Es werden die ver nderbaren IRT Parameter in die bergebene TOUCHSETTINGS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 43 CiTouchW API Referenz der API Funktionen citGetVersion Prototyp Parameter R ckgabe Beschreibung citOpen Prototyp Parameter R ckgabe Beschreibung citPlaySound Prototyp Parameter R ckgabe Beschreibung Benutzerhandbuch CiTouchW WORD WINAPI citGetVersion void keine Versionsnummer des CITOUCHW DRV Programms Diese Funktion sollte nicht mehr verwendet werden Satt dessen sollte zur Versionsabfrage die VERSIONINFO Resource des CITOUCHW DRV Treibers gelesen werden Windows bietet dazu zahlreiche Hilfsfunktionen in der VER DLL Library BOOL WINAPI citOpen HWND hWnd WORD wMsg HWND hWnd Handle des Fensters welches die Benachrichtigungsmeldungen erhalten soll oder NULL falls keine Benachrichtigungen verschickt werden sollen WORD wMsg Botschaft die als Benachrichtigung an d
10. Pixeln an Double Click Speed Dieser Rollbalken dient der Einstellung des zeitlichen Abstands innerhalb dessen zwei Maustastendr cke erfolgen m ssen um von Windows als Doppelklick erkannt zu werden Die Zeit kann in Schritten von 16 ms zwischen 100 ms und 900 ms eingestellt werden Window Frame Width Bei Verwendung absoluter Koordinaten kann der Rahmen eines Mouse Trails Fensters meist nicht getroffen werden ber diesen Rollbalken l t sich daher die Rahmenbreite vergr ern Zur Verbesserung der Sichtbarkeit des Cursors bieten die meisten Bildschirmtreiber eine Mausspur an Dabei wird der Cursor nach einer Bewegung nicht sofort gel scht sondern bleibt eine gewisse Zeit an der alten Position sichtbar Durch Anklicken dieses K stchens kann die Option ein und ausgeschaltet werden Ist das K stchen angekreuzt wird ein Rollbalken sichtbar ber den die Anzahl der gleichzeitig sichtbaren Cursor zwischen 1 und 7 eingestellt werden kann 22 Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW 4 1 8 Steuerung der Hintergrundbeleuchtung Backlight Dimming Der IRT besitzt eine Touch Saver Funktion die immer dann aktiviert wird wenn der Touchbereich f r eine bestimmte einstellbare Zeit nicht unterbrochen wurde Ist der Touch Saver aktiv so wird gleichzeitig die Abtastrate der IRT Lichtschranken verringert Daher reagiert der IRT bei aktivem Touch Saver langsamer auf Unterbrechungen des Touchbereichs a
11. Touchbereichs am zweiten Kalibrierpunkt und die Installation der CiTouchW Software ist erfolgreich beendet Anschlie end wird jedoch nicht sofort zum Windows Desktop zur ckgekehrt sondern der Hauptdialog der CiTouchW Konfigurationssoftware ge ffnet Von hier aus k nnen nun wie im Kapitel Handling auf Seite 11 beschrieben weitere Parameter des Treiber den W nschen des Benutzers angepa t werden So kann zum Beispiel eine eventuell mi lungene Kalibrierung durch Druck auf die Calibrations Schaltfl che wiederholt werden 3 4 Probleme w hrend der Installation In diesem Kapitel sind einige Hinweise zur Behebung von Problemen w hrend der Installationsphase der CiTouchW Software zusammengefa t Sollte trotzdem keine korrekte Installation m glich sein so wenden Sie sich bitte an Citron GmbH Anwaltinger Str 14 86165 Augsburg Fax 49 821 74945 0 Tel 99 M gliche Probleme in den einzelnen Phasen der Installation werden in den folgenden Abschnitten einzeln behandelt 3 4 1 Kopierphase Wird die Installation w hrend des Kopierens der CiTouchW Dateien abgebrochen mu der gesamte Vorgang wiederholt werden Nur so kann eine korrekte Installation gew hrleistet werden Sollte Windows nach dem Kopieren der CiTouchW Dateien nicht wieder von alleine starten mu der Rechner von Hand neu gebootet werden Anschlie end sollte der Installationsvorgang wie oben beschrieben weiterlaufen Ist dies nicht der Fall mu die IRT Hardware u
12. Wird eine Lichtschranke des IRT l nger als die hier angegebene Zeit unterbrochen so wird sie als defekt angesehen und von der Koordinatenberechnung ausgeschlossen Hier wird eingestellt wie oft im Falle einer g ltigen Unterbrechung eine neue Koordinatenmeldung des IRT erfolgen soll Hier wird eingestellt wieviele Lichtschranken auf der X Achse unterbrochen sein m ssen damit diese Unterbrechung vom IRT erkannt wird Hier wird eingestellt wieviele Lichtschranken auf der Y Adhse unterbrochen sein m ssen damit diese Unterbrechung vom IRT erkannt wird Hier wird die Baudrate f r die serielle Verbindung zwischen IRT und dem Rechner eingestellt Falls es h ufig zu bertragungsfehlern kommt sollte die Baudrate herabgesetzt werden M gliche Raten sind 1200 2400 4800 9600 und 19200 Baud Falls ein anderer als der PC bliche 1 8432 MHz Quarz zur Erzeugung der Baudrate verwendet wird so mu hier die korrekte Quarzfrequenz in Megahertz eingegeben werden In diesem Feld wird der errechnete Teiler f r die Baudrate angezeigt Dahinter wird in Klammern die prozentuale Abweichung der tats chlichen von der geforderten Baudrate angegeben Ist der Touch Saver aktiv so wird die Abtastrate auf die hier eingestellte Zeit herabgesetzt Konfiguration des CiTouchW Treibers Hardware Benutzerhandbuch CiTouchW 4 2 Hardware Der CiTouchW Treiber ben tigt die in dieser Dialogbox einstellbaren Informationen um eine serielle Verbindung zum IR
13. der Cursorposition umgesetzt sondern der Cursor erscheint immer an derjenigen Stelle an welcher der Bildschirm gerade ber hrt wird Zur Erh hung der Positioniergenauigkeit kann jedoch auch mit relativen Koordinaten gearbeitet werden Die Umschaltung des Koordinatenmodus erfolgt dabei entweder statisch w hrend der Konfiguration oder dynamisch im laufenden Betrieb Dabei wird aufgrund einer speziellen Fingerbewegung z B durch eine Zweifachber hrung der Koordinatenmodus gewechselt Die gr te Herausforderung bei der Emulation einer Maus durch einen Touch ist die Nachbildung der Maustasten Es lassen sich nicht alle Eigenschaften einer Maustaste gleichzeitig und gleich gut nachempfinden Allerdings werden je nach Anwendungsprogramm unterschiedliche Anforderungen gestellt z B exaktes Timing des Tastendrucks hohe Sicherheit gegen Fehlbedienung Drag And Drop F higkeit so da meist bereits ein bestimmter Teilaspekt der Mausfunktion ausreichend f r die Bedienung des jeweiligen Programms ist Die Emulation der Maustasten ist beim CiTouchW in weiten Grenzen durch den Benutzer konfigurier und programmierbar S mtliche Parameter welche die Arbeitsweise des CiTouchW beeinflussen werden zentral ber eine Applikation f r die Windows Systemsteuerung eingestellt Alle Einstellungen lassen sich sowohl w hrend der Installation als auch im laufenden Betrieb ver ndern Installation Kopieren der CiTouchW Dateien Benutzerhandbuch CiTouchW
14. die Z Achse des IRT aus Vorgabewert ist20 SaverScan 1 65535 Dieser Eintrag legt die Abtastrate des IRT bei aktivem Touch Saver fest Die Abtastrate entspricht dem hier angegebenen Wert in Millisekunden Der Vorgabewert ist500 SaverTime 0 65535 49 OCITRON Anhang CTW300 INI Dieser Eintrag bestimmt die Zeit bis zur Aktivierung des Touch Savers Die Aktivierungszeit entspricht dem hier eingetragenen Wert in Sekunden Bei einem Wert von 0 wird der Touch Saver sofort aktiviert Bei einem Wert von 65535 wird der Touch Saver niemals aktiviert Der Vorgabewert ist65535 SmoothAlways Ja Nein Dieser Eintrag legt fest ob die Mittelwertbildung f r absolute Koordinaten auch ber das Verlassen und erneute Unterbrechen des Touchbereichs hinweg erfolgen soll Der Vorgabewert istNein TapTime 0 65535 Dieser Eintrag bestimmt die Zeit innerhalb derer der Touchbereich erneut unterbrochen werden mu um ein Tap Ereignis auszul sen Die Zeit entspricht dem hier angegebenen Wert in Millisekunden Der Vorgabewert ist 220 X_Offset 32768 32767 Dieser Eintrag bestimmt den X Abstand zwischen dem Ber hrpunkt und der tats chlichen Cursorposition Positive Werte verschieben die Cursorposition nach rechts negative Werte nach links Der Vorgabewert ist 0 X_Smoothing 0 dcSmoothMax 1 Dieser Eintrag bestimmt die Anzahl an Koordinatenmeldungen Uber die zur Glattung absoluter X Koordinaten gemittelt wird Die obere Grenze kann mit der Funktioncit
15. email aA r edt EE 44 6 12 Calibration jena ten AE NET ENEE dg 45 EECH T eu Ela e EE 46 6 1 4 lee UE RE 47 Gi SOMUINGS h sees ececaua LEERE a a a a a a a S a a aa FEERESE 48 6 1 6 SOUNG re ite a ee Eed 51 ER EL NL EE 52 6 2 1 Advanced ra itn ee ete tole edit tte hehe 52 6 2 2 Buttonblick 2 22 EE 52 Ke VS E 57 O CITRON Einf hrung Kopieren der CiTouchW Dateien 2 Einf hrung Der CiTouchW Maustreiber Citron Touch Treiber f r Windows erm glicht den Einsatz eines Citron Infrarot Touchs im Folgenden kurz IRT genannt als Mausersatz unter der grafischen Oberfl che Microsoft Windows Es werden alle Eigenschaften des IRT wie z B die Z Achse falls der IRT mit Drucksensoren ausgestattet ist oder Zweifachber hrung unterst tzt Voraussetzung f r den Betrieb des CiTouchW ist Windows Version 3 1 oder h her sowie mindestens ein i386 Prozessor Die Verbindung zwischen IRT und PC erfolgt entweder ber ein Kabel an der seriellen Schnittstelle des PC oder ber das Display Kabel der Citron LDVGA Karte Neben dem IRT ist die gleichzeitige Nutzung einer Paz Bus oder seriellen Maus m glich Der in CiTouchW integrierte Maustreiber bietet hierzu den gleichen Funktionsumfang wie der Standard Windows 3 1 Maustreiber Im Gegensatz zu einer normalen Maus besteht bei CiTouchW die M glichkeit mit absoluten Koordinaten zu arbeiten Dabei wird die Bewegung des Fingers auf der Bildschirmoberfl che nicht in eine relative Anderung
16. ist gew hrleistet da die Hintergrundbeleuchtung eines TFT s im Normalbetrieb niemals ganz ausgeht e Lower Dimming Level Uber diesen Rollbalken wird die Helligkeit der Hintergrundbeleuchtung bei aktivem Touch Saver festgelegt Bei einem Lower Dimming Level unter 165 kann es passieren daB die Hintergrundbeleuchtung nach einiger Zeit ganz erlischt 4 1 9 Erweiterte Einstellungen Advanced Auf dieser Dialogseite kann der IRT f r den verwendeten Rechner optimiert werden Dazu ist allerdings eine genaue Kenntnis der Funktionsweise des IRT wie sie im Handbuch zum IRT vermittelt wird n tig Normalerweise sind keine nderungen dieser Parameter n tig so da die einzelnen Eingabefelder hier nur kurz erl utert werden 23 OCITRON Konfiguration des CiTouchW Treibers Handling CiTouchW Handling Advanced Settings rMin Interrupted Beams X Beams 1 Y Beams 1 Beam Handling Timeout 20 s Report every 22 ms Baud Rate ____ pTouch Saver Scan every 500 ms Rate 9600 baud SIO Quartz 1 8432 MHz Divisor 12 0 0 Abbildung 4 14 Dialogseite f r die erweiterten Einstellm glichkeiten Die Bedienelemente dieser Dialogseite lauten im Einzelnen Beam Handling e Timeout e Report every Min Interrupted Beams e X Beams e Y Beams Baud Rate e Rate e SIO Quartz e Divisor Touch Saver e Scan every 24
17. m ssen vom Anwenderprogramm eingef gt werden CiTouchW API Referenz der API Funktionen citSetAcceleration Prototyp Parameter R ckgabe Beschreibung citSetButtonBeep Prototyp Parameter R ckgabe Beschreibung citSetCalibrationAbs Prototyp Parameter R ckgabe Beschreibung Benutzerhandbuch CiTouchW BOOL WINAPI citSetAcceleration LPACCELERATION IpAC LPACCELERATION IpAC Zeiger auf eine ACCELERATION Struktur mit den neuen Parametern f r die Cursorbeschleunigung TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Parameter f r die Cursorbeschleunigung auf die bergebene ACCELERATION Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 39 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetButtonBeep LPBUTTONBEEP IpBB LPBUTTONBEEP IpBB Zeiger auf eine BUTTONBEEP Struktur mit den neuen Parametern f r die Maustastenklickerzeugung TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Parameter f r die Maustastenklickerzeugung auf die bergebene BUTTONBEEP Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 39 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetCalibrat
18. stellt eine einfach zu handhabende Schnittstelle f r das Senden von Befehlen zum IRT und das Empfangen von Berichten vom IRT zur Verf gung Befehle k nnen jederzeit mit der Funktion citSend gesendet werden Bevor ein Anwenderprogramm jedoch Berichte des IRT empfangen kann mu zuerst der Empfangskanal mittels der FunktioncitOpen ge ffnet werden Ein CiTouchW Treiber mit ge ffnetem Empfangskanal meldet allerdings keine Cursorbewegungen oder Maustastendr cke mehr an Windows Daher darf nach Empfang der gew nschten Berichte ein Aufruf von citClose nicht vergessen werden Es werden stets nur komplette Berichte des IRT an ein Anwenderprogramm bergeben F r das Anwenderprogramm entf llt dadurch der Aufwand f r die Erkennung von Berichtsgrenzen Es k nnen allerdings nur IRT Funktionen verwendet werden die keine Neuinitialiserung des IRT erfordern Insbesondere eine Neuprogrammierung des FLASH Memorys auf dem IRT ist somit nicht m glich F r das Empfangen von IRT Berichten werden zwei Methoden angeboten Polling und Notification Beim Polling mu st ndig ber citReceiveStatus abgefragt werden ob bereits ein kompletter Bericht vom IRT vorliegt Ist dies der Fall so kann der Bericht mit der FunktioncitReceive gelesen werden Bei der Notification wird hingegen an das Anwenderprogramm eine Nachricht gesendet sobald ein kompletter Bericht empfangen wurde Die Nummer dieser Nachricht und das Fenster Handle des Applikationsfensters welches
19. und Rechner automatisch neu angekoppelt werden soll Der Vorgabewert istJa BeamTimeout 0 65535 Dieser Eintrag bestimmt die Ausblendzeit f r defekte Lichtschranken Ist eine Lichtschranke des IRT langer als die hier eingestellte Zeit in Sekunden unterbrochen so wird sie von der Koordinatenberechnung ausgeschlossen Ein Wert von 0 verhindert das Ausblenden der Lichtschranken Der Vorgabewert ist 20 Button 7 3 Dieser Eintrag bestimmt die zu emulierende Maustaste Dabei steht 1 fiir die linke Taste 2 fiir die rechte Taste und 3 f r beide Taste gleichzeitig der Vorgabewert ist1 ButtonClick Ja Nein Dieser Eintrag legt fest ob bei einem Maustastendruck eine akustische R ckmeldung ber den PC Lautsprecher erfolgen soll Der Vorgabewert istJa ContTime 0 65535 Dieser Eintrag bestimmt den Abstand zwischen zwei Koordinatenmeldungen des IRT Der zeitliche Abstand errechnet sich aus dem hier angegebenen Wert in Millisekunden Dabei ist die zur bertragung einer Koordinatenmeldung ben tigte Zeit abh ngig von der Baudrate zu beachten Der Vorgabewert ist 22 CoordEnterZ Ja Nein 48 Anhang CTW300 INI Benutzerhandbuch CiTouchW Dieser Eintrag legt fest ob zur Meldung der ersten Cursorposition nach dem Eintauchen zus tzlich die berschreitung des eingestellten Drucks auf die Frontscheibe n tig ist Dazu mu der IRT allerdings mit einer Z Achse ausger stet sein Der Vorgabewert istNein CoordinateSkip 0 65535 Dieser Eintr
20. von 2 0 bedeutet zum Beispiel da der Cursor den Bildschirmrand bereits erreicht hat w hrend der Finger erst die halbe Strecke zwischen der Beschleunigungsgrenze und dem Bildschirmrand zur ckgelegt hat 21 OCITRON Konfiguration des CiTouchW Treibers Handling 4 1 7 Desktop Einstellungen Desktop Auf dieser Dialogseite lassen sich verschiedene Eigenschaften des Windows Desktop verandern Die Anderungen am Desktop betreffen nicht unmittelbar den CiTouchW Treiber verbessern jedoch die Bedienbarkeit von Windows in Verbindung mit dem CiTouchW Treiber erheblich CiTouchW Handling Desktop Double Click Speed 252 ms Double Click Area a L H Window Frame Width 3 pixel l LI a T Mouse Trails Abbildung 4 12 Dialogseite mit Windows Desktop Einstellungen Double Click Area Die Double Click Area ist derjenige Bereich um den Ort des ersten Maustastendrucks innerhalb dessen ein zweiter Maustastendruck stattfinden mu um von Windows als Doppelklick erkannt zu werden Da es aufgrund der eingeschr nkten Ortsaufl sung des IRT schwierig ist genau die gleiche Stelle innerhalb kurzer Zeit zweimal zu treffen kann ber die beiden Rollbalken die Double Click Area vergr ert werden Das Feld zwischen den Rollbalken zeigt die tats chliche Gr e der Double Click Area grafisch an Die Zahlenangabe innerhalb des Feldes gibt die Gr e der Double Click Area in
21. 12 entsprechend 9600 Baud Interrupt 0 15 Dieser Eintrag bestimmt die Nummer des ISA Bus Interruptkanals der seriellen Schnittstelle Der Vorgabewert ist 0 IO_Base 0 65535 Dieser Eintrag bestimmt die Basisadresse des seriellen Schnittstellenbausteins Der Vorgabewert isi0 47 OCITRON Anhang CTW300 INI IRT_Mode 0 1 2 Dieser Eintrag enth lt das zuletzt vom Treiber detektierte Kommunikationsprotokoll des IRT Dadurch kann der IRT schneller angekoppelt werden Fehlt dieser Eintrag oder enth lt er eine falsche Angabe versucht der CiTouchW Treiber das vorhandene Kommunikationsprotokoll automatisch zu erkennen Es wird die folgende Zuordnung zwischen dem erkannten Protokoll und dem hier angegebenen Zahlenwert verwendet Wert Bedeutung 0 kein Protokoll erkannt 1 Mode C Protokoll 2 CTS1 Protokoll 6 1 5 Settings In diesem Abschnitt sind alle ver nderbaren Betriebsparameter des Treibers und des IRT eingetragen Im Abschnitt Settings sind die folgenden Eintr ge m glich AbsoluteMouse Ja Nein Dieser Eintrag legt fest ob nach der Initialisierung des Treibers mit absoluten oder relativen Koordinaten gearbeitet werden soll Ist im Abschnitt Commands unter dem Eintrag ModeChange ein anderer Wert als 0 angegeben kann der Koordinatenmodus auch dynamisch im laufenden Betrieb gewechselt werden Der Vorgabewert ist Ja AutoReinit Ja Nein Dieser Eintrag legt fest ob nach einer Unterbrechung der Verbindung zwischen IRT
22. CPL 5 CTAPPLET INI 52 CTL3DV2 DLL 5 Current Settings 25 Cursor Control 21 Cursor Offset 21 Cursorbeschleunigung 21 D DblErrSkip 49 55 Default 11 Define User 15 Benutzerhandbuch CiTouchW Desktop 22 DIMMING 41 Divisor 24 Double Click Area 12 Double Click Speed 22 Doubleclick Area 22 DRIVERCONSTANTS 41 DRIVERSETTINGS 41 Drucksensoren 4 Dual Exit 14 Dual Touch 14 17 Dual Touch Skip Count 14 Enable Auto Reinit 26 Enter 13 17 20 EPROM 10 Erweiterte Einstellungen 23 Exit 13 Gl ttung 18 Handling 11 Hardware 9 25 47 Idle_T1 46 IdleT1 53 Immediately 17 Interrupt 26 47 IO Base 47 IRT 4 IRT Hardware 9 IRT Hauptprogramm 9 Koordinatenmodus 19 Leave 17 Left Button 13 Lower Dimming Level 23 Mausspur 22 Maustastenklick 16 Min Interrupted Beams 24 MinXBeams 49 MinYBeams 49 ModeChange 46 Mouse Trails 22 mouse drv 5 MOUSEINFO 42 Move Cursor 20 Name 56 57 OCITRON Never 17 20 No Dual Touch 17 Notensymbol 16 Notification 28 O Options 10 P Polling 28 Pressure 49 Pressure Sensitvity 15 R Rahmenbreite 22 Rate 24 README TXT 5 Report every 24 Rescan 26 Right Button 13 SaverScan 49 SaverTime 49 Scan every 24 Serial Port 26 SERIALHARDWARE 42 Settings 48 51 SETUP 5 SIO Quartz 24 SioQuartz High 52 SioQuartz Low 52 SmoothAlways 50 Smoothing 18 Software 9 10 Steuerung der Hintergrundbeleuchtung 23 SYSTEM INI 5 Systemsteuerung 9 T1 53 T1_Trigger 46 T1T
23. FLASH Memory reserviert Im Mode C Protokoll Optionaler Kommentar 0 terminierter String Im CTS1 Protokoll Seriennummer des IRT 0 terminierter String Diese Struktur enthalt die einstellbaren Parameter des IRT TOUCHHARDWARE Typ Name WORD thBeamsX WORD thBeamsY WORD thResolutionX WORD thResolutionY WORD thProtocol char thDesignator 33 char thAssy 1 7 char thMem BYTE thReserved1 char thComment 257 TOUCHSETTINGS Typ Name WORD tsMinBeamsX WORD tsMinBeamsY WORD tsBeamTimeout WORD tsTCont WORD tsPressLevel WORD tsTSaver WORD tsTScan 5 4 Benachrichtigung durch CiTouchW Beschreibung Minimale Anzahl unterbrochener X Lichtschranken Minimale Anzahl unterbrochener Y Lichtschranken Ausblendzeit f r fehlerhafte Lichtschranken in Einheiten von 1 s Abstand zwischen zwei Koordinatenmeldungen in Einheiten von 1 ms Druckempfindlichkeit Zeit nach welcher der Touch Saver aktiviert wird in Einheiten von 1 s Abstand zwischen zwei Scanvorgangen bei aktivem Touch Saver in Einheiten von 1 ms Wurde beim Aufruf von citOpen als erster Parameter ein g ltiges Fensterhandle bergeben so sendet CiTouchW sobald ein kompletter Bericht des IRT empfangen wurde diesem Fenster eine Benachrichtigung Die Nummer dieser Nachricht wird als zweiter Parameter ancitOpen bergeben z B WM_USER 1 Die Benachrichtigungsparameter sind auf die folgenden Werte gesetzt wParam LOWORD IParam Zustand des Empfangspuffers wie bei c
24. GetDriverConstants angefragt werden Der Vorgabewert ist 10 Y_Offset 32768 32767 Dieser Eintrag bestimmt den Y Abstand zwischen dem Ber hrpunkt und der tats chlichen Cursorposition Positive Werte verschieben die Cursorposition nach unten negative Werte nach oben Der Vorgabewert ist 0 Y_Smoothing 0 dcSmoothMax 1 Dieser Eintrag bestimmt die Anzahl an Koordinatenmeldungen ber die zur Gl ttung absoluter Y Koordinaten gemittelt wird Die obere Grenze kann mit der FunktioncitGetDriverConstants angefragt werden Der Vorgabewert ist 10 50 Anhang CTW300 INI Benutzerhandbuch CiTouchW 6 1 6 Sound In diesem Abschnitt sind die Parameter zum Erzeugen des Maustastenklicks eingetragen Im Abschnitt Sound sind die folgenden Eintr ge m glich ButtonClick 0 1 2 3 Dieser Eintrag legt fest wann ein Ton erzeugt werden soll Dabei kann eine Kombination der folgenden Werte verwendet werden Wert Bedeutung 0 keine Tonerzeugung 1 Tonerzeugung wenn die Maustaste gedr ckt wird 2 Tonerzeugung wenn die Maustaste losgelassen wird 3 Tonerzeugung sowohl beim Dr cken als auch beim Losgelassen der Maustaste Der Vorgabewert ist 1 FreqDown 0 65535 Dieser Eintrag legt die H he des Tons der beim Dr cken der Maustaste erzeugt wird in 1 Hz Schritten fest Der Vorgabewert ist 783 FreqUp 0 65535 Dieser Eintrag legt die H he des Tons der beim Loslassen der Maustaste erzeugt wird in 1 Hz Schritten fest
25. M Zeiger auf eine DIMMING Struktur mit den neuen Parametern f r die Ansteuerung des PWM Ausgangs des IRT TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Parameter f r die Ansteuerung des PWM Ausgangs des IRT auf die bergebene DIMMING Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite41 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetDriverSettings LPDRIVERSETTINGS IpDS LPDRIVERSETTINGS IpDS Zeiger auf eine DRIVERSETTINGS Struktur mit den neuen Treiberparametern TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Treiberparameter auf die bergebene DRIVERSETTINGS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 41 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetSerialHardware LPSERIALHARDWARE IpSH LPSERIALHARDWARE IpSH Zeiger auf eine SERIALHARDWARE StruKur mit den neuen seriellen Schnittstellenparametern TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die seriellen Schnittstellenparameter auf die bergebene SERIALHARDWARE Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 42
26. OCITRON e Industrial Electi CiTouchW Touch Treiber f r Windows V4 0 x Benutzerhandbuch O CITRON Inhalt Kopieren der CiTouchW Dateien Dokumenten Rev Rev Beschreibung 0 Bearb Datum 004 L n Software Version 2 0 000 angepaBt_ tt 08 05 1995 005 006 Neue API Funktionen Neuer Maustastenpieps tt 22 01 1996 009 Uberarbeitung nach bersetzung pk 13 11 1996 Haftungsausschlu Der Inhalt dieses Handbuchs dient nur zu Informationszwecken Die Citron GmbH beh lt sich das Recht vor ohne vorherige Ank ndigung Anderungen am Inhalt dieses Handbuchs vorzunehmen Bei der Erstellung dieses Handbuchs wurde mit gr ter Sorgfalt vorgegangen Trotzdem k nnen Fehler nicht vollkommen ausgeschlossen werden Die Citron GmbH bernimmt deshalb keinerlei Haftung f r fehlende oder fehlerhafte Informationen in diesem Handbuch oder f r Fehler die durch Anwendung der in diesem Handbuch enthaltenen Informationen entstanden sind F r Verbesserungsvorschl ge und Hinweise auf Fehler ist die Citron GmbH dankbar Dieses Handbuch und die zugrundeliegende Software unterliegen dem Urheberrecht Copyright 1994 1997 CITRON GmbH Anwaltinger Str 14 86165 Augsburg Tel 0821 74945 0 FAX 0821 74945 99 ALLE RECHTE VORBEHALTEN Dokumenten Info Dateiname h manuals citouchw ctw_r014 doc Datum 27 04 98 17 53 Dokumenten Rev 4 Dokumenten Vorlage h dformat dot cidoku dot Inhalt Kopieren der CiTouchW D
27. Parameter des CiTouchW Treibers Typ Name WORD dcSmoothMax WORD dcFixedBias WORD dcReportMax WORD dcKeyNum WORD dcKeyMode DRIVERSETTINGS Typ Name WORD dsSmoothX WORD dsSmoothY short dsOfsX short dsOfsY Beschreibung Gl ttungsfaktor f r die X Achse Gl ttungsfaktor f r die Y Achse X Abstand zwischen Ber hrpunkt und Cursorposition Y Abstand zwischen Ber hrpunkt und Cursorposition 41 OCITRON CiTouchW API Referenz der Strukturen Zeit innerhalb derer der Touchbereich erneut unterbrochen werden mu damit ein Tap erkannt wird Die TapTime wird in Einheiten von 55 ms angegeben Anzahl der Koordinatenmeldungen die nach dem Eintauchen verworfen werden bevor eine neue Cursorposition gemeldet wird Anzahl der Zweifachber hrungsmeldungen die verworfen werden bevor eine Zweifachber hrung erkannt wird Nummer der zu emulierenden Maustaste 1 linke Maustaste 2 rechte Maustaste 3 beide Maustasten gleichzeitig TRUE wenn nach einer Unterbrechung der Verbindung zwischen IRT und Rechner automatisch neu angekoppelt werden soll TRUE wenn bei einem Maustastendruck zus tzlich eine akustische R ckmeldung erfolgen soll TRUE wenn absolute Koordinaten verwendet werden sollen TRUE wenn die Koordinatengl ttung auch ber ein Verlassen und erneutes Eintauchen hinweg erfolgen soll Diese Struktur enth lt globale Parameter eines Windows Maustreibers Beschreibung Ungleich Null falls eine Maus existiert Ungl
28. S1 protocol SysMgr 1 00 002 Hardware 1 00 004 Process Protocol HWParam Z Touch detected FLASH memory detected Options Calibrations Hardware Close Abbildung 4 2 Hauptdialoge mit Versionsanzeige links Mode C rechts CTS1 In den ersten Zeilen werden die Versionsnummern des CITOUCHW DRV Treiberprogramms der CTAPPLET CPL Systemsteuerungsapplikation angezeigt Darunter befindet sich eine Box mit Informationen zum angeschlossenen IRT Die angezeigten Informationen sind abh ngig vom Kommunikationsprotokoll des angeschlossenen IRT Genaue Bezeichnung der IRT Hardware Dahinter ist in Klammern die Anzahl der vorhandenen X und Y Lichtschranken angegeben Falls der IRT das CTS1 Kommunikationsprotokoll unterst tzt wird zus tzlich die Seriennummer des IRT angezeigt e Touch e Running Mode C Protocol Boot Bezeichnung Erstellungsdatum JJ MM TT und Uhrzeit HH MM des IRT Bootprogramms Software Bezeichnung Erstellungsdatum JJ MM TT und Uhrzeit HH MM des IRT Hauptprogramms e Running CTS1 Protocol SysMgr Versionsnummer Erstellungsdatum TT MM JJJJ und Uhrzeit HH MM des Systemmanager Moduls Hardware Versionsnummer Erstellungsdatum TT MM JJJJ und Uhrzeit HH MM des Hardware Moduls Process Versionsnummer Erstellungsdatum TT MM JJJJ und Uhrzeit HH MM des Process Moduls 9 O CITRON Konfiguration des CiTouchW Treibers Probleme w hrend d
29. T herzustellen Es ist auch nach einer erfolgreichen Installation jederzeit m glich die Schnittstellenparameter zu ndern Allerdings mu nach einer nderung der Parameter zur Neuinitialisierung des Treibers Windows neu gestartet werden Das Programm versucht alle im Rechner installierten seriellen Schnittstellen automatisch zu erkennen Dazu wird zun chst der BIOS Datenbereich ausgewertet Dadurch k nnen bis zu 4 Schnittstellen erkannt werden Allerdings sind dort keine Angaben ber den zugeordneten Interrupt vorhanden so da von den PC blichen Einstellungen ausgegangen werden mu COM1 0x3f8 Interrupt 4 COM2 0x2f8 Interrupt 3 COMS 0x3e8 kein Interrupt COM4 0x2e8 kein Interrupt Anschlie end wird der Inhalt der Datei SYSTEM INI auf Konfigurationsdaten f r serielle Schnittstellen untersucht Hierdurch kann sowohl die Basisadresse als auch der zugeordnete Interrupt festgestellt werden Die so gewonnenen Informationen ber die vorhandenen seriellen Schnittstellen werden dem Benutzer in vier Eingabefeldergruppen angeboten Sollte eine serielle Schnittstelle nicht erkannt werden oder die automatische Interrupt Zuordnung nicht stimmen so m ssen die richtigen Parameter von Hand in die Eingabefelder eingetragen werden CiTouchW Hardware Setup Current settings CiTouchW enabled port 0x02F8 interrupt 3 Auto Reinit rSerial Ports Base Adr Interrupt COM1 0x03F8 4 COM2 0x02F8 3 O COM3 Fa
30. TOUCHW H sind zahlreiche Strukturen zur Parameter bergabe an die API Funktionen definiert Es folgt eine alphabetische Auflistung dieser Strukturen ACCELERATION Diese Struktur enth lt die Parameter f r die Cursorbeschleunigung Typ Name Beschreibung short acMulX Beschleunigungsfaktor f r X Koordinaten short acMulY Beschleunigungsfaktor f r Y Koordinaten WORD acBorderX Breite des Beschleunigungsbereichs in Touch Koord WORD acBorderY H he des Beschleunigungsbereichs in Touch Koord Die Gr en acMulX und acMulY sind vorzeichenbehaftete Festkommazahlen Ihr Wertebereich wird Uber die Formeln 32767 dcFixedBias acMulX max caMulX 32767 dcFixedBias acMulY ax caMulY berechnet Der Skalierungsfaktor dcFixedBias f r die Festkommazahlen kann mittels citGetDriverConstants und caMulX bzw caMulY mittels citGetCalibrationAbs abgefragt werden Die Gr en acBorderX und acBorderY werden in Touch Koordinaten angegeben Der Wertebereich betr gt acBorderX max 32767 acBorderY nax 32767 BUTTONBEEP Diese Struktur enth lt die Parameter f r die Maustastenklickerzeugung Typ Name Beschreibung WORD bbFreqDown Frequenz des Tones beim Niederdr cken der Maustaste in Hertz Hz WORD bbTimeDown Dauer des Tones beim Niederdr cken der Maustaste in Millisekunden ms WORD bbFreqUp Frequenz des Tones beim Loslassen der Maustaste in Hertz Hz WORD bbTimeUp Dauer des Tones beim Loslassen der Maustaste in Milli
31. W hrend der Installation wird Windows mehrmals neu gestartet Es wird daher empfohlen s mtliche Anwendungen insbesondere offene DOS Boxen vor der Installation der CiTouchW Software zu schlie en 3 1 Kopieren der CiTouchW Dateien Die CiTouchW Software besteht aus den folgenden Dateien CITOUCHW DRV Der eigentliche Windows Maustreiber CTAPPLET CPL Applikation f r die Systemsteuerung zur Einstellung der CiTouchW Parameter CVMD 386 32 bit Teil des CiTouchW Treibers CTL38DV2 DLL DLL f r die 3D Effekte der CTAPPLET Dialogboxen README TXT Textdatei mit den neuesten Anderungen an CITOUCHW DRV und CTAPPLET CPL Alle Dateien mit Ausnahme von README TXTwerden ins Windows Systemverzeichnis z B C WINDOWS SYSTEM kopiert Bei Netzwerkversionen von Windows wird die Datei CTL3DV2 DLL allerdings ins Windows Verzeichnis selbst kopiert Sind bereits Teile der CiTouchW Software auf dem Zielrechner vorhanden so erfolgt eine Anfrage an den Benutzer ob die gegenw rtig installierte Version beibehalten oder ob die neue Version von der Installationsdiskette kopiert werden soll Bereits installierte neuere Dateiversionen insbesondere von CTL3DV2 DLL sollten dabei nicht leichtfertig berschrieben werden Sind alle Dateien erfolgreich kopiert wird die Datei SYSTEM INlangepa t Dazu werden die folgenden Eintr ge ge ndert boot mouse drv citouchw drv boot description mouse drv CiTouchW V4 0 001 386Enh mouse cvmd 386 Die alten Eintr g
32. abens gekennzeichnet Die Funktion wird dann durch gleichzeitiges Dr cken der ALT Taste und der Abk rzungstaste aktiviert Mit der ESC Taste werden nderungen verworfen mit der Eingabetaste wird die Funktion der dick umrahmten Schaltfl che Default Button ausgel st 10 Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW 4 1 Handling F r die komfortable Handhabung des CiTouchW Treibers gibt es zahlreiche einstellbare Parameter Da es nicht m glich ist s mtliche Parameter auf einem 640x480 Bildpunkte gro em Bildschirm darzustellen ist diese Dialogbox in einzelne Seiten unterteilt Allen Seiten gemeinsam ist der unten dargestellte Teil der Dialogbox Category Smoothing Coord Mode Cursor Control Desktop Backlight Dimming Advanced Cancel Default Test Abbildung 4 3 Gemeinsame Bedienelemente der Handling Dialogseiten Im Category Listenfenster werden die einzelnen Dialogseiten ausgew hlt e Click Mode Hier wird die Maustastenemulation konfiguriert e Smoothing Hier werden die Glattungsfaktoren fiir die Koordinatenberechnung eingestellt e Coord Mode Hier wird die Art der Koordinatenberechnung und die Umschaltung zwischen absoluten und relativen Koordinaten eingestellt e Cursor Control Hier wird die Cursorposition relativ zum Ber hrpunkt und die Cursorbeschleunigung eingestellt e Desktop Hier werden verschiedene Parameter des Windows Desktop geandert e Backlight Dimmin
33. ag bestimmt die Anzahl von Koordinatenmeldungen des IRT die nach den Eintauchen ignoriert werden sollen Der Vorgabewert ist 1 CoordSignalZ Ja Nein Dieser Eintrag legt fest ob zur Meldung der weiterer Cursorposition nach dem Eintauchen zus tzlich die berschreitung des eingestellten Drucks auf die Frontscheibe n tig ist Dazu mu der IRT allerdings mit einer Z Achse ausger stet sein Der Vorgabewert istNein DbIErrSkip 0 65535 Dieser Eintrag bestimmt die Anzahl von Zweifachber hrungsmeldungen des IRT die ignoriert werden sollen bevor eine Zweifachber hrung erkannt wird Der Vorgabewert ist1 DimmingHigh 0 255 Dieser Eintrag bestimmt das Puls Pausenverh ltnis des IRT PWM Ausgangs bei inaktivem Touch Saver Der Vorgabewert ist 0 DimmingLow 0 255 Dieser Eintrag bestimmt das Puls Pausenverh ltnis des IRT PWM Ausgangs bei aktivem Touch Saver Der Vorgabewert ist 0 MinXBeams 7 5 Dieser Eintrag bestimmt die Anzahl nebeneinanderliegender X Lichtschranken des IRT die gleichzeitig unterbrochen werden m ssen um als Ber hrung erkannt zu werden Der Vorgabewert ist1 MinYBeams 1 5 Dieser Eintrag bestimmt die Anzahl nebeneinanderliegender Y Lichtschranken des IRT die gleichzeitig unterbrochen werden m ssen um als Ber hrung erkannt zu werden Der Vorgabewert ist1 Pressure 0 255 Dieser Eintrag bestimmt den Druck auf die Frontscheibe der n tig ist um die druckgesteuerten Ereignisse des Treibers auszul sen Der Wert 0 schaltet
34. ameter unter dem Punkt 5 other eingetragen werden Die Parameter f r die restlichen COM Ports m ssen trotzdem stimmen 26 CiTouchW API bersicht der API Funktionen 5 CiTouchW API Der CiTouchW Treiber bietet neben seiner Funktion als Maustreiber zus tzlich eine Schnittstelle f r Anwenderprogramme an Sie erlaubt sowohl die Einstellung aller Treibereinstellungen als auch eine direkten Zugriff auf den IRT Benutzerhandbuch CiTouchW Um die CiTouchW API in eigenen Programmen verwenden zu k nnen mu die Datei CITOUCHW LIB hinzugelinkt und die Headerdatei CITOUCHW H in das Programm eingebunden werden Diese beiden Dateien befinden sich auf der Installationsdiskette im Unterverzeichnis APT 5 1 bersicht der API Funktionen Es folgt eine Kurz bersicht aller CiTouchW API Funktionen zusammengefa t nach Funktionsgruppen 5 1 1 Abfrage von CiTouchW Parametern Mit diesen Befehlen lassen sich s mtliche Konfigurationsparameter des CiTouchW Treibers auslesen Befehl citGetAcceleration citGetButtonBeep citGetCalibrationAbs citGetCalibrationRel citGetCommands citGetCoordMode citGetDimming citGetDriverConstants citGetDriverSettings citGetFlags citGetSerialHardware citGetTouchHardware citGetTouchSettings citGetVersion Inquire MouseGetintVect Zuruckgelieferte Daten Parameter f r die Cursorbeschleunigung Parameter f r Maustastenklicks Kalibrierungsparameter f r absolute Koordinaten Kalibrierungsparameter f r re
35. arbeiten Werden absolute Koordinaten verwendet springt der Cursor direkt an die Stelle der Unterbrechung des Touchbereichs Bei Verwendung relativer Koordinaten bewegt sich der Cursor dagegen immer relativ zu seiner aktuellen Position weiter Die Richtung der Bewegung entspricht dabei der Richtung des sich bewegenden Unterbrechungspunktes Da die zur ckgelegte Strecke geringer ausfallen kann als es der Fingerbewegung entspricht l t sich eine Ortsaufl sung erreichen die der einer konventionellen Maus entspricht Es ist m glich im laufenden Betrieb zwischen den verschiedenen Koordinatenmodi zu wechseln Auf welches Ereignis hin dies geschehen soll l t sich in der Rubrik Mode Switch festlegen Je nach gew hltem Ereignis erscheint rechts neben der Box ein Rollbalken ber den sich der zugeh rige Parameter z B die Tap Time einstellen l t CiTouchW Handling Coordinate Mode rMove Cursor Relative Mode X Speed Enter a al Z Press Enter Relative Mode Y Speed O Z Press D al SLOW TAST rAbs Rel Switch Initially Use Relative Coordinates Never Tap Dual Touch O Z Press Abbildung 4 10 Dialogseite zur Koordinatenmoduseinstellung Die Bedienelemente dieser Dialogseite lauten im Einzelnen e Relative Mode X Speed ber diesen Rollbalken wird die horizontale Geschwindigkeit des Cursors bei Verwendung relativer Koordinaten eingestellt Pos
36. as Fenster gesendet werden soll TRUE falls der Empfangskanal ge ffnet werden konnte FALSE falls der Empfangskanal nicht ge ffnet werden konnte M gliche Gr nde hierf r sind ein bereits ge ffneter Empfangskanal oder ein nicht initialisierter Treiber Bevor ein Anwenderprogramm Berichte des IRT empfangen kann mu zuerst der Empfangskanal ge ffnet werden Ein CiTouchW Treiber mit ge ffnetem Empfangskanal meldet allerdings keine Cursorbewegungen oder Maustastendr cke mehr Daher darf nach Empfang der gew nschten Berichte ein Aufruf voncitClose nicht vergessen werden void WINAPI citPlaySound WORD frequency WORD duration WORD frequency Tonh he in Hertz Hz WORD duration Dauer in Millisekunden ms keine Diese Funktion gibt einen Ton mit der gew nschten H he und Dauer auf dem PC Lautsprecher aus Die Funktion kehrt zur ck sobald die Tonausgabe gestartet wurde Der Rechner wird daher nicht f r die gesamte Dauer der Tonausgabe blockiert 33 OCITRON citReceive Prototyp Parameter R ckgabe Beschreibung citReceiveStatus Prototyp Parameter R ckgabe Beschreibung citReloadlni Prototyp Parameter R ckgabe Beschreibung citSend Prototyp Parameter R ckgabe Beschreibung 34 CiTouchW API Referenz der API Funktionen WORD WINAPI citReceive LPBYTE IpBuffer LPBYTE lpBuffer Zeiger auf einen Puffer in welchen der empfangene Bericht kopiert wird Zustand
37. ateien Benutzerhandbuch CiTouchW 1 Inhalt cl Otter eet Ee E Er STRETCH ERS 3 2 EiNf hfung WEE 4 2 Installation EE 5 3 1 Kopieren der C7TouchwW Dateien 5 3 2 Einrichten der IT Hardware 6 3 9 Kalibrierung des H EE 6 3 4 Probleme w hrend der Installation 7 EE Meel EE H 3 4 2 Einrichten der IT Harchware eee e etter eee tea ceca aaaeaaeeeeeeeeeeeeeeeeeeteeeeeeesasaaaaeeaees 8 374 3 Temporare Date le ET 8 4 Konfiguration des Couch Treibers tae ee aaa eee eeeeee eter ete nn 9 AsV erte in e EE 11 4 1 1 Tastenmodus Click Model 12 KS EE 16 4 1 3 Benutzerdefinierte Tastenemulaton 16 4 1 4 Glattung SMOOthing EE 18 4 1 5 Koordinatenmodus Coord Mode 19 4 1 6 Cursor Beeinflussung Cursor Control 21 4 1 7 Desktop Einstellungen Desktop 22 4 1 8 Steuerung der Hintergrundbeleuchtung Backlight Dimmimg nenne 23 4 1 9 Erweiterte Einstellungen chance 23 4 2 TEE 25 S C1TOUCHWSAP EE 27 5 1 bersicht der Ab Funkttonen aa aa ea a a aa EEE A A ia 27 5 1 1 Abfrage von CITouchW Parametem nn 27 5 1 2 Ver ndern von CITouchW Parametem nnl 27 5 1 3 Kommunikation mit dem IT 28 5 1 4 Allgemeine Hilfsfunktionen eeesssessesssessseeresssssesssesrrrrrrrnrnsssnntssenrnrtnnntsnnssssetastnnennnennnenssent 28 5 2 Referenz der AP Funktonen ennnen 28 5 3 Referenz der Girkturen srein riina na aa a aaa a T aaa E EE Taa Ea aa 39 5 4 Benachrichtigung durch C Touchww 43 6 AN hang EE 44 Gl GT WSOO IN IT 44 6 1 1 AcCeleration s s nH2
38. ch FALSE F r weitere Koordinatenmeldungen gen gt es da der Touchbereich unterbrochen bleibt Diese Struktur enth lt die Parameter f r die Ansteuerung des PWM Ausgangs des IRT Typ WORD WORD BOOL Name bIDimmingHigh bIDimmingLow blSaverActive Beschreibung Puls Pausenverh ltnis bei inaktivem Touch Saver Puls Pausenverhaltnis bei aktivem Touch Saver TRUE bei aktivem Touch Saver Der Wertebereich f r b DimmingHigh bzw bIDimmingLow reicht von 0 bis 255 Sind beide Werte gleich 0 so wird das Puls Pausenverh ltnis unabh ngig vom Zustand des Touch Savers auf den Maximalwert eingestellt Die Aktivierungszeit des Touch Savers wird UbercitSetTouchSettings festgelegt Der bISaverActive Wert wird von der Funktion citGetDimming gesetzt Die Funktion citSetDimming ignoriert diesen Parameter Der Touch Saver kann hier ber nicht ein oder ausgeschaltet werden DRIVERCONSTANTS Diese Struktur enth lt die unver nderlichen Parameter des CiTouchW Treibers Beschreibung Obere Grenze f r die Gl ttungsfaktoren Gl ttungsfaktoren m ssen kleiner als der hier angegebene Wert sein Skalierungsfaktor f r das Festkommaformat zur Kalibrierung absoluter Koordinaten Maximale L nge des Puffers f r empfangene IRT Berichte Der IRT wird im Tastenmodus betrieben wobei eine einzige Taste mit der hier angegebenen Nummer definiert wird Betriebsart der Taste im Mode C Protokoll Diese Struktur enth lt die einstellbaren
39. d ber die beiden Schaltfl chen mit den Pfeilsymbolen im Bereich 0 bis 5 eingestellt Die Tonh he variiert zwischen 130 Hz und 8372 Hz Die Tondauer wird ber den Schieberegler mit der Bezeichnung Duration eingestellt Die k rzeste Tondauer betr gt 10 ms die l ngste Dauer 577 ms Die Einstellung erfolgt in 10 Stufen mit logarithmischer Einteilung Beim Ausw hlen eines Notensymbols wird der zugeh rige Ton angespielt sobald die Maustaste losgelassen wird Deshalb werden keine regul ren Maustastenklicks erzeugt w hrend dieser Dialog dargestellt wird Ob berhaupt ein Maustastenklick erzeugt werden soll wird ber die Kastchen Beep on Button Down Events f r das Dr cken der Maustaste und Beep on Button Up Events f r das Loslassen der Maustaste getrennt eingestellt Die neuen Einstellungen werden erst dann eingestellt wenn auch der Handling Dialog mit OK beendet wird Zum Austesten der neuen Maustastenklicks kann der oben beschriebene Testmodus verwendet werden 4 1 3 Benutzerdefinierte Tastenemulation Im CiTouchW Treiber werden Maustastenereignisse von der sogenannten Button Machine erzeugt Dabei handelt es sich um einen programmierbaren asynchronen Zustandsautomaten Der bergang von einem Zustand zum n chsten erfolgt sobald alle angegebenen Bedingungen zutreffen In der Dialogbox zur Programmierung der benutzerdefinierten Tastenemulation ist das vereinfachte Zustands Ubergangs Diagramm dieses Zustandsautomaten dargest
40. d sofort ein e Enter Es werden Koordinaten an Windows gemeldet e Z Press Der eingestellte Druck wurde Uberschritten e Dual Touch Es wurde eine Zweifachber hrung festgestellt e Tap Ein Tap wurde erkannt e Leave Es werden keine Koordinaten mehr gemeldet e Z Release Der eingestellte Druck wurde unterschritten e No Dual Touch Es werden keine Zweifachber hrungen mehr gemeldet Das genaue Zustands Ubergangs Diagramm der Button Machine ist inAbbildung 4 8 dargestellt Button Down Bedingung1 Bedingung1v Mausbewegung Bedingung2A t 0 Bedingung3 Bedingung3 Bedingung4v t 0 Bedingung5v t 0 Bedingung6 Abbildung 4 8 Zustandsautomat zur Maustastenemulation 17 e CITRON Konfiguration des CiTouchW Treibers Handling Der Tastenemulationsmodus Time ist zum Beispiel folgendermaBen programmiert T1 550 ms T2 0ms T3 550 ms Bedingung1 Enter Bedingung2 Enter Bedingung3 Leave Bedingung4 Never Bedingung5 Never Bedingung6 Enter Ein weiteres Beispiel w re ein neuer Emulationsmodus mit Namen Z Press Exit Dabei erfolgt hnlich dem Modus Dual Exit das Loslassen der Maustaste nicht bereits beim Unterschreiten eines Drucks sondern erst nachdem der Touchbereich vollst ndig verlassen wird Die Parameter hierf r lauten T1 0ms T2 0ms T3 0ms Bedingung1 Enter Bedingung2 Z Press Bedingung3 Leave Bedingung4 Never Bedingung5
41. der seriellen Schnittstelle von Hand eingetragen werden Weitere Hilfe zu diesem Fall findet sich in Kapitel Probleme w hrend der Installation auf Seite 7 Da eine korrekte Zuordnung von COM Ports zu Basisadressen und Interruptkan len f r den zufriedenstellenden Betrieb des CiTouchW Treibers unbedingt erforderlich ist m ssen alle im Rechner vorhandenen COM Ports in die entsprechenden Felder der Dialogbox eingetragen werden Eine genaue Beschreibung der Dialogbox ist in Kapitel Hardware auf Seite 25 gegeben Kann mit den gegebenen Parametern ein IRT initialisiert werden erfolgt falls erforderlich ein Neustart von Windows 3 3 Kalibrierung des IRT Zum Abschlu der Installation ist noch eine Kalibrierung der CiTouchW Software notwendig Dadurch ist der Treiber unabh ngig von der Einbauposition des IRT gegen ber dem Display Das notwendige Kalibrierfenster wird nach dem erneuten Hochfahren von Windows automatisch angezeigt Hilfetext Abbildung 3 2 Kalibrierung im Flat Panel Mode Das Kalibrierfenster belegt den gesamten Bildschirm In seiner Mitte erscheint ein Hilfetext und in der linken oberen Ecke ist ein Cursorsymbol zu erkennen Der Touchbereich mu in etwa an der Stelle des Cursorsymbols unterbrochen werden Nachdem der Finger den Touchbereich wieder verlassen hat verschwindet das Cursorsymbol und erscheint in der rechten unteren Ecke wieder Dort mu es ebenfalls mit dem Finger ber hrt werden Beim Ber hren und Verlas
42. des Empfangspuffers Wurde ein kompletter Bericht vom IRT empfangen so kann er mit dieser Funktion ausgelesen werden Falls kein Bericht vorliegt wird nicht gewartet sondern mit einem entsprechenden Zustandscode sofort zur ckgekehrt Die maximal erforderliche Gr e f r den Empfangspuffer kann mit der Funktion citGetDriverConstants angefragt werden M gliche R ckgabewerte sind in der Datei CITOUCHW H als Konstanten mit dem Pr fix CRS_ definiert und im Kommentar erl utert Berichte im CTS1 Protkoll sind bereits dekodiert d h sie enthalten keine DC2 DC4 und SYN Sequenzen mehr WORD WINAPI citReceiveStatus void keine Zustand des Empfangspuffers Es wird der momentane Zustand des Empfangspuffers ermittelt M gliche R ckgabewerte sind in der Datei CITOUCHW H als Konstanten mit dem Pr fix CRS_ definiert und im Kommentar erl utert BOOL WINAPI citReloadlni void keine TRUE falls der Treiber neu initialisiert werden konnte FALSE falls der Treiber nicht initialisiert werden konnte Die Datei CTW300 INI wird neu eingelesen und der CiTouchW Treiber komplett neu initialisiert void WINAPI citSend BYTE byData BYTE byData Datenbyte welches zum IRT gesendet werden soll keine Es wird ein Byte zum IRT gesendet Falls der Sendepuffer des Schnittstellenbausteins nicht leer sein sollte wird solange gewartet bis dieser leer ist Befehle im CTS1 Protokoll m ssen bereits kodiert sein d h die DC2 DC4 und SYN Sequenzen
43. die Nachricht empfangen soll legt der Benutzer beim Aufruf dercitOpen Funktion fest Der Aufbau der Benachrichtigung ist auf Seite43 beschrieben Wird ein weiterer Bericht vom IRT empfangen obwohl der Empfangspuffer noch nicht ausgelesen wurde wird der neu empfangene Bericht verworfen Auf diese Weise ist sichergestellt da ein explizit angeforderter Bericht nicht von nachfolgenden Koordinatenmeldungen des IRT berschrieben werden kann M gliche Befehle f r den IRT und der Aufbau von IRT Berichten unterscheiden sich im Mode C Kommunikationsprotokoll und im CTS1 Protokoll Die jeweils g ltigen Befehle sind im Handbuch zum IRT erl utert Befehl Funktion Seite citCheckBreak Pr ft eine serielle Schnittstelle auf 100ms Breaks 29 citClose Schlie t den Empfangskanal 29 citOpen Offnet dem Empfangskanal vom IRT zum Rechner 33 citReceive Empfangt einen kompletten Bericht vom IRT 34 citReceiveStatus Ermittelt den Zustand des Empfangskanals 34 citSend Sendet ein Byte zum IRT 34 5 1 4 Allgemeine Hilfsfunktionen Der CiTouchW Treiber stellt neben den f r die Mausemulation ben tigten Schnittstellen auch noch einige n tzliche Zusatzfunktionen zur Verf gung Befehl Funktion Seite citDetectLDVGA Pr ft ob eine LDVGA Karte vorhanden ist 29 citPlaySound Gibt einen Ton auf dem PC Lautsprecher aus 33 5 2 Referenz der API Funktionen Im folgenden wird der Aufbau eines Referenzeintrags beispielhaft erl utert Beispiel Prototyp Funktionsprot
44. e werden nicht gel scht sondern lediglich auskommentiert so da alle nderungen ohne Schwierigkeiten r ckg ngig gemacht werden k nnen War bereits eine fr here Version des CiTouchW Treibers auf dem Zielrechner installiert werden einige Eintr ge der vorhandenen CITOUCHW INI in die neue CTW300 INI bertragen Um welche Eintr ge es sich dabei handelt ist in der Datei README TXT auf der Installationsdiskette beschrieben Nachdem SYSTEM INI ge ndert wurde mu Windows neu gestartet werden Dies erfolgt nach einer Sicherheitsabfrage automatisch O CITRON Installation Einrichten der IRT Hardware 3 2 Einrichten der IRT Hardware Ist Windows wieder hochgefahren wird vom Installationsprogramm die Systemsteuerung mit dem CiTouchW Hardware Setup gestartet In dieser Dialogbox werden die Basisadresse und die ISA Bus Interruptnummer der seriellen Schnittstellenkarte an welche der IRT angeschlossen ist eingetragen CiTouchY Hardware Setup Current settings CiTouchW enabled port 0x02F8 interrupt 3 rSerial Ports Base Ad Interrupt Joose ao com2 nn 3 mg COMI COM3 COM4 OS other Abbildung 3 1 Hardware Dialog Ein korrekt angeschlossener IRT wird automatisch erkannt so da im Normalfall die Vorgabewerte durch einen Druck auf die Eingabetaste bernommen werden k nnen Erscheint unter Current settings jedoch der Text No IRT found so m ssen die Parameter
45. eTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress WOOONNN_NNND T1 0 65535 Dieser Eintrag enth lt die Zeitkonstante f r den Zustand T1 Die Zeit entspricht dem hier angegeben Wert in Millisekunden Die Vorgabewerte lauten Abschnitt Vorgabewert f r T1 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress ooooo20000 oo oo T1Trigger 0 8 Dieser Eintrag enth lt die Bedingung f r den bergang vom Zustand T1 in den Zustand TRIGGER Die Vorgabewerte lauten Abschnitt Vorgabewert f r T1Trigger ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress OO OO OOhMhMO Oz AA 53 OCITRON Anhang CTA300 INI T2 0 65535 Dieser Eintrag enthalt die Zeitkonstante fur den Zustand T2 Die Zeit entspricht dem hier angegeben Wert in Millisekunden Die Vorgabewerte lauten Abschnitt Vorgabewert f r T2 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPres
46. eich Null falls relative Koordinaten gemeldet werden Anzahl der Maustasten maximale Anzahl von Interrupts pro Sekunde X Schwelle fur Mausbeschleunigung Y Schwelle fur Mausbeschleunigung X Aufl sung der Maus Y Aufl sung der Maus Von Maus benutzte serielle Schnittstelle Diese Struktur enth lt die Parameter der seriellen Schnittstelle WORD dsTapTime WORD dsCoordSkip WORD dsDberrSkip WORD dsButtonNum BOOL dsAutolnit BOOL dsButtonClick BOOL dsAbsolute BOOL dsSmoothAlways MOUSEINFO Typ Name BYTE msExists BYTE msRelative WORD msNumButtons WORD msRate WORD msXThresh WORD msYThresh WORD msXRes WORD msYRes WORD msMouseComPort SERIALHARDWARE Typ Name WORD shPort short shinterrupt WORD shBaudDiv 42 Beschreibung Basisadresse des seriellen Schnittstellenbausteins Zugeh riger ISA Bus Interruptkanal Teiler f r die Baudrate CiTouchW API Benachrichtigung durch CiTouchW Benutzerhandbuch CiTouchW Diese Struktur enthalt die unveranderlichen Parameter des IRT Beschreibung Anzahl der physikalisch vorhandenen X Lichtschranken Anzahl der physikalisch vorhandenen Y Lichtschranken Maximale vom IRT gelieferte X Koorinate Maximale vom IRT gelieferte Y Koorinate Vom IRT verwendetes Kommunikationsprotokoll Dieses Feld kann einen der durch die TP_ Konstanten definierten Werte annehmen Bezeichnung des IRT 0 terminierter String ASSY Nummer des IRT 0 terminierter String E EPROM F
47. ellt Nach der Initialisierung des Treibers befindet sich die Button Machine im Zustand IDLE Alle Maustasten sind im losgelassenen Zustand Die Zust nde werden in Pfeilrichtung durchlaufen Mit den Listenfenstern wird die Bedingung f r einen bergang in den Folgezustand festgelegt In den Zust nden T1 T2 und T3 kann eine Zeit eingestellt werden nach deren Ablauf der jeweilige Zustand verlassen wird F r den Zustand T1 mu dazu gleichzeitig die in dem in Pfeilrichtung folgenden Listenfenster angegebene Bedingung erf llt sein Dagegen ist in den Zust nden T2 und T3 entweder die angegebene Bedingung oder ein Ablaufen der eingestellten Zeit ausreichend um in den Folgezustand zu wechseln 16 Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW Beim Eintreten in den Zustand TRIGGER wird ein Maustastendruck emuliert Beim Ubergang in den Zustand T3 wird die Maustaste wieder losgel assen User Defined Mode 1 Name GREEN Never B E Button Up T gt T2 or Never T gt T3 or Enter T gt T1 and Button Down Tap Time Pressure Sensivity Dual Touch Skip Count Leave Z Press Cancel Abbildung 4 7 Dialog zum Programmieren der benutzerdefinierte Maustastenemulation M gliche Bedingungen f r Zustands berg nge sind e Never Diese Bedingung tritt niemals ein e Immediately Diese Bedingung tritt immer un
48. em Desktop dargestellt 4 1 1 Tastenmodus Click Mode Die erste Dialogseite dient der Konfiguration der Maustastenemulation Es gibt eine Reihe vordefinierter und drei benutzerdefinierbare Tastenemulationen In der rechten oberen Ecke der Box wird die gerade aktuelle Emulation grafisch dargestellt Je nach gew hltem Emulationsmous erscheinen die ben tigten Rollbalken und Schaltfl chen im rechten unteren Bereich der Dialogbox CiTouchW Handling Button Clicks Mode Touch a Button 7 O Enter O Exit O Tap Time A P A O Time O Dual Touch O Dual 7 Exit Button cick Down 783 Hz 30 ms O Time 7 Time Up OFF Z Press Pressure Sensitivity O User 1 SAU W 30 O User 2 User 3 Mouse Button X Left T Right Abbildung 4 5 Dialogseite zur Auswahl der Maustasten Emulation In der Mitte der Dialogbox wird festgelegt welche Maustaste emuliert werden soll Au erdem werden die aktuellen Einstellungen f r die Maustastenklicks angezeigt Zum ndern der Maustastenklicks dient die Schaltfl che Button Click ber die eine Dialogbox zur Festlegung der Tonh he und dauer eines Maustastenklicks gestartet wird 12 Konfiguration des CiTouchW Treibers Handling e Left Button e Right Button Benutzerhandbuch CiTouchW Ist dieses Kastchen angekreuzt wird die linke Maustaste emuliert Ist dieses Kastchen angekreuzt wird die rechte Maustasteemuliert Die vordefinierten
49. en Modus angezeigt Eine Beschreibung der benutzerdefinierten Programmierung befindet sich im n chsten Kapitel keine 15 e CITRON Konfiguration des CiTouchW Treibers Handling 4 1 2 Maustastenklicks Der CiTouchW Treiber ist in der Lage f r das emulierte Niederdr cken und Loslassen einer Maustaste einen Ton auf dem PC Lautsprecher auszugeben Die Einstellung der Tonh he und dauer wird in der in Abbildung 4 6 gezeigten Dialogbox eingestellt Diese Dialogbox wird ber die Schaltflache Button Click auf der Dialogseite Click Mode gestartet Define Button Beep Button Down octave Duration D jl short IX Beep on Button Down Events Button Up 3 Da e Duration 4 short IX Beep on Button Up Events Regular button clicks are not available while running this dialog Abbildung 4 6 Festlegen der Maustastenklicks Die Tonerzeugung beim Niederdr cken einer Maustaste wird im Bereich Button Down eingestellt F r das Loslassen der Maustaste wird der Bereich Button Up verwendet Dieser enth lt die gleichen Elemente wie der Bereich Button Down so da im Folgenden nur einer der beiden Bereiche ausf hrlich erl utert wird Die Tonh he wird durch Auswahl eines Notensymbols und Einstellen der Oktav festgelegt Die gerade selektierte Note wird blau anstatt schwarz gezeichnet Die Oktav wir
50. en der Cursor gegen ber dem Finger in Y Richtung beschleunigt wird Der Vorgabewert ist 384 entsprechend dem Faktor 1 5 6 1 2 Calibration In diesem Abschnitt sind die Kalibrierungsparameter f r absolute und relative Koordinaten enthalten Im Abschnitt Calibrations sind die folgenden Eintr ge m glich X_Add 32767 32767 Dieser Eintrag bestimmt den Offset der Geradengleichung zur Kalibrierung absoluter X Koordinaten Der Vorgabewert ist 0 X_Mul 0 65535 Dieser Eintrag bestimmt die Steigung der Geradengleichung zur Kalibrierung absoluter X Koordinaten X_Mul ist eine vorzeichenlose Festkommazahl Der Skalierungsfaktor kann mit der Funktion citGetDriverConstants abgefragt werden Der Vorgabewert ist256 XRel_Div 0 65535 Dieser Eintrag bestimmt den Teiler zur Skalierung relativer X Koordinaten Der Vorgabewert ist 1 XRel_Mul 32768 32767 Dieser Eintrag bestimmt den Multiplikator zur Skalierung relativer X Koordinaten Der Vorgabewert ist 1 Y_Add 32767 32767 Dieser Eintrag bestimmt den Offset der Geradengleichung zur Kalibrierung absoluter Y Koordinaten Der Vorgabewert ist 0 Y_Mul 0 65535 Dieser Eintrag bestimmt die Steigung der Geradengleichung zur Kalibrierung absoluter Y Koordinaten Y_Mul ist eine vorzeichenlose Festkommazahl Der Skalierungsfaktor kann mit der Funktion citGetDriverConstants abgefragt werden Der Vorgabewert ist256 45 OCITRON Anhang CTW300 INI YRel_Div 0 65535 Dieser Eintrag b
51. ensoren verf gt Neue Cursorpositionen werden nur gemeldet solange der eingestellte Druck auf die Frontscheibe berschritten wird Abs Rel Switch Unter dieser Rubrik wird festgelegt wann ein Wechsel zwischen absoluten und relativen Koordinaten erfolgt e Never W hrend des Betriebs ist kein Wechsel zwischen absoluten und relativen Koordinaten m glich e Tap Bei jedem Tap wird zwischen absoluten und relativen Koordinaten gewechselt Eine genaue Erklarung was ein Tap ist befindet sich auf Seite 13 e Dual Touch Bei jeder Zweifachber hrung wird zwischen absoluten und relativen Koordinaten gewechselt e Z Press Diese Option ist nur verf gbar wenn der IRT ber Drucksensoren verf gt Immer wenn der eingestellte Druck auf die Frontscheibe berschritten wird findet ein Wechsel zwischen absoluten und relativen Koordinaten statt 20 Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW 4 1 6 Cursor Beeinflussung Cursor Control Auf dieser Seite kann ein Abstand zwischen der tats chlichen Cursorposition gegen ber dem Ber hrpunkt und eine beschleunigte Bewegung des Cursors gegen ber dem Finger eingestellt werden Je nach Einbaulage des IRT ist es nicht immer m glich den u ersten Bildschirmrand mit dem Finger zu erreichen Durch die Cursorbeschleunigung des CiTouchW Treibers bewegt sich die Cursorposition innerhalb eines einstellbaren Bereichs schneller als der Finger auf den Bildschirmrand zu So
52. er R ckgabe Beschreibung Benutzerhandbuch CiTouchW WORD WINAPI citGetCoordMode LPCOORDMODE IpCM LPCOORDMODE IpcM i Zeiger auf eine COORDMODE Struktur zur Ubernahme der Parameter zur Koordinatenausgabe Anzahl der in die COORDMODE Struktur geschriebenen Bytes Es werden die Parameter zur Koordinatenausgabe in die bergebene COORDMODE Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 41 WORD WINAPI citGetDimming LPDIMMING IpDIM LPDIMMING IpDIM i Zeiger auf eine DIMMING Struktur zur Ubernahme der Dimming Parameter Anzahl der in die DIMMING Struktur geschriebenen Bytes Es werden die Parameter zur Ansteuerung des PWM Ausgangs des IRT in die bergebene DIMMING Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite41 WORD WINAPI citGetDriverConstants LPDRIVERCONSTANTS IpDC LPDRIVERCONSTANTS IpDC R Zeiger auf eine DRIVERCONSTANTS Struktur zur Ubernahme der Treiberkonstanten Anzahl der in die DRIVERCONSTANTS Struktur geschriebenen Bytes Es werden die unveranderlichen Treiberparameter in die Ubergebene DRIVERCONSTANTS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 41 WORD WINAPI citGetDriverSettings LPDRIVERSETTINGS IpDS LPDRIVERSETTINGS IpDS Zeiger auf eine DRIVERSETTINGS Struktur zur Ubernahme der Treiberparameter Anzahl der in die DRIVERSETTINGS Struktur geschriebenen Bytes Es werden die veranderbaren Treiber
53. er Installation Protocol Versionsnummer Erstellungsdatum TT MM JJJJ und Uhrzeit HH MM des Protocol Moduls HWParam Versionsnummer Erstellungsdatum TT MM JJJJ und Uhrzeit HH MM des Hardware Parameter Moduls e Options Speicherbest ckung des IRT FLASH Memory detected oder EPROM detected Falls ein IRT mit Drucksensoren angeschlossen ist erscheint der Text Z Touch detected und in den folgenden Dialogboxen sind die Optionen f r die Z Achse aktiviert ber die Schaltfl chen am unteren Rand der Dialogbox erreicht man die einzelnen Bereiche zur Einstellung der CiTouchW Treiberparameter e Handling Hier wird die Bedienung des CiTouchW Treibers eingestellt Dazu zahlen die Maustastenemulation Koordinatenberechnung diverse Veranderungen am Windows Desktop sowie erweiterte Einstellungen des Treibers e Calibrations Uber diese Schaltflache kann die Kalibrierung der CiTouchW Software jederzeit korrigiert werden Eine genaue Beschreibung des Kalibriervorgangs findet sich in Kapitel Kalibrierung des IRT auf Seite 6 e Hardware Hier erfolgt die Einstellung der seriellen Schnittstellenparameter f r den CiTouchW Treiber e Close Uber diese Schaltfl che wird die Dialogbox geschlossen und zur Systemsteuerung zur ckgekehrt S mtliche Dialogboxen lassen sich auch ber die Tastatur ohne Maus oder IRT bedienen Die jeweiligen Abk rzungstasten sind wie unter Windows blich durch Unterstreichen des zugeh rigen Buchst
54. estimmt den Teiler zur Skalierung relativer Y Koordinaten Der Vorgabewert ist 1 YRel_Mul 32768 32767 Dieser Eintrag bestimmt den Multiplikator zur Skalierung relativer Y Koordinaten Der Vorgabewert ist 1 6 1 3 Commands In diesem Abschnitt sind die Parameter zur Maustastenemulation enthalten Eine Beschreibung der Maustastenemulation findet sich in Kapitel Benutzerdefinierte Tastenemulation auf Seite 16 Die Zahlenwerte f r die Zustands bergangsbedingungen besitzen die folgende Bedeutung Wert Bedeutung Never Immediately Enter Z Press Dual Touch Tap Leave Z Release No Dual Touch ON Oak WON CO Im Abschnitt Commands sind die folgenden Eintr ge m glich Idle_T1 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand IDLE in den Zustand T1 Der Vorgabewert ist 2 ModeChange 0 3 4 5 Bedingung f r den Wechsel zwischen absoluten und relativen Koordinaten Der Vorgabewert isi0 T1_Trigger 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand T1 in den Zustand TRIGGER Der Vorgabewert ist 4 T2_UPT3 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand T2 in den Zustand T3 Der Vorgabewert ist 0 Time1 0 65535 Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T1 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert istO 46 Anhang CTW300 INI Benutzerhandbuch CiTouchW Ti
55. g Hier wird die Helligkeit der Hintergrundbeleuchtung bei aktivem und inaktivem Touch Saver eingestellt e Advanced Hier werden die erweiterten Parameter fiir den Betrieb des IRT eingestellt Diese Einstellungen m ssen vom Benutzer normalerweise nicht ge ndert werden nderungen der Treiberparameter haben solange keine Wirkung auf die Funktion von CiTouchW bis sie entweder durch einen Druck auf die OK Schaltflache dauerhaft abgespeichert oder durch Bet tigung der Test Schaltflache zeitweilig aktiviert werden Die Cancel Schaltfl che verwirft alle Anderungen und kehrt zum Hauptdialog zur ck Die Default Schaltfl che setzt alle CitouchW Parameter auf ihre Vorgabewerte zur ck Dazu werden die Dateien CTW300 INI und CTA300 INI in CTW300 nnn bzw CTA300 nnn umbenannt Dabei steht nnn f r eine fortlaufende Nummerierung der Form 000 001 002 Die Kalibrierung und die seriellen Schnittstellenparameter werden allerdings nicht zur ckgesetzt mit Ausnahme der Baudrate und des zuletzt erkannten Kommunikationsprotokolls 11 O CITRON Konfiguration des CiTouchW Treibers Handling Im Testmodus wird der aktuelle Treiberzustand gesichert und die vorgenommenen nderungen aktiviert Es erscheint der nachfolgend dargestellte Testdialog Nach Beenden des Testmodus Bet tigung der Close Schaltfl che oder Druck auf die ESC Taste wird der alte Treiberzustand wiederhergestellt Somit ist es gefahrlos m glich die verschiedene
56. hW Treibers Der CiTouchW Treiber bietet eine Vielzahl von Einstellungsm glichkeiten Auf diese Weise l t er sich individuell an die Wiinsche des jeweiligen Benutzers anpassen Alle Parameter werden zentral von einer Applikation in der Programmgruppe Systemsteuerung verwaltet Zum Starten gen gt ein Doppelklick auf das CiTouchW Symbol in der Systemsteuerung Systemsteuerung Einstellungen Hilfe iil Farben Schriftarten Drucker L ndereinstellungen Datum Uhrzeit SS Tastatur 386 erweitert Setup the Citron Infrared Touch mouse driver Abbildung 4 1 Systemsteuerung Vom anschlieBend erscheinenden Hauptdialog aus wird zu den einzelnen Bereichen verzweigt Zus tzlich werden alle wichtigen Parameter des angeschlossenen IRT angezeigt Citron Infrared Touch Setup CiTouchW Version 4 0 001 Copyright 1994 96 Citron GmbH CtApplet Version 4 0 001 Copyright 1994 96 Citron GmbH Touch Revisions Touch IRT1014 V2 2 ASSY_14 40 x 30 Running Mode C protocol Boot BOT04010 95 01 10 08 09 Software 10004010 94 03 09 08 06 Z Touch detected FLASH memory detected Options Calibrations Hardware Close Citron Infrared Touch Setup CiTouchW Version 4 0 001 Copyright 1994 96 Citron GmbH CtApplet Version 4 0 001 Copyright 1994 96 Citron GmbH Touch Revisions Touch IRT1014 V3 1 ASSY_15 40 x 30 S N 00345678 Running CT
57. handen Diese Funktion stellt fest ob eine Citron Long Distance VGA Karte vorhanden ist WORD WINAPI citGetAcceleration LPACCELERATION IpAC LPACCELERATION IpAC S Zeiger auf eine ACCELERATION Struktur zur Ubernahme der Parameter f r die Cursorbeschleunigung Anzahl der in die ACCELERATION Struktur geschriebenen Bytes Es werden die Parameter fiir die Cursorbeschleunigung in die bergebene ACCELERATION Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 39 29 OCITRON citGetButtonBeep Prototyp Parameter R ckgabe Beschreibung citGetCalibrationAbs Prototyp Parameter R ckgabe Beschreibung citGetCalibrationRel Prototyp Parameter R ckgabe Beschreibung citGetCommands Prototyp Parameter R ckgabe Beschreibung 30 CiTouchW API Referenz der API Funktionen WORD WINAPI citGetButtonBeep LPBUTTONBEEP IpBB LPBUTTONBEEP IpBB Zeiger auf eine BUTTONBEEP Struktur zur Ubernahme der Maustastenklick Parameter Anzahl der in die BUTTONBEEP Struktur geschriebenen Bytes Es werden die Parameter f r die Erzeugung des Maustastenklicks in die Ubergebene BUTTONBEEP Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite39 WORD WINAPI citGetCalibrationAbs LPCALIBRATIONABS IpCA LPCALIBRATIONABS IpCA A Zeiger auf eine CALIBRATIONABS Struktur zur bernahme der absoluten Kalibrierungsparameter Anzahl der in die CALIBRATIONABS S
58. iger auf eine COMMANDS Struktur mit den neuen Parameter f r die Maustastenemulation TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Parameter f r die Maustastenemulation auf die bergebene COMMANDS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Eine Beschreibung der Funktion der Maustastenemulation befindet sich in Kapitel Benutzerdefinierte Tastenemulation auf Seite 16 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetCoordMode LPCOORDMODE IpCM LPCOORDMODE IpcCM Zeiger auf eine COORDMODE Struktur mit den neuen Parametern zur Koordinatenausgabe TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Parameter zur Koordinatenausgabe auf die bergebene COORDMODE Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 41 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten CiTouchW API Referenz der API Funktionen citSetDimming Prototyp Parameter R ckgabe Beschreibung citSetDriverSettings Prototyp Parameter R ckgabe Beschreibung citSetSerialHardware Prototyp Parameter R ckgabe Beschreibung Benutzerhandbuch CiTouchW BOOL WINAPI citSetDimming LPDIMMING IpDIM LPDIMMING IpDI
59. intrag enth lt die zum jeweiligen benutzerdefinierten Maustastenemulationsmodus geh rende Zeit die zwischen dem Verlassen und erneuten Unterbrechen des Touchbereichs maximal verstreichen darf um ein Tap Ereignis auszul sen Die Zeit entspricht dem hier angegebenen Wert mal 55 Millisekunden Der Vorgabewert ist die in der Datei CTW300 INI im Abschnitt Settings unter dem Eintrag TapTime gespeicherte Zahl ZPress 0 255 Dieser Eintrag enth lt den zum jeweiligen Benutzerdefinierten Maustastenemulationsmodus geh renden Druck der auf die Frontscheibe ausge bt werden mu um ein Druckereignis auszul sen Der Vorgabewert ist die in der Datei CTW300 INI im Abschnitt Settings unter dem Eintrag Pressure angegebene Zahl 56 Index CTA300 INI 7 Index 27 Abs Rel Switch 20 absolute Koordinaten 19 AbsoluteMouse 48 51 ACCELERATION 39 44 Acceleration Border 21 Acceleration Factor 21 Advanced 23 52 AutoReinit 48 Autostart Gruppe 8 Backlight Dimming 23 Base Address 26 BaudDivisor 47 Beam Handling 24 BeamTimeout 48 Boot 9 Button 48 Button State 12 ButtonClick 48 ButtonClick 52 Button Machine 16 Calibration 45 CALIBRATIONABS 40 CALIBRATIONREL 40 Check 26 CITOUCHW DRV 5 CITOUCHW H 27 CITOUCHW INI 44 CITOUCHW LIB 27 CiTouchW Hardware Setup 6 Citron Infrarot Touch 4 Click Mode 13 COMMANDS 39 40 46 52 ContTime 48 Coord Mode 19 CoordEnterZ 48 CoordinateSkip 49 COORDMODE 41 CoordSignalZ 49 CTAPPLET
60. ionAbs LPCALIBRATIONABS IpCA LPCALIBRATIONABS IpCA Zeiger auf eine CALIBRATIONABS Struktur mit den neuen absoluten Kalibrierungsparametern TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Kalibrierungsparameter des absoluten Koordinatenmodus auf die bergebene CALIBRATIONABS Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Falls das ndern der Parameter nicht m glich war bleibt der alte Zustand erhalten 35 OCITRON citSetCalibrationRel Prototyp Parameter R ckgabe Beschreibung citSetCommands Prototyp Parameter R ckgabe Beschreibung citSetCoordMode Prototyp Parameter R ckgabe Beschreibung 36 CiTouchW API Referenz der API Funktionen BOOL WINAPI citSetCalibrationRel LPCALIBRATIONREL IpCR LPCALIBRATIONREL IpCR Zeiger auf eine CALIBRATIONREL Struktur mit den neuen relativen Kalibrierungsparametern TRUE falls die neuen Parameter eingestellt werden konnten FALSE falls die Parameter nicht eingestellt werden konnten Es werden die Kalibrierungsparameter des relativen Koordinatenmodus auf die bergebene CALIBRATIONREL Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten BOOL WINAPI citSetCommands LPCOMMANDS IpCMD LPCOMMANDS IpCMD Ze
61. itReceive HIWORD IParam 0 Anzahl der Bytes im Empfangspuffer 43 OCITRON Anhang CTW300 INI 6 Anhang Alle Parameter f r die Programme CITOUCHW DRV und CTAPPLET CPL werden in den Dateien CTW300 INI und CTA300 INI im Windows Verzeichnis abgespeichert Um alle Einstellungen auf ihre Vorgabewerte zur ckzusetzen kann die jeweilige INI Datei gel scht werden Die Programme arbeiten dann mit den fest eingespeicherten Vorgabewerten und schreiben etwaige nderungen nur bei Bedarf in ihre INI Datei ein Die Dateien CTW300 INI und CTA300 INI besitzen den gleichen Aufbau wie alle INI Dateien unter Windows M gliche Werte f r die einzelnen Eintr ge werden in Kursivschrift dargestellt Die Grenzen der Wertebeiche werden wie im Beispiel gezeigt angegeben X_Mul 32768 32767 Eintr ge mit Schalterfunktion werden durch Ja Nein dargestellt F r Ja mu eine 1 eingetragen werden Nein entspricht dem Wert 0 Ist eine Auswahl aus mehreren Werten m glich so werden diese durch einen senkrechten Strich getrennt Zum Beispiel AutoReinit Ja Nein 6 1 CTW300 INI In der Datei CTW300 INI speichert der CiTouchW Treiber seine Parameter Im Folgenden werden die einzelnen Abschnitte und Eintr ge der Datei CTW300 INI in alphabetischer Reihenfolge aufgef hrt Ist ein Eintrag nicht vorhanden so wird der im Treiber fest eingespeicherte Vorgabewert verwendet Eine Besonderheit stellen in diesem Zusammenhang die Eintr ge IO Ba
62. itionen links der Mitte bedeuten niedrigere Geschwindigkeit bei h herer rtlicher Aufl sung Positionen rechts der Mitte f hren zu h heren Geschwindigkeiten bei geringerer rtlicher Aufl sung e Relative Mode Y Speed ber diesen Rollbalken wird die vertikale Geschwindigkeit des Cursors bei Verwendung relativer Koordinaten eingestellt Positionen links der Mitte bedeuten niedrigere Geschwindigkeit bei h herer rtlicher Aufl sung Positionen rechts der Mitte f hren zu h heren Geschwindigkeiten bei geringerer rtlicher Aufl sung 19 e CITRON Konfiguration des CiTouchW Treibers Handling e Initially Use Relative Coordinates Ist dieses Kastchen angekreuzt werden nach der Initialisierung des CiTouchW Treibers zun chst relative Koordinaten verwendet Andernfalls erfolgt die Cursorbewegung aufgrund absoluter Koordinaten Move Cursor Unter dieser Rubrik wird festgelegt wann sich die Cursorposition ndert e Enter Es wird eine neue Cursorposition gemeldet sobald eine g ltige Unterbrechung des Touchbereichs vorliegt e Z Press Enter Diese Option ist nur verf gbar wenn der IRT ber Drucksensoren verf gt Damit nach dem Eintauchen eine neue Cursorposition gemeldet wird mu zuerst der eingestellte Druck auf die Frontscheibe berschritten werden F r weitere nderungen der Cursorposition gen gt es dann da der Touchbereich unterbrochen bleibt e Z Press Diese Option ist nur verf gbar wenn der IRT ber Drucks
63. lache wird mit den eingestellten Parametern versucht den IRT zu initialisieren Das Ergebnis dieses Tests wird in einem Meldungsfenster angezeigt e Rescan Bei Betatigung dieser Schaltflache wird der Rechner erneut nach seriellen Schnittstellen und einem angeschlossenen IRT durchsucht e Enable Auto Reinit Ist dieses Kastchen angekreuzt wird der IRT automatisch wieder angekoppelt nachdem die Verbindung zwischen IRT und Rechner unterbrochen war Serial Ports e Base Adr In dieser Spalte wird die Basisadresse der gefundenen seriellen Schnittstelle angezeigt oder eingetragen e Interrupt In dieser Spalte wird die ISA Bus Interruptnummer der seriellen Schnittstelle eingetragen oder eingetragen Zum Betrieb des CiTouchW Treibers ist ein serieller Interrupt unbedingt erforderlich An welcher Schnittstelle der IRT letztendlich angeschlossen ist wird durch das Auswahlfeld vor der jeweiligen Zeile festgelegt Wichtig F r einen zufriedenstellenden Betrieb des CiTouchW Treibers ist esunbedingt erforderlich da die Basisadresse und der Interruptkanal f r alle im Rechner vorhandenen seriellen Schnittstellen korrekt eingetragen sind Eventuell vorhandene Eintragungen f r nicht real existierende Schnittstellen m ssen gel scht werden Wird eine Citron LDVGA Grafikkarte f r den IRT Anschlu verwendet und sind bereits alle 4 COM Ports des Rechners durch andere Schnittstellenkarten belegt k nnen die f r die LDVGA Karte verwendeten Par
64. lative Koordinaten Parameter f r Maustastenemulation Parameter zur Koordinatenberechnung Puls Pausenverh ltnisse des IRT PWM Ausgangs Unver nderliche Treiberparameter Ver nderliche Treiberparameter Aktueller Treiberzustand Parameter der seriellen Schnittstelle Unver nderliche Parameter des IRT Ver nderliche Parameter des IRT Versionsnummer von CITOUCHW DRV Allgemeine Mausparameter wird von jedem Windows Maustreiber unterst tzt Verwendeter Interruptvektor wird von jedem Windows Maustreiber unterst tzt 5 1 2 Ver ndern von CiTouchW Parametern Mit diesen Befehlen lassen sich s mtliche Konfigurationsparameter des CiTouchW Treibers ver ndern Befehl citSetAcceleration citSetButtonBeep citSetCalibrationAbs citSetCalibrationRel citSetCommands citSetCoordMode citSetDimming citSetDriverSettings citSetSerialHardware citSetTouchSettings citReloadlni Ver nderte Parameter Parameter f r die Cursorbeschleunigung Parameter f r Maustastenklicks Kalibrierungsparameter f r absolute Koordinaten Kalibrierungsparameter f r relative Koordinaten Parameter f r Maustastenemulation Parameter zur Koordinatenberechnung Puls Pausenverh ltnisse des IRT PWM Ausgangs Ver nderliche Treiberparameter Parameter der seriellen Schnittstelle Ver nderliche Parameter des IRT Komplette Neuinitialisierung des Treibers 27 OCITRON CiTouchW API Referenz der API Funktionen 5 1 3 Kommunikation mit dem IRT Der CiTouchW Treiber
65. len e Gute Sicherheit gegen Fehlbedienung e Bewegung des Cursors bei gedr ckter Maustaste m glich e Ungenaue Positionierung des Mausdrucks bei Verwendung absoluter Koordinaten e Relativ komplizierte Bedienung 13 OCITRON Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Vorz ge Nachteile 14 Konfiguration des CiTouchW Treibers Handling Time Ist der Touchbereich unterbrochen und erfolgt f r eine Zeit T1 keine Mausbewegung wird ein Maustastendruck emuliert Die Taste bleibt solange gedr ckt bis der Touchbereich wieder verlassen wird Wird der Touchbereich innerhalb einer Zeit T2 erneut unterbrochen so erfolgt sofort ein Maustastendruck Auf diese Weise ist es m glich einen Doppelklick zu erzeugen Time to Click T1 Nach dieser Zeit erfolgt der erste Maustastendruck T1 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar Time to Idle T2 Wird der Touchbereich innerhalb dieser Zeit erneut unterbrochen so erfolgt ein sofortiger Maustastendruck T2 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar e Einfache Bedienung e Bewegen des Cursors bei gedr ckter Maustaste m glich e Ungenaues Timing des Maustastendrucks e Geringe Sicherheit gegen Fehlbedienung Dual Touch Ist der Touchbereich unterbrochen und erfolgt gleichzeitig eine zweite Ber hrung so wird ein Maustastendruck emuliert Die Taste bleibt sola
66. ls bei inaktivem Touch Saver Des weiteren besitzt der IRT einen PWM Ausgang der z B zur Helligkeitseinstellung der Hintergrundbeleuchtung von TFT Displays eingesetzt werden kann Der CiTouchW Treiber ordnet nun den zwei Zust nden aktiv und inaktiv des Touch Savers je ein bestimmtes Puls Pausenverh ltnis des PWM Ausgangs und somit unterschiedliche Helligkeiten der Hintergrundbeleuchtung zu Die Aktivierungszeit des Touch Savers und die Helligkeitswerte lassen sich auf dieser Dialogseite einstellen CiTouchW Handling Dimming Time to Dimm er Dimming Level X wer Dimming Level kd 7 Abbildung 4 13 Dialogseite zum Dimmen der Hintergrundbeleuchtung e Time to Dimm Uber diesen Rollbalken wird die Aktivierungszeitdes Touch Savers in Schritten von 1 s eingestellt Die minimale Aktivierungszeit betr gt 1 Sekunde die maximale Aktivierungszeit betr gt 546 Minuten und 6 Sekunden Der Touch Saver l t sich deaktivieren indem man den Schieber des Rollbalkens ganz nach rechts bewegt Wird der IRT im Mode C Protokoll betrieben kann die Ansprechzeit des Touch Savers nur in 30 Sekunden Schritten eingestellt werden e Upper Dimming Level Uber diesen Rollbalken wird die Helligkeit der Hintergrundbeleuchtung bei inaktivem Touch Saver entspricht Normalbetrieb festgelegt Der Upper Dimming Level kann nur auf einen minimalen Wert von 165 eingestellt werden Dadurch
67. me2 0 65535 Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T2 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert istO Time3 0 65535 Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T3 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert istO Trigger_T2 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand TRIGGER in den Zustand T2 Der Vorgabewert ist 6 UPT3_ldle 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand T3 in den Zustand IDLE Der Vorgabewert ist 0 UPT3_Trigger 0 8 Dieser Eintrag bestimmt die Bedingung f r den bergang vom Zustand T3 in den Zustand TRIGGER Der Vorgabewert ist 0 6 1 4 Hardware In diesem Abschnitt werden die Parameter der seriellen Schnittstelle eingetragen Fehlt einer der Eintr ge IO_Base oder Interrupt oder ist einer dieser Eintr ge auf 0 gesetzt so wird kein Versuch unternommen einen IRT anzukoppeln Der Treiber verbleibt dennoch im Speicher so da die im Kapitel CiTouchW API auf Seite 27 aufgef hrten API Funktionen genutzt werden k nnen Im Abschnitt Hardware sind die folgenden Eintr ge m glich BaudDivisor 0 65535 Dieser Eintrag bestimmt den Teiler f r den Baudratengenerator Die erzielte Baudrate errechnet sich nach der Formel BaudRate u fquarz 1 8432 MHz beim Standard PC 16 BaudDivisor Der Vorgabewert f r BaudDivisor ist
68. meter f r Maustastenemulation User 3 ButtonClick ZPress Parameter f r Maustastenemulation Z Press 6 2 1 Advanced In diesem Abschnitt befinden die Parameter des Dialogseite Advanced Settings die nicht bereits in der Datei CTW300 INI gespeichert sind Im Abschnitt Advanced sind die folgenden Eintr ge m glich SioQuartz High 0 65535 Dieser Eintrag enth lt das High Word der Frequenz 100 zur Erzeugung der Baudrate f r die serielle Schnittstelle Der Vorgabewert ist 0x0000 SioQuartz Low 0 65535 Dieser Eintrag enth lt das Low Word der Frequenz 100 zur Erzeugung der Baudrate f r die serielle Schnittstelle Der Vorgabewert ist0x4800 6 2 2 ButtonClick In diesen Abschnitten befinden sich die Parameter zur Maustastenemulation Alle Abschnitte mit dem Pr fix ButtonClick enthalten mindestens die im Folgenden aufgef hrten Eintr ge M gliche Werte f r die Zustands bergangsbedingungen sind im Kapitel Commands auf Seite 46 angegeben Die einzelnen Bedingungen sind im Kapitel Benutzerdefinierte Tastenemulation auf Seite 16 erl utert 52 Anhang CTA300 INI Benutzerhandbuch CiTouchW IdleT1 0 8 Dieser Eintrag enth lt die Bedingung f r den bergang vom Zustand IDLE in den Zustand T1 Die Vorgabewerte lauten Abschnitt Vorgabewert f r IdleT1 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick Tim
69. mit kann in jedem Fall der u erste Bildschirmrand erreicht werden Die Cursorbeschleunigung wird nur zusammen mit absoluten Koordinaten verwendet CiTouchW Handling Cursor Control Acceleration Border Cursor Offset ao Acceleration Factor X Direction Kl 1 00 Y Direction 1 00 Abbildung 4 11 Dialogseite zur Cursorbeeinflussung Die Bedienelemente dieser Dialogseite lauten im Einzelnen Acceleration Border ber die beiden Rollbalken wird die Grenze ab der eine Cursor Offset Cursorbeschleunigung einsetzt eingestellt Die aktuelle Position der Beschleunigungsgrenze wird als roter Rahmen dargestellt Die Zahlenangaben geben den Abstand der Grenze vom Bildschirmrand in Relation zum maximalen Abstand an 100 Bildschirmmitte 0 Bildschirmrand ber die beiden Rollbalken wird die tats chliche Cursorposition gegen ber dem Ber hrpunkt festgelegt Dieser Abstand wird unabh ngig von der Kalibrierung des CiTouchW Treibers beibehalten Im Feld zwischen den Rollbalken wird die aktuelle Position des Ber hrpunkts dargestellt durch ein Handsymbol gegen ber dem Cursor grafisch dargestellt Die Zahlenangabe innerhalb des Feldes gibt den Cursor Offset in Pixeln an e Acceleration Factor ber die beiden Rollbalken wird der Beschleunigungsfaktor der Cursorbewegung eingestellt Ein Beschleunigungsfaktor
70. n Einstellungen auszutesten CiTouchW Test Coordinate Mode ABSOLUTE Click Mode Z Press Cursor Move Condition Coordinate Mode Switch Double Click Area Button State Abbildung 4 4 Testmodus In der obersten Zeile der Test Dialogbox wird der aktuelle Koordinatenmodus angezeigt Dieser kann entweder ABSOLUTE oder RELATIVE sein Darunter werden falls die zugeh rige Dialogseite bereits aufgerufen wurde die Bedingung f r einen Maustastendruck Click Mode f r eine Cursorbewegung Cursor Move Condition und f r den Wechsel zwischen absoluten und relativen Koordinaten Coordinate Mode Switch angezeigt Das Double Click Area Feld ist in zwei H lften unterteilt Die linke H lfte ndert ihre Farbe bei jedem g ltigen Doppelklick mit der linken Maustaste die rechte entsprechen bei Doppelklicks mit der rechten Maustaste In der Mitte der Double Click Area wird die gegenw rtige Gr e des Doppelklickfelds angezeigt Innerhalb eines Bereichs dieser Gr e um den ersten Mausklick herum mu der zweite Klick erfolgen um von Windows als Doppelklick erkannt zu werden In der Mitte der Test Dialogbox unter der berschrift Button State ist eine stilisierte Maus dargestellt Die beiden Maustasten an ihrer Oberseite wechseln bei einem Druck auf die linke oder rechte Maustaste ihre Farbe Die Grenze au erhalb derer die Cursorbeschleunigung einsetzt wird durch einen rot wei en Rahmen auf d
71. nd die CiTouchW Kalibrierung von Hand durchgef hrt werden Eine genaue Beschreibung der dazu notwendigen Vorg nge findet sich in den Kapiteln Hardware auf Seite 25 und Kalibrierung des IRT auf Seite 6 2 CITRON Installation Probleme w hrend der Installation 3 4 2 Einrichten der IRT Hardware Falls im Windows Programmanager eine Autostart Gruppeexistiert Ist nach dem Neustart von Windows nicht die CiTouchW Hardware Setup Dialogbox aktiv sondern die als letzte in der Autostart Gruppe aufgef hrte Applikation In diesem Fall mu mit der ALT TAB Tastenkombination zum CiTouchW Hardware Setup gewechselt werden Sollte der IRT nicht automatisch erkannt werden berpr fen sie bitte die folgenden m glichen Fehlerquellen e Ist der IRT korrekt mit einer seriellen Schnittstelle des Rechners verbunden e Ist die Spannungsversorgung des IRT eingeschaltet e Ist die verwendete serielle Schnittstelle interruptfahig und wurde die korrekte ISA Bus Interruptnummer in der Dialogbox angegeben Der CiTouchW Hardware Setup geht von einer Standardkonfiguration aus d h COM1 0x3f8 Interrupt 4 und COM2 0x2f8 Interrupt 3 Sollte die verwendete serielle Schnittstelle von diesen Parametern abweichen so m ssen die korrekten Werte in die entsprechenden Felder der Dialogbox eingetragen werden e Sind alle seriellen Schnittstellen im Hardware Dialog richtig eingetragen e Falls eine LDVGA Karte verwendet wird Wurden die seriellen Schnitt
72. nge gedr ckt wie die Zweifachber hrung besteht Dual Touch Skip Count Legt fest wieviel Zweifachber hrungsmeldungen verworfen werden bevor der Maustastendruck emuliert wird einstellbar zwischen 0 und 255 e Einfache Bedienung e Genaue rtliche und zeitliche Positionierung des Maustastendrucks e Geringe Sicherheit gegen Fehlbedienung e Keine Bewegung des Cursors bei gedr ckter Maustaste m glich Dual Exit Ist der Touchbereich unterbrochen und erfolgt gleichzeitig eine zweite Ber hrung so wird ein Maustastendruck emuliert Im Gegensatz zu Dual Touch bleibt die Taste solange gedr ckt bis der Touchbereich wieder verlassen wird Dual Touch Skip Count Legt fest wieviel Zweifachber hrungsmeldungen verworfen werden bevor der Maustastendruck emuliert wird einstellbar zwischen 0 und 255 e Einfache Bedienung e Genaue rtliche und zeitliche Positionierung des Maustastendrucks e Bewegung des Cursors bei gedr ckter Maustaste m glich e Geringe Sicherheit gegen Fehlbedienung e Schwieriges Erzeugen von Doppelklicks Konfiguration des CiTouchW Treibers Handling Benutzerhandbuch CiTouchW Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Vorz ge Nachteile Beschreibung Parameter Time Time Ist der Touchbereich unterbrochen und erfolgt f r eine Zeit T1 keine Mausbewegung so wird ein Maustastendruck emuliert Wird der Cursor weiterhin nicht bewegt so wird nach einer Zeit T2 die Mau
73. otyp Parameter Beschreibung der Parameter R ckgabe Beschreibung des R ckgabeparameters Beschreibung Genaue Beschreibung der Funktion 28 CiTouchW API Referenz der API Funktionen citCheckBreak Prototyp Parameter R ckgabe Beschreibung citClose Prototyp Parameter R ckgabe Beschreibung citDetectLDVGA Prototyp Parameter R ckgabe Beschreibung citGetAcceleration Prototyp Parameter R ckgabe Beschreibung Benutzerhandbuch CiTouchW BOOL WINAPI citCheckBreak WORD wPort WORD wPort Basisadresse der seriellen Schnittstelle die getestet werden soll TRUE Es wurden 100ms Breaks gefunden FALSE Es wurden keine Breaks gefunden Ein uninitialisierter IRT sendet in Abst nden von 100 ms BREAK Signale Mit Hilfe dieser Funktion kann eine serielle Schnittstelle auf solche Signale untersucht werden BOOL WINAPI citClose void keine TRUE Empfangskanal konnte geschlossen werden FALSE Empfangskanal konnte nicht geschlossen werden M gliche Ursachen daf r sind ein bereits geschlossener Empfangskanal oder ein nicht initialisierter Treiber Damit der CiTouchW Treiber wieder seine normale Funktion als Maustreiber aufnehmen kann mu der Empfangskanal nachdem er ge ffnet und alle interessierenden Berichte gelesen wurden wieder geschlossen werden BOOL WINAPI citDetectLDVGA void keine TRUE Es wurde eine Citron LDVGA Karte gefunden FALSE Eine Citron LDVGA Karte ist nicht vor
74. parameter in die Ubergebene DRIVERSETTINGS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 41 31 OCITRON citGetFlags Prototyp Parameter R ckgabe Beschreibung citGetSerialHardware Prototyp Parameter R ckgabe Beschreibung citGetTouchHardware Prototyp Parameter R ckgabe Beschreibung citGetTouchSettings Prototyp Parameter R ckgabe Beschreibung 32 CiTouchW API Referenz der API Funktionen WORD WINAPI citGetFlags void keine Momentaner Zustand des CiTouchW Treibers Im R ckgabewort liegt der aktuelle Treiberzustand in Form von Bit Flags vor Zur Abfrage einzelner Flags sind in der Datei CITOUCHW H Konstanten mit dem Pr fix IF_ definiert mit denen das R ckgabewort verUNDet werden kann Eine Erl uterung der einzelnen Flags befindet sich in der selben Datei als Kommentar neben jeder Definition WORD WINAPI citGetSerialHardware LPSERIALHARDWARE IpSH LPSERIALHARDWARE IpSH Zeiger auf eine SERIALHARDWARE Struktur zur bernahme der seriellen Schnittstellenparameter Anzahl der in die SERIALHARDWARE Struktur geschriebenen Bytes Es werden die seriellen Schnittstellenparameter in die Ubergebene SERIALHARDWARE Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 42 WORD WINAPI citGetTouchHardware LPTOUCHHARDWARE IpTH LPTOUCHHARDWARE IpTH Zeiger auf eine TOUCHHARDWARE Struktur zur bernahme der konstanten IRT
75. rigger 53 T2 54 T2_UPT3 46 T2UpT3 54 T3 54 Tap 13 17 20 Tap Time 13 TapTime 50 56 Tastenmodus 12 Testmodus 12 Time 14 Time Time 15 Time to Click 14 15 58 Index CTA300 INI Time to Dimm 23 Time to Idle 14 Time to Second Click 15 Time1 46 Time2 47 Time3 47 Timeout 24 Tondauer 16 Tonh he 16 TOUCHHARDWARE 43 Touch Saver 23 24 TOUCHSETTINGS 43 Trigger_T2 47 TriggerT2 55 Upper Dimming Level 23 UPT3_ Idle 47 UPT3_Trigger 47 UpT3lidle 55 UpT8Trigger 55 User 15 W Window Frame Width 22 X_Add 45 X_Border 44 A Mul 45 X_Offset 50 X_Smoothing 50 X Beams 24 XRel_Div 45 XRel_Mul 45 V Add 45 Y Border 45 Y Mul 45 Y Offset 50 Y_Smoothing 50 Y Beams 24 YRel_Div 46 YRel_Mul 46 Z Achse 4 ZPress 56 Z Press 15 17 20 Z Press Enter 20 Z Release 17 Z Touch 10
76. s SS SS SSeS CH T2UpT3 0 8 Dieser Eintrag enth lt die Bedingung f r den bergang vom Zustand T2 in den Zustand T3 Die Vorgabewerte lauten Abschnitt Vorgabewert f r T2UpT3 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress oooooVoooo0o0 T3 0 65535 Dieser Eintrag enth lt die Zeitkonstante f r den Zustand T3 Die Zeit entspricht dem hier angegeben Wert in Millisekunden Die Vorgabewerte lauten Abschnitt Vorgabewert f r T3 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress PAO OS OO SOS CH 54 Anhang CTA300 INI Benutzerhandbuch CiTouchW TriggerT2 0 8 Dieser Eintrag enth lt die Bedingung f r den bergang vom Zustand TRIGGER in den Zustand T2 Die Vorgabewerte lauten Abschnitt Vorgabewert f r TriggerT2 ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress JO OO OO A OO CO UpT3ldle 0 8 Dieser Eintrag enthalt die Bedingung fur den Ubergang vom Zu
77. se und Interrupt im Abschnitt Hardware dar Fehlt einer dieser Eintr ge unternimmt der CiTouchW Treiber keinen Versuch einen IRT anzukoppeln Die folgenden Abschnitte werden in CTW300 INI erkannt Abschnitt Funktion Acceleration Parameter zur Cursorbeschleunigung Calibration Kalibrierung absoluter und relativer Koordinaten Commands Maustastenemulation Hardware Parameter der serielle Schnittstelle Settings Allgemeine Einstellungen f r den Treiber und IRT Sound Einstellungen f r die Maustastenklickerzeugung 6 1 1 Acceleration In diesem Abschnitt sind die Parameter f r die Beschleunigung der Cursorbewegung bei Verwendung absoluter Koordinaten enthalten Im Abschnitt Acceleration sind die folgenden Eintr ge m glich X_Border 0 32767 Dieser Eintrag bestimmt die Breite des Bereichs innerhalb dessen der Cursor gegen ber dem Finger beschleunigt bewegt wird Der Vorgabewert ist7864 entsprechend 24 44 Anhang CTW300 INI Benutzerhandbuch CiTouchW Y_Border 0 32767 Dieser Eintrag bestimmt die H he des Bereichs innerhalb dessen der Cursor gegen ber dem Finger beschleunigt bewegt wird Der Vorgabewert ist7864 entsprechend 24 X_Mul 0 32767 dcFixedBias caMulX Dieser Eintrag bestimmt den Faktor um den der Cursor gegen ber dem Finger in X Richtung beschleunigt wird Der Vorgabewert ist384 entsprechend dem Faktor 1 5 Y_Mul 0 32767 dcFixedBias caMulY Dieser Eintrag bestimmt den Faktor um d
78. sekunden ms WORD bbClickMode Eine Kombination der BC_ Konstanten die festlegt wann ein Ton erzeugt wird 39 OCITRON CALIBRATIONABS Diese Struktur enth lt die Parameter f r die Kalibrierung absoluter Koordinaten Die verwendete Formel zur Kalibrierung absoluter Koordinaten ist eine einfache Geradengleichung y mx t CiTouchW API Referenz der Strukturen Windows erwartet Koordinaten mit einem Wertebereich von 0 bis 65535 Typ Name DWORD caMulX short caAddX DWORD caMulY short caAddY WORD caOrientation Beschreibung m f r die X Koordinate t f r die X Koordinate m f r die Y Koordinate t f r die Y Koordinate Orientierung des IRT gegen ber dem Display Dabei wird eine der OR_ Konstanten entsprechend der Position des IRT Anschlu steckers gegen ber der linken oberen Display Ecke angegeben Die Gr en caMulX und caMulY sind vorzeichenlose Festkommazahlen Der Skalierungsfaktor f r die Festkommazahlen kann mittels citGetDriverConstants abgefragt werden CALIBRATIONREL Diese Struktur enth lt die Parameter f r die Kalibrierung relativer Koordinaten Die verwendete Formel zur Kalibrierung relativer Koordinaten lautet m YX Typ Name short crMulX WORD crDivX short crMulY WORD crDivY COMMANDS Beschreibung m f r die X Koordinate d f r die X Koordinate m f r die Y Koordinate d f r die Y Koordinate Diese Struktur enth lt die Parameter f r die Maustastenemulation Die
79. sen des Touchbereichs wird ein kurzer Ton 6 Installation Probleme wahrend der Installation Benutzerhandbuch CiTouchW auf dem Computerlautsprecher ausgegeben Als Kalibrierposition wird die Position des Fingers beim Verlassen des Touchbereichs verwendet Bei der Montage eines IRT Uber einem Flat Panel Display kann davon ausgegangen werden daB sich der Touchbereich und der aktive Displaybereich genau berdecken In diesem Fall wird bei der Kalibrierung lediglich die Lage des Koordinatenursprungs des IRT gegen ber dem des Displays ermittelt Das Display mu folglich nur in etwa ber dem dargestellten Cursorsymbol ber hrt werden Dadurch erfolgt eine einfachere und dennoch genaue Kalibrierung Wird jedoch der IRT vor einem CRT Bildschirm montiert oder stimmen IRT Gr e und Display Gr e nicht berein mu eine exakte Kalibrierung erfolgen Daher existiert ein zweiter Kalibriermodus f r CRT Bildschirme In diesen Modus gelangt man indem der Bildschirm ber dem Hilfetext ber hrt wird Die Umschaltung wird ebenfalls durch ein akustische Signal quittiert Im CRT Kalibriermodus werden die Kalibrierpunkte durch ein Fadenkreuz symbolisiert In diesem Fall mu der Touchbereich exakt im Zentrum des Fadenkreuzes verlassen werden Nur so kann eine genaue Kalibrierung auf die vorhandene Bildschirmgr e und lage erfolgen Hilfetext Abbildung 3 3 Kalibrierung im CRT Mode Das Kalibrierungsfenster verschwindet nach dem Verlassen des
80. stand T3 in den Zustand IDLE Die Vorgabewerte lauten Abschnitt Vorgabewert f r UpT3ldle ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress oooooVoooo000 UpT3Trigger 0 8 Dieser Eintrag enth lt die Bedingung f r den bergang vom Zustand UpT3 in den Zustand TRIGGER Die Vorgabewerte lauten Abschnitt Vorgabewert f r UpT3Trigger ButtonClick Double ButtonClick DoubleExit ButtonClick Enter ButtonClick Exit ButtonClick Tap ButtonClick Time ButtonClick TimeTime ButtonClick User1 ButtonClick User2 ButtonClick User3 ButtonClick ZPress oooopDDooooo Die Abschnitte ButtonClick User1 bis ButtonClick User3 enthalten zus tzlich die folgenden Eintr ge DbIErrSkip 0 65535 Dieser Eintrag enth lt die zum jeweiligen benutzerdefinierten Maustastenemulationsmodus geh rende Zahl von Zweifachber hrungsmeldungen die verworfen werden bevor eine Zweifachber hrung akzeptiert wird Der Vorgabewert ist die in der Datei CTW300 INI im Abschnitt Settings unter dem Eintrag DblErrSkip gespeicherte Zahl 55 OCITRON Anhang CTA300 INI Name Zeichenfolge Dieser Eintrag enthalt den Namen des jeweiligen benutzerdefinierten Maustastenemulationsmodus Der Vorgabewert ist ein leerer String TapTime 0 65535 Dieser E
81. staste kurz angehoben und sofort wieder gedr ckt Time to Click T1 Nach dieser Zeit erfolgt der Maustastendruck T1 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar Time to Second Click T2 Nach dieser Zeit erfolgt der zweite und weitere Tastendr cke bis der Touchbereich wieder verlassen wird T2 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar e Einfache Bedienung e Einfaches und positionsgenaues Erzeugen von Doppelklicks e Ungenaues Timing des Maustastendrucks e Geringe Sicherheit gegen Fehlbedienung Z Press Dieser Wahlpunkt steht nur zur Verf gung falls der IRT mit Drucksensoren ausger stet ist Ein Maustastendruck wird emuliert sobald ein einstellbarer Druck auf die Frontscheibe berschritten wird Die Taste bleibt solange gedr ckt bis dieser Druck abz glich einer Hysterese wieder unterschritten wird Pressure Sensitvity H he des notwendigen Drucks auf die Frontscheibe einstellbar zwischen 0 und 255 Die tats chliche Druckst rke ist abh ngig vom Einbau des IRT e Einfache Bedienung e Bewegen der Maus bei gedr ckter Taste m glich e Hohe Sicherheit gegen Fehlbedienung e IRT mu mit Drucksensoren ausger stet sein User 1 User 3 Es stehen drei benutzerdefinierbare Emulationsmodi zur Verf gung Die Programmierung erfolgt durch Druck auf die Schaltflache Define User Statt der grafischen Darstellung wird in der rechten oberen Ecke der Dialogbox der Name des benutzerdefiniert
82. stelle S101 mittels LDVINST und LDVDRV aktiviert e Wurde der IRT bereits von einer vorhergehenden Installation initialisiert In diesem Fall schl gt die automatische IRT Erkennung fehl Zur Beseitigung des Problems mu die serielle Verbindung zwischen IRT und Rechner oder die Spannungszuf hrung des IRT f r einige Sekunden unterbrochen werden Durch Druck auf die Rescan Schaltfl che kann nach Beseitigung der Fehlerquelle die automatische Suche nach einem IRT wiederholt werden 3 4 3 Tempor re Dateien W hrend der Installation werden eine Anzahl tempor rer Dateien und ein tempor res Unterverzeichnis angelegt Diese werden normalerweise nach erfolgter Installation wieder entfernt Sollte dies jedoch aufgrund eines Fehlers w hrend der Installation nicht m glich sein k nnen diese Dateien auch explizit vom Benutzer gel scht werden Im einzelnen handelt es dabei um folgende Dateien e Einzeldateien im Windows Verzeichnis _MSSETUP BAT _MSRSTRT EXE CTCTRL EXE CTSETUP INI e Temporares Unterverzeichnis im Hauptverzeichnis des Windows Laufwerks Der Dateiname des Unterverzeichnisses beginnt mit der Buchstabenfolge M Der Rest des Verzeichnisnamens ist eine Folge zuf lliger Ziffern und Buchstaben Alle Dateien in diesem Verzeichnis und das Verzeichnis selbst k nnen ohne Bedenken gel scht werden Benutzerhandbuch CiTouchW Konfiguration des CiTouchW Treibers Probleme wahrend der Installation 4 Konfiguration des CiTouc
83. truktur geschriebenen Bytes Es werden die Kalibrierungsparameter des absoluten Koordinatenmodus in die bergebene CALIBRATIONABS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 40 WORD WINAPI citGetCalibrationRel LPCALIBRATIONREL IpCR LPCALIBRATIONREL IpCR Zeiger auf eine CALIBRATIONREL Struktur zur Ubernahme der relativen Kalibrierungsparameter Anzahl der in die CALIBRATIONREL Struktur geschriebenen Bytes Es werden die Kalibrierungsparameter des relativen Koordinatenmodus in die bergebene CALIBRATIONREL Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 40 WORD WINAPI citGetCommands LPCOMMANDS IpCMD LPCOMMANDS IpCMD Zeiger auf eine COMMANDS Struktur zur Ubernahme der Parameter f r die Maustastenemulation Anzahl der in die COMMANDS Struktur geschriebenen Bytes Es werden die Parameter f r die Maustastenemulation in die bergebene COMMANDS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Eine Beschreibung der Funktion der Maustastenemulation befindet sich in Kapitel Benutzerdefinierte Tastenemulation auf Seite 16 CiTouchW API Referenz der API Funktionen citGetCoordMode Prototyp Parameter R ckgabe Beschreibung citGetDimming Prototyp Parameter R ckgabe Beschreibung citGetDriverConstants Prototyp Parameter R ckgabe Beschreibung citGetDriverSettings Prototyp Paramet

CitouchW Benutzerhandbuch

Contents

Download Pdf Manuals

Related Search

Related Contents