Home

- Citron GmbH

1. 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 ist 1 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 ist 1 Pressure 0 255 Dieser Eintrag bestimmt den Druck auf die Frontscheibe der n tig ist um die druckgesteuerten Ereignisse des Treibers auszul sen Ein Wert von 0 schaltet die Z Achse des IRT aus Der Vorgabewert ist 20 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 ist 500 SaverTime 0 65535 47 OCITRON CITOUCHD 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 ist 65535 SmoothAlways Ja Nein Dieser Eintrag legt fest ob die Mittelwertbildung f r absolute Koordinaten auch ber das Verlassen und erneute Unterbrechen des Touchbe
2. Funktion 20h Eingabe R ckgabe Beschreibung citCheckBreak AL 1Ch AH Kennung des CiTouchD Treibers AX 0001h Es wurden 100ms Breaks gefunden AX 0000h 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 citGetDimming AL 1Dh AH Kennung des CiTouchD Treibers E ES DI Zeiger auf eine DIMMING Struktur zur bernahme der Dimming Parameter AN 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 Be schreibung dieser Struktur befindet sich auf Seite 40 citSetDimming AL 1Eh AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine DIMMING Struktur mit den neuen Parame tern f r die Ansteuerung des PWM Ausgangs des IRT AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden 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 Seite 40 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citGetAcceleration AL 20h AH Kennung des CiTouchD Treibers S ES DI Zeiger auf eine ACCELERATION Struktur zur bernahme der Paramete
3. Regs Registers IdenNr Byte IdenStrPtr Pointer Softwareschnittstelle Benutzerhandbuch CiTouchD TmpIden SELING dd Integer j Byte Found Boolean begin Found False i C0 ID number from C0 FF are allowed repeat Regs AL PRESENCE Verify presence function Regs AH Byte i Identify number Intr 2F Regs Look if a tsr with multiplex support is installed under this identfy number if Regs AL FF then begin IdenStrPtr Ptr Regs ES Regs DI Point to given identifier string Convert given null terminated C String in Pascal string and compare TmpIden ze for j 1 to 8 do begin TmpIden TmpIden Chart Ptr Regs ES Regs DI Regs DI Regs DI 1 end if TmpIden IdenStr then Found TRUE end pes A e until Found OR i gt SFF if Not Found then writeln CiTouchD not installed else begin idenNr Byte i 1 store identify number detect LDVGA Regs AL citDetectLDVGA Regs AH idenNr Intr 2F Regs if Regs AX lt gt 0 then writeln LDVGA found else writeln No LDVGA detected end end Assembler Beispiel hhh Swit cha Switch back to TBT Assembler example Assemble with MASM or TASM gg MODEL small pascal DOSSEG CR EQU 13t LF EQU 10t IDLEN EQU 8t PRESENCE EQU 000h DETECTLDVGA EQU 025h STACK DATA MsgErr BYTE CR LF CiTouchD no
4. Time1 Time2 Time3 Idle_T1 T1_Trigger Trigger_T2 T2_UPT3 u UPT3_lIdle UPT3_ Trigger Exit Sobald der Touchbereich wieder verlassen wird erfolgt ein kurzer Maustastendruck keine c gt citouchd exe m 1 Konfiguration Benutzerhandbuch CiTouchD Vorz ge e Genaues Timing des Maustastendrucks e Einfache Bedienung e Gute Positionierung des Maustastendrucks Nachteile e Relative Koordinaten nicht sinnvoll e Keine Bewegung des Cursors bei gedr ckter Maustaste m glich CITOUCHD INI Commands Time1 Time2 Time3 Idie_T1 T1_Trigger Trigger_T2 T2_UPT3 UPT3_lIdle UPT3_Trigger A wt uot wt 1 000 0000 OCITRON m 2 t Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI m 3 t1 t2 Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI Konfiguration 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 Touchbereich erneut verlassen wird Tap Time t 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 zwi schen 0 ms und 2 s einstellen c gt citouchd exe m 2 300 e Gute Sicherheit gegen Fehlbedienung e Bewegung des Cursors bei gedr ckter Maustaste m glich e Ungenaue Positionierung des Mausdrucks bei Verwendung absolut
5. mov dx Printout mov ah int 21h MainExit mov int Start ENDP END al DETECTLDVGA ah IDNr use examined ID number 02Fh ax ax have we found the LDVGA NotFound 7 gt NO dx OFFSET MsgFound DS DX points to message PrintOut OFFSET MsgNoLDVGA DS DX points to message 09h Request print string function 09h ax 04C00h end program 21h Start Softwareschnittstelle Benutzerhandbuch CiTouchD 5 3 2 Ubersicht der erweiterten API Funktionen Es folgt eine Kurz bersicht aller CiTouchD API Funktionen zusammengefa t nach Funktionsgruppen 5 3 2 1 Abfrage von CiTouchD Parametern Mit diesen Befehlen lassen sich s mtliche Konfigurationsparameter des CiTouchD Treibers auslesen Nr Bezeichnung Zur ckgelieferte Daten sh Seite 05h citGetFlags Aktueller Treiberzustand 27 06h citGetSerialHardware Parameter der seriellen Schnittstelle 27 07h citGetCommands Parameter f r Maustastenemulation 27 08h citGetCoordMode Parameter zur Koordinatenberechnung 28 09h citGetCalibrationAbs Kalibrierungsparameter f r absolute Koordinaten 28 0Ah citGetCalibrationRel Kalibrierungsparameter f r relative Koordinaten 28 OBh citGetDriverSettings Veranderliche Treiberparameter 28 0Ch citGetTouchSettings Ver nderliche Parameter des IRT 29 0Dh citGetTouchHardware Unver nderliche Parameter des IRT 29 OEh citGetDriverConstants Unver nderliche Treiberparameter 29 1Bh citGetVersion Versionsnummer von CITOUCHD EXE 33 1Dh citGetDimming Puls
6. unterst tzt Alle anderen Codenummern werden ignoriert Version Maustyp und IRQ ermitteln AX 0024h BH Vorkommateil der Versionsnummer BL Nachkommateil der Versionsnummer CH Maustyp immer 2 serielle Maus CL IRQ Nummer CiTouchD unterst tzt prinzipiell jede auf einem PC verf gbare IRQ Nummer so da in CL auch Werte gr er 7 zur ckgeliefert werden k nnen Bit Masken des Bildschirm Cursors abfragen AX 0027h AX UND Maske bei Software Startzeile bei Hardware Cursor BX XOR Maske bei Software Endzeile bei Hardware Cursor CX Lange der horizontalen Bewegung in Mickeys DX Lange der vertikalen Bewegung in Mickeys Die Werte in CX und DX sind stets 0 da ein IRT mit absoluten Koordinaten arbeitet Liste der verfugbaren Video Modi abfragen AX 0029h CX 0 ersten Video Mode bzw lt gt 0 nachste Modi abfragen BX Segmentadresse eines Strings CX Codenummer des Videomodus DX Offsetadresse eines Strings In CX wird stets der Wert 0 zur ckgeliefert um anzuzeigen da keine Modi abgefragt werden k nnen 19 OCITRON Funktion 2Bh Eingabe Ruckgabe Besonderheiten Funktion 2Ch Eingabe Ruckgabe Besonderheiten Funktion 2Dh Eingabe Ruckgabe Besonderheiten Funktion 30h Eingabe R ckgabe Besonderheiten 20 Softwareschnittstelle Beschleunigungskurve einstellen AX 002Bh BX Nummer der zu aktivierenden Beschleunigungskurve ES S
7. 0001h Empfangskanal konnte geschlossen werden AX 0000h Empfangskanal konnte nicht geschlossen werden M gliche Ursachen daf r sind ein bereits geschlossener Empfangskanal oder ein nicht initialisierter Treiber Damit der CiTouchD 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 citReceiveStatus AL 1Ah AH Kennung des CiTouchD Treibers AX Zustand des Empfangspuffers M gliche R ckgabewerte sind 00h CRS_IDLE Kein Bericht verf gbar 01h CRS_READY Ein Bericht wurde empfangen 02h CRS_OVER Es wurden weitere Berichte empfangen Der zuerst emp fangene Bericht befindet sich aber noch vollst ndig im Puf fer 04h CRS_CLOSE Der Treiber wurde nicht durch citOpen Funktion 18h ge ff net Es wird der momentane Zustand des Empfangspuffers ermittelt Versionsnummer von CITOUCHD EXE AL 1Bh AH Kennung des CiTouchD Treibers DH Hauptversionsnummer DL Subversionsnummer AH Revisionsnummer AL Stadium Es wird die Versionsnummer von CiTouchD ermittelt ber die Funktion int33Inquire wird hingegen die Microsoft Maustreiber kompatible Version zur ckgeliefert 33 OCITRON Softwareschnittstelle Funktion 1Ch Eingabe Ruckgabe Beschreibung Funktion 1Dh Eingabe R ckgabe Beschreibung Funktion 1Eh Eingabe R ckgabe Beschreibung
8. 4 Trigger_T2 6 T2_UPT3 0 UPT3_lIdle 0 UPT3_ Trigger 0 Settings DbIErrSkip n OCITRON m 6 t1 t2 Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI m 7 p Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI 10 Konfiguration Time Time Ist der Touchbereich unterbrochen und erfolgt f r eine Zeit T1 keine Mausbewe gung so wird ein Maustastendruck emuliert Wird der Cursor weiterhin nicht be wegt so wird nach einer Zeit T2 die Maustaste kurz angehoben und sofort wieder gedr ckt Time to Click t1 Nach dieser Zeit erfolgt der Maustastendruck T1 ist in Schrit ten zu 55 ms zwischen 0 ms und 2 s einstellbar Time to Second Click t2 Nach dieser Zeit erfolgt der zweite und weitere Ta stendr cke bis der Touchbereich wieder verlassen wird T2 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar c gt citouchd exe m 6 500 300 e Einfache Bedienung e Einfaches und positionsgenaues Erzeugen von Doppelklicks e Ungenaues Timing des Maustastendrucks e Geringe Sicherheit gegen Fehlbedienung Commands Time1 t1 Time2 12 Time3 0 Idle_T1 T1_Trigger Trigger_T2 T2_UPT3 6 UPT3_ldle UPT3_Trigger 2 Z Press Dieser Wahlpunkt steht nur zur Verf gung falls der IRT mit Drucksensoren ausge r stet ist Ein Maustastendruck wird emuliert sobald ein einstellbarer Druck auf die Frontscheibe berschritten wird Die Taste bleibt solange gedr ckt b
9. CiTouchD arbeiten soll wird ber die folgende Funktion festgelegt citGetDriverSettings Funktion OBh Abfrage des Koordinatenmodus citSetDriverSettings Funktion 14h Andern des Koordinatenmodus Die zugeh rigen Elemente der Struktur DRIVERSETTINGS sh S 40 lauten dsAbsolute 0 Es wird der relative Koordinatenmodus verwendet 1 Es wird der absolute Koorinatenmodus verwendet Es ist weiterhin m glich im laufenden Betrieb zwischen den verschiedenen Koordinatenmodi zu wechseln Unter welcher Bedingung ein Wechsel zwischen absoluten und relativen Koordinaten erfolgen soll wird ber die folgende Funktion festgelegt citGetCommands Funktion 07h Abfrage der Bedingung f r Moduswechsel citSetCommands Funktion 10h Andern der Bedingung f r Moduswechsel Die zugeh rigen Elemente der Struktur COMMANDS sh S 39 lauten cmModeChange 0 W hrend des Betriebs ist kein Wechsel zwischen absoluten und relativen Koordinaten m glich 3 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 4 Bei jeder Zweifachber hrung wird zwischen absoluten und relativen Ko ordinaten gewechselt 5 Bei jedem Tap wird zwischen absoluten und relativen Koordinaten ge wechselt die Erl uterung eines Tap befindet sich auf Seite 8 Um bei kritischen Anwendungen die Gefahr einer Fehlbedi
10. EE 45 Benutzerhandbuch CiTouchD X A ele EE 43 ele TEE 43 Me TEEN 43 X OFSET nn era ein 48 XK Gmoothlnmg cccccocccococinonocanancconanonanonanana nan nccnnns 48 RGM DIV oi 43 A sais rare 43 Y NIAAA WEE E 43 K re EE 43 e UE 43 44 KEE EE 48 Y Smoothing ienn tas Nave enn ee 48 Y Rel DV aan 44 YRel Mul 2 asno ars a aeaiia 44 Z Z EEN 10 12 15 Z Press Enter 15 4 AO 12 51
11. 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 Funktion OEh angefragt werden Berichte im CTS1 Protkoll sind bereits dekodiert d h sie enthalten keine DC2 DC4 und SYN Sequenzen mehr citOpen AL 18h AH Kennung des CiTouchD Treibers ES DI Zeiger auf einen Eventhandler oder NULL falls keine Be nachrichtigungen verschickt werden sollen AX 0001h Der Empfangskanal konnte ge ffnet werden AX 0000h Der Empfangskanal konnte nicht ge ffnet werden M gliche Gr nde hierf r sind ein bereits gedffneter Empfangskanal oder ein nicht initialisierter Treiber Bevor ein Anwenderprogramm Berichte des IRT empfangen kann mu zuerst der Empfangskanal ge ffnet werden Ein CiTouchD Treiber mit ge ffnetem Empfangskanal meldet allerdings keine Cur sorbewegungen oder Maustastendr cke mehr Daher darf nach Empfang der gew nschten Berichte ein Aufruf von citClose Funktion 19h nicht vergessen werden Softwareschnittstelle Funktion 19h Eingabe R ckgabe Beschreibung Funktion 1Ah Eingabe R ckgabe Beschreibung Funktion 1Bh Eingabe R ckgabe Beschreibung Benutzerhandbuch CiTouchD citClose AL 19h AH Kennung des CiTouchD Treibers AX
12. im voraus festliegt mu ein Pro gramm das die ber den Mulitplex Interrupt 2Fh bereitgestellten Treiberfunktionen nutzen will zuerst die momentan g ltige Kennummer ermitteln Zur Ermittlung dieser ruft das Programm ausgehend von der Kennummer COh im AH Register zu speichern die Funktion 00h im AL Register zu speichern des Multiplex Interrupts 2Fh auf bis das Registerpaar ES DI auf die Zeichenkette CiTouchD zeigt Die beim erfolgreichen Aufruf angegebene Kennummer entspricht dann der aktuellen Kennummer des CiTouchD Treibers Ausgehend von dieser Kennziffer k nnen nun die ber den Multiplex Interrupt zur Verf gung gestellten Funktionen von CiTouchD aufgerufen werden Bleibt die Suche bis Kennummer FFh erfolglos ist CiTouchD nicht installiert Die folgenden Beispiele in den Programmiersprachen C Pascal und Assembler nutzen diese Methode um ber die weiter unten beschriebene Funktion 25h citDetectLDVGA das Vorhandensein einer LDVGA Karte abzufragen C Beispiel JK KR aR Rk kkk kkk AAA Ak kk kkk Ok detectLDVGA Check if LDVGA graphics card is present Microsoft C example tt include lt conio h gt include lt dos h gt include lt stdio h gt include lt string h gt define IDENSTR CiTouchD define IDSTRLEN 8 define PRESENCE 0x00 Literal for interupt 2f function 00h af 21 OCITRON Softwareschnittstelle define DETECTLDVGA 0x25 Literal for interupt 2f function 25h 37d af int main
13. 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 Im Abschnitt Hardware sind die folgenden Eintr ge m glich BaudDivisor 0 65535 Dieser Eintrag bestimmt den Teiler fur den Baudratengenerator Die erzielte Baudrate errechnet sich nach der Formel fon BaudRate EZ blicherweise ist foyar 1 8432 MHz 16 BaudDivisor Der Vorgabewert f r BaudDivisor ist 6 das entspricht 19200 Baud bei fquarz 1 8432 MHz Interrupt 0 15 Dieser Eintrag bestimmt die Nummer des ISA Bus Interruptkanals der seriellen Schnittstelle Der Vorga bewert ist 4 IO Base 0 65535 Dieser Eintrag bestimmt die Basisadresse des seriellen Schnittstellenbausteins Der Vorgabewert ist 0x3f8 45 OCITRON CITOUCHD INI IRT_Mode 0 1 2 Dieser Eintrag enthalt 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 CiTouchD Treiber das vorhandene Kommunikationsprotokoll automatisch zu erkennen Es wird die folgende Zuordnung zwischen dem erkannten Protokoll und dem hier angegebenen Zahlen wert verwendet Wert Bedeutung 0 kein Protokoll
14. void union _REGS ir or struct _SREGS sregs INEA unsigned char idenNr Identify number of CiTouchD af void far pIdenStr Zort i 0xC0 i lt 0x100 i ID number from 0xC0 OxFF are allowed 7 for non system TSRs using MUX interupt 7 ir h al PRESENCE Verify presence function ir h ah i Identify number SZ _int86x 0x2F Gir amp or amp sregs Look if a tsr with multiplex support is installed under this identfy number af if or h al OxFF point to given identifier string Ef pIdenStr void far unsigned long sregs es lt lt 16 or x di Look if identifier string matches searched one 7 if _fstrncmp pIdenStr IDENSTR IDSTRLEN break if i 256 printf nCiTouchD not installed n else idenNr unsigned char i store identify number EL detect LDVGA ir h al DETECTLDVGA ir h ah idenNr _int86x 0x2F Gir amp or amp sregs LLL OE eek o printf LDVGA detected n else printf No LDVGA detected n return 0 Pascal Beispiel 22 CREPE AAA AAA LA LAR ARK RAR LER APA KAR LR AR BAAR AR ARR AR AR AR LAR IARI TERRES I SARE RR detectLDVGA Check if LDVGA graphics card is present Turbo Pascal example RR RRA AEA AIR AL RA ARATE AA KAR RL LR LAA RR RR KARA RAR RAR ARK RARA KR AR AR ARS uses dos CG For Inter const IdenStr CiTouchD PRESENCE 00 citDetectLDVGA 25 var
15. 0 lauten dsSmoothX Gl ttungsfaktor f r die X Achse dsSmoothY Gl ttungsfaktor f r die Y Achse dsSmoothAlways 0 mit der Mittelwertbildung wird nach jeder neuen Unterbrechung des Touchbereichs frisch begonnen Das bedeutet der Cursor wird zun chst un mittelbar auf den Ber hrpunkt gesetzt und erst weitere Cursorbewegungen werden gemittelt 1 der alte Mittelwert bleibt nach dem Verlassen des Touchbereichs erhalten Wird der Touchbereich wieder unterbrochen wandert der Cursor ausgehend von seiner alten Position entsprechend dem eingestellten Gl ttungsfaktor schrittweise zum neuen Ber hrpunkt hin dsCoordSkip Legt fest wieviele Koordinatenmeldungen des IRT nach dem Unterbrechen des Touchbereichs verworfen werden bevor eine neue Cursorposition ge meldet wird Das Verwerfen der ersten Koordinatenmeldungen ist zum Beispiel dann sinnvoll wenn der IRT in einem gr eren Abstand zur Bild schirmoberfl 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 Un terbrechungserkennung 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 Der zul ssige Werte
16. 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 42 CITOUCHD INI Benutzerhandbuch CiTouchD X_Border 0 32767 Dieser Eintrag bestimmt die Breite des Bereichs innerhalb dessen der Cursor gegen ber dem Finger beschleunigt bewegt wird Der Vorgabewert ist 7864 entsprechend 24 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 ist 7864 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 ist 256 entsprechend dem Faktor 1 0 Y_Mul 0 32767 dcFixedBias caMulY Dieser Eintrag bestimmt den Faktor um den der Cursor gegen ber dem Finger in Y Richtung beschleunigt wird Der Vorgabewert ist 256 entsprechend dem Faktor 1 0 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 Kalibr
17. Inhalt Blo la EE 3 2 EINTUNTUNG E 4 3 gege Ber He ul RE A A Ate ue Ce EE 4 4 1 kommandozelenparameier nn nr nnnn nn rene rra r rn rra r enn r nn rra ann narran 5 4 2 Vordefinierte Maustasten Emulationsmodi ooocconncccccononcccnonanononanana nono nono conocio conan nn cnn an cnn nara n rn nnnnnnnnn 6 el Ee ET 11 been 11 5 1 1 KoordinatensysteM8 ooooccconnocccononoconononccnnnnn nc 11 5 1 2 Unterst tzte Videomodi z sonenn aceite eek ess 11 5 1 3 Benutzerdefinierte TasteneMulation ccc cccccsccecccsseesceeeseseeeeeeeseesauuueeeeuuueuseueueesuuaueeesauaaas 12 5 1 4 Weitere Betriebsparameter AAA 13 5125 Autrut der AP I FUNKtONGN sisi eco bees ne ee a RE U ea 17 5 2 Emulierte Maustreiberfunktionen ere I arena 17 5 2 1 Numerische b amp rsicht 2 2 2 2R ee er Del ar ask a a aaa aea eae ainai 17 5 2 2 Besonderheiten der Int 33 APIl Emulation nana co conocia nn conan acc conan nn nnnanannnnn 18 5 3 Erweiterte API FEUNKtIONEN EE 21 5 3 1 Ermittlung der Ferreira 21 5 3 2 bersicht der erweiterten AbDl Funkttonen conocio nono no nono nana nn nn na nn n ona ncnnnnnn 25 5 3 3 Referenz der erweiterten API Funktionen ooocccoconcccccnnncconononoconononono nana no nono nn nn nono nn nn non n cnn nnnannn nana 26 5 3 4 Referenz der Strukturen cein diar nono non nn nnnn cono non aran anna nono naaa anna nn nn nnnnanins 37 5 3 5 Benachrichtigung durch CTouchf cnn nnnn nora nano cnn cn cnn nnr nn nann cnn 42 6 CIFOUGHDEIN oct re ae a
18. OCITRON Creative Industrial Electronic Systems CiTouchD Touch Treiber fur DOS V1 0 01x Benutzerhandbuch OCITRON Inhalt Dokumenten Revision Rev Beschreibung Bear Datum 006 Anpassung und Korrektur nach Ubersetzung pk mime 009 Anpassung an CiTouchD V1 0 010 nderung der Vorgabewerte in CITOUCHD INI wh 14 07 1997 HaftungsausschluB Der Inhalt dieses Handbuchs dient nur zu Informationszwecken Die Citron GmbH beh lt sich das Recht vor ohne vorherige Ank ndigung nderungen 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 1995 1998 CITRON GmbH Anwaltinger Str 14 86165 Augsburg Tel 0821 74945 0 FAX 0821 74945 99 E mail info citron de http Awww citron de ALLE RECHTE VORBEHALTEN Dokumenten Info Dateiname h manuals citouchd ctd_r011 doc Datum 29 08 97 11 25 Dokumenten Rev 2 Dokumenten Vorlage h dformat dot cidoku dot Inhalt Benutzerhandbuch CiTouchD 1
19. Pausenverhaltnise des IRT PWM Ausgangs 34 20h citGetAcceleration Parameter f r die Cursorbeschleunigung 34 22h citGetButtonBeep Parameter f r Maustastenklicks 35 27h citGetCitdFlags Erweiterter Treiberzustand 36 5 3 2 2 Ver ndern von CiTouchD Parametern Mit diesen Befehlen lassen sich s mtliche Konfigurationsparameter des CiTouchD Treibers ver ndern Nr Bezeichnung Ver nderte Parameter sh Seite OFh citSetSerialHardware Parameter der seriellen Schnittstelle 29 10h citSetCommands Parameter f r Maustastenemulation 30 11h citSetCoordMode Parameter zur Koordinatenberechnung 30 12h citSetCalibrationAbs Kalibrierungsparameter f r absolute Koordinaten 30 13h citSetCalibrationRel Kalibrierungsparameter f r relative Koordinaten 31 14h citSetDriverSettings Ver nderliche Treiberparameter 31 15h citSetTouchSettings Ver nderliche Parameter des IRT 31 1Eh citSetDimming Puls Pausenverh ltnise des IRT PWM Ausgangs 34 21h citSetAcceleration Parameter f r die Cursorbeschleunigung 35 23h citSetButtonBeep Parameter f r Maustastenklicks 35 28h citSetCitdFlags Setzen des Hardware Reset Handlings 36 5 3 2 3 Kommunikation mit dem IRT Der CiTouchD Treiber stellt eine einfach zu handhabende Schnittstelle f r das Senden von Befehlen zum IRT und das Empfangen von Berichten vom IRT zur Verf gung Bevor ein Anwenderprogramm mit dem IRT kommunizieren kann mu der Empfangskanal mittels der Funktion citOpen ge ffnet werden Ein CiTouchD Treiber mit ge
20. Up Button Down UPT3_Trigger Abbildung 5 1 Zustandsautomat zur Maustastenemulation M gliche Bedingungen f r Zustands berg nge lauten e Never Diese Bedingung tritt niemals ein e Immediately Diese Bedingung tritt immer und sofort ein e Enter Es werden Koordinaten 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 Der Tastenemulationsmodus Time kann zum Beispiel folgenderma en programmiert werden 12 T1 550 ms T2 0ms T3 550 ms Idle_T1 Enter T1_Trigger Enter Trigger_T2 Leave T2_UPT3 Never UPT3_Idle Never UPT3_Trigger Enter Softwareschnittstelle Benutzerhandbuch CiTouchD Ein weiteres Beispiel ware ein neuer Emulationsmodus mit Namen Z Press Exit Dabei erfolgt ahnlich 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 Idle_T1 Enter T1_Trigger Z Press Trigger_T2 Leave T2_UPT3 Never UPT3_Idle Never UPT3_Trigger Never 5 1 4 Weitere Betriebsparameter Damit die Mausemulation durch einen IRT so komfortabel
21. agen Eine Beschreibung dieser Struktur befindet sich auf Seite 41 citGetDriverConstants AL 0Eh AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine DRIVERCONSTANTS Struktur zur Uber nahme der Treiberkonstanten AN Anzahl der in die DRIVERCONSTANTS Struktur geschrie benen Bytes Es werden die unver nderlichen Treiberparameter in die Ubergebene DRIVERCONSTANTS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 40 citSetSerialHardware AL OFh AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine SERIALHARDWARE Struktur mit den neuen seriellen Schnittstellenparametern AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die seriellen Schnittstellenparameter auf die bergebene SERIALHARDWARE Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 41 Falls ein ndern der Parameter nicht m glich war bleibt der alte Zustand erhalten 29 OCITRON Funktion 10h Eingabe Ruckgabe Beschreibung Funktion 11h Eingabe Ruckgabe Beschreibung Funktion 12h Eingabe R ckgabe Beschreibung 30 Softwareschnittstelle citSetCommands AL 10h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine COMMANDS Struktur mit den neuen Pa rameter f r die Maustastenemulation AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter kon
22. aver entspricht tsDimmLow SaverScan entspricht tsTScan SaverTime entspricht tsTSaver 5 1 5 Aufruf der API Funktionen Die Kommunikation eines Anwenderprogramms mit dem CiTouchD Treiber erfolgt ber Softwareinterrupts Dabei wird die Funktionsnummer im AL Register bergeben und der entstprechende Softwareinterrupt ausgel st Weitere Parameter werden in den anderen Prozessorregistern bergeben Die genaue Registerbelegung ist bei der jeweiligen Funktionsbeschreibung angegeben 5 2 Emulierte Maustreiberfunktionen der Int33 API Die Int 33 API Application Program Interface Interrupt 33h des CiTouchD Treibers ist kompatibel zum Microsoft Maustreiber Version 8 0 Daher wird auf eine detailierte Beschreibung jeder Funktion dieser API verzichtet und nur auf Besonderheiten bei einzelnen Funktionen eingegangen 5 2 1 Numerische bersicht Die nachfolgende Tabelle zeigt die unterst tzten Funktionen der Int33 API in numerischer Reihenfolge Die mit einem Kreuz markierten Funktionen k nnen zwar aufgerufen werden besitzen jedoch keinerlei Funktionalit t Die mit einem Stern markierten Funktionen unterscheiden sich in Details vom Microsoft Maustreiber und werden weiter unten genauer beschrieben Nummer Bezeichnung Beschreibung 00h int33ResetAndStatus Reset des Treibers und der Touch Hardware Oth int33ShowCursor Maus Cursor auf dem Bildschirm anzeigen 02h int33HideCursor Maus Cursor ausblenden 03h int33GetPosBtn Mausposition und Sta
23. befindet sich auf Seite 38 citSetButtonBeep AL 23h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine BUTTONBEEP Struktur mit den neuen Pa rametern f r die Maustastenklickerzeugung AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Parameter f r die Maustastenklickerzeugung auf die bergebene BUTTONBEEP Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 38 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citDetectLDVGA AL 25h AH Kennung des CiTouchD Treibers AX 0001h Es wurde eine Citron LDVGA Karte gefunden AX 0000h Eine Citron LDVGA Karte ist nicht vorhanden Diese Funktion stellt fest ob eine Citron Long Distance VGA Karte vorhanden ist 35 OCITRON Funktion 26h Eingabe R ckgabe Beschreibung Funktion 27h Eingabe R ckgabe Beschreibung Funktion 28h Eingabe R ckgabe Beschreibung 36 Softwareschnittstelle citPlaySound AL 26h AH Kennung des CiTouchD Treibers BX Tonh he in Hertz Hz CX 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 Dauer des Tons blockiert Erweiterter Treiberzustand AL 27h AH Kennung des CiTouchD Treib
24. bereich f r dsSmoothX und dsSmoothY bewegt sich von 0 bis dsSmoothMax Dieser Wert kann ber citGetDriverConstants Funktion OEh abgefragt werden 13 O CITRON Softwareschnittstelle In der Datei CITOUCHD INI steuern die folgenden Eintr ge das Gl ttungsverhalten Settings X_Smoothing entspricht dsSmoothx Y_Smoothing entspricht dsSmoothY SmoothAlways entspricht dsSmoothAlways CoordinateSkip entspricht dsCoordSkip 5 1 4 2 Koordinatenmodus Der CiTouchD Treiber kann sowohl mit absoluten als auch mit relativen Koordinaten arbeiten Werden absolute Koordinaten verwendet springt der Cursor direkt an die Stelle der Unterbrechung des Touchbe reichs 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 Fingerbe wegung entspricht l t sich eine Ortsaufl sung erreichen die der einer konventionellen Maus entspricht Die Geschwindigkeit mit der sich der Cursor bei Verwendung relativer Koordinaten bewegt wird ber die folgenden Funktionen eingestellt citGetCalibrationRel Funktion OAh i Abfrage der Kalibrierung f r rel Koordinaten citSetCalibrationRel Funktion 13h Andern der Kalibrierung relativer Koordinaten Die Parameter werden in der Struktur CALIBRATIONREL sh S 38 bergeben In welchem Koordinatenmodus
25. brochen wird 39 OCITRON COORDMODE Softwareschnittstelle Diese Struktur enth lt die Parameter f r die Koordinatenerzeugung Typ BOOL BOOL DIMMING Diese Struktur enth lt die Parameter f r die Ansteuerung des PWM Ausgangs des IRT Typ WORD WORD BOOL cmCoordEnterZ cmCoordSignalZ Beschreibung TRUE FALSE FALSE Name bIDimmingHigh bIDimmingLow blSaverActive TRUE F r die erste Koordinatenmeldung nach dem Eintauchen ist die berschreitung des einge stellten Drucks auf die Frontscheibe erforder lich Die erste Koordinatenmeldung erfolgt sofort nach dem Eintauchen F r alle weiteren Koordinatenmeldung ist die berschreitung des eingestellten Drucks auf die Frontscheibe ebenfalls erforderlich F r weitere Koordinatenmeldungen gen gt es da der Touchbereich unterbrochen bleibt Beschreibung Puls Pausenverh ltnis bei inaktivem Touch Saver Puls Pausenverh ltnis bei aktivem Touch Saver TRUE bei aktivem Touch Saver Der Wertebereich f r bIDimmingHigh 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 ber citSetTouchSettings Funktion 15h festgelegt Der bISaverActive Wert wird von citGetDimming Funktion 1Dh gesetzt Die Funktion citSetDimming Funktion 1Eh ignoriert diesen Parameter Der Touch Saver kann hier ber ni
26. chleunigung een 15 D BblErrSkip TE 47 DIMMING cooooccccccnnnononononcnncnnnonnn nana cnn arc n no nono 40 DRIVERCONSTANTS o ae 40 DRIVERSETTINGS 2 0 0 40 Dual MEX oi 9 Dual TOUCH aia atada 9 12 Dual Touch Skip Count 9 E Entera 6 12 14 EE oi active ebe 7 G E En EE 13 50 INDEX H Hardware 45 I die EE 44 Immediately nennen 12 lune 45 lO Base iit Aten ini 45 IERT geet ee iaa AE el A K KoordinatenMmoduS ccccccccccccnonononcnnnnnncinonananon 14 L Leave A ar atlas 12 M MiNXBe MS iii 422 ne 47 MINYBe E 47 ModeChange Ceiri itra aansen aranan ta o aaeain 44 N REALE EAEAN ATE E des ege 12 No Dual Touch 12 INOTIMCATION keinen in 25 P Lee ee Ga eee es 25 Pressure nee igen en 47 Pressure Sensivity c ccccecceseeeesseeeteeeestees 10 A DGaverf can AEEA AT 47 et VR EE 48 SERIALHARDWARE ooocccccccccncncnnnnananananananann 41 SONO ii tina 46 48 SmoothAlways s seseeseeeneeese eene eeen neer nern rennes 48 Steuerung der Hintergrundbeleuchtung 16 INDEX T TITOJ eiie 44 TA BIR EE 44 BEI E 8 12 TapTimes Haie ek 48 d GAR Lu 8 A ee 8 Time TIMO inci 10 Timetochick 8 10 Timesto Idle cin ident eed daa dictated 8 Time to Second Click 10 BU CA EA 45 AA Ee 45 Times een era 45 TOUCHHARDWARE 41 Touch Savetr rn nen 16 TOUCHSETTINGS nennen 42 Trigger NEE 45 U Ea Feo Ile arica di is 45 OFTIS Nee
27. cht ein oder ausgeschaltet werden Diese Struktur enth lt die unver nderlichen Parameter des CiTouchD Treibers Beschreibung Obere Grenze f r die Gl ttungsfaktoren Gl ttungs faktoren 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 Parameter des CiTouchD Treibers DRIVERCONSTANTS Typ Name WORD dcSmoothMax WORD dcFixedBias WORD dcReportMax WORD dcKeyNum WORD dcKeyMode DRIVERSETTINGS Typ Name WORD dsSmoothX WORD dsSmoothY short dsOfsX short dsOfsY 40 Beschreibung Glattungsfaktor fiir die X Achse Gl ttungsfaktor f r die Y Achse X Abstand zwischen Ber hrpunkt und Cursorposition Y Abstand zwischen Ber hrpunkt und Cursorposition Softwareschnittstelle Benutzerhandbuch CiTouchD Zeit innerhalb derer der Touchbereich erneut unter brochen werden muB damit ein Tap erkannt wird Die TapTime wird in Einheiten von 55 ms angege ben Anzahl der Koordinatenmeldungen die nach dem Eintauchen verworfen werden bevor eine neue Cur sorposition gemeldet wird Anzahl der Zweifachber hrungsmeldungen die ver worfen werden bevor eine Zweifachber hrung er kannt wird Nummer der z
28. e Zustand erhalten Softwareschnittstelle Funktion 13h Eingabe R ckgabe Beschreibung Funktion 14h Eingabe R ckgabe Beschreibung Funktion 15h Eingabe R ckgabe Beschreibung Funktion 16h Eingabe R ckgabe Beschreibung Benutzerhandbuch CiTouchD citSetCalibrationRel AL 13h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine CALIBRATIONREL Struktur mit den neuen relativen Kalibrierungsparametern AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Kalibrierungsparameter des relativen Koordinatenmo dus auf die bergebene CALIBRATIONREL Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 38 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citSetDriverSettings AL 14h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine DRIVERSETTINGS Struktur mit den neuen Treiberparametern AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Treiberparameter auf die bergebene DRIVERSETTINGS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Falls ein ndern der Parameter nicht m glich war bleibt der alte Zustand erhalten citSetTouchSettings AL 15h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine TOUCHSETTINGS Strukt
29. e 12 27 OCITRON Funktion 08h Eingabe R ckgabe Beschreibung Funktion 09h Eingabe R ckgabe Beschreibung Funktion 0Ah Eingabe R ckgabe Beschreibung Funktion 0Bh Eingabe R ckgabe Beschreibung 28 Softwareschnittstelle citGetCoordMode AL 08h AH Kennung des CiTouchD Treibers S ES DI Zeiger auf eine COORDMODE Struktur zur bernahme der Parameter zur Koordinatenausgabe AN 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 40 citGetCalibrationAbs AL 09h AH Kennung des CiTouchD Treibers 6 ES DI Zeiger auf eine CALIBRATIONABS Struktur zur Uber nahme der absoluten Kalibrierungsparameter AN Anzahl der in die CALIBRATIONABS Struktur geschriebe nen Bytes Es werden die Kalibrierungsparameter des absoluten Koordinaten modus in die bergebene CALIBRATIONABS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 38 citGetCalibrationRel AL 0OAh AH Kennung des CiTouchD Treibers N ES Dl Zeiger auf eine CALIBRATIONREL Struktur zur Uber nahme der relativen Kalibrierungsparameter AX Anzahl der in die CALIBRATIONREL Struktur geschriebe nen Bytes Es werden die Kalibrierungsparameter des relativen Koordinatenmo dus in die bergebene CALIBRATIONREL Struktur einget
30. e API Funktionen Die erweiterten API Funktionen sind ber den sogenannten Multiplex Interrupt 2Fh erreichbar Hier ber lassen sich verschiedene Parameter und Arbeitsmodi des Treibers ermitteln bzw einstellen Dabei mu die Kennummer des CiTouchD Treibers im AH Register und die Nummer der angesprochenen Funktion im AL Register bergeben werden Da es sich hierbei um spezielle API Funktionen des CiTouchD Trei bers handelt werden diese im folgenden genau beschrieben Die Mausemulation des CiTouchD Treibers ist vollst ndig parametrisierbar Diese Parameter werden beim Programmstart von der Kommandozeile oder aus der Datei CITOUCHD INI gelesen Der Inhalt dieser Datei ist in Kapitel CITOUCHD INI auf Seite 42 dokumentiert Zum ndern der Parameter zur Laufzeit sind eine Anzahl API Funktionen vorgesehen die alle ber eine Int 2Fh Multiplexer Interrupt Schnittstelle implementiert sind Diese Funktionen werden im Folgenden beschrieben 5 3 1 Ermittlung der Kennummer von CiTouchD Die Kennnummer des CiTouchD Treibers mu bei jedem Aufruf einer erweiterten API Funktion ber den Multiplex Interrupt im Register AH angegeben werden Seinen Namen verdankt der Multiplex Interrupt der Tatsache da ber ihn nicht nur ein einziges DOS Programm erreicht werden kann sondern da er f r alle TSR Programme offen ist die eine Kommunikationsschnittstelle nach au en ben tigen Nachdem ein TSR Programm bei seinem ersten Aufruf installiert ist k nne
31. e Spalten in obiger Tabelle haben dabei die folgende Bedeutung Parameter Bereich CITOUCHD INI Vorgabe Beschreibung Syntax des Kommandozeilenparameters Erlaubter Wertebereich Abschnitt und zugeh riger Eintrag in der Datei CITOUCHD INI Wert der verwendet wird wenn sowohl der Kommandozeilenparameter als auch der Eintrag in die CITOUCHD INI Datei fehlt Kurze Erlauterung der Funktion des Kommandozeilenparameters 4 2 Vordefinierte Maustasten Emulationsmodi Es existieren 8 vordefinierte Emulationsmodi Einer davon wird Uber den Aufrufparameter m beim Start von CiTouchD ausgew hlt Wird kein Maustasten Emulationsmodus beim Aufruf von CiTouchD angege ben wird der im Abschnitt Commands der CITOUCHD INI Datei festgelegte Emulationsmodus verwen det Im folgenden werden die vordefinierten Modi einzeln erl utert m 0 Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI m 1 Beschreibung Parameter Beispiel 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 c gt citouchd exe m 0 Genaues Timing des Maustastendrucks Einfache Bedienung Bewegung des Cursors bei gedr ckter Maustaste m glich Ungenaue Positionierung des Maustastendrucks bei Verwendung absoluter Koordinaten Relative Koordinaten nicht sinnvoll Geringe Sicherheit gegen Fehlbedienung Commands
32. egmentadresse der Kenndaten SI Offsetadresse der Kenndaten AX FFFFh Fehler oder 0021h ok BX Anzahl der Mauskn pfe In AX wird stets FFFFh zur ckgeliefert da Beschleunigungkurven in Zusammenhang mit einem IRT keinen Sinn machen Aktuelle Beschleunigungskurve auslesen AX 002Ch AX Funktionsstatus lt gt 0 Fehler oder 0000h ok BX Nummer der aktuellen Beschleunigungskurve 0 3 ES Segmentadresse des Buffers SI Offsetadresse des Buffers In AX wird stets FFFFh zur ckgeliefert da Beschleunigungkurven in Zusammenhang mit einem IRT keinen Sinn machen Aktuelle Beschleunigungskurve einstellen abfragen AX 002Dh BX 1 aktuelle Beschleunigungskurve abfragen oder BX 1 4 diese Beschleunigungskurve aktivieren AX Funktionsstatus lt gt 0 Fehler oder 0000h ok BX Nummer der aktuellen Beschleunigungskurve 0 3 ES Segmentadresse des Buffers mit Namen der Kurve SI Offsetadresse des Buffers mit Namen der Kurve In AX wird stets FFFFh zur ckgeliefert da Beschleunigungkurven in Zusammenhang mit einem IRT keinen Sinn machen Einstellungen der Ballpoint Maus setzen abfragen AX 0030h BX Drehwinkel CX Kommando Code AX Funktionsstatus 1 keine Ballpoint Mouse oder lt gt 0 ok BX Drehwinkel CX aktive Buttons In AX wird stets FFFFh zur ckgeliefert da CiTouchD keine Ballpoint M use unterst tzt Softwareschnittstelle Benutzerhandbuch CiTouchD 5 3 Erweitert
33. ei inaktivem Touch Saver auf Unterbrechungen des Touchbereichs Des weiteren besitzt der IRT einen PWM Ausgang der z B zur Helligkeitseinstellung der Hintergrundbe leuchtung von TFT Displays eingesetzt werden kann Der CiTouchD Treiber ordnet nun den zwei Zust nden aktiv und inaktiv des Touch Savers je ein be stimmtes Puls Pausenverh ltnis des PWM Ausgangs und somit unterschiedliche Helligkeiten der Hin tergrundbeleuchtung zu Die Aktivierungszeit des Touch Savers l t sich ber die folgenden API Funk tionen einstellen citGetTouchSettings Funktion OCh Abfrage der Aktivierungszeit citSetTouchSettings Funktion 15h Andern der Aktivierungszeit 16 Benutzerhandbuch CiTouchD Softwareschnittstelle Die zugeh rigen Elemente der Struktur TOUCHSETTINGS sh S 42 lauten tsTSaver Aktivierungszeit des Touch Savers 0 sofort aktiv 65535 abgeschaltet tsTScan Abstand zwischen zwei Scanvorgangen bei aktivem Touch Saver Die Helligkeit der Hintergrundbeleuchtung l t sich ber die folgenden API Funktionen einstellen citGetDimming Funktion 1Dh citSetDimming Funktion 1Eh Abfrage der Helligkeitswerte Andern der Helligkeitswerte Die Parameter werden in der Struktur DIMMING sh S 40 bergeben In der Datei CITOUCHD INI steuern die folgenden Eintr ge die Touch Saver Funktion Settings DimmingHigh Helligkeit bei inaktivem Touchsaver Normalbetrieb entspricht tsDimmHigh DimmingLow Helligkeit bei aktivem Touchs
34. eigt auf einen 8 Zeichen lan gen String AL 00h Kein residentes Programm unter dieser Kennung vorhanden EG DI ist in diesem Fall ung ltig Beschreibung Wenn CiTouchD installiert ist liefert die Funktion im AL Register den Wert FFh und im Registerpaar ES DI einen Zeiger auf den Identifizierungsstring CiTouchD ASCIIZ Format zur ck Dann und nur dann k nnen auch die anderen Funktionen des Multiplex Interrupts aufgerufen werden Der in AH anzugebende Wert h ngt von der Rechnerkonfiguration ab Eine genaue Erkl rung findet sich im Kapitel Ermittlung der Kennummer auf Seite 21 Funktion 01h citGetPSP Eingabe AL 01h AH Kennung des CiTouchD Treibers R ckgabe ES DI Segment und Offset des residenten Teils von CiTouchD Beschreibung Diese Funktion liefert den PSP des residenten Teils des Treibers 26 Softwareschnittstelle Funktion 05h Eingabe R ckgabe Beschreibung Funktion 06h Eingabe R ckgabe Beschreibung Funktion 07h Eingabe R ckgabe Beschreibung Benutzerhandbuch CiTouchD citGetFlags AL 05h AH Kennung des CiTouchD Treibers AX Momentaner Zustand des CiTouchD Treibers Im R ckgabewort liegt der aktuelle Treiberzustand in Form von Bit Flags vor Die einzelnen Bits haben dabei die folgende Bedeutung Bit3 IFLSMOOTH_ALWAYS Gl ttung auch zwischen zwei Ber hrungen Bit 4 IF_FIRST_COORDINATE Erste Koordinatenmeldung Bit5 IFLBEEP_MODE Akkustische R ckmeldung bei Ma
35. enung zu verringern kann festgelegt werden wann sich die Cursorposition ndern darf Dabei existieren die folgenden M glichkeiten e Enter cmCoordEnterZ 0 cmCoordSignalZ 0 Es wird eine neue Cursorposition gemeldet sobald eine g ltige Unterbrechung des Touchbereichs vorliegt e Z Press Enter cmCoordEnterZ 1 cmCoordSignalZ 0 Diese Option ist nur verf gbar wenn der IRT ber Drucksensoren verf gt Damit nach dem Eintauchen eine neue Cursorposition gemeldet wird muB 14 Softwareschnittstelle Benutzerhandbuch CiTouchD 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 cmCoordEnterZ 1 cmCoordSignalZ 1 Diese Option ist nur verf gbar wenn der IRT ber Drucksensoren verf gt Neue Cursorpositionen werden nur gemeldet solange der eingestellte Druck auf die Frontscheibe berschritten wird Das Verhalten wird mit den folgenden Funktionen eingestellt citGetCoordMode Funktion 08h Abfrage der Parameter citSetCoordMode Funktion 11h Andern der Parameter Die Parameter werden in der Struktur COORDMODE sh S 40 bergeben In der Datei CITOUCHD INI steuern die folgenden Eintr ge den Koordinatenmodus Calibration XRel_Div Divisor f r X Koordinatenskalierung entspricht crDivX XRel_Mul Multiplikator f r X Koordinatenskalierung entspricht crMulX YRel_Div Divisor f r Y Koordi
36. er Koordi naten e Relativ komplizierte Bedienung Commands Time1 0 Time2 0 Time3 Idie_T1 2 T1_Trigger u Trigger_T2 T2_UPT3 0 UPT3_lIdle UPT3_Trigger 0 Settings TapTime 1 Time Ist der Touchbereich unterbrochen und erfolgt f r eine Zeit T1 keine Mausbewe gung 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 unterbro chen so erfolgt ein sofortiger Maustastendruck T2 ist in Schritten zu 55 ms zwischen 0 ms und 2 s einstellbar c gt citouchd exe m 3 500 300 e Einfache Bedienung e Bewegen des Cursors bei gedr ckter Maustaste m glich e Ungenaues Timing des Maustastendrucks e Geringe Sicherheit gegen Fehlbedienung Commands Time1 t1 Time2 Time3 12 Idle_T1 T1_Trigger Trigger_T2 u T2_UPT3 UPT3_Idle UPT3_ Trigger 2 Konfiguration m 4 n Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI m 5 n Beschreibung Parameter Beispiel Vorz ge Nachteile CITOUCHD INI Benutzerhandbuch CiTouchD Dual Touch Ist der T
37. erade laufenden Programms Der Vorgabe wert ist 6 HardReset 0 1 2 Dieser Eintrag legt fest ob in den Maus API Funktionen Software Interrupt 33h 00h int33ResetAndStatus und 2Fh int33HardReset ein Reset des Touches durchgef hrt werden soll Da dieser Vorgang bis zu 10 Sekunden dauern kann im Falle eines Fehlschlagens l t sich der Reset abschalten Der Vorgabewert ist 0 Wert Bedeutung 0 Weder in Funktion 00h noch in Funktion 2Fh wird ein Reset des Touches ausgef hrt 1 Nur in Funktion int33HardReset wird ein Reset des Touches ausgef hrt 2 Sowohl in Funktion 00h als auch in Funktion 2Fh wird ein Reset des Touches ausgef hrt 49 OCITRON 7 INDEX A absolute Koordinaten ccccccesesseseseeeeeeees 14 AbsoluteMouse ccccccccccccnonoconcnncoconononanononos 46 49 ACCELERATION oseese 37 42 AUTO ROI iii 46 B Backlight Dimming ooooccccnccccnnoniccconanacannnnnnnos 16 Baudiveor 45 DBeamTimeout ahisi anid 46 Button ee in ark 46 Button lick4 2 2e ee 46 Button Machine 12 C Calida a a e 43 CALIBRATIONABS ccccccoccnonononinoconononeninininnnos 38 CALIBRATIONREL 00000cccccseeeeeeeeeeeeeeeeaees 38 CITOUCHWIN esse nana nana 42 Citron JInfrarot Touch A COMMANDG essen eee eee 38 39 44 A erh 46 GoordEnterZ stees Meet aie 46 CoordinateSkip cccceceeeeceeeeeeeeesteeeeneeeeees 47 COORDMODE E a ata 40 GoordSignalz nie ea 47 Cursor Control 15 Cursorbes
38. 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 und Rechner auto matisch neu angekoppelt werden soll Der Vorgabewert ist Ja 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 bedeutet 1 die linke Taste 2 die rechte Taste und 3 beide Taste gleichzeitig der Vorgabewert ist 1 ButtonClick Ja Nein Dieser Eintrag legt fest ob bei einem Maustastendruck eine akustische R ckmeldung ber den PC Laut sprecher erfolgen soll Der Vorgabewert ist Ja ContTime 0 65535 Di
39. erruptrate der Maus Hardware einstellen 1Dh int33SetCrtPage Bildschirmseite f r Maus Cursor setzen 1Eh int33GetCriPage Bildschirmseite des Maus Cursor ermitteln 1Fh int33Disable Touch Treiber deaktivieren 20h int33Enable Touch Treiber aktivieren 21h int33SoftReset Softwarereset des CiTouchD Treibers 22h int33SetLanguage Sprache f r Meldungen einstellen 23h int33GetLanguage Sprache f r Meldungen abfragen 24h int33Inquire Version Maustyp und IRQ ermitteln 25h int33InquireEx Allgemeine Informationen abfragen 26h int33GetMouseScreen Ausdehnung des virtuellen Maus Bildschirms abfragen 27h int33GetCursorMask Bit Masken des Bildschirm Cursors abfragen 28h int33SetVideoMode Videomodus setzen 29h int33InquireVideoModes Liste der verf gbaren Video Modi abfragen 2Ah int33GetCursorInfo Informationen ber Maus Cursor Abfragen 2Bh int33SetAcceleration Beschleunigungskurve einstellen 2Ch int33GetAcceleration Aktuelle Beschleunigungskurve auslesen 2Dh int33GetSelectAccel Aktuelle Beschleunigungskurve einstellen abfragen 2Fh int33HardReset Reset der Touch Hardware 30h int33InquireBallpoint Einstellungen der Ballpoint Maus setzen abfragen 31h int33GetVirtualScreen Ausdehnung des virtuellen Bildschirms abfragen 32h int33InquireFunc Unterst tzte Funktionen ermitteln 33h int33InquireAll Einstellungen ermitteln 34h int83Getlni Lage der Datei CITOUCHD INI ermitteln 5 2 2 Besonderheiten der Int 33 API Emulation Einige Funktionen der In
40. ers AX Momentaner Arbeitsmodus des CiTouchD Treibers Der R ckgabewert stellt den Arbeitsmodus als Bitfeld vor Die Bits haben dabei folgende Bedeutung Bit 0 CTDF_VESA gt VGA Karte unterst tzt VESA Standard Bit 1 CTDF_CHANGEMODE gt Video Modus wurde ge ndert Bit 2 CTDF_TEXT gt Grafikkarte arbeitet im Textmodus Bit 3 CTDF_SOFT gt Verwendung des Software Textcursors Bit 4 CTDF_EGA gt EGA Karte gefunden Bit 5 CTDF_VGA gt VGA Karte gefunden Bit 6 CTDF_MONO gt monochromer EGA VGA Video Modus Bit 7 CTDF_EXTVIDEO gt Funktion des erweiterten Video BIOG Bit 8 CTDF_STACK gt CiTouchD nutzt eigenen Stack Bit 9 CTDF_HARDRESETO gt Touch Reset in Fkt Int33h 00h Bit 10 CTDF_HARDRESET2F gt Touch Reset in Fkt Int33 2Fh Bit 11 CTDF_HIDE gt Keine eigener Cursor unter WINDOWS Bit 12 CTDF_SYS gt CiTouchD in CONFIG SYS geladen Bit 13 CTDF_CONDOFF gt Conditional off ist aktiv Diese Version von CiTouchD unterst zt CTDF_EGA CTDF_EXTVIDEO und CTDF_SYS noch nicht Diese Bits sind stets 0 Setzen des Hardware Reset Handlings AL 28h AH Kennung des CiTouchD Treibers BX Zu andernde Flags AN O falls Read Only Flags ge ndert werden sollten ber diese Funktion l t sich das Reset Verhalten des Touches bei Aufruf der Int33h Funktionen 00h und 2Fh ber die Flags CTDF_HARDRESETO Bit 9und CTDF_HARDRESET F Bit 10 ndern Alle anderen Flags sind Read Only und m ssen in BX auf 0
41. erungsfaktor dcFixedBias f r die Festkommazahlen kann mittels citGetDriverConstants Funktion OEh und caMulX bzw caMulY mittels citGetCalibrationAbs Funktion 09h abgefragt werden Die Gr en acBorderX und acBorderY werden in Touch Koordinaten angegeben Der Wertebe reich betr gt acBorderX ma 32767 acBorderY nax 32767 37 OCITRON BUTTONBEEP Softwareschnittstelle Diese Struktur enth lt die Parameter f r die Maustastenklickerzeugung Typ Name WORD bbFreqDown WORD bbTimeDown WORD bbFreqUp WORD bbTimeUp WORD bbClickMode CALIBRATIONABS Beschreibung Frequenz des Tones beim Niederdr cken der Maustaste in Hertz Hz Dauer des Tones beim Niederdr cken der Mausta ste in Millisekunden ms Frequenz des Tones beim Loslassen der Maustaste in Hertz Hz Dauer des Tones beim Loslassen der Maustaste in Millisekunden ms Eine Kombination der folgenden Konstanten die festlegt wann ein Ton erzeugt wird 00h BC_OFF Keine Tonerzeugung 01h BC_DOWN Tonausgabe beim Dr cken der emulierten Maustaste 02h BC_UP Tonausgabe beim Loslassen der emulierten Maustaste 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 mit y kalibrierte Koordinate und x vom IRT gelieferte Koordinate CiTouchD erwartet kalibrierte Koordinaten mit einem Wertebereich von 0 bis 65535 Typ Na
42. eser Eintrag bestimmt den Abstand zwischen zwei Koordinatenmeldungen des IRT Der zeitliche Ab stand errechnet sich aus dem hier angegebenen Wert in Millisekunden Dabei ist die zur Ubertragung einer Koordinatenmeldung ben tigte Zeit abh ngig von der Baudrate zu beachten Der Vorgabewert ist 22 CoordEnterZ Ja Nein 46 CITOUCHD INI Benutzerhandbuch CiTouchD Dieser Eintrag legt fest ob zur Meldung der ersten Cursorposition nach dem Eintauchen zusatzlich 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 ist Nein CoordinateSkip 0 65535 Dieser Eintrag bestimmt die Anzahl von Koordinatenmeldungen des IRT die nach den Eintauchen igno riert werden sollen Der Vorgabewert ist 1 CoordSignalZ Ja Nein Dieser Eintrag legt fest ob zur Meldung weiterer Cursorpositionen 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 ist Nein 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 ist 1 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
43. ffnetem Empfangskanal meldet allerdings keine Cursorbewegungen oder Maustastendr cke mehr 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 Funktion citReceive gelesen werden Bei der Notification wird hingegen ein Event Handler des Anwenderprogramms aufgerufen sobald ein kompletter Bericht empfangen wurde Die Adresse des Event Handlers legt der Benutzer beim Aufruf der citOpen Funktion fest Der Aufbau der Benachrichtigung ist auf Seite 42 beschrieben 25 O C IT RO N Softwareschnittstelle 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 angefor derter Bericht nicht von nachfolgenden Koordinatenmeldungen des IRT berschr
44. gesetzt sein Softwareschnittstelle Benutzerhandbuch CiTouchD 5 3 4 Referenz der Strukturen Zur Parameter bergabe an die erweiterten API Funktionen sind zahlreiche Strukturen definiert Es folgt eine alphabetische Auflistung dieser Strukturen Dabei ist zu beachten da von den API Funktionen keinerlei zus tzliche F llbytes zwischen den Strukturelementen erwartet werden Es werden die folgenden Datentypen verwendet Typ L nge char 1 Byte BYTE 1 Byte short 2 Byte WORD 2 Byte BOOL 2 Byte DWORD 4Byte Wertebereich Beschreibung 128 127 vorzeichenbehafteter Integerwert 0 255 vorzeichenloser Integerwert 32768 32767 vorzeichenbehafteter Integerwert 0 65535 vorzeichenloser Integerwert O 1 vorzeichenloser Integerwert Werte ungleich 0 werden als WAHR der Wert 0 wird als FALSCH interpretiert 0 4294967295 vorzeichenloser Integerwert ACCELERATION Diese Struktur enth lt die Parameter f r die Cursorbeschleunigung Typ Name Beschreibung short acMulX Beschleunigungsfaktor fur X Koordinaten short acMulY Beschleunigungsfaktor fur 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 acMulX max ei 32767 dcFixedBias caMulX _ 32767 dcFixedBias acMulY max caMulY berechnet Der Skali
45. i a het atl ae ee 42 6 151 Acceleration its Hear tires 42 6 12 Calibration ET 43 le Tune DEE 44 6 1 4 Hardware EE 45 6 15 Settings EE 46 GER REI EE 48 OG IT RO N Einf hrung 2 Einf hrung Der CiTouchD Maustreiber Citron Touch Treiber f r MS DOS erm glicht den Einsatz eines Citron In frarot Touchs im Folgenden kurz IRT genannt als Mausersatz unter dem Betriebssystem MS DOS Voraussetzung f r den Betrieb des CiTouchD ist MS DOS Version 3 0 oder h her sowie mindestens ein 386 Prozessor Der in CiTouchD integrierte Maustreiber bietet die Funktionen eines Standard DOS Maustreibers an die zur Bestimmung der Cursorposition Position der Touch Unterbrechung und der Simulation einer Maustaste n tig sind Ein bereits zuvor installierter Treiber f r eine normale Maus wird durch den CiTouchD Treiber abgeschaltet so da diese Maus nicht mehr als Eingabemedium verwendet werden kann Bevor mit der Installation begonnen wird mu der IRT an eine serielle Schnittstelle des Rechners ange schlossen werden Dabei ist zu beachten da f r den Betrieb des CiTouchD Treibers unbedingt eine interruptf hige serielle Schnittstelle ben tigt wird Wird eine Citron LDVGA Grafikkarte zusammen mit der LDRI Empf ngerkarte eingesetzt ist ein geeig neter IRT Anschlu bereits ber das Verbindungskabel zur Display Einheit erfolgt In diesem Fall mu nur noch die Basisadresse und der Interruptkanal f r die SIO1 der LDVGA Karte eingestellt werde
46. ieben werden kann M gliche Befehle f r den IRT und der Aufbau von IRT Berichten unterscheiden sich im Mode C Kom munikationsprotokoll und im CTS1 Protokoll Die jeweils g ltigen Befehle sind im Handbuch zum IRT erl utert Nr Bezeichnung Funktion Seite 16h citSend Sendet ein Byte zum IRT 31 17h citReceive Empf ngt einen kompletten Bericht vom IRT 32 18h citOpen ffnet dem Empfangskanal vom IRT zum Rechner 32 19h citClose SchlieBt den Empfangskanal 33 1Ah citReceiveStatus Ermittelt den Zustand des Empfangskanals 33 1Ch citCheckBreak Pr ft eine serielle Schnittstelle auf 100ms Breaks 34 5 3 2 4 Allgemeine Hilfsfunktionen Der CiTouchD Treiber stellt neben den f r die Mausemulation ben tigten Schnittstellen auch noch einige n tzliche Zusatzfunktionen zur Verf gung Nr Befehl Funktion Seite 00h citPresence Installationsstatus abfragen 26 01h citGetPSP PSP des residenten Treibers ermitteln 26 25h citDetectLDVGA Pr ft ob eine LDVGA Karte vorhanden ist 35 26h citPlaySound Gibt einen Ton auf dem PC Lautsprecher aus 36 5 3 3 Referenz der erweiterten API Funktionen Es folgt eine Referenz aller erweiterten API Funktionen in numerischer Reihenfolge Diese sind ber den Int 2Fh Multiplex Interrupt erreichbar Die Bestimmung der erforderlichen Kennung des CiTouchD Trei bers wurde weiter oben bereits beschrieben Funktion 00h citPresence Eingabe AL 00h AH Kennung des CiTouchD Treibers R ckgabe AL 0FFh Kennung g ltig ES DI z
47. ierung absoluter X Koordinaten X_Mul ist eine vorzeichenlose Festkommazahl Der Skalierungsfaktor kann mit der Funktion citGetDriverConstants abgefragt werden Der Vorgabewert ist 256 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 43 OCITRON CITOUCHD INI 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 Funktion OEh abgefragt werden Der Vorgabewert ist 256 YRel_Div 0 65535 Dieser Eintrag bestimmt 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 12 Die Zahlenwerte f r die Zustands bergangsbedingungen besitzen die folgende Bedeutung We
48. is dieser Druck abz glich einer Hysterese wieder unterschritten wird Pressure Sensitivity p 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 c gt citouchd exe m 7 10 e Einfache Bedienung e Bewegung des Cursors bei gedr ckter Maustaste m glich e Hohe Sicherheit gegen Fehlbedienung e IRT mu mit Drucksensoren ausger stet sein Commands Time1 0 Time2 Time3 Idle_T1 3 T1_Trigger Trigger_T2 7 T2_UPT3 u UPT3_lIdle UPT3_Trigger 0 Settings Pressure p Softwareschnittstelle Benutzerhandbuch CiTouchD 5 Softwareschnittstelle Es folgt eine Einf hrung in die Funktion des CiTouchD Treibers und eine Beschreibung der Anwender programmen zur Verf gung gestellten Softwareschnittstellen 5 1 Grundlagen Um die API Funktionen des CiTouchD Treiber einsetzen zu k nnen ist ein Verst ndnis der Funktion der Mausemulation erforderlich Dies soll in den folgenden Kapiteln vermittelt werden 5 1 1 Koordinatensysteme Positionen werden innerhalb des Touchtreibers immer auf einen virtuellen Grafikbildschirm bezogen dessen Aufl sung von dem jeweiligen Videomodus und der ihm zugrundeliegenden Grafik Karte abh ngt Da dieser virtuelle Grafikbildschirm auch innerhalb der verschiedenen Textmodi zur Bestimmung der Touchunterbrechung herangezogen wird und die Grundlage f r die Kommunikation mit dem Touch Interface darste
49. ister sind beim Aufruf des Event Handlers auf die folgenden Werte gesetzt AX Zustand des Empfangspuffers wie bei citReceive Funktion 17h CX Anzahl der Bytes im Empfangspuffer ES DI Zeiger auf den Empfangspuffer von hier darf nur gelesen werden Der Event Handler mu einen der folgenden Werte in AX zur ckliefern 00h Empfangspuffer wurde nicht gelesen Zustand des Puffers soll nicht ver ndert werden 01h Empfangspuffer wurde gelesen Zustand der Empfangspuffer soll gel scht werden 6 CITOUCHD INI In der Datei CITOUCHD INI speichert der CiTouchD Treiber seine Parameter Beim Start von CiTouchD werden die hier abgelegten Werte verwendet sofern sie nicht durch Kommandozeilenparameter ber schrieben werden Im folgenden werden die einzelnen Abschnitte und Eintr ge der Datei CITOUCHD INI in alphabetischer Reihenfolge aufgef hrt Ist ein Eintrag nicht vorhanden so wird der im Treiber fest eingespeicherte Vor gabewert oder der entsprechende Kommandozeilenparameter verwendet Die folgenden Abschnitte werden in CITOUCHD 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 Citouchd Einstellungen f r Verhalten von CiTouchD als Maustreiber 6
50. k 640 350 Punkte 640 350 Punkte 11h Grafik 640 480 Punkte 640 480 Punkte 12h Grafik 640 480 Punkte 640 480 Punkte 13h Grafik 320 200 Punkte 320 200 Punkte 5 1 3 Benutzerdefinierte Tastenemulation Im CiTouchD 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 erforderlichen Bedingungen eintreffen Das genaue Zustands Ubergangs Diagramm der Button Machine ist in Abbildung 5 1 dargestellt 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 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 int T1_ Trigger 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 Beim Eintreten in den Zustand TRIGGER wird ein Maustastendruck emuliert Beim bergang in den Zustand T3 wird die Maustaste wieder losgelassen 11 O C IT RO N Softwareschnittstelle Idle_T1 ldle_T1 v Mausbewegung T1_Trigger t 0 Trigger_T2 Trigger_T2 T2_UPT3 v t 0 t T3 UPT3_Idlev t 0 Button
51. llt mu jeweils eine Umrechnung zwischen diesen Grafikkoordinaten und der Spalten bzw Zeilenkoordinate des Cursors vorgenommen werden Da jede Spalte und Zeile acht Punkten entspricht m ssen die Grafikkoordinaten durch acht geteilt werden Der Ursprung des virtuellen Bildschirms liegt in der linken oberen Ecke Die Koordinaten werden nach unten und nach rechts positiv gez hlt sind also immer positiv Die Funktionen OFh und OBh der Int33 API liefern relative Koordinaten Aus Kompatibilit tsgr nden zur Maus wurde hier die Einheit Mickeys 1 400 Zoll beibehalten Funktion OFh erlaubt die Einstellung des Verh ltnisses zwischen Mickeys und 8 virtuellen Pixeln Relative Koordinaten sind vorzeichenbehaftet Negative Vektoren stehen f r eine Bewegung nach links oben positive Vektoren f r eine Bewegung nach rechts unten 5 1 2 Unterst tzte Videomodi Unterst tzt werden alle ber Funktion 00h des EGA VGA BIOS einstellbare Video Modi Bildschirmmodus Text Grafik Aufl sung Virtueller Bildschirm 00h Text 40 25 Zeichen 320 200 Punkte 01h Text 40 25 Zeichen 320 200 Punkte 02h Text 80 25 Zeichen 640 200 Punkte 03h Text 80 25 Zeichen 640 200 Punkte 04h Grafik 320 200 Punkte 320 200 Punkte 05h Grafik 320 200 Punkte 320 200 Punkte 06h Grafik 640 200 Punkte 640 200 Punkte 07h Text 80 25 Zeichen 640 200 Punkte ODh Grafik 320 200 Punkte 320 200 Punkte OEh Grafik 640 200 Punkte 640 200 Punkte OFh Grafik 640 350 Punkte 640 350 Punkte 10h Grafi
52. me 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 fur die Y Koordinate Orientierung des IRT gegen ber dem Display Dabei wird einer der folgenden Werte entsprechend der Position des IRT AnschluBsteckers gegen ber der linken oberen Display Ecke angegeben 00h OR_TOPLEFT linke obere Ecke 01h OR_TOPRIGHT rechte obere Ecke 02h OR_BOTTOMRIGHT rechte untere Ecke 03h OR_BOTTOMLEFT linke untere Ecke Die Gr en caMulX und caMulY sind vorzeichenlose Festkommazahlen Der Skalierungsfaktor f r die Festkommazahlen kann mittels citGetDriverConstants Funktion OEh abgefragt werden CALIBRATIONREL Diese Struktur enth lt die Parameter f r die Kalibrierung relativer Koordinaten Die verwendete Formel zur Kalibrierung relativer Koordinaten lautet 38 Typ short WORD short WORD US y x Name crMulX crDivX crMulY crDivY Beschreibung m f r die X Koordinate a f r die X Koordinate m fur die Y Koordinate a f r die Y Koordinate Softwareschnittstelle COMMAN DS Benutzerhandbuch CiTouchD Diese Struktur enth lt die Parameter f r die Maustastenemulation Die Erzeugung eines Mausta stendrucks ist in Kapitel Benutzerdefinierte Tastenemulation auf Seite 12 beschrieben Typ Name Beschreibung cmdT1 erste Zeitkonstante in Einheiten von 1 ms cmdT2 zweite Zeitkonstante in Ei
53. n Dies erfolgt ber das im LDVGA Handbuch beschriebene Utility LDVINST Im Gegensatz zu einer normalen Maus besteht bei CiTouchD die M glichkeit mit absoluten Koordinaten zu arbeiten Dabei wird die Bewegung des Fingers auf der Bildschirmoberfl che nicht in eine relative Anderung 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 ent weder 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 nach empfinden 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 CiTouchD in weiten Grenzen durch den Benutzer konfigurier und programmierbar S mtliche Parameter welche die Arbeitsweise des CiT
54. n gleichzeitig Nummer der vom IRT verwendeten seriellen Schnittstelle Die Option kombiniert i und p wobei von den PC Standard Schnittstellen ausgegangen wird COM1 c 1 gt Port 3F8h IRQ 4 COM2 c 2 gt Port 2F8h IRQ 3 COMS c 3 gt Port 3E8h IRQ 4 COM4 c 4 gt Port 2E8h IRQ 3 Entfernt den residenten Teil des CiTouchD Treibers wieder aus dem Speicher Gr e des von CiTouchD einge richteten Stacks in Schritten von 256 Byte Im Falle von k 0 verwendet CiTouchD den Stack des gerade laufenden Programms Nummer des von der seriellen Schnittstelle verwendeten IRQ Maustasten Emulationsmodus je nach Modus sind weitere Parameter erforderlich Diese werden durch Kommas ohne Leerzeichen abge trennt Basisadresse der seriellen Schnitt stelle Der Parameter wird als Hexa dezimalzahl interpretiert Es sind keine f hrenden Nullen erforderlich Einstellung ob Touch durch die Maus API Funktion 00h und 2Fh zur ckgesetzt wird R cksetzen dauert bis zu 10 Sekunden 0 keine Zur cksetzung 1 R cksetzen nur in Fkt 2Fh 2 R cksetzen nur in Fkt 00h OCITRON Konfiguration kt 0 1 2 128 Hardware 0 Kommunikationsprotokoll des ange IRT_Mode schlossenen IRT 0 automatische Erkennung 1 Mode C 2D Touch 2 CTS1 3D Touch Wird ber diesen Parameter das richtige Kommunikationsprotokoll angegeben erfolgt das Ankoppeln des IRT schneller als bei der automati schen Erkennung Di
55. n weitere Aufrufe von der DOS Kommandozeile aus dazu genutzt werden bestimmte Parameter in der bereits installierten Kopie des Programms einzustellen oder das Programm wieder aus dem Speicher zu entfernen Das neuerlich aufgerufene Programm tritt mit dem bereits installierten Teil dabei ber den Multiplex Interrupt in Kontakt Ein Programm das den Multiplex Interrupt kurz MUX nutzen will mu sich zun chst selbst eine 8 Bit Kennnummer geben Die Kennummern von 00h bis BFh sind dabei von Microsoft f r eigene DOS Pro gramme reserviert der Bereich von COh bis FFh ist jedoch frei und kann von Anwendungsprogrammen d h von eigenen TSR Programmen genutzt werden Da die Wahl der Kennummer innerhalb von COh bis FFh freigestellt ist besteht die M glichkeit da mehrere Programme dieselbe Nummer besitzen Um diesem Problem beizukommen mu jedes Pro gramm das den Multiplex Interrupt nutzen will eine Funktion f r den Installations Check bereitstellen Diese wird ausgef hrt wenn beim Multiplexer Aufruf im AH Register die Kennummer des jeweiligen Programms und im AL Register der Wert 00h bergeben werden Entdeckt einer der bereits installierten Handler seine Kennummer mu er daraufhin einen Wert ungleich 00h in der Regel FFh im AL Register zur ckliefern CiTouchD durchl uft auf diese Weise alle Kennummern von COh an aufw rts und h ngt sich an die erste freie Stelle Da bei dieser Vorgehensweise die Kennummer von CiTouchD nicht
56. natenskalierung entspricht crDivY YRel_Mul Multiplikator fur Y Koordinatenskalierung entspricht crMulY SmoothAlways entspricht dsSmoothAlways CoordinateSkip entspricht dsCoordSkip Commands ModeChange entspricht cmModeChange Settings AbsoluteMouse entspricht dsAbsolute CoordEnterZ entspricht cmCoordEnterZ CoordSignalZ entspricht cmCoordSignalZ 5 1 4 3 Cursor Beeinflussung Mit diesen Parametern 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 CiTouchD Treibers bewegt sich die Cursorposition au erhalb eines Bereichs einstellbarer Gr e schneller als der Finger auf den Bildschirmrand zu Somit kann in jedem Fall der u erste Bildschirmrand erreicht werden Die Cursorbeschleunigung wird nur zusammen mit absoluten Koordinaten verwendet 15 O C IT RO N Softwareschnittstelle X Acceleration Border Touch Koordinaten lt gt 0 0 gt x Im schraffierten Bereich bewegt sich der Cursor schneller als der Y Acceleration Ber hrpunkt auf den Display Rand zu Border In diesem Bereich stimmt die Cursorgeschwindigkeit mit der Geschwindigkeit des Ber hrpunkts berein Zum Einstellen der Beschleunigungsparameter werden die folgenden API F
57. ndet Wurden beim Programmstart zus tzlich Kommandozeilenparameter ange geben so berschreiben diese die Werte aus der CITOUCHD INI Datei Dabei wird auch der Inhalt der Datei auf die neuen Werte aktualisiert Welche Eintr ge in die Datei CITOUCHD INI m glich sind ist im Kapitel CITOUCHD INI auf Seite 42 beschrieben Benutzerhandbuch CiTouchD Konfiguration Aufrufe der Programmierschnittstelle verandern lediglich die internen Variablen des Treibers Der Inhalt der CITOUCHD INI Datei wird dadurch nicht ge ndert 4 1 Kommandozeilenparameter CiTouchD versteht die folgenden Kommandozeilenparameter in beliebiger Reihenfolge unter Ber cksichtigung von Gro Kleinschreibung Parameter Bereich Vh H 2 5 D oi b 1 3 JC 1 A d S k 0 64 fi 0 15 m 0 7 p 1 FFFF Ir 0 2 CITOUCH INI Settings Button Hardware Interrupt IO Base Citouchd Stack Hardware Interrupt Commands m gliche Eintr ge sh n chstes Kapitel Hardware IO Base Citouchd HardReset Vorgabe 4 3D Touch 7 2D Touch 5 3F8 Beschreibung Gibt alle zulassigen Kommandozei lenparameter aus Installationsstatus von CiTouchD Aktuelle Einstellungen des resident installierten Teils von CiTouchD Hard und Softwarestand des ange schlossenen IRT Gibt an welche Maustaste emuliert werden soll 1 linke Maustaste 2 rechte Maustaste 3 beide Maustaste
58. nheiten von 1 ms cmdT3 dritte Zeitkonstante in Einheiten von 1 ms cmdldleT1 Bedingung 1 cmdT1Trigger Bedingung 2 cmdTriggerT2 Bedingung 3 cmdT2UpT3 Bedingung 4 cmdUpT3ldle Bedingung 5 cmdUpT3Trigger Bedingung 6 cmdModeChange Bedingung f r Wechsel zwischen absoluten und relativen Koordinaten cmdReserved1 reserviert M gliche Werte f r die Bedingungen 1 bis 6 lauten Wert 00h 01h 02h 03h 04h 05h 06h 07h 08h Bezeichnung BM_NEVER BM_IMMED BM_ENTER BM_ZPRESS BM_DUAL BM_TAP BM_LEAVE BM_ZRLSE BM_NODUAL Bedeutung niemals WAHR immer WAHR WAHR sobald der Touchbereich unterbrochen wird WAHR sobald ein bestimmter Druck auf den Touchbereich berschritten wird WAHR sobald eine Doppelber hrung des Touchbereichs vorliegt WAHR sobald der Touchbereich f r kurze Zeit verlassen und dann erneut unterbrochen wird WAHR sobald der Touchbereich wieder verlassen wird WAHR sobald der Druck auf den Touchbereich wieder unterschritten wird WAHR sobald keine Doppelber hrung des Touchbereichs mehr vorliegt F r das Feld cmdModeChange k nnen die folgenden Werte verwendet werden Wert 00h 03h 04h 05h Bezeichnung MC_NEVER MC_ZPRESS MC_DUAL MC_TAP Bedeutung Niemals umschalten WAHR sobald ein bestimmter Druck auf den Touchbereich berschritten wird WAHR sobald eine Doppelber hrung des Touchbereichs vorliegt WAHR sobald der Touchbereich f r kurze Zeit verlassen und dann erneut unter
59. nten nicht ge ndert werden Es werden die Parameter f r die Maustastenemulation auf die ber gebene COMMANDS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 39 Eine Beschreibung der Funktion der Maustastenemulation befindet sich in Kapitel Benutzerdefinierte Tastenemulation auf Seite 12 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citSetCoordMode AL 11h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine COORDMODE Struktur mit den neuen Pa rametern zur Koordinatenausgabe AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Parameter zur Koordinatenausgabe auf die berge bene COORDMODE Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Falls ein ndern der Parameter nicht m glich war bleibt der alte Zustand erhalten citSetCalibrationAbs AL 12h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine CALIBRATIONABS Struktur mit den neuen absoluten Kalibrierungsparametern AX 0001h Die neuen Parameter konnten eingestellt werden EX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Kalibrierungsparameter des absoluten Koordinaten modus auf die bergebene CALIBRATIONABS Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 38 Falls das Andern der Parameter nicht m glich war bleibt der alt
60. onClick 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 keine Tonerzeugung Tonerzeugung wenn die Maustaste gedr ckt wird Tonerzeugung wenn die Maustaste losgelassen wird Tonerzeugung sowohl beim Dr cken als auch beim Losgelassen der Maustaste OM OH Der Vorgabewert ist 1 48 CITOUCHD INI Benutzerhandbuch CiTouchD 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 Der Vorgabewert ist 1046 TimeDown 0 65535 Dieser Eintrag legt die Dauer des Tons der beim Dr cken der Maustaste erzeugt wird in Millisekunden schritten fest Der Vorgabewert ist 30 TimeUp 0 65535 Dieser Eintrag legt die Dauer des Tons der beim Loslassen der Maustaste erzeugt wird in Millisekun denschritten fest Der Vorgabewert ist 30 6 1 7 Citouchd In diesem Abschnitt sind die Parameter f r das Verhalten von CiTouchD als Maustreiber eingetragen Im Abschnitt Citouchd sind die folgende Eintr ge m glich Stack 0 64 Dieser Eintrag legt fest wieviel Stack CiTouchD f r sich reserviert Der Wert entspricht der Stackgr e in 256 Byte Bl cken Im Falle von Stack 0 arbeitet CiTouchD auf dem Stack des g
61. ouchD beeinflussen werden in einer INI Datei im ASCII Format abgespeichert Alle Einstellungen lassen sich sowohl w hrend der Installation als auch im laufenden Betrieb ver ndern 3 Aufruf von CiTouchD Der CiTouchD Treiber wird durch einen Aufruf der Datei CITOUCHD EXE von der MS DOS Komman dozeile oder aus der AUTOEXEC BAT resident in den Speicher des Computers geladen Bevor CiTouchD gestartet wird mu der IRT an eine serielle Schnittstelle des Rechners angeschlossen werden Dabei ist zu beachten da f r den Betrieb des CiTouchD Treibers unbedingt eine interruptf hige serielle Schnittstelle ben tigt wird Wird eine Citron LDVGA Grafikkarte zusammen mit der LDRI Empf ngerkarte eingesetzt ist ein geeig neter IRT Anschlu bereits ber das Verbindungskabel zur Display Einheit erfolgt In diesem Fall mu nur noch die Basisadresse und der Interruptkanal f r die SIO1 der LDVGA Karte eingestellt werden Dies erfolgt ber das im LDVGA Handbuch beschriebe Utility LDVINST 4 Konfiguration Die Parameter zur Konfiguration des CiTouchD Verhaltens k nnen auf drei verschiedene Arten gesetzt werden 1 bergabe als Kommandozeilenparameter 2 Eintr ge in der Datei CITOUCHD INI 3 Aufrufe der Programmierschnittstelle Int 33h bzw Int 2Fh API Dabei verwendet CiTouchD die Parameter in der folgenden Reihenfolge Zun chst liest der Treiber seine Parameter aus der Datei CITOUCHD INI Fehlt dort ein Eintrag so wird der Vorgabewert verwe
62. ouchbereich unterbrochen und erfolgt gleichzeitig eine zweite Ber hrung so wird ein Maustastendruck emuliert Die Taste bleibt solange gedr ckt wie die Zweifachber hrung besteht Dual Touch Skip Count n Legt fest wieviel Zweifachber hrungsmeldungen verworfen werden bevor der Maustastendruck emuliert wird einstellbar zwi schen 0 und 255 c gt citouchd exe m 4 1 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 Commands Time1 0 Time2 0 Time3 0 Idle_T1 2 T1_Trigger 4 Trigger_T2 8 T2_UPT3 0 UPT3_ldle 0 UPT3_ Trigger 0 Settings DbIErrSkip n 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 n Legt fest wieviel Zweifachber hrungsmeldungen verworfen werden bevor der Maustastendruck emuliert wird einstellbar zwi schen 0 und 255 c gt citouchd exe m 5 1 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 Commands Time1 0 Time2 0 Time3 0 Idle_T1 2 T1_Trigger
63. r durch die TP_ Kon stanten definierten Werte annehmen Bezeichnung des IRT 0 terminierter String ASSY Nummer des IRT 0 terminierter String E EPROM F FLASH Memory reserviert Im Mode C Protokoll Optionaler Kommentar 0 terminierter String Im CTS1 Protokoll Seriennummer des IRT 0 ter minierter String 41 OCITRON CITOUCHD INI TOUCHSETTINGS Diese Struktur enth lt die einstellbaren Parameter des IRT Typ Name Beschreibung WORD tsMinBeamsX Minimale Anzahl unterbrochener X Lichtschranken WORD tsMinBeamsY Minimale Anzahl unterbrochener Y Lichtschranken WORD tsBeamTimeout Ausblendzeit f r fehlerhafte Lichtschranken in Ein heiten von 1 s WORD tsTCont Abstand zwischen zwei Koordinatenmeldungen in Einheiten von 1 ms WORD tsPressLevel Druckempfindlichkeit WORD tsTSaver Zeit nach welcher der Touch Saver aktiviert wird in Einheiten von 1 s WORD tsTScan Abstand zwischen zwei Scanvorg ngen bei aktivem Touch Saver in Einheiten von 1 ms 5 3 5 Benachrichtigung durch CiTouchD Wurde beim Aufruf von citOpen Funktion 18h ein Zeiger auf einen Event Handler bergeben so ruft CiTouchD sobald ein kompletter Bericht des IRT empfangen wurde diesen Event Handler auf Dabei ist zu beachten da der Event Handler innerhalb der Interrupt Service Routine von CiTouchD aufgerufen wird und daher m glichst schnell wieder zur ckkehren sollte Insbesondere d rfen keine DOS bzw BIOS Funktionen aufgerufen werden Die Reg
64. r f r die Cursorbeschleunigung AX Anzahl der in die ACCELERATION Struktur geschriebenen Bytes Es werden die Parameter f r die Cursorbeschleunigung in die ber gebene ACCELERATION Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 37 34 Softwareschnittstelle Funktion 21h Eingabe Ruckgabe Beschreibung Funktion 22h Eingabe Ruckgabe Beschreibung Funktion 23h Eingabe Ruckgabe Beschreibung Funktion 25h Eingabe Ruckgabe Beschreibung Benutzerhandbuch CiTouchD citSetAcceleration AL 21h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine ACCELERATION Struktur mit den neuen Parametern f r die Cursorbeschleunigung AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die Parameter f r die Cursorbeschleunigung auf die bergebene ACCELERATION Struktur ge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 37 Falls das Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citGetButtonBeep AL 22h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine BUTTONBEEP Struktur zur bernahme der Maustastenklick Parameter AN Anzahl der in die BUTTONBEEP Struktur geschriebenen Bytes Es werden die Parameter f r die Erzeugung des Maustastenklicks in die bergebene BUTTONBEEP Struktur eingetragen Eine Be schreibung dieser Struktur
65. ragen Eine Beschreibung dieser Struktur befindet sich auf Seite 38 citGetDriverSettings AL 0Bh AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine DRIVERSETTINGS Struktur zur Uber nahme der Treiberparameter AN Anzahl der in die DRIVERSETTINGS Struktur geschriebe nen Bytes Es werden die veranderbaren Treiberparameter in die Ubergebene DRIVERSETTINGS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 40 Softwareschnittstelle Funktion 0Ch Eingabe R ckgabe Beschreibung Funktion 0Dh Eingabe R ckgabe Beschreibung Funktion OEh Eingabe R ckgabe Beschreibung Funktion OFh Eingabe R ckgabe Beschreibung Benutzerhandbuch CiTouchD citGetTouchSettings AL 0Ch AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine TOUCHSETTINGS Struktur zur Uber nahme der veranderbaren IRT Parameter AN Anzahl der in die TOUCHSETTINGS Struktur geschriebe nen Bytes Es werden die ver nderbaren IRT Parameter in die Ubergebene TOUCHSETTINGS Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 42 citGetTouchHardware AL 0Dh AH Kennung des CiTouchD Treibers d ES DI Zeiger auf eine TOUCHHARDWARE Struktur zur Uber nahme der konstanten IRT Parameter AN Anzahl der in die TOUCHHARDWARE Struktur geschrie benen Bytes Es werden die unver nderlichen IRT Parameter in die bergebene TOUCHHARDWARE Struktur eingetr
66. reichs hinweg erfolgen soll Der Vorgabewert ist Nein 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 Vor gabewert ist 500 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 Koordi naten gemittelt wird Die obere Grenze kann mit der Funktion citGetDriverConstants abgefragt 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 Koordi naten gemittelt wird Die obere Grenze kann mit der Funktion citGetDriverConstants angefragt werden Der Vorgabewert ist 10 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 Butt
67. rt Bedeutung Never Immediately Enter Z Press Dual Touch Tap Leave Z Release No Dual Touch On Oa P o MA O Im Abschnitt Commands sind die folgenden Eintr ge m glich Idie_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 ist 0 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 fiir den Ubergang vom Zustand T2 in den Zustand T3 Der Vorgabewert ist 0 Time1 0 65535 44 CITOUCHD INI Benutzerhandbuch CiTouchD Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T1 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert ist 0 Time2 0 65535 Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T2 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert ist 0 Time3 0 65535 Dieser Eintrag bestimmt die Zeitkonstante f r den Zustand T3 Die Angabe entspricht der gew nschten Zeit in Millisekunden Der Vorgabewert ist 0 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_lIdle 0 8 Dieser Eintrag bestimmt die Bedingung f
68. t 33 API unterscheiden sich in Details vom Verhalten des Microsoft Treibers Diese Funktionen werden im folgenden einzeln erlautert Funktion 13h Schwelle f r Verdoppelung der Mausgeschwindigkeit setzen Eingabe AX 0013h DX Schwelle f r Verdoppelung der Mausgeschwindigkeit R ckgabe keine Besonderheiten Die Schwelle f r die Verdoppelung der Mausgeschwindigkeit in DX wird zwar intern gespeichert aber ansonsten ignoriert Funktion 1Ah Maus Sensitivit t einstellen Eingabe AX 001Ah BX Anzahl horizontaler Mickeys die 8 Pixeln entsprechen CX Anzahl vertikaler Mickeys die 8 Pixeln entsprechen DX Schwelle f r Verdoppelung der Mausgeschwindigkeit R ckgabe keine Besonderheiten Die Schwelle f r die Verdoppelung der Mausgeschwindigkeit in DX wird zwar intern gespeichert aber ansonsten ignoriert 18 Softwareschnittstelle Funktion 1Ch Eingabe Ruckgabe Besonderheiten Funktion 22h Eingabe Ruckgabe Besonderheiten Funktion 24h Eingabe Ruckgabe Besonderheiten Funktion 27h Eingabe Ruckgabe Besonderheiten Funktion 29h Eingabe R ckgabe Besonderheiten Benutzerhandbuch CiTouchD Interruptrate der Maus Hardware einstellen AX 001Ch BX Interrupt Rate keine Die Ubergebene Rate wird intern gespeichert ansonsten ignoriert Sprache f r Meldungen einstellen AX 0022h BX Codenummer der Sprache keine Es wird nur die Codenummer 0 Englisch
69. t installed CR LF r MsgFound BYTE CR LF LDVGA found CR LF S MsgNoLDVGA BYTECR LF No LDVGA detected CR LF r IDStr BYTE CiTouchD 0 Multiplex indentifier string IDNr BYTE Storage for found MUX code 23 OCITRON 24 Softwareschnittstelle CODE Start PROC NEAR mov ax DGROUP Initialize DS mov ds ax Start searching with number 0COh mov cld SearchIDLoop mov mov int Look if zes OFER bx 0COh only bl is of interest bx is used for easier overflow test String compare from left to right al PRESENCE verify presence function ah bl next identifier number to search for 02Fh a tsr with multiplex support is installed under this identify number cmp al OFFh jne SearchIDLoopNext Look if identify string matches ZA ESDI points to CiTouchb if right tsr mov cx IDLEN mov si OFFSET IDStr DS SI points to compare string REPE cmpsb jnz SearchIDLoopNext No match gt carry on search mov IDNr bl else store ID number and jmp Detect search LDVGA SearchIDLoopNext inc bx cmp bx 0100h look if search for all possible ID numbers jne SearchIDLoop gt if not next try ID String not found gt quit with error message mov jmp ax OFFSET MsgErr PrintOut DS DX points to message check presence of LDVGA via multiplex function DETECTLDVGA Detect mov mov int or jz mov jmp NotFound
70. tus der emulierten Maustaste ermitteln 04h int33SetCursorPos Maus Cursor bewegen 05h int33GetBtnPress Anzahl der Bet tigungen der emulierten Maustaste ermitteln 06h int33GetBtnRelease Wie oft wurde die emulierte Maustaste losgelassen 07h int33SetMinMaxHor Horizontalen Bewegungsbereich f r Maus Cursor festlegen 08h int33SetMinMaxVer Vertikalen Bewegungsbereich f r Maus Cursor festlegen 09h int33SetGraphicsCursor Maus Cursor im Grafikmodus definieren OAh int33SetTextCursor Maus Cursor im Textmodus definieren OBh int33ReadMotionCounters Bewegungswerte ermitteln OCh int33InstallEvent Event Handler installieren ODh int33LightPenOn Emulation des Lichtgriffels anschalten OEh int33LightPenOff Emulation des Lichtgriffels abschalten OFh int33SetMickeyPixelRatio Verh ltnis zwischen Mickeys und Pixeln setzen 10h int33ConditionalOff Ausschlu Bereich definieren 13h int33SetDoubleThreshold Schwelle f r Verdoppelung der Mausgeschwindigkeit setzen 14h int33SwapEvents Austauschen der Event Handler 15h int33GetStateSize Gr e des Touch Status Puffers ermitteln 16h int33SaveState Touch Status sichern 17h int33RestoreState Touch Status restaurieren 18h int33SetAltEvent Alternativen Event Handler installieren 19h int33GetAltEvent Adresse eines alternativen Event Handlers ermitteln 1Ah int33SetSensitivity Maus Sensitivit t einstellen 17 OCITRON Softwareschnittstelle 1Bh int33GetSensitivity Maus Sensitivit t ermitteln 1Ch int33SetInterruptRate Int
71. u emulierenden Maustaste 1 linke Maustaste 2 rechte Maustaste 3 beide Maustasten gleichzeitig TRUE wenn nach einer Unterbrechung der Verbin dung zwischen IRT und Rechner automatisch neu angekoppelt werden soll TRUE wenn bei einem Maustastendruck zusatzlich eine akustische R ckmeldung erfolgen soll TRUE wenn absolute Koordinaten verwendet wer den sollen TRUE wenn die Koordinatengl ttung auch ber ein Verlassen und erneutes Eintauchen hinweg erfolgen soll Diese Struktur enth lt die Parameter der seriellen Schnittstelle Beschreibung Basisadresse des seriellen Schnittstellenbausteins Zugeh riger ISA Bus Interruptkanal Teiler f r die Baudrate Diese Struktur enth lt die unver nderlichen Parameter des IRT WORD dsTapTime WORD dsCoordSkip WORD dsDberrSkip WORD dsButtonNum BOOL dsAutolnit BOOL dsButtonClick BOOL dsAbsolute BOOL dsSmoothAlways SERIALHARDWARE Typ Name WORD shPort short shinterrupt WORD shBaudDiv 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 Beschreibung Anzahl der physikalisch vorhandenen X Licht schranken Anzahl der physikalisch vorhandenen Y Licht schranken Maximale vom IRT gelieferte X Koorinate Maximale vom IRT gelieferte X Koorinate Vom IRT verwendetes Kommunikationsprotokoll Dieses Feld kann einen de
72. unktionen verwendet citGetAcceleration Funktion 20h Abfrage der Beschleunigungsparameter citSetAcceleration Funktion 21h Andern der Beschleunigungsparameter Die Parameter werden in der Struktur ACCELERATION sh S 37 bergeben Zum Einstellen des Abstands zwischen Ber hrpunkt und Cursorposition werden die folgenden API Funk tionen verwendet citGetDriverSettings Funktion OBh Abfrage des Abstands citSetDriverSettings Funktion 14h Andern des Abstands Die zugeh rigen Elemente der Struktur DRIVERSETTINGS sh S 40 lauten dsOfsX X Abstand zwischen Ber hrpunkt und Cursorposition dsOfsY Y Abstand zwischen Ber hrpunkt und Cursorposition In der Datei CITOUCHD INI steuern die folgenden Eintr ge die Cursorbeeinflussung Acceleration X_Border X Grenze au erhalb derer die Beschleunigung greift entspricht acBorderX Y_Border Y Grenze au erhalb derer die Beschleunigung greift entspricht acBorderY X_Mul X Beschleunigungsfaktor entspricht acMulX Y_Mul Y Beschleunigungsfaktor entspricht acMulY Settings X_Offset entspricht dsOfsX Y_Offset entspricht dsOfsY 5 1 4 4 Steuerung der Hintergrundbeleuchtung 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 als b
73. ur mit den neuen IRT Parametern AX 0001h Die neuen Parameter konnten eingestellt werden AX 0000h Die Parameter konnten nicht ge ndert werden Es werden die IRT Parameter auf die Ubergebene TOUCHSETTINGS Struktur abge ndert Eine Beschreibung dieser Struktur befindet sich auf Seite 42 Falls ein Andern der Parameter nicht m glich war bleibt der alte Zustand erhalten citSend AL 16h AH Kennung des CiTouchD Treibers BL 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 m ssen vom Anwenderprogramm eingef gt werden 31 OCITRON Funktion 17h Eingabe R ckgabe Beschreibung Funktion 18h Eingabe R ckgabe Beschreibung 32 Softwareschnittstelle citReceive AL 17h AH Kennung des CiTouchD Treibers ES DI Zeiger auf einen Puffer in welchen der empfangene Bericht kopiert wird AX Zustand des Empfangspuffers M gliche R ckgabewerte sind 00h CRS_IDLE Kein Bericht verf gbar 01h CRS_READY Ein Bericht wurde empfangen 02h CRS_OVER Es wurden weitere Berichte empfangen Der zuerst emp fangene Bericht befindet sich aber noch vollst ndig im Puf fer 04h CRS_CLOSE Der Treiber wurde nicht durch citOpen Funktion 18h ge ff net Wurde
74. ustastenereignissen Bit6 IFLABSOLUTE_MODE Es werden absolute Koordina ten verwendet Bit 7 1F_Z TOUCH Es wurde ein 3D IRT gefunden Bit8 IF ENABLED Der Treiber ist aktiviert Bit 11 IF_INT_ON Die Hardware Interrupts sind freigegeben Bit 12 IF_BREAK Es wurden BREAKs vom IRT empfangen Bit 13 IF_AUTOREINIT Automatische Neuinitialisie rung ist eingeschaltet Bit 14 IFLON_SLAVEPIC Der verwendete Interruptvektor befindet sich auf dem zweite PIC des Rechners Bit 15 IF_IRT_EXISTS Ein IRT wurde gefunden citGetSerialHardware AL 06h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine SERIALHARDWARE Struktur zur Uber nahme der seriellen Schnittstellenparameter AX Anzahl der in die SERIALHARDWARE Struktur geschrie benen Bytes Es werden die seriellen Schnittstellenparameter in die Ubergebene SERIALHARDWARE Struktur eingetragen Eine Beschreibung dieser Struktur befindet sich auf Seite 41 citGetCommands AL 07h AH Kennung des CiTouchD Treibers ES DI Zeiger auf eine COMMANDS Struktur zur bernahme der Parameter f r die Maustastenemulation AX Anzahl der in die COMMANDS Struktur geschriebenen Bytes Es werden die Parameter f r die Maustastenemulation in die ber gebene COMMANDS Struktur eingetragen Eine Beschreibung die ser Struktur befindet sich auf Seite 39 Eine Beschreibung der Funk tion der Maustastenemulation befindet sich in Kapitel Benutzerdefinierte Tastenemulation auf Seit
75. wie m glich zu bedienen ist existieren eine Reihe weiterer Parameter mit denen das Verhalten der Mausemulation auf die Bed rfnisse des Benutzers und der Applikation angepa t werden k nnen Diese Parameter werden entweder in der CITOUCHD INI Datei dauerhaft eingestellt oder von der jeweiligen Applikation durch Aufruf der erweiterten API Funktionen tempor r ver ndert 5 1 4 1 Gl ttung Die Aufl sung des IRT im Mode C Kommunikationsprotokoll ist bei Verwendung absoluter Koordinaten nicht ausreichend um im Grafikmodus 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 Koordina tenmeldungen gebildet Die Anzahl der bei der Mittelwertbildung zu ber cksichtigenden Koordinatenmel dungen kann f r die X und die Y Achse getrennt eingestellt werden Die API Funktionen und zugeh rigen Strukturelemente f r die Gl ttungsparameter lauten im Einzelnen citGetDriverSettings Funktion OBh Abfrage der Einstellungen citSetDriverSettings Funktion 14h Ver ndern der Einstellungen Die zugeh rigen Elemente der Struktur DRIVERSETTINGS sh S 4

- Citron GmbH

Contents

Download Pdf Manuals

Related Search

Related Contents