                    Touch Screen Drivers and Utilities, 
                    Release 3.0.0 for Windows 9x
                    -----------------------------------

Copyright (c) 1995-1999, Dynapro Technologies Inc.
All rights reserved.

This file contains the following sections:

	1. Installation Diskette
	2. How to Install/Upgrade the Touch Screen Software
	3. Concurrent Mouse and Touch Screen Operation
	4. Exporting/Importing Touch Screen Configurations
	5. New Features Not Described in Manual
	6. Uninstalling the Touch Screen Drivers software
	7. Developer Touch Error Detection


1.  INSTALLATION DISKETTE
-------------------------

The Dynapro Touch Screen Driver Disk contains all the software you need
to use an NFI touch screen and NFI touch controller with Windows 9x.
Included on this diskette are the touch screen driver and configuration
utilities.

The following files are contained on this installation diskette:

    INSTALL.EXE - Installation utility

    VDTCD.VXD	- Touch Screen Virtual Device Driver (DTC)
    VDTCD.INF   - Installation script used by Windows 9x
    README.TXT	- This file

    TOUCHCFG.EXE- Touch Screen Configuration Utility executable
    TOUCHCFG.HLP- Touch Screen Configuration Utility help file
    TOUCHINI.EXE- Touch Screen Configuration Import/Export Utility
    TOUCHERR.EXE- Touch Screen Startup Log Utility executable
    TOUCHERR.DLL- Touch Screen Startup Log Devloper Dynamic Link Library
    MBSWAP.EXE  - Mouse Button Selector Utility executable
    MBSWAP.HLP  - Mouse Button Selector Utility help file
    NSD.EXE     - NFI Setup and Diagnostic Utility
    NFISETUP.EXE - NFI Setup Wizard

    TOUCHOSI.DLL- Touch Screen Dynamic Link Library
    MSVCRT.DLL  - Touch Utilities Dynamic Link Library
    XNMBA458.DLL- Touch Utilities Dynamic Link Library
    XNMHN458.DLL- Touch Utilities Dynamic Link Library
    XNMTE458.DLL- Touch Utilities Dynamic Link Library

    UNINSTAL.EXE- Uninstallation utility.
    UNINSTAL.INF- Uninstallation script file.
    INSX16.DLL  - Uninstallation Dynamic Link Library
    INSX32.DLL  - Uninstallation Dynamic Link Library



2.  HOW TO INSTALL/UPGRADE THE TOUCH SCREEN SOFTWARE
----------------------------------------------------

To install or upgrade the software onto your computer, you must have
Windows 9x running and a floppy disk drive.  Follow these steps:

1.  From the "Start" menu, select "Run". Enter the full path to the
    installation utility in the "Open" field (e.g. A:\install.) 
    You can use the "Browse" button to find the install utility. 
    Choose OK to continue.

2.  The "Dynapro Touch Screen installation" window will appear and 
    the first dialog will display the following information: 
    driver version, touch screen configuration, target directory and
    target folder.  You will not be able to change any of this
    information. Select "Next" to proceed with the installation.

3.  The next dialog will enable you to select the communication port for
    the Touch Screen operation. Select the desired port from the list of 
    standard ports or define a custom port using the "Interrupts"
    and "I/O Address" lists. Select "Back" to go to the previous 
    dialog, select "Cancel" to abort the installation or select "Next" 
    to proceed with the installation.

4.  The last dialog will display all the entered installation information.
    If you are satisfied with your choices, select "Install" to start the
    installation.  All installation steps will be displayed on the screen.
    Once installation has been completed, you will be prompted to restart
    Windows 9x.  Select "Yes" to do so.  When Windows 9x restarts, the
    touch screen will be operational.

5.  The touch screen must be aligned after installation to ensure proper 
    operation.  Alignment ensures the touch screen is oriented and aligned
    with the video display.  To do this use the "Configuration" item from
    the "Touch Screen Utilities" start sub-menu.  Select "Alignment" and
    then press the "Alignment" button.  Follow the prompts, touching where
    instructed.  When satisified with the alignment, choose "Ok" to both save
    and active the alignment points defined.

The installation process places the files contained on the installation 
diskette into the following locations, on the hard drive where your Windows 9x
directory resides:

    \TOUCH\W9x
        README.TXT
        TOUCHCFG.EXE
        TOUCHCFG.HLP
        TOUCHINI.EXE
        TOUCHERR.EXE
        MBSWAP.EXE
        MBSWAP.HLP
        NSD.EXE
        NFISETUP.EXE

        MSVCRT.DLL
        XNMBA458.DLL
        XNMHN458.DLL
        XNMTE458.DLL

        UNINSTAL.EXE
        UNINSTAL.INF
        INSX16.DLL
        INSX32.DLL

    \WINDOWS\SYSTEM
        VDTCD.VXD
        TOUCHERR.DLL



3.  CONCURRENT MOUSE AND TOUCH SCREEN OPERATION
-----------------------------------------------

The Windows 9x Touch Screen driver supports concurrent mouse and touch 
screen operation.  To facilitate this, you must ensure that an appropriate
driver is installed for your mouse.  The recommended way for to achieve
this is via the "Add New Hardware" Wizard in the Control Panel.  Connect
your mouse to the computer and instruct the Wizard to search for new
hardware by selecting "Yes" at the prompt on the first screen.  Do NOT
select "No" and manually choose a mouse driver.

Once the Add New Hardware Wizard has detected your mouse and installed
the appropriate mouse driver, your mouse will work concurrently with
the touch screen.

If the Wizard fails to detect your mouse, then it can not be used
concurrently with the touch screen.  A mouse that is detectable by
Windows 9x, such as a Microsoft or Logitech mouse is required.



4.  EXPORTING/IMPORTING TOUCH SCREEN CONFIGURATIONS
---------------------------------------------------

Included with this software is a Touch Screen Configuration Import/Export 
Utility (TOUCHINI.EXE).  Installed with the touch screen software, this 
utility is located in the \TOUCH\W9x directory.  The utility allows you 
to configure the touch screen driver by importing a file containing the 
configuration data into the Windows 9x Registry.  It will also extract the
current touch screen configuration from the Registry and write it to a file.

By using the TOUCHINI utility, you can easily generate a configuration file
that may be copied to other computers and then imported without requiring 
manual configuration of each unit.

Exporting:
---------

To export the current configuration from the Windows 9x Registry into a
file, execute the following command from a Windows 9x DOS command prompt:

        TOUCHINI /o

This creates a file called TOUCH.INI, which contains an ASCII representation
of the touch screen configuration.  You can override the default filename
by specifying a file after the /o command line option (for example,
"TOUCHINI /oCONFIG.INI").  This file can later be used to import the same
configuration into your unit, as per the import instructions which follow.

Importing:
---------

To import a previously exported touch screen configuration file into the
Windows 9x Registry execute the following command from a Windows 9x DOS
command prompt:

        TOUCHINI /i[file name]

where [file name] is the name of the file you previously exported to
(like CONFIG.INI in the above example).  The new configuration will take
effect the next time you restart Windows 9x.

IMPORTANT: all previous touch screen configuration is erased during the
           import process except alignment and communication port data.


5. NEW FEATURES NOT DESCRIBED IN MANUAL
---------------------------------------

NFI SENSITIVITY
---------------

If you are using a Dynapro NFI touch screen, you can adjust the sensitivity of
the touch detection for your touch screen by selecting the sensitivity button
from within the the Interface Configuration Options dialog.  Sensitivity
ranges from low to high with six discrete levels as described below.  

1. Low is the least sensitive and is best for large size bare fingers.
2. Best for medium to large size bare fingers.
3. The default setting which is for average size bare fingers.
4. Best for cotton gloved fingers.
5. Best for suede gloved fingers.
6. High is the most sensitive and is best when wearing thick rubber gloves.

Please Note: These sensitivity descriptions are approximate and are subject
to change depending on the environmental influences surrounding the unit.

After selecting sensitivity using the slider bar provided, you can test
the new settings before applying them by the test button.  To apply your
selected setting press OK, or to quit and revert back to the previous setting
press Cancel.

6. UNINSTALLING THE TOUCH SCREEN DRIVER SOFTWARE
------------------------------------------------

To uninstall the touchscreen software you can use utility placed on your
Touch Screen directory "\TOUCH\W9x".
From the "Start" menu, select "Run" and enter the full path to the 
uninstallation utility (e.g. C:\TOUCH\W9x\UNINSTAL.EXE) and follow the
on-line instructions.

7. DEVELOPER TOUCH ERROR DETECTION
-----------------------------------------

Application Developers can use the supplied Dynamic Link Library -
"toucherr.dll" to detect touch screen and controller errors during startup.
The DLL provides a single function "C" API that reads startup errors from the
registry and returns the error string to the caller.

Interface Specification:

function - TouchGetErrorLogString

  The TouchGetErrorLogString function retrieves the data for the touch 
  error log value asociated with the DYNAPRO registry key. 

  LONG TouchGetErrorLogString
  ( 
    CHAR *pszBuffer,         /* pointer to pre-allocated char buffer */
    LONG *pnBufferSize       /* size of the above char buffer */
  ) 

 
Parameters:

  - pszBuffer

  Pointer to a buffer that receives the value's data. This parameter can be NULL
  if the data is not required. 

  - pnBufferSize

  A pointer to a variable that specifies the size, in bytes, of the buffer pointed
  to by the pszBuffer parameter. When the function returns, this variable
  contains the size of the data copied to pszBuffer parameter. 

  If the buffer specified by pszBuffer parameter is not large enough to hold the
  data, the function returns the value ERROR_MORE_DATA, and stores the required
  buffer size, in bytes, into the variable pointed to by pnbufferSize. 

  If pszBuffer is NULL, and nBufferSize is non-NULL, the function returns
  ERROR_SUCCESS, and stores the size of the data, in bytes,
  into the variable pointed to by pnbufferSize.

Return Values

  If the function succeeds, the return value is ERROR_SUCCESS.

  If the function fails, the return value is an error code as defined
  in WINERROR.H.

Sample Application Code:

  The following is a sample of code used to access the dll and retrieve
  the ErrorLog Value:

/* declarations */
typedef LONG (CALLBACK* LPFNDLLFUNC)(CHAR *,LONG *);
#define nERRORLOG_SIZE_MAX  1024

...

LONG YourErrorCheckFunction()
{
    CHAR         szValueBuffer[nERRORLOG_SIZE_MAX];
    LONG         nValueBufferSize = nERRORLOG_SIZE_MAX;
    LONG         status = ERROR_SUCCESS;
    HINSTANCE    hDLL;                      /* Handle to DLL */
    LPFNDLLFUNC  lpfnDllFunc;               /* function pointer */

    hDLL = LoadLibrary("TOUCHERR.DLL");

    if (hDLL != NULL)
    {
         lpfnDllFunc = (LPFNDLLFUNC) GetProcAddress(hDLL,"TouchGetErrorLog");

         if (!lpfnDllFunc)
         {
             /* handle error */
             status = ERROR;   
         }
         else
         {   
             /* call the function */
	     status = lpfnDllFunc1(szValueBuffer,&nValueBufferSize);
	     /* Buffer now contains error message if any */
         }

    FreeLibrary(hDLL);
    }
    return status;
}

----------------------------------------------------------------------------
Dynapro and NFI are registered trademarks of Dynapro Technologies.
All other brand and product names are trademarks or registered
trademarks of their respective companies and are hereby acknowledged.


