com.luciad.input.touch

LuciadFusionClass TLcdTouchDevice

java.lang.Object

com.luciad.input.touch.TLcdTouchDevice

public class TLcdTouchDevice
extends Object

This singleton represents the built-in multi-touch support of LuciadLightspeed. Touch events are supported for Swing applications in Windows 7 and higher.

JavaFX applications have native touch support and should not use this class.

Call getInstance() to load the native driver and use getTouchDeviceStatus() to find out at runtime if touch events are supported.

This class contains some important touch related properties. For each of these properties a getter and setter is available. PropertyChangeListeners can be attached and removed.

The following system properties can be used to tweak the behavior of the native driver:

• -Dcom.luciad.input.touch.windows.loadNativeDriver=false : never load the native driver.
  This can be useful if you create your own touch events. The default is true.
• -Dcom.luciad.input.touch.windows.requireMultiTouch=true : do not load the native driver if the touch device does not support multi-touch.
  The default is false.

Since:

10.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TLcdTouchDevice.Status

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener aListener) Add a PropertyChangeListener to the listener list.
int	getDoubleTapDistanceThreshold() Returns the maximum allowed distance in either the X or Y direction between two successive TOUCH_DOWNs to be considered as a double-tap.
int	getDoubleTapTimeOut() Returns the maximum allowed time between two successive TOUCH_DOWNs to be considered as a double-tap.
static TLcdTouchDevice	getInstance() Initializes the touch support and returns the singleton instance of this class.
String	getTouchDeviceNotReadyMessage() Returns a human readable explanation of why the touch device is not ready.
TLcdTouchDevice.Status	getTouchDeviceStatus() Returns the status of the physical touch device.
void	removePropertyChangeListener(PropertyChangeListener aListener) Remove a PropertyChangeListener from the listener list.
void	setDoubleTapDistanceThreshold(int aDoubleTapDistanceThreshold) When the touch device is touched multiple times rapidly after each other at the same location, the tap count of the corresponding TLcdTouchPoint will increase (similar to double-click with a mouse).
void	setDoubleTapTimeOut(int aDoubleTapTimeOut) When the touch device is touched multiple times rapidly after each other at the same location, the tap count of the corresponding TLcdTouchPoint will increase (similar to double-click with a mouse).

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static TLcdTouchDevice getInstance()

Initializes the touch support and returns the singleton instance of this class.

Returns:

the singleton instance of this class.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener aListener)

Add a PropertyChangeListener to the listener list. The listener is registered for all properties. The same listener object may be added more than once, and will be called as many times as it is added. If aListener is null, no exception is thrown and no action is taken.

Parameters:

aListener - The PropertyChangeListener to be added

See Also:

removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener aListener)

Remove a PropertyChangeListener from the listener list. This removes a PropertyChangeListener that was registered for all properties. If aListener was added more than once to the same event source, it will be notified one less time after being removed. If aListener is null, or was never added, no exception is thrown and no action is taken.

Parameters:

aListener - The PropertyChangeListener to be removed

See Also:

addPropertyChangeListener(java.beans.PropertyChangeListener)

getDoubleTapDistanceThreshold

public int getDoubleTapDistanceThreshold()

Returns the maximum allowed distance in either the X or Y direction between two successive TOUCH_DOWNs to be considered as a double-tap.

Returns:

the maximum allowed distance in either the X or Y direction between two successive TOUCH_DOWNs to be considered as a double-tap, expressed in pixels.

See Also:

setDoubleTapDistanceThreshold(int), getDoubleTapTimeOut()

setDoubleTapDistanceThreshold

public void setDoubleTapDistanceThreshold(int aDoubleTapDistanceThreshold)

When the touch device is touched multiple times rapidly after each other at the same location, the tap count of the corresponding TLcdTouchPoint will increase (similar to double-click with a mouse). This setter allows to specify the maximum difference in either the X or Y direction between two successive TOUCH_DOWNs. If the difference in location between those two TOUCH_DOWNs in either the X or Y direction is greater than aDoubleTapThreshold, the tap count of the corresponding TLcdTouchPoint will not be increased.

Parameters:

aDoubleTapDistanceThreshold - the threshold, expressed in pixels

See Also:

getDoubleTapDistanceThreshold(), getDoubleTapTimeOut()

getDoubleTapTimeOut

public int getDoubleTapTimeOut()

Returns the maximum allowed time between two successive TOUCH_DOWNs to be considered as a double-tap.

Returns:

the maximum allowed time between two successive TOUCH_DOWNs to be considered as a double-tap, expressed in milliseconds.

See Also:

setDoubleTapTimeOut(int), getDoubleTapDistanceThreshold()

setDoubleTapTimeOut

public void setDoubleTapTimeOut(int aDoubleTapTimeOut)

When the touch device is touched multiple times rapidly after each other at the same location, the tap count of the corresponding TLcdTouchPoint will increase (similar to double-click with a mouse). This setter allows to specify the maximum allowed delay between two successive TOUCH_DOWNs. If the delay between two TOUCH_DOWNs is higher then aDoubleTapDelay, the tap count of the corresponding TLcdTouchPoint will not be increased.

Note that his delay is also used when determining whether the tap count should be increased from 2 to 3, from 3 to 4, ... .

Parameters:

aDoubleTapTimeOut - the delay, expressed in milliseconds

See Also:

getDoubleTapTimeOut(), getDoubleTapDistanceThreshold()

getTouchDeviceStatus

public TLcdTouchDevice.Status getTouchDeviceStatus()

Returns the status of the physical touch device. See for a human readable error message

Returns:

the status of the physical touch device

getTouchDeviceNotReadyMessage

public String getTouchDeviceNotReadyMessage()

Returns a human readable explanation of why the touch device is not ready.

Returns:

an error message if the touch device is not ready, or null if the touch device is ready

Since:

2017.0