Introduction

The document describes the example source code that has been written to show how to achieve certain pointer device functionality or invoke UPDD functions via the UPDD SDK API. It is our intention to build a source library that will be available via our new web site (Autumn 2006) but also distributed with the driver so that all example code is to hand via the web or with the driver software as part of the installation. Examples without hyperlinks are yet to be made available. The OS column entry indicates the OS platform associated with the source code, all specifies ‘all’ in the case of cross platform utilisation. If the installation installs the UPDD extras, this document, along with the source code compressed files, will be located in UPDD sub-folder Examples.

Source	Description	OS

Toolbartest	CE example program to handle a UPDD toolbar	CE
Calibration	Actual source code of the UPDD calibration program	All
MultiTouch	Example code showing how to achieve direct touch input (rather than mouse emulation) from multiple touch devices	Windows

Toolbartest for CE

Toolbars are reserved touch-screen areas that do not respond to touches in the normal way, but instead generate events that can be accessed by a client mode program. The Toolbartest.zip file contains the source and library files for a simple program that demonstrates how to access the toolbar data.

A toolbar can be divided into a number of rows and columns. The demo program shows how to access the toolbar name and the pressed row and column for each touch recorded.

The package contains a standard CE Project builder project file (pbp), the source files for the application (cpp, h, rc), the api library file (lib) and the api header file. Libs for x86 (tbapi_x86.lib), mips (tbapi_mips.lib) and arm (tbapi_arm.lib) targets are included. The lib files in this package are for a CE 4.x target, for other targets use the lib file (tbapi.lib) supplied with the UPDD driver package.

The program is straight forward and should integrate simply with any CE project. The significant code is in toolbartest.cpp. The code is clearly annotated and should be self explanatory. For further information on any UPDD API's consult the SDK reference documentation.

In order to make use of the toolbar API's you must first define the toolbar areas on the target system. This is described in UPDD Toolbar document.

Contact

For further information or technical assistance please email the technical support team at technical@touch-base.com.