com.mapbox.android.gestures

Class MoveGestureDetector

java.lang.Object

com.mapbox.android.gestures.BaseGesture<L>

com.mapbox.android.gestures.MultiFingerGesture<L>

com.mapbox.android.gestures.ProgressiveGesture<MoveGestureDetector.OnMoveGestureListener>

com.mapbox.android.gestures.MoveGestureDetector

public class MoveGestureDetector
extends ProgressiveGesture<MoveGestureDetector.OnMoveGestureListener>

Gesture detector handling move gesture.

MoveGestureDetector serves similar purpose to #onScroll(MotionEvent, MotionEvent, float, float), however, it's a ProgressiveGesture that introduces MoveGestureDetector.OnMoveGestureListener.onMoveBegin(MoveGestureDetector), MoveGestureDetector.OnMoveGestureListener.onMoveEnd(MoveGestureDetector, float, float), threshold with setMoveThreshold(float) and multi finger support thanks to MoveDistancesObject.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MoveGestureDetector.OnMoveGestureListener
static class	MoveGestureDetector.SimpleOnMoveGestureListener

Field Summary

Fields inherited from class com.mapbox.android.gestures.BaseGesture

context, listener, windowManager

Constructor Summary

Constructors

Constructor and Description
MoveGestureDetector(android.content.Context context, AndroidGesturesManager gesturesManager)

Method Summary

Modifier and Type	Method and Description
protected boolean	analyzeEvent(android.view.MotionEvent motionEvent)
protected boolean	analyzeMovement()
protected boolean	canExecute(int invokedGestureType)
protected void	gestureStopped()
float	getLastDistanceX() Returns X distance of the focal point in pixels calculated during the last MoveGestureDetector.OnMoveGestureListener.onMove(MoveGestureDetector, float, float) call.
float	getLastDistanceY() Returns Y distance of the focal point in pixels calculated during the last MoveGestureDetector.OnMoveGestureListener.onMove(MoveGestureDetector, float, float) call.
MoveDistancesObject	getMoveObject(int pointerIndex) Returns MoveDistancesObject referencing the pointer held under passed index.
float	getMoveThreshold() Get the delta pixel threshold required to qualify it as a move gesture.
android.graphics.RectF	getMoveThresholdRect() Get the screen area in which the move gesture cannot be started.
protected int	getRequiredPointersCount()
protected java.util.Set<java.lang.Integer>	provideHandledTypes()
protected void	reset()
void	setMoveThreshold(float moveThreshold) Set the delta pixel threshold required to qualify it as a move gesture.
void	setMoveThresholdRect(android.graphics.RectF moveThresholdRect) Set the screen area in which the move gesture cannot be started.
void	setMoveThresholdResource(int moveThresholdDimen) Set the delta dp threshold required to qualify it as a move gesture.

Methods inherited from class com.mapbox.android.gestures.ProgressiveGesture

gestureStarted, interrupt, isInProgress, setEnabled

Methods inherited from class com.mapbox.android.gestures.MultiFingerGesture

getCurrentSpan, getCurrentSpanX, getCurrentSpanY, getFocalPoint, getPointersCount, getPreviousSpan, getPreviousSpanX, getPreviousSpanY, getSpanThreshold, isSloppyGesture, setSpanThreshold, setSpanThresholdResource

Methods inherited from class com.mapbox.android.gestures.BaseGesture

getCurrentEvent, getGestureDuration, getPreviousEvent, isEnabled, onTouchEvent, removeListener, setListener

Methods inherited from class java.lang.Object

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

Constructor Detail

MoveGestureDetector

public MoveGestureDetector(android.content.Context context,
                           AndroidGesturesManager gesturesManager)

Method Detail

provideHandledTypes

protected java.util.Set<java.lang.Integer> provideHandledTypes()

Specified by:

provideHandledTypes in class ProgressiveGesture<MoveGestureDetector.OnMoveGestureListener>

analyzeEvent

protected boolean analyzeEvent(android.view.MotionEvent motionEvent)

Overrides:

analyzeEvent in class ProgressiveGesture<MoveGestureDetector.OnMoveGestureListener>

analyzeMovement

protected boolean analyzeMovement()

Overrides:

analyzeMovement in class MultiFingerGesture<MoveGestureDetector.OnMoveGestureListener>

canExecute

protected boolean canExecute(int invokedGestureType)

Overrides:

canExecute in class MultiFingerGesture<MoveGestureDetector.OnMoveGestureListener>

reset

protected void reset()

Overrides:

reset in class MultiFingerGesture<MoveGestureDetector.OnMoveGestureListener>

gestureStopped

protected void gestureStopped()

Overrides:

gestureStopped in class ProgressiveGesture<MoveGestureDetector.OnMoveGestureListener>

getRequiredPointersCount

protected int getRequiredPointersCount()

Overrides:

getRequiredPointersCount in class MultiFingerGesture<MoveGestureDetector.OnMoveGestureListener>

getMoveThreshold

public float getMoveThreshold()

Get the delta pixel threshold required to qualify it as a move gesture.

Returns:

delta pixel threshold

See Also:

getMoveThresholdRect()

setMoveThreshold

public void setMoveThreshold(float moveThreshold)

Set the delta pixel threshold required to qualify it as a move gesture.

We encourage to set those values from dimens to accommodate for various screen sizes.

Parameters:

moveThreshold - delta threshold

See Also:

setMoveThresholdRect(RectF)

getMoveThresholdRect

public android.graphics.RectF getMoveThresholdRect()

Get the screen area in which the move gesture cannot be started. If the gesture is already in progress, this value is ignored. This condition is evaluated before setMoveThreshold(float).

Returns:

the screen area in which the gesture cannot be started

setMoveThresholdRect

public void setMoveThresholdRect(android.graphics.RectF moveThresholdRect)

Set the screen area in which the move gesture cannot be started. If the gesture is already in progress, this value is ignored. This condition is evaluated before setMoveThreshold(float).

Parameters:

moveThresholdRect - the screen area in which the gesture cannot be started

setMoveThresholdResource

public void setMoveThresholdResource(int moveThresholdDimen)

Set the delta dp threshold required to qualify it as a move gesture.

Parameters:

moveThresholdDimen - delta threshold

getLastDistanceX

public float getLastDistanceX()

Returns X distance of the focal point in pixels calculated during the last MoveGestureDetector.OnMoveGestureListener.onMove(MoveGestureDetector, float, float) call.

Returns:

X distance of the focal point in pixel

getLastDistanceY

public float getLastDistanceY()

Returns Y distance of the focal point in pixels calculated during the last MoveGestureDetector.OnMoveGestureListener.onMove(MoveGestureDetector, float, float) call.

Returns:

Y distance of the focal point in pixel

getMoveObject

public MoveDistancesObject getMoveObject(int pointerIndex)

Returns MoveDistancesObject referencing the pointer held under passed index.

Pointers are sorted by the time they were placed on the screen until lifted up. This means that index 0 will reflect the oldest added, still active pointer and index (MultiFingerGesture.getPointersCount() - 1) will reflect the latest added, still active pointer.

Parameters:

pointerIndex - pointer's index

Returns:

distances object of the referenced pointer