Firmware version 1.50 or greater is required to use this SDK with FingerWorks devices. To upgrade firmware, run the MultiTouch Utilities and click the Device Firmware Upgrade launch button.
Further steps may be needed before the device will send the data stream you desire:
The kFW_HandMotionStream is usually enabled by default for use by XWinder, but you can enable it upon startup with a FWHID_enableStreams (kFW_HandMotionStream) call to make sure. Furthermore, you may need to enable XWinder chords in the MultiTouch Utilities Feature Selector or MyGesture Editor:
- For the spread, thumb+index+pinky chord of either hand, check "One-handed XWinder Chords..." in the Gesture Sets pane.
- For various bi-manual two, three, and four finger chords, check "Two-handed XWinder Chords..." in the Gesture Sets pane.
When the gesture report stream is enabled, ALL chords and gestures, not just "XWinder" and bimanual chords, generate Chord Selection and Hand Motion events. Thus the gesture report stream is particularly useful for gesture tutorial applications that monitor which chords are being activated, as well as for custom gesture-based games.
The Contact/Path stream provides detailed tracking and identification for each finger or palm touching the surface. It can be used as the basis for a custom gesture recognition system, or for creative applications like electronic 'finger-painting' or sound synthesis. Since this stream uses more USB bandwidth than the others, enabling it may occasionally cause sluggishness in the other streams (particularly keyboard or hand motion) on some systems.
- Some tracking applications may want completely take over all gesture recognition and thus disable normal keyboard, mouse, and hand motion events while collecting path data. Such applications should call FWHID_disableStreams (kFW_DefaultStreams) in their Device Creation Callback and also be sure to call FWHID_enableStreams (kFW_DefaultStreams) from their Device Disposal Callback. Applications that require tracking or interpretation of flattened hands may also want to call FWHID_setFlathandReset (false) in their Device Creation Callback. Remember to restore the flathand recalibration feature with FWHID_setFlathandReset (true) in the Device Disposal Callback.
- The Mac OS X implementation is susceptible to path stream overflow or delays from the underlying HID Element buffers. To reduce path data delays on Mac OS X, call FWHID_setPathFramesToSkip ( ) with an argument of 1 or 2 so that the path stream is not transmitted every image frame. With the default of 0 frames skipped, path updates are transmitted at the full 100-120Hz imaging rate.
Next: Contacts Up to FingerWorks Hand Tracking SDK
Generated on Fri Dec 10 10:08:12 2004 for FingerWorks Hand Tracking SDK by
1.3.8