com.tacttiles.api

Class Glove

java.lang.Object

com.tacttiles.api.Glove

public class Glove
extends java.lang.Object

A Glove is a hardware abstraction that handles the low level communication protocol used in devices compatibles with the HELENA Glove platform.

In this class gestures are simplified to letters, which may be composed of a single/double tap (input) or vibration (output).

High level user-interaction events can be handled by a custom implementation and register of the inner static class Glove.GloveListener.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Glove.GloveListener A glove listener receives notifications of new data available in the Glove object.

Constructor Summary

Constructors

Constructor and Description
Glove() Constructs a glove adapter.

Method Summary

Modifier and Type	Method and Description
void	addListener(Glove.GloveListener gloveListener) Adds a listener to the current set of event listeners of this adapter.
protected java.lang.String	buildLetterGestureMessage(char letter) Constructs a gesture for the passed letter.
void	connect(Context appContext) Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access.
java.lang.Thread	draw(java.lang.String text) Draws a text as a series of vibration gestures.
Device	getDevice() Returns the core device of this class.
char	getLetter(int symbol) Converts a received symbol into a letter.
int	getTileId(char letter) Returns the index of the tile that is used as input for the passed letter.
void	removeListener(Glove.GloveListener gloveListener) Removes a listener from the set listening to this adapter.
void	setGloveIOMap(int[] map) The glove I/O map is a array containing the tile indexes for each of the 26 letters of the alphabet.
void	setSpaceChar(char spaceChar) Set the space character as the inverse gesture of the passed letter.
void	setup(int delayL, int delayW, int singleH, int doubleH, int doubleL) Set the default values used while drawing the letter gestures.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Glove

public Glove()

Constructs a glove adapter.

Method Detail

getDevice

public Device getDevice()

Returns the core device of this class. It can be used to access lower level control over the physical device that this adapter class is connected to.

Returns:

The core device

addListener

public void addListener(Glove.GloveListener gloveListener)

Adds a listener to the current set of event listeners of this adapter. Events can be button presses or I/O letter gestures.

Parameters:

gloveListener - The listener to be added to the current set of listeners on this adapter.

removeListener

public void removeListener(Glove.GloveListener gloveListener)

Removes a listener from the set listening to this adapter.

Parameters:

gloveListener - The listener to be removed to the current set of listeners on this adapter.

setup

public void setup(int delayL,
                  int delayW,
                  int singleH,
                  int doubleH,
                  int doubleL)

Set the default values used while drawing the letter gestures.

Parameters:

delayL - Delay in ms between letters, default = 250 ms.

delayW - Delay in ms between words, default = 250 ms.

singleH - Single vibration duration in ms, default = 150 ms.

doubleH - Vibration duration in ms for double tap letters, default = 150 ms.

doubleL - Delay between vibrations in double tap letters, default = 100 ms.

connect

public void connect(Context appContext)

Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access.

Parameters:

appContext - The current context of this application.

setGloveIOMap

public void setGloveIOMap(int[] map)

The glove I/O map is a array containing the tile indexes for each of the 26 letters of the alphabet. The sign of the numbers in the array represents the type of gesture, single tap gestures are positive and double tap gestures are negative integers.

Parameters:

map - An array containing the tile indexes for each letter of the alphabet.

setSpaceChar

public void setSpaceChar(char spaceChar)

Set the space character as the inverse gesture of the passed letter. If the input letter gesture is a single tap, the space char input becomes the double tap of the said tile, and vice versa.

Parameters:

spaceChar - The new space character, default is 'w'.

getLetter

public char getLetter(int symbol)

Converts a received symbol into a letter. The symbol follows the map logic, in which a positive integer codes a single tap gesture and a negative, a double tap one.

Parameters:

symbol - Symbol coded as a positive or negative tile index.

Returns:

The letter as set by the I/O map.

getTileId

public int getTileId(char letter)

Returns the index of the tile that is used as input for the passed letter.

Parameters:

letter - A character in the range of [a - z] or space ' '.

Returns:

The index of the I/O tile.

buildLetterGestureMessage

protected java.lang.String buildLetterGestureMessage(char letter)

Constructs a gesture for the passed letter. The gesture is coded as a string compatible with Device.send(String).

Parameters:

letter - a char in the range [97,122] or space ' '.

Returns:

array of bytes containing the raw commands for drawing the letter.

draw

public java.lang.Thread draw(java.lang.String text)

Draws a text as a series of vibration gestures. Each letter can be converted into a single or double tap output gesture, which is sent trough a series of adapters and results in the calling of Glove.GloveListener.onLetterDraw(int, char[]), if everything goes as planed.

Parameters:

text - the text to be drawn.

Returns:

a non started Thread object that performs the drawing.