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