Lines Matching +full:on +full:- +full:axis
4 Multi-touch (MT) Protocol
7 :Copyright: |copy| 2009-2010 Henrik Rydberg <rydberg@euromail.se>
11 ------------
13 In order to utilize the full power of the new multi-touch and multi-user
16 document describes the multi-touch (MT) protocol which allows kernel
19 The protocol is divided into two types, depending on the capabilities of the
30 --------------
34 packet. Since these events are ignored by current single-touch (ST)
35 applications, the MT protocol can be implemented on top of the ST protocol
48 All drivers mark the end of a multi-touch transfer by calling the usual
60 enumeration of the full set of anonymous contacts currently on the
67 the ABS_MT_TRACKING_ID of the associated slot. A non-negative tracking id
68 is interpreted as a contact, and the value -1 denotes an unused slot. A
88 total number of type B slots reported in the absinfo for the ABS_MT_SLOT axis.
90 The minimum value of the ABS_MT_SLOT axis must be 0.
93 ------------------
95 Here is what a minimal event sequence for a two-contact touch would look
125 zero-contact event reaching userland.
129 ------------------
131 Here is what a minimal event sequence for a two-contact touch would look
152 ABS_MT_TRACKING_ID -1
162 ABS_MT_TRACKING_ID -1
167 -----------
186 than unity, is related to the contact pressure. For pressure-based devices,
187 ABS_MT_PRESSURE may be used to provide the pressure on the contact area
215 and MINOR are the major and minor axis of an ellipse. The orientation of
217 direction of the finger ellipse is given by the vector (a - b).
232 ---------------
235 The length of the major axis of the contact. The length should be given in
240 The length, in surface units, of the minor axis of the contact. If the
244 The length, in surface units, of the major axis of the approaching
250 The length, in surface units, of the minor axis of the approaching
259 The pressure, in arbitrary units, on the contact area. May be used instead
260 of TOUCH and WIDTH for pressure-based devices or any device with a spatial
264 If the resolution is non-zero, the pressure data is in units/gram. See
265 :ref:`input-event-codes` for details.
276 the Y axis (north) of the surface, a negative value when the ellipse is
278 right. When aligned with the X axis in the positive direction, the range
279 max should be returned; when aligned with the X axis in the negative
280 direction, the range -max should be returned.
284 indicate more than a quarter of a revolution. For an upside-down finger,
311 tool axis points towards the touch point [#f1]_. Otherwise, the tool axes are
327 the contact. This is a low-level anonymous grouping for type A devices, and
328 should not be confused with the high-level trackingID [#f5]_. Most type A
340 -----------------
356 the device can distinguish between a finger along the Y axis (0) and a
357 finger along the X axis (1).
378 ellipse should align with the vector (T - C), so the diameter must
383 ---------------
386 initiated contact on the surface, is a Euclidean Bipartite Matching
393 --------
403 -----
406 in a finger packet must not be recognized as single-touch events.
411 .. [#f1] Also, the difference (TOOL_X - POSITION_X) can be used to model tilt.
414 .. [#f4] See the section on event computation.
415 .. [#f5] See the section on finger tracking.