MicroTouch TM Projected Capacitive Near Field Imaging TM ( NFI )

Transcription

1 MicroTouch TM Projected Capacitive Near Field Imaging TM ( NFI ) Software User s Guide for Windows NT 4.0, Windows 98, Windows 95, Windows 3.1, and MS-DOS Read and understand all safety information before installing and using this product.

2 Copyright Notice Important notice to purchaser FCC compliance This manual is 3M All rights reserved. Reproduction of the contents of this copyrighted manual in whole or in part, by any means, electronic or mechanical, for any purpose, without written permission of 3M Touch Systems, a subsidiary of 3M, is prohibited. Given the variety of factors that can affect the use and performance of a 3M Touch Systems Product (the Product ), including that solid state equipment has operation characteristics different from electromechanical equipment, some of which factors are uniquely within User s knowledge and control, it is essential that User evaluate the 3M Touch Systems Product and software to determine whether it is suitable for User s particular purpose and suitable for User s method of application. 3M Touch Systems statements, engineering/technical information, and recommendations are provided for User s convenience, but their accuracy or completeness is not warranted. 3M Touch Systems products and software are not specifically designed for use in medical devices as defined by United States federal law. 3M Touch Systems products and software should not be used in such applications without 3M Touch Systems express written consent. User should contact its sales representative if User s opportunity involves a medical device application. Specifications are subject to change without notice. These 3M Touch Systems Products and software are warranted to meet their published specifications from the date of shipment and for the period stated in the specification. 3M Touch Systems makes no additional warranties, express or implied, including but not limited to any implied warranties of merchantability or fitness for a particular purpose. User is responsible for determining whether the 3M Touch Systems Products and software are fit for User s particular purpose and suitable for its method of production, including intellectual property liability for User's application. If the Product, software or software media is proven not to have met 3M Touch Systems warranty, then 3M Touch Systems sole obligation and User s and Purchaser s exclusive remedy, will be, at 3M Touch Systems option, to repair or replace that Product quantity or software media or to refund its purchase price. 3M Touch Systems has no obligation under 3M Touch Systems warranty for any Product, software or software media that has been modified or damaged through misuse, accident, neglect, or subsequent manufacturing operations or assemblies by anyone other than 3M Touch Systems. 3M Touch Systems shall not be liable in any action against it in any way related to the Products or software for any loss or damages, whether non-specified direct, indirect, special, incidental or consequential (including downtime, loss of profits or goodwill) regardless of the legal theory asserted. Any modifications or changes to this Product not expressly approved in writing by the manufacturer responsible for compliance to Federal Regulations could void the user s authority to operate this Product within the Laws and Regulations of the Federal Communications Commission. Edition January 2003 Document Number: (Rev. 2.0) Trademarks MicroTouch, Near Field Imaging and TouchSurround are trademarks of 3M. Windows XP, Windows 2000, Windows NT, Windows 98, Windows 95, Windows 3.1, MS-DOS, are registered trademarks of Microsoft Corporation in the United States and/or other countries. Logitech is a trademark of Logitech, Inc.

3 Contents Before You Start About the manual and 3M Touch Systems... 1 Chapter 1 Installing and setting up the software... 5 Windows NT 4.0, Windows 98, Windows Windows MS-DOS... 7 Chapter 2 Customizing the software... 9 Windows NT 4.0, Windows 98, and Windows 95 operating systems... 9 Windows 3.1 operating system MS-DOS operating system Chapter 3 Configuring TouchSurround features: Windows NT 4.0, Windows 98, and Windows Aligning the TouchSurround underlay Customizing touch responses in the TouchSurround area Adding TouchSurround buttons Fixing overlapping buttons Reviewing button definitions Editing and deleting button definitions Copying custom button definitions to multiple computers Chapter 4 Configuring TouchSurround features: Windows Aligning the TouchSurround underlay Adding TouchSurround buttons Reviewing button definitions Editing and deleting button definitions Chapter 5 Configuring TouchSurround features: MS-DOS What is the TouchSurround underlay? Aligning the TouchSurround underlay Customizing touch responses in the TouchSurround area Adding TouchSurround buttons Creating the button identifier Defining the button s coordinates Defining button activation Defining button action Button commands Strings Saving the button definition file Loading button definitions from a file Reviewing TouchSurround button definitions i

4 MicroTouch TM Near Field Imaging TM (NFI) Integration Guide Editing a TouchSurround button Deleting a TouchSurround button Changing the maximum number of TouchSurround buttons Appendix A Troubleshooting Software error messages Questions & answers Uninstalling and re-setting the software Appendix B Button commands and strings for TouchSurround underlay Button commands Strings ii

5 BEFORE YOU START About the manual and 3M Touch Systems Who the manual is for This manual is for: Original equipment manufacturers Value-added resellers System integrators who are responsible for positioning, installing, or maintaining MicroTouch TM Projected Capacitive Near Field Imaging TM (NFI) touch screen systems How the manual is organized Here is a quick tour of the contents of each chapter: Chapter 1: Installing and setting up This chapter will help you to start the NFI installation and setup utility. Once you have finished performing the utility s step-by-step on-screen instructions, you will have: Installed and initialized the touch screen software Aligned the touch screen Note If you are satisfied with the default touch screen settings that are in effect after installing and setting up the software, you do not need to refer to Chapter 2. If your touch screen does not have a TouchSurround underlay, you do not need to refer to Chapter 3, Chapter 4, or Chapter 5. 1

6 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Chapter 2: Customizing the software After installing the software, you may want to customize it to suit your application and/or the preferences of users. This chapter explains how to set: Touch screen responses Communication parameters of the NFI controller Touch emulation of right-mouse button settings Chapters 3, 4, and 5: Configuring the TouchSurround TM underlay and button settings These chapters describe how to configure TouchSurround features (e.g., aligning the TouchSurround underlay and adding, defining, and deleting TouchSurround buttons). You do not need to refer to these chapters if your touch screen does not have a TouchSurround underlay. Appendix A Appendix A has troubleshooting information on: Strategies for solving software issues. Answers to frequently asked questions. How to un-install the software. How to re-set the software (baseline, linearization file, and alignment of the touch screen) without having to un-install and re-install the software. Appendix B Appendix B explains how to add a command or string when defining a TouchSurround button. Terms Refer to this list of terms while using this manual. This term Alignment tool Display area Near Field Imaging TM (NFI) Touch screen TouchSurround Refers to A stylus that is used to align the touch screen and define TouchSurround buttons. The part of the touch screen that is positioned over the product s display. Touches in the display area emulate the movements and actions of a mouse. A proprietary touch screen technology that generates the profile of a touch from changes in the electrostatic field close to the point of contact. The front surface of the NFI touch screen, comprising the display area and the TouchSurround area (for touch screens with the TouchSurround feature). The area on the front of the touch screen, not including the display area. The TouchSurround area allows you to use part of the touch screen to define keys, such as the ones on a keyboard. 2

7 Before You Start About the manual and 3M Touch Systems This term Underlay Refers to A graphic that illustrates the TouchSurround TM area (for touch screens that have the TouchSurround feature). An underlay can be fitted in your product a number of different ways, including behind the touch screen. You must define buttons and controls for your own underlays if you choose to use the TouchSurround feature. About 3M Touch Systems Contacting your regional touch specialist To find the name of your 3M Touch Systems sales representative, refer to contact information on the website: 3M Touch Systems Support Services 3M Touch Systems provides extensive support services through our website and technical support organization. Visit the 3M Touch Systems website at where you can download touch screen software and drivers, obtain regularly updated technical documentation on 3M Touch Systems products, and learn more about our company. Whenever you contact Technical Support, please provide the following information: Part number and serial number Current driver version Operating system used Information on peripherals Technical Support is available Monday through Friday 8 a.m. to 8 p.m. US Eastern Standard Time 9 a.m. to 5 p.m. throughout Europe. Limited call back service Saturdays and Sundays. You can contact 3M Touch Systems Technical Support (US only -- Eastern Standard Time) by calling the hot line or sending a fax. Technical Support Hot Line: Technical Support Fax: Toll Free: [email protected] 3

8 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide 3M Touch Systems Worldwide Offices All offices can be reached through the website: Country Telephone number United Kingdom +44 (0) United States Australia Canada France +33 (1) Germany +49 (0) Hong Kong/China (852) Italy +39 (0) Japan +81 (44) Korea Singapore Spain Taiwan United Kingdom +44 (0)

9 CHAPTER 1 Installing and setting up the software About this chapter To install the NFI touch screen software on your system, follow the instructions in this chapter that match your operating system. The instructions in this chapter pertain to the following operating systems: Windows NT 4.0, Windows 98, and Windows 95 Windows 3.1 MS-DOS If you are running your NFI touch screen with an operating system other than one of these, check for other software instructions on Important If you change the orientation of the NFI components (touch screen, controller or tail) the baseline will need to be retaken following the instructions provided in this chapter. Windows NT 4.0, Windows 98, Windows 95 To install and set up the touch screen software for Windows NT 4.0, Windows 98, or Windows 95 operating systems, follow these steps: 1. From download the NFI original equipment manufacturer (OEM) drivers for 4.0/9X/3.1/MS-DOS to a folder you create on your hard drive (e.g., c:\nfi). 2. Close all open Windows programs. 3. Unzip the downloaded file into a folder. Find SETUP.EXE in the folder, and then run (double-click) SETUP.EXE. 4. Follow the on-screen instructions to install the software. 5. When installation is finished, restart the computer. 6. After restart, the NFI Setup dialog box appears. Follow the on-screen prompts to initialize the touch screen and set the baseline. After initializing the touch screen, a baseline dialog box will prompt you to set the baseline. Select continue in this dialogue box. Ensure nothing is touching the touch screen or bezel assembly when the baseline is set. 5

10 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide 7. The setup dialog box will prompt you to download your touch screen s linearization file Note: If you cannot find the floppy disk with the linearization file, you can download the linearization file from You will need to enter the serial number for the NFI touch screen which appears on the touch screen tail. 8. To align the touch screen open the NFI Setup and Diagnostic Utility dialog box, select Configuration» Alignment. In the Alignment dialog box, select Alignment. 9. Be sure you are directly in front of the touch screen. Use a finger or alignment tool to align the touch screen. An alignment tool produces a more accurate alignment. 10. Test the alignment by moving the pointer around the screen with your finger. If it is satisfactory, select OK. Otherwise select Alignment and complete the procedure again. 11. The touch screen is set up. If you do not need to customize the software or set up TouchSurround TM buttons, then you should not need to consult any other chapters in this manual. Windows 3.1 To install and set up the touch screen software for the Windows 3.1 operating system, follow these steps: 1. From download the NFI original equipment manufacturer (OEM) drivers for Windows NT 4.0/9X/3.1/MS-DOS to a folder you create on your hard drive (e.g., c:\nfi). 2. Close all open Windows programs. Note: To install the Windows 3.1 driver, MS-DOS must be the operating system. Do not run the software from an MS-DOS session with Windows Unzip the downloaded file, find the \Win31 folder in the folder you created, locate INSTALL.EXE in the \Win31 folder, and then run (double-click) INSTALL.EXE. 6

11 Chapter 1: Installing and setting up the software 4. When installation is finished, restart the computer. 5. After restart, follow the on-screen instructions to install the linearization file and set the baseline. 6. Enter the path name to the linearization file that shipped with your touch screen on floppy disk. When the name of your linearization file is requested, make sure that the floppy disk that came with your touch screen is in your floppy drive and than type A:\<filename> and then press Enter, where <filename> is the name of the linearization file on the disk. Note: If you cannot find the floppy disk with the linearization file, you can download the linearization file from You will need to enter the serial number for the NFI touch screen which appears on the touch screen tail. 7. Follow the remaining on-screen instructions to set the baseline and download the linearization file. Ensure nothing is touching the touch screen or bezel assembly when the baseline is set. 8. To align the touch screen open the Windows Program Manager» Main group» Control Panel» Touch Screen. Make sure you are directly in front of the touch screen before starting alignment. 9. In the Touch Screen dialog box, select the Calibration button. Note: Use a finger or alignment tool to align the touch screen. An alignment tool produces a more accurate alignment. Follow the remaining on-screen instructions to finish aligning the touch screen. 10. Test the alignment by moving the pointer around the screen with your finger. If satisfactory, select OK. Otherwise, complete the procedure again. MS-DOS To install and set up the touch screen software for the MS-DOS operating system, follow these steps: 1. From download the NFI original equipment manufacturer (OEM) drivers for Windows NT 4.0/9X/3.1/MS-DOS to a folder you create on your hard drive (e.g., c:\nfi). 2. Unzip the downloaded file, find the \DOS folder in the folder you created, locate INSTALL.EXE in the \DOS folder, and then run INSTALL.EXE. 3. Follow the on-screen instructions. When installation is finished, an Install Successful window appears. 4. After restart, follow the on-screen instructions to install the linearization file and set the baseline. 5. Enter the path name to the linearization file that shipped with your touch screen on floppy disk. When the name of your linearization file is requested, make sure that the floppy disk that came with your touch screen is in your floppy drive and than type A:\<filename> and then press Enter, where <filename> is the name of the linearization file on the disk. Note: If you cannot find the floppy disk with the linearization file, you can download the linearization file from You will need to enter the serial number for the NFI touch screen which appears on the touch screen tail. 7

12 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide 6. Follow the remaining on-screen instructions to finish setting the baseline and loading the linearization file. Ensure nothing is touching the touch screen or bezel assembly when the baseline is set. 7. To align the touch screen, make sure you are directly in front of the touch screen before starting alignment. 8. Follow the on-screen instructions to align the touch screen. Use a finger or alignment tool to align the touch screen. An alignment tool produces a more accurate alignment. 9. If you wish to re-align the touch screen, make sure you are directly in front of the touch screen before starting alignment. At the MS-DOS prompt, type ECAL and then press Enter. 8

13 CHAPTER 2 Customizing the software About this chapter During set up of the touch screen (Chapter 1), the performance of the touch screen was optimized. If you are satisfied with these default settings, you can skip this chapter. This chapter explains how to: Start the NFI touch screen software. Customize touch responses. Customize communication parameters of the NFI controller. Achieve right-mouse button emulation by touching the screen (Windows NT 4.0, Windows 98, and Windows 95 only). Operate a mouse and the touch screen at the same time. The instructions in this chapter pertain to the following operating systems: Windows NT 4.0, Windows 98, and Windows 95 Windows 3.1 MS-DOS If you are running your NFI touch screen with an operating system other than one of these, check for other software instructions on Windows NT 4.0, Windows 98, and Windows 95 operating systems Starting the software To start the software, do one of the following: From the Windows operating system desktop, select Start» Programs» Touch Screen Utilities» Configuration. In the NFI Setup and Diagnostic Utility dialog box, select Configuration. The Configuration Utilities dialog box appears. 9

14 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Align the touch screen before using it. See Chapter 1. Customize touch responses. Configure the TouchSurround TM area and define the TouchSurround buttons. See Chapter 3, Chapter 4, and Chapter 5. Change controller communication parameters or sensitivity. Customizing touch responses Use the Display Area Configuration dialog box to adjust the touch responses of the touch screen. This step is necessary only if you want to change the default settings for the touch screen. 1. In the Configuration Utilities dialog box, select Display. Select the Test Box after adjusting the Double Touch Speed or Timed Double Touch sliders. The Test Box changes color when you successfully touch it. 2. Configure the options below. 3. After you ve configured the settings, select OK to save them or touch Cancel to discard the changes and revert to the previous settings. 10

15 Chapter 2: Customizing the software Double Touch Speed and Timed Double Touch The NFI touch screen can detect a double touch, which is the same as doubleclicking the mouse. To generate two separate touches, touch the screen twice slowly. To use the double touch feature do one of the following: Touch the touch screen twice quickly as if you were double-clicking the mouse. This is the default option. Use the Double Touch Speed slider to increase or decrease the time the touch screen allows between touches. If you increase the speed too much, it may become difficult to generate a double touch; the touches will instead be recognized as two separate touches. If you decrease the speed too much, what you intend to be two separate touches might instead be recognized as a double touch. Touch the touch screen and hold it. To use this option, adjust the Timed Double Touch slider. Use the Timed Double Touch slider to increase or decrease the time the touch screen waits before acknowledging a double touch. If you increase the slider to Long, it takes about two seconds to generate a double touch. If you decrease the slider to just off None, it takes about 0.2 seconds. A timed double touch is generated on the initial touch only, not after dragging. Beep on Touch Select this option to have the computer beep on each first touch. Drag and Drop Check this box if you want the pointer to follow your finger around the screen until you release it. This allows you to select an object on the screen, drag it across the screen to a new location, and then drop it in its new position by releasing the touch. Important For optimal performance, do not choose drag and drop unless your application requires it. 11

16 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Changing the controller communications parameters Use the Interface Configuration Options dialog box to change the communications parameters needed to communicate with the NFI touch screen controller. This step is necessary only if you want to change the communication settings you selected during installation. 1. In the Configuration Utilities dialog box, select Interface. Change the sensitivity of the touch screen. 2. Configure the options below. 3. After you ve configured the settings, select OK to save them or select Cancel to discard the changes and revert to the previous settings. COM Port Sets the serial communication port. Selecting a port automatically fills the Interrupt and Address boxes with the default values for the port. To use custom combinations, select the Interrupt and Address individually. Interrupt Sets the interrupt request number used by the NFI touch screen controller to interrupt the operating system. If you are using a standard COM port, you should need to use only the default values in the Interrupt box. Address Sets the I/O base address used by the touch screen controller. If you are using a standard COM port, you should need to use only the default values in the Address box. Sensitivity Use the Sensitivity Configuration dialog box to change the touch sensitivity of the NFI touch screen. This step is necessary only if you want to change the default sensitivity settings of the touch screen to allow for the way you re touching the screen (finger, gloves, alignment tool), the mounting of the touch screen, and the surrounding environment. 12

17 Chapter 2: Customizing the software Use the Sensitivity slider to increase or decrease the sensitivity of the touch screen. If you increase the sensitivity to High, the touch screen is very sensitive and touches may be detected before the finger actually touches the screen. This setting is useful when wearing heavy or thick gloves. If you decrease the sensitivity to Low, the touch screen is not as responsive but it s also less likely to detect false touches. This setting is useful when using an alignment tool or a finger without gloves. To adjust the Sensitivity slider: 1. In the Interface Configuration Options dialog box, select Sensitivity. 2. In the Sensitivity Configuration dialog box, adjust the slider to the desired setting (Table A). After you adjust the Sensitivity slider, select the Test button. 3. Select Test to confirm the settings for the Sensitivity slider. 4. Follow the on-screen instructions. 5. After you ve configured the setting, select OK to save it or select Cancel to discard the change and revert to the previous setting. Table A: Recommended sensitivity settings Method of touching the screen Bare finger/latex glove Alignment tool Cloth glove Leather glove Rubber glove Recommended setting 1 or higher 2 or higher 3 or higher 3 or higher 4 or higher 13

18 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Using right-mouse button support You can open the same menu that would appear if you clicked an object with the right-mouse button. To open an object s menu: 1. Touch an object to select it. Leave your finger there. 2. Using another finger, touch the screen briefly diagonally opposite the first touch, to open the right-mouse menu. While holding your index finger on the screen, use your middle finger to touch the screen diagonally opposite the first touch. Note: The second touch won t register if it is in the same horizontal or vertical plane as the first touch. Operating a mouse and touch screen at the same time The touch screen driver supports concurrent mouse and touch screen operation. This allows you to use both a mouse and the touch screen. Windows NT 4.0 Windows 98, Windows 95 To use a mouse and touch screen at the same time, install the mouse driver and then the touch screen driver. Windows NT 4.0 leaves the previous mouse driver active when the new one is installed. The next time you start Windows NT 4.0, both touch screen and mouse should operate. Disabling the mouse driver When you install the mouse driver, it will always be active, even if you install a different type of mouse driver later. If you unplug the mouse from your computer and restart Windows NT 4.0, the mouse driver will fail to load, resulting in an error message. To disable the mouse driver: 1. Open the Device dialog box in the Control Panel. 2. Highlight the entry for the mouse driver. 3. Choose Startup to change its startup state to disabled. The touch screen driver supports concurrent mouse and touch screen operation in Windows 95 and Windows 98. To install a mouse driver: 1. Connect a mouse to your computer. 2. Select the Windows Start button» Settings» Control Panel. 3. Select Add New Hardware. 4. Select Yes, to have the Wizard detect new hardware for you. Do not select No to install a mouse driver manually. 5. Follow the on-screen instructions to install the mouse. Once the mouse has been detected and the appropriate mouse driver installed, the mouse will operate at the same time as the touch screen. If the Wizard does not detect your mouse, you cannot use it at the same time as the touch screen. You must use a mouse that Windows 98 or Windows 95 detects automatically, such as one by Microsoft or Logitech. 14

19 Chapter 2: Customizing the software Windows 3.1 operating system Starting the software To start the software, do the following: In the Windows Program Manager, select Main Group» Control Panel» Touch Screen. The Touch Screen dialog box appears. Define TouchSurround TM buttons (see, Chapter 4, and Chapter 5). Align the touch screen (using Calibration button) before using the touch screen (see Chapter 2). Customizing touch responses Use the Touch Screen dialog box to change the touch screen characteristics. 1. Complete the options as described below. 2. After you have configured the following options, select OK to save the settings. To return all parameters to their last configured values, select the Cancel button. The Cancel button does not undo any alignment that was performed from the Alignment button. Double Touch Sensitivity The NFI touch screen can detect a double touch, which is the same as doubleclicking the mouse. To generate two separate touches, touch the screen twice slowly. Touch the touch screen twice quickly as if you were double-clicking the mouse. This is the default option. Use the Double Touch Sensitivity slider to increase or decrease the time the touch screen allows between touches. If you increase the speed too much, it may become difficult to generate a double touch; the touches will instead be recognized as two separate touches. If you decrease the speed too much, what you intend to be two separate touches might instead be recognized as a double touch. 15

20 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Autorepeat Rate This setting is only for the TouchSurround TM underlay. Use the slider to set the autorepeat rate for buttons on the touch screen. If you set the rate to Fast, holding a touch will produce rapid repeat events. If you set the rate to Slow, the same touch will generate fewer repeat events in the same length of time. Autorepeat affects only events generated by button presses. It does not affect events generated by button releases. Autorepeat Delay This setting is only for the TouchSurround underlay. Use the slider to set the time required for a touch to be held before autorepeat mode begins. A Short delay means you don t need to hold a touch very long before autorepeat touches are generated. A Long delay means that you must hold a touch longer to begin generating autorepeat touches. Enable Surround Alignment Select this check box to align the TouchSurround underlay (see Aligning the TouchSurround underlay on page 33). Enable Drag and Drop Check this box if you want the pointer to follow your finger around the screen until you release it. This allows you to select an object on the screen, drag it across the screen to a new location, and then drop it in its new position by releasing the touch. Important For optimal performance, do not choose dragand drop unless your application requires it. Enable Touch Beeps Select this option to have the computer beep on each first touch. Button Selector Window Use the Button Selector Window to select either right- or left-mouse button click emulation in response to a touch. When enabled, this window appears displaying the picture of a mouse. The active button, left or right, is highlighted in black. When you select this window, the pointer does not appear inside the window, but remains in its last position. This reminds you where you were last touching. The Button Selector window appears on top of other windows. To enable this window, select the Enabled box. The Position (Pos) and Size fields display the current position and size of the Button Selector window. Changing the communications parameters To change the installation settings, including sensitivity, see Changing the communications parameters on page

21 Chapter 2: Customizing the software Operating a mouse and touch screen at the same time The touch screen driver supports concurrent mouse and touch screen operation in Windows 3.1, windowed MS-DOS sessions, and full-screen MS-DOS sessions. To use the touch screen and mouse at the same time: 1. From Program Manager, select the Notepad icon. 2. On the file menu, select Open. 3. Open autoexec.bat. 4. Move the line containing the mouse driver before the line containing emouse.com. 5. On the File menu, select Save. 6. Restart your computer. MS-DOS operating system Be sure to connect the mouse before starting your computer, so the driver can detect the mouse when it loads. Aligning the touch screen Before you can use the touch screen, you must use the NFI Setup and Diagnostic Utility dialog box to initialize and align the screen. Alignment orients and aligns the touch screen with the video display (see MS-DOS on page 7). Customizing the touch screen For most applications the default touch screen configuration is appropriate. To change the configuration, use the options in the emouse utility. The emouse utility (emouse.com) allows the touch screen s display area to react to finger touches as if they were the movements of a pointer driven by a singlebutton mouse. This means you can use off-the-shelf programs that require a Microsoft-compatible mouse. To view the options, at the MS-DOS prompt, type EMOUSE /?, and then press Enter. For details about the TouchSurround underlay, see Chapter 5 Configuring TouchSurround features: MS-DOS. You can configure the Display area TouchSurround area to support this feature Drag Autorepeat Autorepeat Holdoff (Delay) Autorepeat Interval Display area and the TouchSurround area Beep Touch event processing 17

22 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide During installation of the touch screen drivers and utilities, the autoexec.bat file is modified to include the following line: C:\TOUCH\DOS\EMOUSE.COM This line loads the emouse.com program into memory, where it stays resident. Important Do not remove this line from the autoexec.bat file, or you will not be able to use the touch screen with your MS-DOS applications If you start applications from the autoexec.bat file, ensure that the emouse.com appears before you start any applications. To configure the TouchSurround TM area or display area for all sessions: 1. Use a text editor (such as edit.exe) to open the autoexec.bat file. 2. Add one or more of the parameters shown in Table B to the emouse.com command. 3. Save the changes. 4. Restart your computer so the changes will take effect. Example of an autoexec.bat file EMOUSE /BEEP=OFF /INT=3 /SENS=4 /DEFINE=C:\TOUCH\DOS\MYFILE.DEF Include spaces as shown in this example. In this example, emouse.com: turns off touch event beeps ( /BEEP=OFF) sets the touch event interval to 3 ( /INT=3) sets the sensitivity of the touch screen to 4 ( /SENS=4) uses button definitions from C:\TOUCH\DOS\MYFILE.DEF ( /DEFINE=C:\TOUCH\DOS\MYFILE.DEF) To change the TouchSurround area or display area settings for the current MS- DOS session only: 1. At the MS-DOS prompt, type EMOUSE <options> where <options> is one or more of the configuration options shown in Table B. 2. Press Enter 18

23 Chapter 2: Customizing the software In Table B, characters in bold italics are the minimum entry for each option. You can use the whole word or any abbreviation that includes the minimum entry. Table B: TouchSurround TM area and display area configuration options Option /AUTOREPEAT={OFF ON} /BASE=<I/O base address> /BEEP={OFF ON} /COM1 /COM2 /COM3 /COM4 /DEFINE={filename} /DRAG={OFF ON} /HOLDOFF=<duration> /INTERVAL=<interval> Description Enables or disables TouchSurround button autorepeat. When autorepeat is enabled, the button will activate the first time you touch it and its press action will repeat for as long as you hold your finger on the button. When autorepeat is disabled, the button s press action activates once only, every time you touch the button. The default is /AUTOREPEAT=ON. Sets the I/O base address for the touch controller s communications port. Enables or disables touch event beeps in the display area and TouchSurround area. The default is /BEEP=OFF. Sets the touch controller s communications port. If you change the COM port from the default of 1, ensure you change the COM port setting in the NFI Setup and Diagnostic Utility (see Changing the communications parameters on page 16). Reads TouchSurround button definitions from the specified file. Enables or disables drag movement (drag-and-drop) in the display area of the touch screen. When drag is enabled, the cursor follows your finger as you move it around the touch screen. When drag is disabled, the cursor remains where you first touched the screen. The default is /DRAG=ON. Sets the period of time required for a touch to be held before it begins autorepeating. A Short duration means that you don t need to hold a touch very long before autorepeat touches are generated. A Long duration means that you must hold a touch longer to begin generating autorepeat touches. The range is 0 to 10. A value of 0 results in a continuous stream of touch events from the moment you first touch the screen, while a value of 10 results in a delay of approximately one second between the first and subsequent touch events. The default is /HOLDOFF=5. Sets the autorepeat interval that is, how quickly the autorepeat feature repeats the touch. If you set the rate to 10, holding a touch will produce rapid repeat events. If you set the rate to 0, the same touch will generate fewer repeat events in the same length of time. The range is 0 to 10. The default is /INTERVAL=5. 19

24 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Table B: TouchSurround TM area and display area configuration options Option /IRQ=<IRQ number> /SENSIVITY={1/2/3/4/5/6} /TOUCH={OFF ON} Description Sets the interrupt request line for the touch controller s communications port. Use the Sensitivity setting to increase or decrease the sensitivity of the touch screen. If you increase the sensitivity to High, the touch screen is very sensitive and touches may be detected before the finger actually touches the screen. This setting is useful when wearing heavy gloves. If you decrease the sensitivity to Low, the touch screen is not as responsive but it s also less likely to detect false touches. This setting is useful when using an alignment tool or a finger without gloves. The default is 3. Enables or disables touch event processing for both the display area and the TouchSurround TM area The default is /TOUCH=ON. Tip: Type EMOUSE /TOUCH=OFF at the command line to disable the touch screen for cleaning. You can also define a TouchSurround button to enable or disable the touch screen (see Summary of steps on page 44). Changing the communications parameters To change the installation settings, manually enter the IRQ and base settings for the touch screen driver in the autoexec.bat file to match the hardware being used. During installation, a line is added to the autoexec.bat file. Here s an example: \TOUCH\DOS\EMOUSE /COM1 To change the IRQ and base settings, replace /COM1 with: /IRQ = XX /BASE = YYY where XX is the interrupt request number for the COM port and YYY is its I/O base address (in hexadecimal). For reference, the following table lists the default COM settings. COM settings IRQ settings Base settings COM 1 4 3F8 COM 2 3 2F8 COM 3 4 3E8 COM 4 3 2E8 After changing and saving the file, restart the computer. For details about advanced COM port options, see the Readme file. 20

25 Chapter 2: Customizing the software Operating a mouse and touch screen at the same time To use a mouse at the same time as the touch screen, load the mouse driver in autoexec.bat before loading emouse.com: 1. At the command prompt, type EDIT C:\AUTOEXEC.BAT where C is the drive letter of the hard disk. 2. Move the line containing the mouse driver before the line containing emouse.com. 3. On the File menu, select Save. Alternatively, press Alt + S. 4. Restart your computer. Be sure to connect the mouse before starting your computer, so the driver can detect the mouse when it loads. 21

26

27 CHAPTER 3 Configuring TouchSurround TM features: Windows NT 4.0, Windows 98, and Windows 95 What is the TouchSurround underlay? The NFI touch screen system can be used with an optional TouchSurround underlay. The TouchSurround underlay allows you to use part of the touch screen to define keys, such as the ones on a keyboard. This underlay may be used in situations where the touch screen is larger than the display. Figure 1: Example of a TouchSurround underlay Aligning the TouchSurround underlay Most applications do not require the TouchSurround underlay option. Do not align the TouchSurround underlay unless a specific application calls for its use. To align the TouchSurround underlay: 1. Select the Windows Start button, point to Programs, Touch Screen Utilities, and then select Configuration. 23

28 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide 2. In the Configuration Utilities dialog box, select Alignment. 3. In the Alignment dialog box, select the Align TouchSurround TM check box. 4. Select Alignment. Be sure you are directly in front of the touch screen. Use a finger or alignment tool to align the TouchSurround underlay. An alignment tool produces a more accurate alignment. 5. To align, follow the on-screen instructions. To cancel alignment without any changes, press ESC at any time. When finished, the new alignment takes effect immediately and the Alignment dialog box reappears. 6. Test the alignment by moving the pointer around the screen with your finger. If it is satisfactory, select OK. Otherwise select Alignment and complete the procedure again. 24

29 Chapter 3: Configuring TouchSurround TM features: Windows NT 4.0, Windows 98, and Windows 95 Customizing touch responses in the TouchSurround area Use the TouchSurround Configuration dialog box to customize the touch responses of the TouchSurround buttons. This step is necessary only if you wish to change the default settings for the TouchSurround buttons. 1. In the Configuration Utilities dialog box, select TouchSurround. 2. Configure the options below. 3. After you ve configured the options, select OK to save them or select Cancel to discard the changes and revert to the previous settings. Autorepeat Rate The autorepeat rate is the rate at which repeat actions are generated when a touch is held. Use the slider to set the autorepeat rate for buttons on the TouchSurround underlay. If you set the rate to Fast, holding a touch produces rapid repeat actions. If you set the rate to Slow, the same touch generates fewer repeat actions in the same length of time. Autorepeat affects only actions generated by button presses. It does not affect actions generated by button releases. Autorepeat Delay The autorepeat delay is the amount of time the touch screen waits before generating autorepeat actions. Use the slider to set the time required for a touch to be held before autorepeat mode begins. A Short delay means you don t need to hold a touch very long before autorepeat touches are generated. A Long delay means that you must hold a touch longer to begin generating autorepeat touches. 25

30 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Adding TouchSurround buttons Beep on Touch Select this box if you want the computer to beep whenever a TouchSurround TM button is activated by a touch or release. The beep occurs only on the first touch of the screen. The beep won t repeat if you move your finger around the display area before releasing it. You can define the size, position, activation, and function of the TouchSurround buttons, and you can define buttons as function keys, command keys, calculator keys, screen change controls, or whatever other format you require. TouchSurround buttons are inactive while you are defining buttons. They become active when you save the definitions and exit the software. Important To optimize performance of a new TouchSurround button, ensure you position the button at least 0.25 inches (6.4mm) from the edge of your product s bezel. In addition, ensure the size of the button is at least the size of your index finger s fingerprint (about 0.70 inches or 17.8mm on each side). Summary of steps To add a TouchSurround button definition do the following: 1. Set up a new button definition in the TouchSurround Button Definitions dialog box. 2. Define the new button s coordinates. 3. Define the new button s press and release actions. 4. If desired, select the autorepeat check box. 5. Test the new button definition. 26

31 Chapter 3: Configuring TouchSurround TM features: Windows NT 4.0, Windows 98, and Windows 95 Set up a new button definition To set up a new button: 1. In the Configuration Utilities dialog box, select Buttons. For information about the entries in this list, see Reviewing button definitions on page 30. Each line in the list is a different button definition. To add or append button definitions to the list, use this button. The location and function of the selected button is shown here. If buttons have not been defined, the list is blank. 2. To display options for defining button location and press/release action, do one of the following: Select Append to add the button definition to the end of the list. The Define a Button dialog box appears. Select a button definition in the list: the Append button changes to Insert. Select Insert to add a new button definition above the selected button. The Define a Button dialog box appears. Define the new button s coordinates To use a new button, you must define its coordinates. The coordinates of a button s upper left and lower right corners define the button s size and its position on the TouchSurround underlay. To ensure accuracy, use an alignment tool to define the button s coordinates. While defining a TouchSurround button, do not rest your hand anywhere on the surface of the touch screen or bezel because the presence of your hand affects the values passed to the screen. 27

32 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide To define the button s coordinates: 1. Hold the alignment tool at a 90-degree angle to the screen s surface, and touch the Upper Left box in the Define a Button dialog box. Define the size and position of the button by touching the screen, or by entering its X and Y coordinates here, separated by a space. If you touch the screen, the coordinates are entered automatically. 2. Touch the point on the TouchSurround TM area where you want to position the upper left corner of the new button. Align the alignment tool with the inside edges of the button s corner 76019_A 3. Touch where you want to position the button s lower right corner. The coordinates of the areas you touched are displayed in the Upper Left box and Lower Right box. 28

33 Chapter 3: Configuring TouchSurround TM features: Windows NT 4.0, Windows 98, and Windows 95 Define the new button s press and release actions Button actions are performed either when the button is pressed or released. A button can either perform a command or inject a string, not both. Commands control what operations are performed when a button is activated. See Button commands on page 61. Strings are passed to the active window when the button is pressed or released. See Strings on page 62. Select the Autorepeat check box If desired, select the Autorepeat check box to enable autorepeat for the button s press action. When autorepeat is enabled, the button activates the first time you touch it and its press action repeats for as long as you hold your finger on the button. When autorepeat is disabled, the button s press action activates once only, every time you touch the button. Test the new button definition 1. When finished, do one of the following: Select OK to start a diagnostic test of the button definition. If the definition is valid, it is added to the button definition list. If the button definition is incorrect, an error message is displayed. See Fixing overlapping buttons. Select Cancel to discard the button definition. Fixing overlapping buttons 2. Repeat the above steps for each button definition. 3. When finished defining buttons, select OK in the TouchSurround Button Definitions dialog box to save the button definition(s). Buttons cannot overlap. If you define a button that overlaps an existing button, an error message appears, and the button definition is not saved. To help find the button with the conflicting coordinates, touch the TouchSurround area where you encountered the overlap. This will display the button definition information for any button defined in that area. Then either modify the original button coordinates or define a new button with new coordinates. To correct the problem, do one of the following: Select Cancel from the TouchSurround Button Definitions dialog box to clear the button definition. Define new coordinates for the button. 29

34 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Reviewing button definitions You can check the function of a TouchSurround TM button by reviewing the information in the TouchSurround Button Definitions dialog box. To check the function of a button: 1. Open the Configuration Utilities dialog box. 2. Select Buttons to open a list of button definitions. The list is blank if no buttons have been defined. 3. Touch a button in the list. The button s location and function are shown at the bottom of the dialog box. For an example of the dialog box, see the one that follows. The information in the TouchSurround Button Definitions dialog box is in columns. Table C provides a key to the information in the columns. See Table C for definitions of these columns The location and function of the selected button is also shown here. Table C: TouchSurround button definitions column key Column Contents Value 1 Indicates whether a command or string is defined for the button s press action. 2 Indicates whether autorepeat is enabled. If the button has a press action, you can make that action repeat for as long as the button is pressed. C (for command) or S (for string) A (or blank) 3 The command or string for the button s press action. Command or string 4 Indicates whether a command or string is defined for the button s release action. C (for command) or S (for string) 5 The command or string for the button s release action. Command or string 30

35 Chapter 3: Configuring TouchSurround TM features: Windows NT 4.0, Windows 98, and Windows 95 Editing and deleting button definitions To edit a button definition: 1. Open the Configuration Utilities dialog box. 2. Select buttons to display the list of button definitions. The number of buttons in the list is shown here. Choose the button definition you want to edit... The location and function of the selected button is shown here....and then touch Edit. 3. Select a button definition, then select Edit, or double touch a button definition. 4. Change the button definition as required, and then select OK to return to the list of button definitions. 5. To save the changes, select OK. To quit without saving changes, select Cancel. To delete a button definition: 1. Open the Configuration Utilities dialog box. 2. Select Buttons to display the list of button definitions. 3. Select a button definition from the list, and then select Delete to delete the button definition. 4. To save your changes, select OK. To restore the button definition, select Cancel. Copying custom button definitions to multiple computers Use the Touch Screen Configuration Import/Export Utility (touchini.exe) to generate a file that can be copied and imported to other computers. Using this utility eliminates the need to configure each computer manually with the same set of button definitions. The Touch Screen Configuration Import/Export Utility is installed when you install the touch screen drivers and utilities. This utility is copied to: 31

36 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide the \TOUCH\NT folder on your computer s hard disk for Windows NT 4.0 the \TOUCH\W9X folder on your computer s hard disk for Windows 98 and Windows 95 Exporting button definitions To export button definitions from the registry to a file: 1. Select the Windows Start button, select Programs, and then select Command Prompt. 2. At the command prompt, type CD\TOUCH\NT for Windows NT 4.0 CD\TOUCH\W9X for Windows 98 and Windows Type TOUCHINI /o where o = output. This creates a file with the default file name TOUCH.INI. This file contains an ASCII representation of the touch screen configuration. 4. To change the file name, specify a new file name after the /o parameter. For example, if you type TOUCHINI /oconfig.ini, the file will be named CONFIG.INI. The file is placed in either the Windows NT 4.0 folder or the Windows 98 and Windows 95 folder. Importing button definitions Important When you import a TouchSurround TM definition file, the existing TouchSurround configuration is erased. To import button definitions into the registry from a file: 1. Select the Windows Start button, select Programs, and then select Command Prompt. 2. At the command prompt, type CD\TOUCH\NT for Windows NT 4.0 CD\TOUCH\W9X for Windows 98 and Windows 95 Type TOUCHINI /i<filename> where <filename> is the file you created in either step 3 or step 4 of the above procedure for exporting button definitions. The new configuration takes effect the next time you start Windows NT 4.0, Windows 98, and Windows

37 CHAPTER 4 Configuring TouchSurround TM features: Windows 3.1 What is the TouchSurround underlay? The NFI touch screen system can be used with an optional TouchSurround underlay. The TouchSurround underlay (illustrated in Chapter 3, page Figure 1) allows you to use part of the touch screen to define keys, such as the ones on a keyboard. This underlay would be used in situations where the touch screen is larger than the display. Aligning the TouchSurround underlay Most applications do not require the TouchSurround option. Do not align the TouchSurround underlay unless a specific application calls for its use. To align the TouchSurround underlay: 1. In the Windows Program Manager, open the Main group. 2. Open the Control Panel. 3. Open Touch Screen in the Control Panel. 4. In the Touch Screen dialog box, select the Enable Surround Alignment check box. 33

38 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide 5. Select Alignment. Adding TouchSurround buttons Be sure you are directly in front of the touch screen. Use a finger or alignment tool to align the TouchSurround TM underlay. An alignment tool produces a more accurate alignment. 6. To align, follow the on-screen instructions. To cancel alignment without any changes, press ESC at any time. When finished the new alignment takes effect immediately, and the Touch Screen dialog box reappears. 7. Test the alignment by moving the pointer around the screen with your finger. If it is satisfactory, select OK. Otherwise select Alignment and complete the procedure again. You can define the size, position, activation, and function of the TouchSurround buttons, and you can define buttons as function keys, command keys, calculator keys, screen change controls, or whatever other format you require. You must have a keyboard connected to your computer to define buttons. TouchSurround buttons are inactive while you are defining buttons. They become active when you save the definitions and exit the software. Summary of steps To add a TouchSurround button definition do the following: 1. Set up a new button definition in the TouchSurround Area dialog box. 2. Define the new button s coordinates. 3. Define the new button s press and release actions. 4. If desired, select the Activate on Release check box. 5. If desired, select the Autorepeat Enabled check box. 6. If desired, select the Enable Touch Beeps check box. 7. Test the new button definition. 34

39 Chapter 4: Configuring TouchSurround TM features: Windows 3.1 Set up a new button definition To set up a new button: 1. Open the Touch Screen dialog box. 2. Select Buttons to open a list of button definitions. The list is blank if no buttons have been defined. To create a button ID manually, enter a value here. To create a TouchSurround button, define the settings for the button, and then touch Set. To clear all the settings for the button you are defining and start over, select Clear. To delete a button definition, choose one from the list, and then select Clear. Important If you re defining a new button for a standard TouchSurround underlay, make sure that a button definition in the list box is not selected and that the fields are blank. If a button definition is selected, you are modifying the selected button, not creating a new one. Once selected, an item in the list of buttons cannot be de-selected. To create a new button, change the highlighted button s ID. 3. To create a button ID manually, select the ID box and type a value. You can define two buttons with the same button ID. The Button Definition ID is a number from 0 to that is used by the system. If you do not type a value, or if the number you type exceeds 65535, the default value of zero is entered automatically. Define the new button s coordinates To use a new button, you must define its coordinates. The coordinates of a button s upper left and lower right corners define the button s size and its position on the TouchSurround underlay. To ensure accuracy, use an alignment tool to define the button s coordinates. 35

40 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide While defining a TouchSurround TM button, do not rest your hand anywhere on the surface of the touch screen or bezel because the presence of your hand affects the values passed to the screen. Important To optimize performance of a new TouchSurround button, ensure you position the button at least 0.25 inches (6.4 mm) from the edge of your product s bezel. In addition, ensure the size of the button is at least the size of your index finger s fingerprint (about 0.70 inches on each side). To define the button s coordinates: 1. Hold the alignment tool at a 90-degree angle to the screen surface, and touch the Upper Left box in the TouchSurround Area dialog box. Touch the point on the TouchSurround area where you want the upper left corner of the new button to be. Define the size and position of the button by touching the screen, or by entering its X and Y coordinates here. If you touch the screen, the coordinates are entered automatically. 2. Touch where you want to position the button s lower right corner. 36

41 Chapter 4: Configuring TouchSurround TM features: Windows 3.1 The coordinates of the areas you touched are displayed in the X Pos (Xposition) and Y Pos (Y-position) boxes. Align the alignment tool with the inside edges of the button s corner _A Define the new button s press and release actions Button actions are performed either when the button is pressed or released. A button can either perform a command or inject a string, not both: Commands control what operations are performed when a button is activated (see Button commands on page 61) Strings are passed to the active window when the button is pressed or released (see Strings on page 62). Select the Activate on Release check box If desired, select the Activate on Release check box. If you choose activate on release, the autorepeat option is disabled. If you leave it blank, the button activates on any presses detected. Select the Autorepeat Enabled check box If desired, select the Autorepeat Enabled check box to enable autorepeat for the button s press action. When autorepeat is enabled, the button activates the first time you touch it and its press action repeats for as long as you hold your finger on the button. When autorepeat is disabled, the button s press action activates once only, every time you touch the button. 37

42 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Select the Enable Touch Beeps check box Select the Enable Touch Beeps check box if you want the touch screen to beep whenever a TouchSurround TM button is activated by a touch or release. Displaying the key state indicator Use the Display Key State Indicator check box to enable or disable the display of the Key State Indicator. Reviewing button definitions This indicator displays the current states of the Shift, Ctrl, and Alt keys. When one of these keys is activated, the corresponding box in the indicator is highlighted in black. For example, if you touch a <SHIFTD> button on the TouchSurround area, the Shift box in the Key State Indicator is highlighted in black. When the key is de-activated, the box reverts to white. The Key State Indicator can be positioned anywhere on the screen and retains its last location when you exit and restart Windows. You can check the function of a TouchSurround button by reviewing the information in the TouchSurround Area dialog box. To check the function of a button: 1. Open the Touch Screen dialog box. 2. Select Buttons to open a list of button definitions. The list is blank if no buttons have been defined. 3. Touch a button in the list. The button s location and function are shown in the Button Definition area of the dialog box. The location and function of the selected button are shown in this half of the dialog box. The number of buttons in the list is shown here. Each line in the list is a different button definition. Scroll up and down to see all the button definitions. 38

43 Chapter 4: Configuring TouchSurround TM features: Windows 3.1 The information in the button list is in columns. The locations of the columns in the list are shown below. Table D provides a key to the information in the columns. The information shown in the columns below is also shown here for the selected button definition. See Table D for definitions of these columns Table D: TouchSurround button definitions column key Column Contents Value 1 Button Identifier (ID) Upper Left Button X Coordinate Upper Left Button Y Coordinate Lower Right Button X Coordinate Lower Right Button Y Coordinate Press or Release Indicator Indicates whether the button activates on a touch Press or touch Release. 7 Autorepeat Indicator (Optional) If P is indicated in column 6, you can specify autorepeat. 8 Command or String Indicates whether the button inserts a String into the Windows input stream or carries out a specific touch screen command. P or R A S or C 9 Command or String text The text of the string or the command, if applicable 39

44 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Editing and deleting button definitions Editing a button definition 1. Open the Touch Screen dialog box. 2. Select Buttons to open a list of button definitions. This list is blank if no buttons have been defined. 3. To select a button definition, select the button definition in the list, or select the button on the TouchSurround TM area. 4. Change the button definition as required. For details about defining TouchSurround buttons (see Adding TouchSurround buttons on page 34). 5. Select Set. 6. To save your changes, touch OK, or touch Cancel to discard all changes to all the buttons. 40

45 Chapter 4: Configuring TouchSurround TM features: Windows 3.1 Deleting a button definition 1. Open the Touch Screen dialog box. 2. Select Buttons to open a list of button definitions. To delete a button definition, choose one from the list, and touch Clear. 3. Select a button definition from the list, and then select Clear. 4. To save your changes, select OK. To restore the button definition, select Cancel. 41

46

47 CHAPTER 5 Configuring TouchSurround TM features: MS-DOS What is the TouchSurround underlay? The NFI touch screen system can be used with an optional TouchSurround underlay. The TouchSurround underlay (illustrated in Chapter 3 on page 23) allows you to use part of the touch screen to define keys, such as the ones on a keyboard. This underlay would be used in situations where the touch screen is larger than the display. Aligning the TouchSurround underlay Most applications do not require the TouchSurround option. Do not align the TouchSurround underlay unless a specific application calls for its use. To align the TouchSurround underlay: 1. At the MS-DOS prompt, type ECAL /S. Press Enter. (Note: There is a space between ECAL and /). 2. Follow the on-screen instructions to complete the alignment. To align the TouchSurround underlay, be sure you are directly in front of the unit. Use a finger or an alignment tool to align the TouchSurround underlay. An alignment tool produces a more accurate alignment. Customizing touch responses in the TouchSurround area Adding TouchSurround buttons Use the emouse utility (emouse.com) to configure the behavior of the display area and the TouchSurround area. To use the emouse utility, see MS-DOS on page 7. Using the Surround.exe utility To define buttons on the TouchSurround area, use the Surround.exe utility. You can define the size, position, activation, and function of the TouchSurround buttons, and you can define buttons as function keys, command keys, calculator keys, screen change controls, or whatever other format you require. 43

48 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide The button definitions are stored in a button definition file. The button definition file for a standard TouchSurround TM underlay is called Surround.def. This file is in the C:\TOUCH\DOS directory on your computer s hard disk. A custom TouchSurround underlay does not have pre-defined button definition files. You must create your own definitions and store them in a file, typically named C:\TOUCH\DOS\SURROUND.DEF. To use a different file name, see Saving the button definition file in this chapter. To open the Surround.exe utility: At the MS-DOS prompt, type SURROUND and then press Enter. The main menu of the Surround utility indicates: which button definition file is currently being processed (if you have a custom TouchSurround underlay, this field will be blank until you create button definitions) how many buttons are defined The Surround utility deactivates all currently defined buttons while it is operating. Buttons on your TouchSurround underlay will not work while running this utility. Summary of steps To add a TouchSurround button definition do the following: 1. Create the new button s identifier in the Surround utility. 2. Define the new button s coordinates. 3. Define the new button s activation. 4. Define the new button s action. 44

49 Chapter 5: Configuring TouchSurround TM features: MS-DOS Creating a TouchSurround button to disable the touch screen for cleaning For a quick overview of the process for creating buttons on the TouchSurround area, here is an example. Cleaning the touch screen without disabling it could cause touch events that alter your process. To prevent this from happening, you could create a button called CLEAN and define its function as TOUCH. You could then press the CLEAN button before cleaning the screen, and press it again after cleaning to enable regular touches. To create a TouchSurround button to disable the touch screen: 1. Open the Surround utility (see Using the Surround.exe utility on page 43). 2. Type 2 at the main menu. 3. Assign a button identifier (see Creating the button identifier ). 4. Define the size and location of the button (see Defining the button s coordinates on page 46). 5. Define an activation method for the button (see Defining button activation on page 47). 6. To display the available codes, type 1, and then type the number of the TOUCH command. 7. At the main menu, type 5 to save the button definition. 8. When prompted, enter the name of the button definition file. The default file name is C:\TOUCH\DOS\SURROUND.DEF. 9. Press Enter to use the default file name, or type the full path and file name for your file. If the button definition file already exists, its previous contents are overwritten by the new definitions. If the file does not exist, it is created, and the button definitions are written to it exactly as displayed by main menu item 1. 45

50 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Creating the button identifier The button identifier is a number between 0 and 65534, used by the system to identify each button. To create the button identifier: 1. Open the Surround utility (see Using the Surround.exe utility on page 43). 2. At the main menu, Type Type the button identifier or leave the field blank, and then press Enter. If you do not enter a value, the system automatically enters a value. If you see the message WARNING: maximum buttons allowed = XX after pressing Enter at Step 3, you have reached the maximum number of buttons the Surround utility is configured to create. For more information about increasing the maximum number of buttons, see Changing the maximum number of TouchSurround buttons on page 53. Defining the button s coordinates To use a new button, you must define its coordinates. The coordinates of a button s upper left and lower right corners define the button s size and its position on the TouchSurround TM area. To ensure accuracy, use an alignment tool to define the button s coordinates. While defining a TouchSurround button, do not rest your hand anywhere on the surface of the touch screen or the bezel because the presence of your hand affects the values passed to the screen. Important To optimize performance of a new TouchSurround button, ensure you position the button at least 0.25 inches (6.4 mm) from the edge of your product s bezel. In addition, ensure the size of the button is at least the size of your index finger s fingerprint (about 0.7 inches on each side). 46

51 Chapter 5: Configuring TouchSurround TM features: MS-DOS To define the button s coordinates: 1. When you see the instructions to enter the button s coordinates, hold the alignment tool at a 90-degree angle to the screen surface, and touch the TouchSurround area where you want to position the upper left corner of the button _A Align the alignment tool with the inside edges of the Defining button activation 2. When prompted, touch where you want to position the button s lower right corner. The rectangular area between these two spots becomes your button. 3. To cancel the procedure, press Esc on your keyboard. After positioning a new button on the TouchSurround underlay, you are prompted to select an activation method for the button. A button can perform (activate) an action either when the button is pressed, or when the button is released. To define button activation, select one of these options: To activate an action once when the button is touched, but not when released, type 1 and then press Enter. To activate an action when the button is released, type 2 and then press Enter. To activate an action the first time you touch the button and repeat that action for as long as you hold your finger on the button, type 3 and then press Enter. 47

52 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Defining button action Button actions are performed either when the button is pressed or released. A button can either perform a command or inject an ASCII string: Commands control what operations are performed when a button is activated. See Button commands on page 48. ASCII strings are injected at the current cursor position when the button is pressed or released. See Strings on page 48. Button commands A button can be defined only as a Command or String button, not both. To define a button action, select one of these options: To display the available codes, type 1, and then type the number of the command you want to select. To define an ASCII string, type 2 followed by the ASCII string. To indicate NO ACTION, type 3. Use the Command option to define a command for a button press or release action. The command controls which operations are performed when a button is pressed or released. The button command code is described in Table E. Table E: Button commands This command TOUCH Does this on the display area Enables/disables the touch screen. When the touch screen is disabled, only this button responds to touches, allowing you to re-enable the screen. This function is useful for cleaning the touch screen. For details, see Summary of steps on page 44. Strings Use the String option to inject an ASCII string at the current cursor position when the button is pressed or released. For example, you can define a button to behave like the Tab key on a computer keyboard when pressed, by injecting the string <tab>. Strings can be any combination of normal ASCII characters, special codes, modified keys, and sticky keys. For example, this string combination: <SHIFTD>HELLO<SHIFTU>!<ENTER>HOW ARE YOU? passes the text HELLO! how are you? to the current cursor position when the button is pressed. 48

53 Chapter 5: Configuring TouchSurround TM features: MS-DOS ASCII characters represent normal computer keyboard keys, including alpha, numeric, and special characters (see Table F). Special codes represent non-printable keyboard keys, such as Tab (see Table G). The maximum length of the string is 40 characters on press, and 40 characters on release. The string consists of the first non-whitespace character you type (leading spaces are ignored) and all remaining characters to the end of the line (including embedded whitespace). Normal ASCII characters Table F lists the normal ASCII characters that are supported. Table F: ASCII characters (MS-DOS) A N a n 0!. _ B O b o 1 / ` C P c p 2 # : { D Q d q 3 $ ; E R e r 4 % < } F S f s 5 & = ~ G T g t 6 > H U h u 7 (? I V i v 8 J W j w 9 * [ K X k x + \ L Y l y, ] M Z m z - ^ Special codes Special codes represent non-printable keyboard keys. A special code is delimited by angle brackets < >, and is translated into the appropriate keyboard character. To put a normal < or > into a string, use double angle brackets like this: << or >>. Table G lists all the special codes that can be included in the button definition strings. Codes in the Normal Code column represent a single key on the keyboard. Codes in the Shift Code column represent the same key pressed in combination with the Shift key. Codes in the Control Code and Alt Code columns represent the key pressed in combination with the Ctrl and Alt keys, respectively. 49

54 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Note: It is not possible to generate key codes for more than one type of combination, such as Ctrl-Alt. Table G: Special codes (MS-DOS) Description Normal Code Shift Code Control Code Alt Code Backspace <BKSP> <C-BKSP> Tab <TAB> <S-TAB> Carriage Return or Enter Space Bar Escape <ENTER> <SPACE> <ESC> Function Key F1 <F1> <S-F1> <C-F1> <A-F1> Function Key F2 <F2> <S-F2> <C-F2> <A-F2> Function Key F3 <F3> <S-F3> <C-F3> <A-F3> Function Key F4 <F4> <S-F4> <C-F4> <A-F4> Function Key F5 <F5> <S-F5> <C-F5> <A-F5> Function Key F6 <F6> <S-F6> <C-F6> <A-F6> Function Key F7 <F7> <S-F7> <C-F7> <A-F7> Function Key F8 <F8> <S-F8> <C-F8> <A-F8> Function Key F9 <F9> <S-F9> <C-F9> <A-F9> Function Key F10 <F10> <S-F10> <C-F10> <A-F10> Function Key F11 <F11> <S-F11> <C-F11> <A-F11> Function Key F12 <F12> <S-F12> <C-F12> <A-F12> Insert Delete <INS> <DEL> Home <HOME> <C-HOME> End <END> <C-END> Page Up <PGUP> <C-PGUP> Page Down <PGDN> <C-PGDN> Up Arrow Down Arrow <UP> <DOWN> Left Arrow <LEFT> <C-LEFT> Right Arrow <RIGHT> <C-RIGHT> A Key a A <C-A> <A-A> B Key b B <C-B> <A-B> C Key c C <C-C> <A-C> D Key d D <C-D> <A-D> E Key e E <C-E> <A-E> F Key f F <C-F> <A-F> 50

55 Chapter 5: Configuring TouchSurround TM features: MS-DOS Table G: Special codes (MS-DOS) (Continued) Description Normal Code Shift Code Control Code Alt Code G Key g G <C-G> <A-G> H Key h H <A-H> I Key i I <A-I> J Key j J <C-J> <A-J> K Key k K <C-K> <A-K> L Key l L <C-L> <A-L> M Key m M <A-M> N Key n N <C-N> <A-N> O Key o O <C-O> <A-O> P Key p P <C-P> <A-P> Q Key q Q <C-Q> <A-Q> R Key r R <C-R> <A-R> S Key s S <C-S> <A-S> T Key t T <C-T> <A-T> U Key u U <C-U> <A-U> V Key v V <C-V> <A-V> W Key w W <C-W> <A-W> X Key x X <C-X> <A-X> Y Key y Y <C-Y> <A-Y> Z Key z Y <C-Z> <A-Z> \ Key <C-\> ] Key <C-]> ^ Key _ Key <C-^> <C-_> - Key <A--> = Key <A-=> 51

56 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Saving the button definition file When you have defined all the required buttons, save their definitions in a button definition file. To save button definitions: 1. At the main menu, type When prompted, enter the name of the button definition file. The default file name is C:\TOUCH\DOS\SURROUND.DEF. 3. Press Enter to use the default file name, or type the full path and file name for your file. If the button definition file already exists, its previous contents are overwritten by the new definitions. If the file does not exist, it is created, and the button definitions are written to it exactly as displayed by main menu item 1. Loading button definitions from a file By default, button definitions are read from a file called Surround.def. To load button definitions from another file, specify the file name as a parameter to the emouse.com command in the autoexec.bat file. See the /DEFINE option in Table B on page 19 for more information. Reviewing TouchSurround TM button definitions You can display the settings for all the buttons defined on the TouchSurround underlay. To review button definitions: 1. Open the Surround utility (see Using the Surround.exe utility on page 43). 2. Type 1 to display the button definitions. Editing a TouchSurround button You can change the button s activation method (press, release, or press and autorepeat) and action (command, string, or none). To change a button: 1. Open the Surround utility (see Using the Surround.exe utility on page 43). 2. If the button you want to change is in the current button definition file, type 3 at the main menu, then skip to Step 4. If the button you want to change is in a different button definition file, type 6 at the main menu, and then go to Step Type the name of the button definition file you want to change, and press Enter. The Surround utility loads the file. For example, if you specify SAMPLE.DEF, and the SAMPLE.DEF file contains 8 buttons, the Surround utility displays this message: 52

57 Chapter 5: Configuring TouchSurround TM features: MS-DOS Button definitions successfully read in Current button definition file = \sample.def Number of buttons defined = 8 4. When prompted for the button s identifier, enter the button s identifier number. If there is more than one button with the same identifier, a list of matching buttons is displayed. Select the button you want to change. 5. Make changes as required. Deleting a TouchSurround button Use the Surround utility to delete a button. To delete a button: 1. Open the Surround utility (see Using the Surround.exe utility on page 43). 2. Type 4 at the main menu. 3. When prompted for the button s identifier, type the button identifier number, and then press Enter to delete the button. If there is more than one button with the same identifier, a list of matching buttons is displayed. Select the button you want to delete, and then press Enter. Changing the maximum number of TouchSurround buttons The maximum number of button definitions a file can contain is set in the config.sys file when the touch screen drivers and utilities are installed. By default, a parameter is added to the touch screen driver (ets.exe) to make the maximum number of button definitions 80, as shown in the following line: DEVICE=C:\TOUCH\DOS\ETS.EXE /BUTTONS=80 Note: If this line does not appear in the config.sys file, the maximum number of buttons you can define is 50. To change the maximum number of buttons you can define: 1. Use a text editor to open the config.sys file. 2. Find this line to edit: DEVICE=C:\TOUCH\DOS\ETS.EXE /BUTTONS=80 3. Type a number between 0 and Save the file, exit the text editor, and restart your computer for this change to take effect. Note: The memory required by the touch screen driver is directly proportional to the maximum number of buttons you specify. Exceeding the maximum number of buttons If you create more button definitions than the maximum number specified in the config.sys file, a message is displayed when you are defining the button: WARNING: maximum buttons allowed = XX 53

58 If your file contains more buttons than the maximum number allowed, excess button definitions will be ignored during system startup. To prevent this from happening, increase the maximum number of buttons.

59 APPENDIX A Troubleshooting Software error messages General The touch screen drivers can detect error conditions that are independent of the operating system. If you see one of the following error messages, please note the number displayed with it. This will help 3M Touch Systems technical support staff diagnose the problem. Error message 9002: Unable to communicate with touch controller. Check COM port settings and cabling. 91xx: Touch controller image error detected. Solution 1. Disconnect power to the controller. 2. Double-check all connections between the controller and the host computer. 3. Re-connect power to the controller. 4. Double-check COM port settings for all peripheral devices and the controller. 5. Ensure no other touch drivers are loaded. 6. If the error message persists, call 3M Touch Systems for assistance. When turning on the NFI touch screen system, make sure that nothing is touching the touch screen or bezel. With a clean, untouched screen, recycle power to the touch controller. If error persists after powercycling: There may be short circuits to the touch controller or screen. The touch screen connector may be loose The touch screen or controller may need servicing. Double-check all connections between the controller and the host computer. Disconnect power to the controller and make sure the touch screen has not shifted within the bezel. Ensure that the touch screen can not shift within the bezel. Reconnect power and reset the baseline following the procedures specific to your operating system (see Chapter 1). If the error message persists, call 3M Touch Systems for assistance. 55

60 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Error message 91xx: Unrecoverable EEPROM failure detected in touch controller. Touch screen is inoperable. Servicing is required. 91xx: Touch controller failed RAM or ROM test. Touch screen is inoperable. Servicing is required. Solution Controller requires servicing. Call 3M Touch Systems for assistance. Controller requires servicing. Call 3M Touch Systems for assistance. Windows 98, Windows 95, and Windows NT 4.0 The Windows 98, Windows 95, and Windows NT 4.0 touch screen drivers can detect error conditions at startup and can display messages. You may see the following message. Error message Description Solution Error found in Display area configuration. Use the Configuration Utility to check settings. Display area configuration data has been corrupted. Default values are being used. Open the Configuration Utilities dialog box and save the configuration. Windows 3.1 One of the following error messages may occur when loading the touch screen driver or when running it from the MS-DOS command line. If the action in the Solution column does not fix the error, call 3M Touch Systems technical support. See 3M Touch Systems Support Services on page 3 for phone numbers. Error message Definition Solution ERROR: unknown parameter XX or unknown option XX ERROR: option XX is not valid when ETS is a device driver ERROR: invalid data specified with XX option or Error: value(s) for XX option out of range The ETS device driver has not been installed The command line contains an unknown parameter. You have attempted to specify an invalid option on the DEVICE= line of the configuration file for the ETS driver. The option is valid, but the value you have associated with it is not. You are attempting to run ETS from the MS-DOS command line, but the ETS driver has not also been installed in config.sys, or its installation failed. Check syntax. See Customizing touch responses in the TouchSurround area on page 25. Check option syntax. See MS-DOS on page 7. Questions & answers 56

61 Appendix A: Troubleshooting Question Is it possible to turn off the pointer/cursor? When I am using Windows NT 4.0 and try to change the touch screen configuration I get the error "Can't write configuration data" after I select "OK." What should I do? I cannot get any response from the touch screen. I am having trouble aligning my touch screen. The software will not accept the confirmation point. What should I do? During alignment, the message appears "Display Area exceeds Touch Screen boundary, Please re-align." What should I do? After installing the touch screen drivers in Windows 98 or Windows 95, my touch screen works but my mouse does not function. What should I do? After initializing my touch screen using the NFI Setup and Diagnostic Utility, the NFI touch screen system displays an error. Answer Yes. To turn off the pointer in Windows NT 4.0, Windows 98, and Windows 95, select a blank cursor. See your operating system manual to perform the procedure. If needed, 3M Touch Systems can provide a blank cursor file for Windows NT 4.0, Windows 98, and Windows 95. In Windows 3.1, see the appropriate Software Development Kit. In MS-DOS, the cursor is off by default. Applications must explicitly turn it on using Int 33h function 1. To turn it off again, use Int 33h function 2. These are standard Microsoft Mouse API capabilities (as described in the Microsoft Mouse Programmer's Reference). The touch screen configuration changes must be written to the registry. Run the Programs/ Administrative Tools/ User Manager and check your user rights. Ensure that you are logged in as the Administrator or belong to the Administrator group. Only Administrators have rights to access the registry. Check your connections to the controller and touch screen. Check that the settings in the touch screen software are the same as the hardware connections (for example, COM 1). Disconnect and then re-connect the power to the controller. If you re still experiencing difficulties, call 3M Touch Systems for assistance. Ensure that you use an alignment tool. In addition, note the numbers displayed on the alignment points and then call 3M Touch Systems for assistance. Your touch screen or controller may have been damaged during shipping or installation. This may mean that you have not touched the touch screen's alignment points accurately. Using an alignment tool, re-align more accurately. If this does not work, re-mount your touch screen or adjust your video display area to be the same size as the touch screen area. Select Control Panel and choose Add New Hardware. Choose "yes" to have Windows 95 or Windows 98 detect new hardware, when prompted. The software will find the mouse and correctly configure it for concurrent use with your touch screen. The baseline may be incorrect. When setting the baseline, ensure that nothing touches the touch screen or bezel. Reset power to the controller and try initializing the touch screen again. 57

62 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Question I am having trouble aligning the screen to match the display when working in MS-DOS. I want to run MS-DOS using a non-standard video mode. Do any mouse functions have to be issued after setting the graphics mode in a custom MS-DOS mouse driver application? Answer Some video displays in MS-DOS are sensitive to the video mode that your application uses. 1. Determine the video mode you re using. 2. Run ecal using the /VXX option where XX is the standard video mode between 0 and 16, as described in the Microsoft Mouse Programmer s Reference. 3. If you must, use a non-standard video mode. See information below. 4. If you re still experiencing difficulties, call 3M Touch Systems for assistance. Run ecal using the /VU option to align the touch screen. This option will not present any alignment targets, but will simply prompt for alignment around the edges of the touch screen. Yes. Issue a mouse function 0 after setting the graphic mode. Uninstalling and re-setting the software Windows NT 4.0, Windows 98, and Windows 95 Uninstalling 1. Select the Windows Start button. 2. In the Start menu, select Run. 3. In the Run dialog box, select Browse to find the following Uninstall programs: C:\TOUCH\NT\UNINSTAL.EXE for Windows NT 4.0 touch screen software C:\TOUCH\W9X\UNINSTAL.EXE for Windows 98 and Windows 95 touch screen software 4. In the Run dialog box, select OK. 5. Follow the on-screen instructions. 6. Restart the computer. Re-setting If you ever want to re-set the touch screen software without re-installing the software, follow these steps: 1. From the Windows operating system desktop, select Start» Programs» Touch» NSD. The NFI setup dialog box appears. 2. Follow the on-screen prompts and perform steps 6, 7 and 8 on page 5 to install the linearization file, set the baseline and align the touch screen. 3. The software is re-set. 58

63 Appendix A: Troubleshooting Windows 3.1 and MS-DOS Uninstalling 1. If you re using Windows 3.1, exit to MS-DOS. 2. Change to the Drivers directory, select the directory for the operating system you are using. Your choices are: TOUCH\WIN for Windows 3.1 software TOUCH\DOS for MS-DOS software 3. Type UNINSTAL and press Enter. 4. Follow the on-screen instructions. 5. Restart the computer. Re-setting If you ever want to re-set the touch screen software without re-installing the software, follow these steps: 1. Make sure you are in MS-DOS. 2. Find the TOUCH\WIN folder and type NSD to start the NFI Setup and Diagnostic Utility. 3. To start the Initialize option, press 1 and then press Enter. 4. If you re using a communications port other than COM 1, follow the onscreen instructions for changing the setting. 5. Insert the floppy disk that came with your NFI touch screen that has the linearization file for your touch screen. 6. When you are prompted for the name of the linearization file, type: A:\<filename> and then press Enter where <filename> is the name of the linearization file on the disk. 7. Follow the on-screen prompts to finish writing the baseline and loading the linearization file. 59

64

65 APPENDIX B Button commands and strings for TouchSurround TM underlay Button commands To add TouchSurround buttons, you must define the action when a button is pressed or released. This chapter explains how to add a command or string for Windows NT 4.0, Windows 98, Windows 95, and Windows 3.1 To define a button command: 1. Select Command. In Windows NT 4.0, Windows 98, and Windows 95, select Command in the Define a Button dialog box. In Windows 3.1, select the Command check box in the TouchSurround Area dialog box. 2. Choose a command from the following list. Table H: Button commands This command NO_COMMAND TOUCH Does this on the display area No command defined for this button. This function is useful for disabling a button temporarily. For example, when the button doesn t work as intended. Enables/disables the touch screen. When the touch screen is disabled, only this button responds to touches, allowing you to reenable the screen. This function is useful for cleaning the touch screen. Cleaning the touch screen without disabling it could cause touch events that alter your process. To prevent this from happening, you could create a button called CLEAN and define its function as TOUCH. When cleaning the touch screen, you could then press the CLEAN button before cleaning the screen, and press it again after cleaning to enable regular touches. 61

66 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Strings Use the String option to insert an ASCII string at the current cursor position when the button is activated. For example, you can define a button to behave like the Tab key on a computer keyboard by inserting the string <tab>. Strings can be any combination of normal ASCII characters, special codes, modified keys, and sticky keys. ASCII characters represent keyboard keys, including alpha, numeric, and special characters (see Table I). Special codes represent non-printable keyboard keys, such as Tab (see Table J and Table K). Modified keys are created by combining any ASCII character or special code with a Shift, Alt, or Ctrl key modifier. Sticky keys are keys defined as the Shift, Ctrl, or Alt modifier. This applies the modifier to the next character inserted. An ASCII string can be up to 40 characters. The string consists of the first nonwhite-space character you type (leading spaces are ignored) and all remaining characters to the end of the line (including embedded white space). To define a string: 1. Select String. In Windows NT 4.0, Windows 98, and Windows 95, select String in the Define a Button dialog box. In Windows 3.1, select the String check box in the TouchSurround TM Area dialog box. 2. Choose a string from the following lists. Normal ASCII characters Table I lists the normal ASCII characters that are supported. Table I: ASCII Characters A N a n 0!. _ B O b o 1 / ` C P c p 2 # : { D Q d q 3 $ ; E R e r 4 % < } F S f s 5 & = ~ G T g t 6 > H U h u 7 (? I V i v 8 J W j w 9 * [ K X k x + \ L Y l y, ] M Z m z - ^ 62

67 Appendix B: Button commands and strings for TouchSurround TM underlay Special codes Special codes represent non-printable keyboard keys. A special code is delimited by angle brackets < >, and is translated into the appropriate keyboard character. To put a normal < or > into a string, use double angle brackets like this: << or >>. Table J lists all the special codes that can be included in the button definition strings. Keys preceded by the # character represent number pad keys. Use the number pad keys for arithmetical functions as well multiply (*), divide (/), subtract (-) and add (+). Some codes, such as, SHIFTU, SHIFTD, CTRLU, CTRLD, ALTU and ALTD have no actual keyboard equivalents. They represent Shift key Up, Shift key Down, Control key Up, Control key Down, Alt key Up, and Alt key Down. The SHIFTLOCK, ALTLOCK, AND CTRLLOCK codes represent toggle functions on each of the Shift, Alt, and Ctrl keys. For example, one insertion of SHIFTLOCK is equivalent to Shift key Down, while the next insertion is equivalent to Shift key Up. CAPSLOCK applies to alphabetical keys only. SHIFTLOCK applies to all keys. Important Use SHIFTLOCK, ALTLOCK, and CTRLLOCK carefully. The operating system may react differently to a mouse click plus these keys than it would to a mouse click alone. Table J: Special codes (Windows NT 4.0, Windows 98, and Windows 95) Description Key Description Key Function key F1 <F1> Shift Lock <SHIFTLOCK> Function key F2 <F2> Shift key down <SHIFTD> Function key F3 <F3> Shift key up <SHIFTU> Function key F4 <F4> Ctrl Lock <CTRLLOCK> Function key F5 <F5> Ctrl key down <CTRLD> Function key F6 <F6> Ctrl key up <CTRLU> Function key F7 <F7> Alt Lock <ALTLOCK> Function key F8 <F8> Alt key down <ALTD> Function key F9 <F9> Alt key up <ALTU> Function key F10 <F10> Scroll key <SCROLL> Function key F11 <F11> Number pad * key <MULT> Function key F12 <F12> Number pad / key <DIV> Escape <ESC> Number pad + key <ADD> Tab <TAB> Number pad - key <SUB> Backspace <BKSP> Num Lock <NUM> Enter <ENTER> Print Screen <PRTSCR> Spacebar <SPACE> Number pad 0 key <#0> 63

68 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Table J: Special codes (Windows NT 4.0, Windows 98, and Windows 95) Description Key Description Key Up arrow <UP> Number pad 1 key <#1> Down arrow <DOWN> Number pad 2 key <#2> Left arrow <LEFT> Number pad 3 key <#3> Right arrow <RIGHT> Number pad 4 key <#4> Page Up <PGUP> Number pad 5 key <#5> Page Down <PGDN> Number pad 6 key <#6> Insert <INS> Number pad 7 key <#7> Delete <DEL> Number pad 8 key <#8> Pause <PAUSE> Number pad 9 key <#9> Caps Lock <CAPS> Number pad. key <#.> Home <HOME> Number pad Enter key <#Enter> End <END> Table K: Special codes (Windows 3.1) Description Normal Code Shift Code Ctrl Code Alt Code Backspace key <BKSP> <S-BKSP> <C-BKSP> <A-BKSP> Tab key <TAB> <S-TAB> <C-TAB> <A-TAB> Carriage Return or Enter <ENTER> <S-ENTER> <C-ENTER> <A-ENTER> ESC key <ESC> <S-ESC> <C-ESC> <A-ESC> Page Up key <PGUP> <S-PGUP> <C-PGUP> <A-PGUP> Page Down key <PGDN> <S-PGDN> <C-PGDN> <A-PGDN> End key <END> <S-END> <C-END> <A-END> Home key <HOME> <S-HOME> <C-HOME> <A-HOME> Left key <LEFT> <S-LEFT> <C-LEFT> <A-LEFT> Up key <UP> <S-UP> <C-UP> <A-UP> Right key <RIGHT> <S-RIGHT> <C-RIGHT> <A-RIGHT> Down key <DOWN> <S-DOWN> <C-DOWN> <A-DOWN> Insert key <INS> <S-INS> <C-INS> <A-INS> Delete key <DEL> <S-DEL> <C-DEL> <A-DEL> Function key F1 <F1> <S-F1> <C-F1> <A-F1> Function key F2 <F2> <S-F2> <C-F2> <A-F2> Function key F3 <F3> <S-F3> <C-F3> <A-F3> Function key F4 <F4> <S-F4> <C-F4> <A-F4> Function key F5 <F5> <S-F5> <C-F5> <A-F5> 64

69 Appendix B: Button commands and strings for TouchSurround TM underlay Table K: Special codes (Windows 3.1) Description Normal Code Shift Code Ctrl Code Alt Code Function key F6 <F6> <S-F6> <C-F6> <A-F6> Function key F7 <F7> <S-F7> <C-F7> <A-F7> Function key F8 <F8> <S-F8> <C-F8> <A-F8> Function key F9 <F9> <S-F9> <C-F9> <A-F9> Function key F10 <F10> <S-F10> <C-F10> <A-F10> Function key F11 <F11> <S-F11> <C-F11> <A-F11> Function key F12 <F12> <S-F12> <C-F12> <A-F12> Break key <C-BREAK> A key a A <C-A> <A-A> B key b B <C-B> <A-B> C key c C <C-C> <A-C> D key d D <C-D> <A-D> E key e E <C-E> <A-E> F key f F <C-F> <A-F> G key g G <C-G> <A-G> H key h H <C-H> <A-H> I key i I <C-I> <A-I> J key j J <C-J> <A-J> K key k K <C-K> <A-K> L key l L <C-L> <A-L> M key m M <C-M> <A-M> N key n N <C-N> <A-N> O key o O <C-O> <A-O> P key p P <C-P> <A-P> Q key q Q <C-Q> <A-Q> R key r R <C-R> <A-R> S key s S <C-S> <A-S> T key t T <C-T> <A-T> U key u U <C-U> <A-U> V key v V <C-V> <A-V> W key w W <C-W> <A-W> X key x X <C-X> <A-X> Y key y Y <C-Y> <A-Y> Z key z Z <C-Z> <A-Z> Print Screen key Spacebar <PRTSCR> <SPACE> 65

70 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide Table K: Special codes (Windows 3.1) Description Normal Code Shift Code Ctrl Code Alt Code Pause key Caps Lock key Scroll Lock key Num Lock key Shift key down Shift key up Shift lock Ctrl key down Ctrl key up Ctrl lock Alt key down Alt key up Alt lock Number pad * key Number pad + key Number pad - key Number pad / key Number pad 0 key Number pad 1 key Number pad 2 key Number pad 3 key Number pad 4 key Number pad 5 key Number pad 6 key Number pad 7 key Number pad 8 key Number pad 9 key <PAUSE> <CAPS> <SCROLL> <NUM> <SHIFTD> <SHIFTU> <SHIFTLOCK> <CTRLD> <CTRLU> <CTRLLOCK> <ALTD> <ALTU> <ALTLOCK> <MULT> <ADD> <SUB> <DIV> <#0> <#1> <#2> <#3> <#4> <#5> <#6> <#7> <#8> <#9> 66

71 Appendix B: Button commands and strings for TouchSurround TM underlay Table K: Special codes (Windows 3.1) Description Normal Code Shift Code Ctrl Code Alt Code Number pad. key Start application <#.> <RUN> Modified key combinations Create Shift, Alt, or Ctrl key combinations by combining any ASCII character or special code with a Shift, Alt, or Ctrl modifier. The modifier is added by prefacing the selected key with one of the following prefixes, and delimiting the result with < >: S- (for Shift) C- (for Ctrl) A- (for Alt) any combination of these (up to a maximum of three) Example: This code <C-X> <A-Tab> <C-A-DEL> Generates this key combination Ctrl+X Alt+Tab Ctrl+Alt+Delete The following procedures show a practical use for modified key combinations for Windows 98 or Windows 95. Key combinations can be used to define TouchSurround buttons that can start Windows applications. First, create a shortcut to your application, then define a button on the TouchSurround underlay to open or start the application. To create a shortcut to your application: 1. While holding down the Ctrl key on the keyboard, select an application icon and drag it to the desktop. 2. Right mouse click on the icon to display options for defining properties. 3. Select the Shortcut tab. 4. Tab to, or click the Shortcut key text box. 5. Type a shortcut key sequence, for example CTRL-ALT-A. 6. Select OK. Pressing this key combination on the keyboard opens or starts the application pointed to by the shortcut. 67

72 MicroTouch TM Near Field Imaging TM (NFI) Software User s Guide To define a TouchSurround TM button to launch the application: 1. Open the Configuration Utilities dialog box. 2. Select Buttons. 3. Do one of the following: Select Append, then define the button co-ordinates. Select a currently defined button, and then press Edit. 4. Choose String as the button press action. 5. Enter the string to match what was previously entered as the shortcut key sequence, example <C-A-A>, meaning CTRL-ALT-A. 6. Select OK. 7. Select Exit. Sticky keys You can also define a button to be the Shift, Ctrl, or Alt modifier that applies to the inserted character that follows the modifier. A button defined to insert this special code is called a sticky key. Inserting such a code has no effect in itself, but the next character inserted after this one has the modifier applied to it. For example, touching a button defined as <A-> and then touching one defined as <F4> is equivalent to typing Alt+F4. Generally, you need sticky key codes only if your TouchSurround underlay has buttons called Shift, Ctrl, and Alt, in which case they should be defined as <S->, <C->, and <A->. Activating a button defined as <S-> and then activating one defined to insert the ASCII character string h-e-l-l-o results in the key sequence H-e-l-l-o. That is, the sticky key is applied only to the first character in the ASCII character string. 68