com.simsilica.lemur.event

Class TouchAppState

java.lang.Object

com.jme3.app.state.BaseAppState

com.simsilica.lemur.event.BasePickState

com.simsilica.lemur.event.TouchAppState

All Implemented Interfaces:

com.jme3.app.state.AppState, PickState

public class TouchAppState
extends BasePickState

Similar to MouseAppState, this state adapts touch and multitouch events to mouse and cursor events. In the case of multitouch, each separate touch ID gets its own PickEventSession. For more details on how a PickEventSession is handled, see MouseAppState or PickEventSession.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	TouchAppState.PointerData Storage class for the session and last location of the touch events for a single pointer (finger for touch).
protected class	TouchAppState.TouchObserver TouchObserver provides the touch event data (pointer, x, and y) to the Lemur pick session for processing.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.Integer,TouchAppState.PointerData>	pointerDataMap

Fields inherited from interface com.simsilica.lemur.event.PickState

PICK_LAYER_GUI, PICK_LAYER_SCENE

Constructor Summary

Constructors

Constructor and Description
TouchAppState(com.jme3.app.Application app)

Method Summary

Modifier and Type	Method and Description
protected void	cleanup(com.jme3.app.Application app)
protected boolean	dispatchButton(TouchAppState.PointerData pointerData, boolean pressed) Dispatches a button action to the appropriate PickEventSession for the touch pointer provided.
protected void	dispatchMotion() Dispatches the last touch locations to the active PickEventSessions.
protected TouchAppState.PointerData	getPointerData(int pointerId, int x, int y) Returns (or creates) the PointerData object with the appropriate PickEventSession and X/Y coordinates for the provided pointerId.

Methods inherited from class com.simsilica.lemur.event.BasePickState

addCollisionRoot, addCollisionRoot, addCollisionRoot, addCollisionRoot, findViewPort, getIncludeDefaultCollisionRoots, getPickLayerOrder, getSession, hasRequestedEnabled, initialize, onDisable, onEnable, releaseEnabled, removeCollisionRoot, removeCollisionRoot, requestEnabled, resetEnabled, setIncludeDefaultCollisionRoots, setPickLayerOrder, update

Methods inherited from class com.jme3.app.state.BaseAppState

cleanup, getApplication, getState, getStateManager, initialize, isEnabled, isInitialized, postRender, render, setEnabled, stateAttached, stateDetached

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jme3.app.state.AppState

cleanup, initialize, isEnabled, isInitialized, postRender, render, setEnabled, stateAttached, stateDetached

Field Detail

pointerDataMap

protected java.util.Map<java.lang.Integer,TouchAppState.PointerData> pointerDataMap

Constructor Detail

TouchAppState

public TouchAppState(com.jme3.app.Application app)

Method Detail

cleanup

protected void cleanup(com.jme3.app.Application app)

Overrides:

cleanup in class BasePickState

dispatchMotion

protected void dispatchMotion()

Dispatches the last touch locations to the active PickEventSessions.
When touch motion events occur, the touch location is stored and then dispatched at the frequency defined to avoid sending more motions than necessary. An early out is provided if no PickEventSessions are active (ie. no touch pointers are active).

Specified by:

dispatchMotion in class BasePickState

dispatchButton

protected boolean dispatchButton(TouchAppState.PointerData pointerData,
                                 boolean pressed)

Dispatches a button action to the appropriate PickEventSession for the touch pointer provided.

Parameters:

pointerData - PointerData object for the appropriate touch pointer

pressed - True when pressed, False when released

Returns:

True if the PickEventSession consumed the event, False otherwise.

getPointerData

protected TouchAppState.PointerData getPointerData(int pointerId,
                                                   int x,
                                                   int y)

Returns (or creates) the PointerData object with the appropriate PickEventSession and X/Y coordinates for the provided pointerId.
The provided X and Y locations are stored in the PointerData object for created PointerData objects and updated if the PointerData object already exists.

Parameters:

pointerId - Touch pointer id

x - X component of the touch location in pixels

y - Y component of the touch location in pixels

Returns:

Associated PointerData object which contains the appropriate PickEventSession and X/Y coordinates of the last touch event