Package com.luciad.input.touch

Class TouchPinchRotateEvent

java.lang.Object

com.luciad.input.touch.TouchPinchRotateEvent

All Implemented Interfaces:

IInputEvent, AutoCloseable

public final class TouchPinchRotateEvent
extends Object
implements IInputEvent, AutoCloseable

Implementation of IInputEvent representing a 2 pointers gesture.

This class aggregates information related to pinch and rotation in the same event.

Method Summary

Modifier and Type	Method	Description
void	close()
static TouchPinchRotateEvent	createEvent(Coordinate initialCenterLocation, double initialDistance, Angle initialAngle, Coordinate currentCenterLocation, double currentDistance, Angle currentAngle, Coordinate previousCenterLocation, double previousDistance, Angle previousAngle, EventStatus status)	Creates a two pointer event.
static TouchPinchRotateEvent	createStartEvent(Coordinate initialCenterLocation, double initialDistance, Angle initialAngle, Coordinate currentCenterLocation, double currentDistance, Angle currentAngle)	Creates the first TouchPinchRotateEvent of a gesture.
protected void	finalize()
Angle	getCurrentAngle()	Returns the absolute angle between the two touch points.
Coordinate	getCurrentCenterLocation()	Returns the location of the current center between the 2 touch points.
double	getCurrentDistance()	Returns the current distance between touch points.
Angle	getInitialAngle()	Returns the absolute angle between the two touch points at the beginning of the gesture.
Coordinate	getInitialCenterLocation()	Returns the location of the center between the 2 starting touch point locations.
double	getInitialDistance()	Returns the span between the initial touch point positions.
Angle	getPreviousAngle()	Returns the absolute angle between the two touch points from the previous event of this gesture.
Coordinate	getPreviousCenterLocation()	Returns the location of the center between the 2 touch points from the previous event of this gesture.
Double	getPreviousDistance()	Returns the distance between touch points from the previous event of this gesture.
EventStatus	getStatus()	Returns the status of the event.

Methods inherited from class java.lang.Object

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

Method Details

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

createStartEvent

@NotNull
public static TouchPinchRotateEvent createStartEvent(@NotNull
 Coordinate initialCenterLocation,
 double initialDistance,
 @NotNull
 Angle initialAngle,
 @NotNull
 Coordinate currentCenterLocation,
 double currentDistance,
 @NotNull
 Angle currentAngle)

Creates the first TouchPinchRotateEvent of a gesture.

The initial values refer to the situation at the beginning of the gesture (i.e. before any gesture detection). The current ones contain the values after the gesture detection is done.

Parameters:

initialCenterLocation - The center location at the beginning of the gesture, defined in device independent pixels.

initialDistance - The distance between the pointers at the beginning of the gesture, defined in device independent pixels.

initialAngle - The absolute angle between the two pointers at the beginning of the gesture.

currentCenterLocation - The current center location, defined in device independent pixels.

currentDistance - The current distance between the pointers, defined in device independent pixels.

currentAngle - The absolute angle between the two pointers. The status of the created event is EventStatus#Start. The information relative to the previous event are std::nullopt.

createEvent

@NotNull
public static TouchPinchRotateEvent createEvent(@NotNull
 Coordinate initialCenterLocation,
 double initialDistance,
 @NotNull
 Angle initialAngle,
 @NotNull
 Coordinate currentCenterLocation,
 double currentDistance,
 @NotNull
 Angle currentAngle,
 @NotNull
 Coordinate previousCenterLocation,
 double previousDistance,
 @NotNull
 Angle previousAngle,
 @NotNull
 EventStatus status)

Creates a two pointer event.

The initial values refer to the situation at the beginning of the gesture (i.e. before any gesture detection).

Parameters:

initialCenterLocation - The center location at the beginning of the gesture, defined in device independent pixels.

initialDistance - The distance between the pointers at the beginning of the gesture, defined in device independent pixels.

initialAngle - The absolute angle between the two pointers at the beginning of the gesture.

currentCenterLocation - The current center location, defined in device independent pixels.

currentDistance - The current distance between the pointers, defined in device independent pixels.

currentAngle - The absolute angle between the two pointers.

previousCenterLocation - The center location from the previous event of the gesture, defined in device independent pixels.

previousDistance - The distance between the pointers from the previous event of the gesture, defined in device independent pixels.

previousAngle - The absolute angle between the two pointers from the previous event of the gesture.

status - The status of the gesture.

getInitialCenterLocation

@NotNull
public Coordinate getInitialCenterLocation()

Returns the location of the center between the 2 starting touch point locations.

It is expressed in device independent pixels.

Returns:

the location of the center between the 2 starting touch point locations.

getInitialDistance

public double getInitialDistance()

Returns the span between the initial touch point positions.

It is expressed in device independent pixels.

Returns:

the span between the initial touch point positions.

getInitialAngle

@NotNull
public Angle getInitialAngle()

Returns the absolute angle between the two touch points at the beginning of the gesture.

It is defined as the angle between the horizontal of the screen and the line connecting the two pointers. It is measured in degrees and counter-clockwise positive. An angle of 0 refers to the position where the first point is located to the left (west, left on the screen) of the other point.

Returns:

the absolute angle between the two touch points at the beginning of the gesture.

getCurrentCenterLocation

@NotNull
public Coordinate getCurrentCenterLocation()

Returns the location of the current center between the 2 touch points.

This location is defined in device independent pixels.

Returns:

the location of the current center between the 2 touch points.

getCurrentDistance

public double getCurrentDistance()

Returns the current distance between touch points.

This distance is defined in device independent pixels.

Returns:

the current distance between touch points.

getCurrentAngle

@NotNull
public Angle getCurrentAngle()

Returns the absolute angle between the two touch points.

It is measured in degrees and counter-clockwise positive.

Returns:

the absolute angle between the two touch points.

getPreviousCenterLocation

@Nullable
public Coordinate getPreviousCenterLocation()

Returns the location of the center between the 2 touch points from the previous event of this gesture.

This location is defined in device independent pixels.

Returns null if this is the first event of the gesture (i.e. when the status is EventStatus#Start).

Returns:

the location of the center between the 2 touch points from the previous event of this gesture.

getPreviousDistance

@Nullable
public Double getPreviousDistance()

Returns the distance between touch points from the previous event of this gesture.

This distance is defined in device independent pixels.

Returns null if this is the first event of the gesture (i.e. when the status is EventStatus#Start).

Returns:

the distance between touch points from the previous event of this gesture.

getPreviousAngle

@Nullable
public Angle getPreviousAngle()

Returns the absolute angle between the two touch points from the previous event of this gesture.

It is measured in degrees and counter-clockwise positive.

Returns null if this is the first event of the gesture (i.e. when the status is EventStatus#Start).

Returns:

the absolute angle between the two touch points from the previous event of this gesture.

getStatus

@NotNull
public EventStatus getStatus()

Returns the status of the event.

Returns:

the status of the event.