PointerCoords

PointerCoords

PointerCoords()

Creates a pointer coords object with all axes initialized to zero.

PointerCoords

PointerCoords(other: MotionEvent.PointerCoords!)

Creates a pointer coords object as a copy of the contents of another pointer coords object.

clear

fun clear(): Unit

Clears the contents of this object. Resets all axes to zero.

copyFrom

fun copyFrom(other: MotionEvent.PointerCoords!): Unit

Copies the contents of another pointer coords object.

getAxisValue

fun getAxisValue(axis: Int): Float

Gets the value associated with the specified axis.

isResampled

fun isResampled(): Boolean

Returns true if these pointer coordinates were generated by resampling, rather than from an actual input event from the device at this time.

Resampling extrapolates or interpolates touch coordinates reported by the input device to better align them with the refresh rate of the display, resulting in smoother movements, in particular for scrolling. Resampled coordinates are always added to batches, so a motion event will always contain at least one sample that is an original event from the input device (i.e. for which this method will return false).

Resampling does not occur if unbuffered dispatch has been requested, or if it has been disabled by the manufacturer (for example, on hardware that already synchronizes its touch events and display frames).

setAxisValue

fun setAxisValue(
    axis: Int, 
    value: Float
): Unit

Sets the value associated with the specified axis.

orientation

var orientation: Float

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

pressure

var pressure: Float

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.

size

var size: Float

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.

toolMajor

var toolMajor: Float

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.

toolMinor

var toolMinor: Float

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.

touchMajor

var touchMajor: Float

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.

touchMinor

var touchMinor: Float

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.

x

var x: Float

The X component of the pointer movement.

y

var y: Float

The Y component of the pointer movement.