gre.mtevent


Prev		Next

`gre.mtevent`

A touchscreen contact has changed and there is information for more than one touch contact. A gre.mtevent will only be delivered to the application and screen. Storyboard Engine will divide the event into discrete gre.mtpress, gre.mtmotion and gre.mtrelease events which are then delivered to the appropriate model elements.

Data

uint32_t         timestamp
int16_t          npoints
int16_t[npoints] x
int16_t[npoints] y
int16_t[npoints] z
int16_t[npoints] id
int16_t[npoints] state
int16_t[npoints] spare

Where:

timestamp

This is an event timestamp in milliseconds since application start

npoints

This is the number of points included in this event and may not correlate to the number of fingers currently in contact with the touchscreen.

x

This is an array of x values for npoints touch contacts

y

This is an array of y values for npoints touch contacts

z

This is an array of z values for npoints touch contacts. This parameter is dependent on the availability of z-co-ordinate information

id

This is an array of id values for npoints touch contacts. This parameter is used to track multi-touch presses as they come in

state

This is an array of state values for npoints touch contacts.

GR_PTR_STATE_PRESS - 0x01: as a finger makes contact with the touchscreen.

GR_PTR_STATE_MOTION - 0x02: as a finger moves on the touchscreen.

GR_PTR_STATE_RELEASE - 0x03: as a finger is lifted from the touchscreen.

spare

This is padding and should be 0