public
static
final
class
MotionEvent.PointerCoords
extends Object
| java.lang.Object | |
| ↳ | android.view.MotionEvent.PointerCoords |
Transfer object for pointer coordinates.
Objects of this type can be used to specify the pointer coordinates when
creating new MotionEvent objects and to query pointer coordinates
in bulk.
Refer to InputDevice for information about how different kinds of
input devices and sources represent pointer coordinates.
Fields | |
|---|---|
public
float |
orientation
The orientation of the touch area and tool area in radians clockwise from vertical. |
public
float |
pressure
A normalized value that describes the pressure applied to the device by a finger or other tool. |
public
float |
size
A normalized value that describes the approximate size of the pointer touch area in relation to the maximum detectable size of the device. |
public
float |
toolMajor
The length of the major axis of an ellipse that describes the size of the approaching tool. |
public
float |
toolMinor
The length of the minor axis of an ellipse that describes the size of the approaching tool. |
public
float |
touchMajor
The length of the major axis of an ellipse that describes the touch area at the point of contact. |
public
float |
touchMinor
The length of the minor axis of an ellipse that describes the touch area at the point of contact. |
public
float |
x
The X component of the pointer movement. |
public
float |
y
The Y component of the pointer movement. |
Public constructors | |
|---|---|
MotionEvent.PointerCoords()
Creates a pointer coords object with all axes initialized to zero. |
|
MotionEvent.PointerCoords(MotionEvent.PointerCoords other)
Creates a pointer coords object as a copy of the contents of another pointer coords object. |
|
Public methods | |
|---|---|
void
|
clear()
Clears the contents of this object. |
void
|
copyFrom(MotionEvent.PointerCoords other)
Copies the contents of another pointer coords object. |
float
|
getAxisValue(int axis)
Gets the value associated with the specified axis. |
void
|
setAxisValue(int axis, float value)
Sets the value associated with the specified axis. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
float orientation
The orientation of the touch area and tool area in radians clockwise from vertical. An angle of 0 radians indicates that the major axis of contact is oriented upwards, is perfectly circular or is of unknown orientation. A positive angle indicates that the major axis of contact is oriented to the right. A negative angle indicates that the major axis of contact is oriented to the left. The full range is from -PI/2 radians (finger pointing fully left) to PI/2 radians (finger pointing fully right).
See also:
float pressure
A normalized value that describes the pressure applied to the device by a finger or other tool. The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), although values higher than 1 may be generated depending on the calibration of the input device.
See also:
float size
A normalized value that describes the approximate size of the pointer touch area in relation to the maximum detectable size of the device. It represents some approximation of the area of the screen being pressed; the actual value in pixels corresponding to the touch is normalized with the device specific range of values and scaled to a value between 0 and 1. The value of size can be used to determine fat touch events.
See also:
float toolMajor
The length of the major axis of an ellipse that describes the size of the approaching tool. The tool area represents the estimated size of the finger or pen that is touching the device independent of its actual touch area at the point of contact. If the device is a touch screen, the length is reported in pixels, otherwise it is reported in device-specific units.
See also:
float toolMinor
The length of the minor axis of an ellipse that describes the size of the approaching tool. The tool area represents the estimated size of the finger or pen that is touching the device independent of its actual touch area at the point of contact. If the device is a touch screen, the length is reported in pixels, otherwise it is reported in device-specific units.
See also:
float touchMajor
The length of the major axis of an ellipse that describes the touch area at the point of contact. If the device is a touch screen, the length is reported in pixels, otherwise it is reported in device-specific units.
See also:
float touchMinor
The length of the minor axis of an ellipse that describes the touch area at the point of contact. If the device is a touch screen, the length is reported in pixels, otherwise it is reported in device-specific units.
See also:
MotionEvent.PointerCoords ()
Creates a pointer coords object with all axes initialized to zero.
MotionEvent.PointerCoords (MotionEvent.PointerCoords other)
Creates a pointer coords object as a copy of the contents of another pointer coords object.
| Parameters | |
|---|---|
other |
MotionEvent.PointerCoords:
The pointer coords object to copy.
|
void clear ()
Clears the contents of this object. Resets all axes to zero.
void copyFrom (MotionEvent.PointerCoords other)
Copies the contents of another pointer coords object.
| Parameters | |
|---|---|
other |
MotionEvent.PointerCoords:
The pointer coords object to copy.
|
float getAxisValue (int axis)
Gets the value associated with the specified axis.
| Parameters | |
|---|---|
axis |
int:
The axis identifier for the axis value to retrieve. |
| Returns | |
|---|---|
float |
The value associated with the axis, or 0 if none. |
Developers
void setAxisValue (int axis,
float value)
Sets the value associated with the specified axis.
| Parameters | |
|---|---|
axis |
int:
The axis identifier for the axis value to assign. |
value |
float:
The value to set. |