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 and 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()
Coordinate	getCurrentCenterLocation()
double	getCurrentDistance()
Angle	getInitialAngle()
Coordinate	getInitialCenterLocation()
double	getInitialDistance()
Angle	getPreviousAngle()
Coordinate	getPreviousCenterLocation()
Double	getPreviousDistance()
EventStatus	getStatus()

Methods inherited from class java.lang.Object

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

Method Detail

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 in device independent pixels.

getInitialDistance

public double getInitialDistance()

Returns:

the span between the initial touch point positions in device independent pixels.

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.

getCurrentCenterLocation

@NotNull
public Coordinate getCurrentCenterLocation()

Returns:

the location of the current center between the 2 touch points in device independent pixels.

getCurrentDistance

public double getCurrentDistance()

Returns:

the current span between touch points in device independent pixels.

getCurrentAngle

@NotNull
public Angle getCurrentAngle()

Returns:

the absolute angle between the two touch points. It is measured in degrees and counter-clockwise positive.

getPreviousCenterLocation

@Nullable
public Coordinate getPreviousCenterLocation()

Returns:

the location of the center between the 2 touch points in device independent pixels from the previous event of this gesture. returns null if this is the first event of the gesture (i.e. when the status is EventStatus#Start).

getPreviousDistance

@Nullable
public Double getPreviousDistance()

Returns:

the span between touch points in device independent pixels from the previous event of this gesture returns null if this is the first event of the gesture (i.e. when the status is EventStatus#Start).

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).

getStatus

@NotNull
public EventStatus getStatus()

Returns:

the status of the event.