com.almeros.android.multitouch.gesturedetectors

Class BaseGestureDetector

java.lang.Object

com.almeros.android.multitouch.gesturedetectors.BaseGestureDetector

Direct Known Subclasses:

MoveGestureDetector, TwoFingerGestureDetector

public abstract class BaseGestureDetector
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected android.content.Context	context
protected android.view.MotionEvent	currEvent
protected float	currPressure
protected boolean	gestureInProgress
protected static float	PRESSURE_THRESHOLD This value is the threshold ratio between the previous combined pressure and the current combined pressure.
protected android.view.MotionEvent	prevEvent
protected float	prevPressure
protected long	timeDelta

Constructor Summary

Constructors

Constructor and Description
BaseGestureDetector(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
long	getEventTime() Return the event time of the current GestureDetector event being processed.
long	getTimeDelta() Return the time difference in milliseconds between the previous accepted GestureDetector event and the current GestureDetector event.
protected abstract void	handleInProgressEvent(int actionCode, android.view.MotionEvent event) Called when the current event occurred when a gesture IS in progress.
protected abstract void	handleStartProgressEvent(int actionCode, android.view.MotionEvent event) Called when the current event occurred when NO gesture is in progress yet.
boolean	isInProgress() Returns true if a gesture is currently in progress.
boolean	onTouchEvent(android.view.MotionEvent event) All gesture detectors need to be called through this method to be able to detect gestures.
protected void	resetState()
protected void	updateStateByEvent(android.view.MotionEvent curr)

Methods inherited from class java.lang.Object

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

Field Detail

context

protected final android.content.Context context

gestureInProgress

protected boolean gestureInProgress

prevEvent

protected android.view.MotionEvent prevEvent

currEvent

protected android.view.MotionEvent currEvent

currPressure

protected float currPressure

prevPressure

protected float prevPressure

timeDelta

protected long timeDelta

PRESSURE_THRESHOLD

protected static final float PRESSURE_THRESHOLD

This value is the threshold ratio between the previous combined pressure and the current combined pressure. When pressure decreases rapidly between events the position values can often be imprecise, as it usually indicates that the user is in the process of lifting a pointer off of the device. This value was tuned experimentally.

See Also:

Constant Field Values

Constructor Detail

BaseGestureDetector

public BaseGestureDetector(android.content.Context context)

Method Detail

onTouchEvent

public boolean onTouchEvent(android.view.MotionEvent event)

All gesture detectors need to be called through this method to be able to detect gestures. This method delegates work to handler methods (handleStartProgressEvent, handleInProgressEvent) implemented in extending classes.

Parameters:

event - MotionEvent

Returns:

true as handled

handleStartProgressEvent

protected abstract void handleStartProgressEvent(int actionCode,
                                                 android.view.MotionEvent event)

Called when the current event occurred when NO gesture is in progress yet. The handling in this implementation may set the gesture in progress (via gestureInProgress) or out of progress

Parameters:

actionCode - Action Code from MotionEvent

event - MotionEvent

handleInProgressEvent

protected abstract void handleInProgressEvent(int actionCode,
                                              android.view.MotionEvent event)

Called when the current event occurred when a gesture IS in progress. The handling in this implementation may set the gesture out of progress (via gestureInProgress).

Parameters:

actionCode - Action Code from MotionEvent

event - MotionEvent

updateStateByEvent

protected void updateStateByEvent(android.view.MotionEvent curr)

resetState

protected void resetState()

isInProgress

public boolean isInProgress()

Returns true if a gesture is currently in progress.

Returns:

true if a gesture is currently in progress, false otherwise.

getTimeDelta

public long getTimeDelta()

Return the time difference in milliseconds between the previous accepted GestureDetector event and the current GestureDetector event.

Returns:

Time difference since the last move event in milliseconds.

getEventTime

public long getEventTime()

Return the event time of the current GestureDetector event being processed.

Returns:

Current GestureDetector event time in milliseconds.