PinchGesture

AI-generated Key Takeaways

• PinchGesture class detects and tracks two-finger pinch gestures on a touchscreen.

• It provides methods to calculate the distance between the fingers (gap) and changes in this distance (gap delta) in both pixels and inches.

• Developers can use the OnGestureEventListener interface to receive callbacks for gesture events like start, finish, and cancel.

• PinchGesture inherits functionality from BaseGesture, allowing for gesture management and interaction with Sceneform nodes.

• This class is essential for implementing interactive features that respond to user pinch gestures within AR applications built with Sceneform.

public class PinchGesture

Gesture for when the user performs a two-finger pinch motion on the touch screen.

Nested Classes

interface

PinchGesture.OnGestureEventListener

Interface definition for callbacks to be invoked by a PinchGesture.

Inherited Fields

From class com.google.ar.sceneform.ux.BaseGesture

protected final GesturePointersUtility	gesturePointersUtility
protected Node	targetNode

Public Constructors

PinchGesture(GesturePointersUtility gesturePointersUtility, MotionEvent motionEvent, int pointerId2)

Public Methods

void	cancel() Cancels the gesture in progress.
float	gapDeltaInches()
float	gapInches()
float	getGap()
float	getGapDelta()

Protected Methods

boolean	canStart(HitTestResult hitTestResult, MotionEvent motionEvent)
PinchGesture	getSelf()
void	onCancel()
void	onFinish()
void	onStart(HitTestResult hitTestResult, MotionEvent motionEvent)
boolean	updateGesture(HitTestResult hitTestResult, MotionEvent motionEvent)

Inherited Methods

From class com.google.ar.sceneform.ux.BaseGesture

abstract boolean	canStart(HitTestResult hitTestResult, MotionEvent motionEvent)
void	cancel()
void	complete()
abstract PinchGesture	getSelf()
Node	getTargetNode()
boolean	hasFinished()
boolean	hasStarted()
float	inchesToPixels(float inches)
boolean	justStarted()
abstract void	onCancel()
abstract void	onFinish()
abstract void	onStart(HitTestResult hitTestResult, MotionEvent motionEvent)
void	onTouch(HitTestResult hitTestResult, MotionEvent motionEvent)
float	pixelsToInches(float pixels)
void	setGestureEventListener(OnGestureEventListener<PinchGesture> listener)
abstract boolean	updateGesture(HitTestResult hitTestResult, MotionEvent motionEvent)
boolean	wasCancelled()

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Constructors

public PinchGesture (GesturePointersUtility gesturePointersUtility, MotionEvent motionEvent, int pointerId2)

Parameters

gesturePointersUtility
motionEvent
pointerId2

Public Methods

public void cancel ()

Cancels the gesture in progress.

public float gapDeltaInches ()

public float gapInches ()

public float getGap ()

public float getGapDelta ()

Protected Methods

protected boolean canStart (HitTestResult hitTestResult, MotionEvent motionEvent)

Parameters

hitTestResult
motionEvent

protected PinchGesture getSelf ()

protected void onCancel ()

protected void onFinish ()

protected void onStart (HitTestResult hitTestResult, MotionEvent motionEvent)

Parameters

hitTestResult
motionEvent

protected boolean updateGesture (HitTestResult hitTestResult, MotionEvent motionEvent)

Parameters

hitTestResult
motionEvent