;============================================================================================================
;
;			GeneralTouch AcousticWave Touchscreen serial interface
;                          README file for touchscreen software for Windows 9x/Me.
;
;			        	Version 2.21
;			  Copyright 2000-2001 General Touch Co. Ltd.
;
;============================================================================================================

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 Component
3.Problem solution
4.Application Programming Information
  4.1 Z_Axis Capability
  4.2 Touchscreen Application Programming Interface(API)

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

1.1 Install Touchscreen Software
====================================================================================
Do the following to install your touchscreen and software:

    1. Shutdown Windows 9x/Me 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 to which you attach your touchscreen.
    8. Complete the Setup program.
    9. Restart Windows 9x/Me 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 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 GenHlp.hlp file.

1.3 Uninstall Touchscreen Software
=====================================================================================

    1. Click the "Start" button, point to "Settings", and then click
       "Control Panel".
    2. Double-click the "Add/Remove Programs" icon.
    3. Select "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 is composed of the following programs:

          GenTouch.VxD               Our 32bit touchscreen driver for Windows 9x/Me.

          GenTouch.Cpl               32 bit touchscreen control panel for windows 9x/Me.

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

          GenCalib.exe               Our touchscreen calibration program.

	  GenHlp.Hlp                 Our touchscreen help file,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.	Problem solution
=============================

 Our touchscreen driver now use "VCOMM" client services instead of writing directly to the serial
COM ports to communicate with our serial touchscreen controller,so the following is essential:
    1.corresponding COM port exists in Device Manager and working properly.
    2.no driver exclusively uses corresponding COM port before our device driver load.

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

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

Windows 95/98 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 windows 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.VxD) 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) 
         Bit 0 = 1,Touchscreen Message                                                                   
	 Bit 1 = 1,Touchscreen Support Z Coordinate,Bit16-Bit23 is the Z Coordinate.

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

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

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

      if(nZ_Coord)
      {
      	//	TODO: your code is to placed here when a touch screen 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.Here are their corresponding declarations:

   A.GetMouseMode:Get Touchscreen current mouse mode.
	BOOL WINAPI GetMouseMode(PULONG pMouseMode);

   B.SetMouseMode:Set Touchscreen Mouse Mode.
     	BOOL WINAPI SetMouseMode(ULONG  nMouseMode);

   C.GetBeep:Get Touchscreen current beep settings.
	BOOL WINAPI GetBeep(PBEEP_INFO pBeepInfo);
	
   D.SetBeep:Set Touchscreen beep settings.
	BOOL WINAPI SetBeep(ULONG nBeepMode, ULONG nBeepFreq, ULONG nBeepTime);

   E.EnableTouchscreen:Enable or disable touchscreen events handling.
	BOOL WINAPI EnableTouchscreen(BOOL bEnable);
	
NOTES:
   To learn how to use these functions to suit your case, or have questions about this,
   contact us for more details about this.

;==============================================================================================================
;
;                                   General Touch Co. Ltd.
;  				 http://www.GeneralTouch.com
;
;                                   All rights reserved.
;
;==============================================================================================================
      

