Introduction

This wiki documents the steps to be followed to get started with Sparsh.

Getting Started on Windows

Note: The java version is suggested for beginners and who want to quickly prototype their multi-touch apps.The source code is also available if you want to add your own gestures.

Java Version:

1) Download the latest Sparsh java version from

2) Download the required hardware driver.

a) FTIR / Diffused illumination devices based devices - MT-Mini (Cardboard

based multi-touch pad)

Since most of them use TouchLib from NUI (http://nuigroup.com/) for such devices , We have a TouchLib adapter that provides the input to Sparsh in the desired format. Download the windows installer from http://sparsh-ui.googlecode.com/files/TouchLibSparshAdapterSetup.zip

Unzip it and click on setup. This would install the TouchLibSparshAdapter. By default it would install in C:/Program Files/TouchLibSparshAdapter/

This is currently tested for MT-Mini. ( We could not test TouchLib with our FTIR table as it does'nt seem to like our old FTIR hardware yet :) ).

b) Support for other drivers

We have published the open source code for Sparsh device Adapters (and Device driver code) and the compilation instructions for some other multi-touch devices:

1. Stantum Multi-touch Tablet from stantum

2) Infrared Bezel from IrTouch systems 3) FTIR based Device driver (non-touchlib version)

If you have your own device , follow the easy steps at http://code.google.com/p/sparsh-ui/wiki/SparshUI_Device_Adapter to write your own adapter for Sparsh.

3) Download the apps:

FingerPaint: http://sparsh-ui.googlecode.com/files/FingerPaint.jar

4) Run JavaGestureServer-VERSION.jar. This would start a window for GestureServer

5) In the All programs menu , you would find an entry called TouchLibSparshAdapter.

If you are running the program for the first time , you have to configure TouchLib by running TouchLibConfigApp.It will open a set of windows with sliders. It needs to configured until blobs appear properly .For a very good documentation on doing this see a very good documentation from Seth Sandler at http://audiotouch.googlecode.com/files/MTmini%20-%20Getting%20Started%20v1.pdf (and also see if you want to build one MT-Mini)

After configuring , run the TouchLibSparshAdapter. It should connect to GestureServer and GestureServer would indicate that "InputDevice Connection Accepted".

6) Run the App.

C++ Version:

C++ version is suggested for C++ enthusiasts who would like to c

1) Download Sparsh UI windows installer from Sparsh UI website

http://sparsh-ui.googlecode.com/files/SparshCPPWindowsInstaller.zip Install the same. By default it would install in the folder "C:\Program Files\Virtual Reality Applications Center\SparshCPP\" and add an entry in programs menu under Virtual Reality Applications Center.

2) Repeat the same steps as mentioned in java version.

Getting Started on Linux

Java:

1) 1) Download the latest Sparsh java version 2) Download the required driver.

Currently the binaries for linux version of Touchlib Adapter for sparshUI are not released.It will be posted soon.

How to make your device compatible with sparsh :

http://code.google.com/p/sparsh-ui/wiki/SparshUI_Device_Adapter

5) Run the app.