MultiTouch - Revision history

AngelHerraez at 11:51, 22 January 2011

2011-01-22T11:51:51Z

AngelHerraez: Reverted edits by Vsimon213 (Talk) to last version by AngelHerraez

2010-07-07T16:12:14Z

Reverted edits by Vsimon213 (Talk) to last version by AngelHerraez

Anonymous at 00:43, 7 July 2010

2010-07-07T00:43:04Z

AngelHerraez: /* Technical details of the implementation */

2010-01-16T16:34:02Z

‎Technical details of the implementation

AngelHerraez: collecting Multi-Touch documentation

2010-01-16T13:36:25Z

collecting Multi-Touch documentation

AngelHerraez: new page to collect details on multi-touch support in Jmol

2010-01-15T18:27:10Z

new page to collect details on multi-touch support in Jmol

New page

= Using Jmol with Multi-Touch Panels =

..very rough draft yet..

(introduction)

[http://www.youtube.com/watch?v=7x8uDRQKIg0 Preliminary demo]

(versions)

(details)

An adaptation of SparshUI to work with the Jmol application (either stand-alone or embedded) and the Jmol applet.

Custom gestures: SinglePointGesture and TwoPointGesture

Ports: 5946 for clients and 5947 for a single driver

Implemented gestures include:

- single touch up/down/move (standard mouse down,drag,up -- model rotation)
- single-touch click (standard mouse click)
- single-touch long click (model translation)
- two-finger slide (model translation)
- two-finger stretch (zoom in)
- two-finger pinch (zoom out)

On the HP TouchSmart one first starts the device connection -- JmolMultiTouchDriver.exe.
Then you start the Jmol application using the -Msparshui flag or, for the embedded application, initialize it with the command option -multitouch-sparshui. For the applet, include the JavaScript command:

Â JmolSetCallback("multiTouchSparshUI", "true")

prior to

Â JmolApplet(...)

Or, with my latest version of Jmol.js, you can add parameters to the URL line, so with that you can adapt any page to work with multi-touch. For example, if you have JmolMultiTouchDriver.exe running on your HP TouchSmart, the following should work:

http://chemapps.stolaf.edu/jmol/docs/examples-11/molecules/molecules.htm?PARAMS=multiTouchSparshUI:true

The driver will cycle while waiting for a connection, and the first Jmol application or applet that loads will start a gesture server that connects with it. If additional applets or applications load, then their gesture server will not connect, but they will find the other gesture server.

The problem of multiple overlapping windows was solved easily by only allowing SparshUI action within a window if that window has the focus. So one needs to first click on a model to activate SparshUI action within that window.

There might be a problem if one applet starts a server and then closes while another is using it. In addition, multiple applets on the same page are no problem, but applets on different pages within the same tabbed browser system probably cause problems. Just closing a page doesn't necessarily work. I've been using File|Close Tab in Firefox.

== Terminology ==

swipe: put finger on surface, drag in a single direction, while continuing
the drag motion lift finger from surface

flick: swipe but done must faster

@@ Line 12: / Line 12: @@
 == How to use it ==
-You need at least version 11.9.11 of Jmol. It is recommended that you use the latest 11.9.x
+You need at least version 11.9.11 of Jmol. It is recommended that you use the latest 12.1.x
 First, you must start the device connection executing {{file|JmolMultiTouchDriver}}, a driver written in C++ and currently set up only for the HP TouchSmart computer using Windows, or any computer with [http://www.nextwindow.com/ NextWindow] technology.

← Older revision		Revision as of 16:12, 7 July 2010
Line 82:		Line 82:

	Custom gestures: SinglePointGesture and TwoPointGesture		Custom gestures: SinglePointGesture and TwoPointGesture
−
−	~~==Related Links==~~
−
−	~~[http://hellokittydigitalcamera.net/ '''hello kitty digital camera''']~~

← Older revision		Revision as of 00:43, 7 July 2010
Line 82:		Line 82:

	Custom gestures: SinglePointGesture and TwoPointGesture		Custom gestures: SinglePointGesture and TwoPointGesture
		+
		+	==Related Links==
		+
		+	[http://hellokittydigitalcamera.net/ '''hello kitty digital camera''']

@@ Line 73: / Line 73: @@
 After the small C++ program 'JmolMultiTouchDriver' is running, all messages from the touch-screen are passed to Jmol and interpreted as "gestures".
- Gestures include a standard two-finger spread/pinch for zoom in/out, a two-finger slide for translation, and a one-finger "flick" to start spinning.
+Gestures include a standard two-finger spread/pinch for zoom in/out, a two-finger slide for translation, and a one-finger "flick" to start spinning.
 The driver will cycle while waiting for a connection, and the first Jmol application or applet that loads will start a gesture server that connects with it. If additional applets or applications load, then their gesture server will not connect, but they will find the other gesture server.

@@ Line 1: / Line 1: @@
 = Using Jmol with Multi-Touch Panels =
-..very rough draft yet..
+:''Note: This is a novel feature and experience with it is limited. If you have a multi-touch device, the Jmol developers will be happy to share your experience and suggestions.''
-(introduction)
+...This is a draft yet...
-(versions)
+== Introduction to multi-touch technology ==
-(details)
+[http://www.youtube.com/watch?v=7x8uDRQKIg0 Preliminary demo] of Jmol working with multi-touch features.
-An adaptation of SparshUI to work with the Jmol application (either stand-alone or embedded) and the Jmol applet.
+== How to use it ==
-Custom gestures: SinglePointGesture and TwoPointGesture
+First, you must start the device connection executing {{file|JmolMultiTouchDriver}}, a driver written in C++ and currently set up only for the HP TouchSmart computer using Windows, or any computer with [http://www.nextwindow.com/ NextWindow] technology.
-Ports: 5946 for clients and 5947 for a single driver
+=== Jmol Application ===
-- single touch up/down/move (standard mouse down,drag,up -- model rotation)
+While {{file|JmolMultiTouchDriver}} is running, you start Jmol with the -Msparshui flag. Example:
-- single-touch click (standard mouse click)
+ java -jar Jmol.jar -Msparshui
-On the HP TouchSmart one first starts the device connection -- JmolMultiTouchDriver.exe.
+There's also
-Then you start the Jmol application using the -Msparshui flag or, for the embedded application, initialize it with the command option -multitouch-sparshui. For the applet, include the JavaScript command:
+ java -jar Jmol.jar -Msparshui-simulated
-Â  JmolSetCallback("multiTouchSparshUI", "true")
+=== Jmol Applet ===
 prior to
-Â  JmolApplet(...)
+With latest version of Jmol.js, you can also add parameters to the URL line, so you can adapt any page to work with multi-touch. For example, if you have {{file|JmolMultiTouchDriver}} running, the following should work:
-Or, with my latest version of Jmol.js, you can add parameters to the URL line, so with that you can adapt any page to work with multi-touch. For example, if you have JmolMultiTouchDriver.exe running on your HP TouchSmart, the following should work:
+=== Jmol embedded in another Java application ===
-http://chemapps.stolaf.edu/jmol/docs/examples-11/molecules/molecules.htm?PARAMS=multiTouchSparshUI:true
+== Gestures ==
-The driver will cycle while waiting for a connection, and the first Jmol application or applet that loads will start a gesture server that connects with it. If additional applets or applications load, then their gesture server will not connect, but they will find the other gesture server.
+Implemented gestures include:
-The problem of multiple overlapping windows was solved easily by only allowing SparshUI action within a window if that window has the focus. So one needs to first click on a model to activate SparshUI action within that window.
+== Terminology ==
-There might be a problem if one applet starts a server and then closes while another is using it. In addition, multiple applets on the same page are no problem, but applets on different pages within the same tabbed browser system probably cause problems. Just closing a page doesn't necessarily work. I've been using File|Close Tab in Firefox.
+click
-== Terminology ==
+slide
 swipe: put finger on surface, drag in a single direction, while continuing
 the drag motion lift finger from surface
-flick: swipe but done must faster
+flick: swipe but done must faster -- Jmol does not differentiate this from swipe