This function will fetch touch (and button) event data from the Pinnacle ASIC. This function only applies to PINNACLE_RELATIVE mode, otherwise if setDataMode() is given PINNACLE_ANYMEAS or PINNACLE_ABSOLUTE, then this function does nothing.

Parameters:¶

out

RelativeReport *report¶

A reference pointer (declared variable of datatype RelativeReport) for storing the data that describes the touch (and button) event.

bool readButtons = true¶

A flag that can be used to skip reading the button data from the Pinnacle. The default (true) will read the button data and store it in the report object’s buttons attribute. This parameter is useful to speed up read operations when not using the Pinnacle’s button input pins.

Warning

If relative mode’s tap detection is enabled, then setting this parameter to false can yield deceptively inaccurate data when reporting tap gestures.