This binding has been deprecated - please see the most recent release notes for more information.
In this tutorial you will prepare your development environment for use with the .NET bindings for Gestureworks Core. While no code will be written in this tutorial, the steps performed here will prepare your environment for subsequent Gestureworks Core .NET tutorials.
Download the code for all of the C# & XNA multitouch tutorials here: tutorials_csharp_xna.zip
The various bindings included with Gestureworks Core allow a developer to create multitouch applications using their preferred language and framework, and are essentially mini-APIs providing an interface to the functions exported by the native Gestureworks Core library (GestureWorksCoreWin7.dll, GestureWorksCoreWin8.dll). Source code for each of the bindings is included so that you may extend or modify them as you like, as well as providing a blueprint for creating bindings for other languages or frameworks.
You may download the API documentation for the .NET bindings in *.chm format here: gestureworkscorenet_help.zip
The .NET bindings for Gestureworks Core can be used by any .NET project. The source code for the .NET bindings is provided for portability and extensibility, but can be used quite effectively as-is in most situations.
In this and the following tutorials, Microsoft's XNA Game Studio 4.0 is used for demonstrating Gestureworks Core fundamentals using the .NET bindings. XNA Game Studio – while unfortunately no longer supported by Microsoft – is an easy-to-use framework providing methods for loading content (e.g. bitmap images), displaying that content on screen, and manipulating it; this allows us to focus on the use of Gestureworks instead of the intricacies of writing supporting code from scratch.
Time to complete: 15 minutes
A number of software packages are required for completing this and the following .NET tutorials, as well as a multitouch display device and familiarity with object oriented programming in C#.
The following primary steps are performed in this tutorial:
Each of the following software packages must be downloaded and installed prior to continuing with the tutorial. Note that because XNA Game Studio 4.0 does not officially support Windows 8, there is an extra package (Games For Windows Marketplace Client) that must be installed before XNA; Windows 7 does not have this requirement.
The Gestureworks Core installer package – GestureWorksCoreSetup.exe – contains the main GestureWorksCore.dll files (the “native” DLLs), various bindings (C++ .NET, Python, etc.), and supporting documentation. Gestureworks Core must be licensed prior to use in any software project.
Download the Gestureworks Core Trial package from here.
Double-click the downloaded installer package GestureWorksCoreSetup.exe to install Gestureworks Core. Gestureworks Core consists of the Gestureworks Core DLLs as well as various tutorials, bindings, and documentation:
Sample GestureML file:
.NET bindings (project source)
.NET bindings (compiled libraries)
.NET documentation (also available as downloadable *.chm help file)
Assets for the tutorials
Microsoft's XNA Game Studio 4.0 provides an easy-to-use framework for developing interactive graphics-based applications using C# and .NET. XNA supplies easy bitmap display using the “content pipeline” as well as a ready-made draw loop that’s perfect for use with Gestureworks.
First, create a new XNA Game Studio solution in Visual Studio 2010:
Next, add a reference to the appropriate GestureWorksCoreNET.dll to the GestureWorksTutorial1 project:
The Gestureworks Core .NET reference is now added to the GestureWorksTutorial1 project and will appear in its References. This will allow using the Gestureworks Core .NET bindings' code in the following tutorials.
Please note that this procedure added a reference to the binary version of the .NET bindings DLL and not the native Gestureworks Core DLL (GestureworksCore32.dll / GestureworksCore64.dll). You will learn more about the Gestureworks Core DLL in the next tutorial, .NET & XNA: Getting Started II (Hello Multitouch).
There are some compiler settings that are unique to XNA development, and others that are applicable to all development with the Gestureworks Core .NET bindings.
In this tutorial we installed Gestureworks Core, the prerequisites for developing with the Gestureworks Core .NET bindings, and created a solution that includes the .NET bindings project. From here we move on to NET & XNA: Getting Started II (Hello Multitouch) in which we dig into actual source code, initializing Gestureworks Core and working with touch and gesture event data.