;=================================================================================================
;
;  GeneralTouch RS232,AcousticWave Touchscreen
;  README for Touchscreen driver for Windows NT 4.0
;
;  Version 1.10 
;
;
;  Copyright 1998-2001, General Touch Co. Ltd.All rights reserved.
;
;=================================================================================================
   
Thank you for choosing our RS232,acousticWave touchscreen products!! This README file contains
additional notes about our touchscreen software which,we think,will help you make better use of
our touchscreen and touchscreen software.

================
CONTENTS
================

1.Install/Uninstall manual
  1.1 Install touchscreen software
  1.2 Change touchscreen settings
  1.3 Uninstall touchscreen software
2.Software package component
3.Release Notes
4.Application Programming Information
  4.1 Z_Axis capability
  4.2 Touchscreen Application Programming Interface(API)
5.Contact GeneralTouch

===================================
1.	Install/Uninstall Manual
===================================

================================================
1.1 	Install touchscreen driver software
================================================

Note: you must have administrator access rights on the Windows NT 4.0 system 
to install this touchscreen driver for Windows NT 4.0. You must also have 
adminstrator access rights to run the touchscreen control panel and 
calibration applications.

    1. Shutdown Windows NT and turn off your computer.

    2. Install your touchscreen hardware.

    3. Start your computer.

    4. After Windows loads, click the "Start" button, and then click "Run".

    5. Click the "Browse" button to locate the GenInst.exe program in
       the directory containing the driver install files. Click OK,
       then OK again to run GenInst.exe

    6. Follow the directions on the screen.

    7. Choose the COM port you install your touchscreen.

    8. Complete the setup program.

    9. Restart Windows NT when prompted. The touchscreen
       calibration program will automatically run when Windows
       starts up. Touch the targets as they appear on the screen. 
       Click Yes when the cursor lines up correctly with your finger.

================================================
1.2	Change Touchscreen driver settings
================================================

    1. Click the "Start" button,point to "Settings",and then "control panel".

    2. Double-click the "GeneralTouch Touchscreen" icon, now you can change touchscreen settings.
       for more about touchscreen settings,see help file.

================================================
1.3 	Uninstall Touchscreen driver software
================================================

    1. Click the "Start" button, point to "Settings", and then click
       "Control Panel".

    2. Double-click the "Add/Remove Programs" icon.

    3. Select "GeneralTouch RS232,AcousticWave Touchscreen" from the list of
       uninstallable programs on the Install/Uninstall tab.

    4. Click the "Add/Remove" button then follow the directions on
       your screen.

    5. Restart Windows to complete the uninstall process.

============================================
2.	Software Component
============================================

Our touchscreen software package for Windows NT is composed of the following programs:

          GenTouch.sys               32 bit touchscreen driver for Windows NT 4.0

	  Genstub.sys		     32 bit touchscreen stub driver for Windows NT 4.0.

          GenTouch.Cpl               32 bit touchscreen control panel.

	  GenInst.exe                32 bit touchscreen software package install/Uninstall
				     program,with it,all hardware installation and software 
				     configuration is quite easy.

          GenCalib.exe               32 bit touchscreen calibration program.

	  GenHelp.Hlp                Touchscreen help file with internet style, you can get more
				     information about our product and device settings.
     
          RButton.exe                Touchscreen button mode switching utility,though left
                                     button is enough for most circumstances,right button 
				     may be very useful sometimes.
          
          Write.exe                  Our touchscreen support z axis coordinate now,so write
                                     on our touchscreen and see what happened!

          README.txt                 It's me!


=============================
3.	Release Notes
=============================

-  The system mouse class driver MOUCLASS.SYS is required by the driver. most times,
   it is installed during Windows NT installation process.if not,our device driver 
   will not work.

-  Our device driver depends on the Windows NT 4.0 beep service (BEEP.SYS) to make audible 
   feedback,so if NT beep service (BEEP.SYS) does not work,there will be no beep here.

-  Our touchscreen driver now use serial service to communicate with our touchscreen 
   controller,so it will not make a serial COM port invisible to the user.

-  Because serial communications services are not available until late in the 
   Windows NT 4.0 startup process, the touchscreen will not begin to function for several 
   seconds after the Windows NT logon dialog is displayed.

============================================
4.	Application Programming Information           
============================================

============================================
4.1 	Z_Axis Capability
============================================

Win32 programmers can make advantage of our touchscreen's z_axis capabilities.
For a demo,just click "Begin" --"Programs"--"GeneralTouch Touchscreen"
---"Handwriting Demo" and write on our touchscreen.

Z_Axis support can make our applications more active and interesting. For Win32 programmers,
it is very important to know how to obtain z coordinate data.The following information describes
how to obtain z coordinate data.

First,you must verify that our device driver(GenTouch.sys) is installed and working properly.
you can do it by using Win32 API call CreateFile(to get more details about CreateFile function
call,see your Win32 API reference book).

Then,you can use the GetMessageExtraInfo() function to receive additional mouse event 
information when mouse events ocurr.It's 0 for real mouse events,nonezero for touchscreen
events.Here is the bit definitions for what you get from call GetMessageExtraInfo():

                 (High Word)                          (Low Word)
     Bit31          Bit23          Bit16 Bit15                         Bit0            
      0 0 0 0 0 0 0 0 X X X X X X X X      0 0 0 0 0 0 0 0 0 0 0 0 0 0 X X
                      ( Z Coordinate)   	                       ( Message Flag) 

	Message Flag:	
		Bit 0 = 1,It's a touchscreen message                                                                   
	 	Bit 1 = 1,Touchscreen supports z coordinate,Bit16-Bit23 is the z coordinate.

	Z Coordinate:
		total 8 bits,in range 0-255

The following code fragment demonstrates how to obtain z coordinate data.

////////////////////////////////////////////////////////////////////////////////////////////////////
//
// 	call the following code when mouse events occur
//
////////////////////////////////////////////////////////////////////////////////////////////////////

      WORD 	nZ_Coord;
      nZ_Coord = (HIWORD)GetMessageExtraInfo();

      if(nZ_Coord)
      {
          //	TODO: your code is to placed here when a touchscreen event ocurrs.
      }
      else
      {
	 //     TODO: your code is to  placed here when a mouse event ocurrs.
      }

See a Win32 API for more information about Windows function call.

==============================================================
4.2	Touchscreen Application Programming Interface(API)
==============================================================

In additional to Z_Axis support,Our control panel program also provides several useful
exported function calls.If you want to know them in detail,please contact us.


===============================
5. Contact GeneralTouch
===============================

GeneralTouch Technology Co. Ltd.

Add:Sunsing High-Tech Zone,
    No.8 Shuangxing North Road,
    Xiejiaci,Chengdu,Sichuan,P.R.China

Tel:(86)28-7344128
Fax:(86)28-7341133

http://www.generaltouch.com

;===================================================================================================
;
;                                 General Touch Co. Ltd.
;			(Visit us at:http://www.GeneralTouch.com)
;                                   All rights reserved.
;
;===================================================================================================

