Main Page | Alphabetical List | Data Structures | File List | Data Fields | Globals | Related Pages

FingerWorks Hand Tracking SDK

v1.5.3 Copyright (c) 2003-2004 FingerWorks Inc. All rights reserved.

Introduction

The FingerWorks Hand Tracking SDK allows programmers to access additional data streams available on FingerWorks MultiTouch devices. The additional data streams available are Contacts, Paths, and Hand Motion. Contacts and Paths allow applications to receive real-time finger & palm location data including proximity, orientation, eccentricity, and estimated identity. The Hand Motion data stream allows applications to receive hand motion events, an extended form of mouse events that includes chording, translation/rotation/scaling motion and hand source data. Hand Motion events offer rich possibilities like two handed manipulation that are simply impossible with standard mouse/keyboard channels.

This documentation is mostly a reference guide with a short section on getting started. Two programming examples are available that illustrate using Contacts and Paths. For a example of the Hand Motion data see the XWinder source with is also packaged with the SDK.

Table of Contents

System Requirements

A FingerWorks MultiTouch device is required with special firmware which is available with this SDK. See Setting up a MultiTouch Device to work with the SDK for more information

Microsoft Windows 98 and later

Multiple devices are fully supported. Make sure the latest firmware has been installed and the desired hand/contact/path data streams have been enabled either through stream enable calls, or for XWinder chords, through the MultiTouch Utilities Feature Selector.

Mac OS X 10.2 and later

Warning:
Third party Mac OS X mouse drivers like USB Overdrive must be UNINSTALLED, not just disabled, for HID Manager drivers used by Hand Motion SDK to work!

Linux -- Not yet implemented!

Warning:
Until a hand motion Linux driver is provided, enabling the hand motion stream may cause keyboard stalls!

SDK License and Disclaimer

IMPORTANT: This FingerWorks software is supplied to you by FingerWorks, Inc. ("FingerWorks") in consideration of your agreement to the following terms, and your use, installation, or modification of this FingerWorks software constitutes acceptance of these terms. If you do not agree with these terms, please do not use, install or modify this FingerWorks software.

In consideration of your agreement to abide by the following terms, and subject to these terms, FingerWorks grants you a personal, non-exclusive license, under FingerWorks's copyrights in this original FingerWorks software (the "FingerWorks Software"), to use, reproduce, and modify the FingerWorks Software for personal, academic, research, or artistic purposes. You may NOT distribute this FingerWorks Software, with or without modifications, in either source or binary form.

Neither the name, trademarks, service marks or logos of FingerWorks, Inc. may be used to endorse or promote products derived from the FingerWorks Software without specific prior written permission from FingerWorks. Except as expressly stated in this notice, no other rights or licenses, express or implied, are granted by FingerWorks herein, including but not limited to any patent rights that may be infringed by your derivative works or by other works in which the FingerWorks Software may be incorporated.

Disclaimer: The FingerWorks Software is provided by FingerWorks on an "AS IS" basis. FINGERWORKS MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE FINGERWORKS SOFTWARE OR ITS USE AND OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS.

IN NO EVENT SHALL FINGERWORKS BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION OF THE FINGERWORKS SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF FINGERWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Copyright (c) 2003-2004 FingerWorks Inc. All rights reserved.

Source Code License and Disclaimer

Source code for portions of this SDK (specifically the Windows XP and Mac OS X implementations of the XWinder/HandMotion API) may be provided subject to the MPL 1.1/GPL 2.0/LGPL 2.1 open-source tri-license (The Tri-License), but see individual source files for license details. You may not use these files except in compliance with the License. You may obtain a copy of the Tri-License at http://www.mozilla.org/MPL/

Software distributed under the Tri-License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the Tri-License for the specific language governing rights and limitations under the Tri-License.

Support and Feedback

For any support issues email sdk@fingerworks.com or post in the SDK forums at http://forums.fingerworks.com/.

Acknowledgements

Thanks go to:
Generated on Fri Dec 10 10:08:11 2004 for FingerWorks Hand Tracking SDK by doxygen 1.3.8