public static final class

MotionEvent.PointerCoords

extends Object
java.lang.Object
   ↳ android.view.MotionEvent.PointerCoords

Class Overview

Transfer object for pointer coordinates. Objects of this type can be used to manufacture new MotionEvent objects and to query pointer coordinate information in bulk. Refer to InputDevice for information about how different kinds of input devices and sources represent pointer coordinates.

Summary

Fields
public float orientation The orientation of the touch area and tool area in radians clockwise from vertical.
public float pressure A scaled value that describes the pressure applied to the pointer.
public float size A scaled value of the approximate size of the pointer touch area.
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 coordinate of the pointer movement.
public float y The Y coordinate of the pointer movement.
Public Constructors
MotionEvent.PointerCoords()
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public float orientation

Since: API Level 9

The orientation of the touch area and tool area in radians clockwise from vertical. An angle of 0 degrees 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).

public float pressure

Since: API Level 9

A scaled value that describes the pressure applied to the pointer. The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), however values higher than 1 may be generated depending on the calibration of the input device.

public float size

Since: API Level 9

A scaled value of the approximate size of the pointer touch area. This 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.

public float toolMajor

Since: API Level 9

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.

public float toolMinor

Since: API Level 9

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.

public float touchMajor

Since: API Level 9

The length of the major axis of an ellipse that describes the touch area at the point of contact.

public float touchMinor

Since: API Level 9

The length of the minor axis of an ellipse that describes the touch area at the point of contact.

public float x

Since: API Level 9

The X coordinate of the pointer movement. The interpretation varies by input source and may represent the position of the center of the contact area, a relative displacement in device-specific units or something else.

public float y

Since: API Level 9

The Y coordinate of the pointer movement. The interpretation varies by input source and may represent the position of the center of the contact area, a relative displacement in device-specific units or something else.

Public Constructors

public MotionEvent.PointerCoords ()

Since: API Level 9