Lines Matching full:tool
162 <h2 id="tools-and-tool-types">Tools and Tool Types</h2>
163 <p>A <em>tool</em> is a finger, stylus or other apparatus that is used to interact with
166 <p>Elsewhere in Android, as in the <code>MotionEvent</code> API, a <em>tool</em> is often referred
168 <p>The following tool types are supported:</p>
201 above it. Not all touch devices are able to sense the presence of a tool
203 can often detect when the tool is within a limited range of the digitizer.</p>
221 assume that <code>BTN_TOUCH</code> will always be used to indicate whether the tool is
228 <p><code>ABS_X</code>: <em>(REQUIRED)</em> Reports the X coordinate of the tool.</p>
231 <p><code>ABS_Y</code>: <em>(REQUIRED)</em> Reports the Y coordinate of the tool.</p>
235 of the tool or the signal strength of the touch contact.</p>
239 touch contact or of the tool itself.</p>
242 <p><code>ABS_DISTANCE</code>: <em>(optional)</em> Reports the distance of the tool from the surface of
246 <p><code>ABS_TILT_X</code>: <em>(optional)</em> Reports the tilt of the tool from the surface of the
250 <p><code>ABS_TILT_Y</code>: <em>(optional)</em> Reports the tilt of the tool from the surface of the
254 <p><code>BTN_TOUCH</code>: <em>(REQUIRED)</em> Indicates whether the tool is touching the device.</p>
265 <em>(optional)</em> Reports the <a href="#tools-and-tool-types">tool type</a>.</p>
273 <p><code>ABS_MT_POSITION_X</code>: <em>(REQUIRED)</em> Reports the X coordinate of the tool.</p>
276 <p><code>ABS_MT_POSITION_Y</code>: <em>(REQUIRED)</em> Reports the Y coordinate of the tool.</p>
280 tip of the tool or the signal strength of the touch contact.</p>
292 <p><code>ABS_MT_WIDTH_MAJOR</code>: <em>(optional)</em> Reports the cross-sectional area of the tool itself,
293 or the length of the longer dimension of the tool itself.
294 This axis should not be used if the dimensions of the tool itself are unknown.</p>
298 the tool itself. This axis should not be used if <code>ABS_MT_WIDTH_MAJOR</code> is reporting
299 an area measurement or if the dimensions of the tool itself are unknown.</p>
302 <p><code>ABS_MT_ORIENTATION</code>: <em>(optional)</em> Reports the orientation of the tool.</p>
305 <p><code>ABS_MT_DISTANCE</code>: <em>(optional)</em> Reports the distance of the tool from the
309 <p><code>ABS_MT_TOOL_TYPE</code>: <em>(optional)</em> Reports the <a href="#tools-and-tool-types">tool type</a> as
313 <p><code>ABS_MT_TRACKING_ID</code>: <em>(optional)</em> Reports the tracking id of the tool.
315 and track each tool independently when multiple tools are active. For example,
321 <p><code>ABS_MT_SLOT</code>: <em>(optional)</em> Reports the slot id of the tool, when using the Linux
326 <p><code>BTN_TOUCH</code>: <em>(REQUIRED)</em> Indicates whether the tool is touching the device.</p>
337 <em>(optional)</em> Reports the <a href="#tools-and-tool-types">tool type</a>.</p>
380 are reported at all, must be non-zero when the tool is touching the device
381 and zero otherwise to indicate that the tool is hovering.</p>
388 <code>ABS_MT_WIDTH_MAJOR</code>, or <code>ABS_MT_WIDTH_MINOR</code> should be non-zero when the tool
398 zero when the tool is touching the device. The distance may remain non-zero
399 even when the tool is in direct contact. The exact values reported depend
406 tool is perpendicular to the device. A non-zero tilt is taken as an indication
407 that the tool is held at an incline.</p>
421 <p>If the tool type is reported by <code>ABS_MT_TOOL_TYPE</code>, it will supercede any tool
423 If no tool type information is available at all, the tool type defaults to
427 <p>A tool is determined to be active based on the following conditions:</p>
430 <p>When using the single-touch protocol, the tool is active if <code>BTN_TOUCH</code>,
433 information about the nature of the tool, either whether it is touching,
434 or at least its tool type. If no information is available,
435 then the tool is assumed to be inactive (out of range).</p>
438 <p>When using the multi-touch protocol 'A', the tool is active whenever it
439 appears in the most recent sync report. When the tool stops appearing in
443 <p>When using the multi-touch protocol 'B', the tool is active as long as
444 it has an active slot. When the slot it cleared, the tool ceases to exist.</p>
449 <p>A tool is determined to be hovering based on the following conditions:</p>
452 <p>If the tool is <code>BTN_TOOL_MOUSE</code> or <code>BTN_TOOL_LENS</code>, then the tool
456 <p>If the tool is active and the driver reports pressure information,
457 and the reported pressure is zero, then the tool is hovering.</p>
460 <p>If the tool is active and the driver supports the <code>BTN_TOUCH</code> key code and
461 <code>BTN_TOUCH</code> has a value of zero, then the tool is hovering.</p>
475 <p>When a tool becomes inactive (finger goes "up"), it should stop appearing
511 the position and other characteristics of each tool. It also tracks
528 <p>If there are no touching tools but there is at least one hovering tool,
730 of the <a href="#tools-and-tool-types">tool</a> itself in output units (pixels).</p>
740 field specifies the shorter dimension of the tool's cross-sectional area.</p>
741 <p>If the touch size is unavailable but the tool size is available, then the tool size
742 will be set equal to the touch size. Conversely, if the tool size is unavailable
743 but the touch size is available, then the touch size will be set equal to the tool size.</p>
744 <p>Touch devices measure or report the touch size and tool size in various ways.
751 touch size and tool size.</p>
762 the diameter (width) of the touch or tool.</p>
766 area of the touch or tool.</p>
879 <p>A zero pressure indicates that the tool is hovering.</p>
918 <p>The <code>Orientation</code> field describes the orientation of the touch and tool as an
922 tool is present, the orientation range may be described in a full circle range
924 <p>The <code>Tilt</code> field describes the inclination of the tool as an angular measurement.
925 A tilt of <code>0</code> indicates that the tool is perpendicular to the surface.
926 A tilt of <code>PI/2</code> indicates that the tool is flat on the surface.</p>
1003 <p>The <code>Distance</code> field describes the distance between the tool and the touch device
