<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qquickmultipointtoucharea.cpp --> <title>TouchPoint QML Type | Qt Quick 5.12.6</title> <link rel="stylesheet" type="text/css" href="style/offline-simple.css" /> <script type="text/javascript"> document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css"); // loading style sheet breaks anchors that were jumped to before // so force jumping to anchor again setTimeout(function() { var anchor = location.hash; // need to jump to different anchor first (e.g. none) location.hash = "#"; setTimeout(function() { location.hash = anchor; }, 0); }, 0); </script> </head> <body> <div class="header" id="qtdocheader"> <div class="main"> <div class="main-rounded"> <div class="navigationbar"> <table><tr> <td >Qt 5.12</td><td ><a href="qtquick-index.html">Qt Quick</a></td><td ><a href="qtquick-qmlmodule.html">QML Types</a></td><td >TouchPoint QML Type</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right"><a href="qtquick-index.html">Qt 5.12.6 Reference Documentation</a></td> </tr></table> </div> </div> <div class="content"> <div class="line"> <div class="content mainContent"> <div class="sidebar"> <div class="toc"> <h3><a name="toc">Contents</a></h3> <ul> <li class="level1"><a href="#properties">Properties</a></li> <li class="level1"><a href="#details">Detailed Description</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">TouchPoint QML Type</h1> <span class="subtitle"></span> <!-- $$$TouchPoint-brief --> <p>Describes a touch point in a <a href="qml-qtquick-multipointtoucharea.html">MultiPointTouchArea</a>. <a href="#details">More...</a></p> <!-- @@@TouchPoint --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtQuick 2.12</td></tr></table></div><ul> <li><a href="qml-qtquick-touchpoint-members.html">List of all members, including inherited members</a></li> <li><a href="qml-qtquick-touchpoint-obsolete.html">Obsolete members</a></li> </ul> <a name="properties"></a> <h2 id="properties">Properties</h2> <ul> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#ellipseDiameters-prop">ellipseDiameters</a></b></b> : size</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#pointId-prop">pointId</a></b></b> : int</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#pressed-prop">pressed</a></b></b> : bool</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#pressure-prop">pressure</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#previousX-prop">previousX</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#previousY-prop">previousY</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#rotation-prop">rotation</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#sceneX-prop">sceneX</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#sceneY-prop">sceneY</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#startX-prop">startX</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#startY-prop">startY</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#uniqueId-prop">uniqueId</a></b></b> : PointingDeviceUniqueId</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#velocity-prop">velocity</a></b></b> : vector2d</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#x-prop">x</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-touchpoint.html#y-prop">y</a></b></b> : real</li> </ul> <!-- $$$TouchPoint-description --> <a name="details"></a> <h2 id="details">Detailed Description</h2> <p>The <a href="qml-qtquick-touchpoint.html">TouchPoint</a> type contains information about a touch point, such as the current position, pressure, and area.</p> <p class="centerAlign"><img src="images/touchpoint-metrics.png" alt="" /></p><!-- @@@TouchPoint --> <h2>Property Documentation</h2> <!-- $$$ellipseDiameters --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="ellipseDiameters-prop"> <td class="tblQmlPropNode"><p> <a name="ellipseDiameters-prop"></a><span class="name">ellipseDiameters</span> : <span class="type">size</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the major and minor axes of the ellipse representing the covered area of the touch point.</p> <p>This property was introduced in Qt 5.9.</p> </div></div><!-- @@@ellipseDiameters --> <br/> <!-- $$$pointId --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="pointId-prop"> <td class="tblQmlPropNode"><p> <a name="pointId-prop"></a><span class="name">pointId</span> : <span class="type">int</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the point id of the touch point.</p> <p>Each touch point within a <a href="qml-qtquick-multipointtoucharea.html">MultiPointTouchArea</a> will have a unique id.</p> </div></div><!-- @@@pointId --> <br/> <!-- $$$pressed --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="pressed-prop"> <td class="tblQmlPropNode"><p> <a name="pressed-prop"></a><span class="name">pressed</span> : <span class="type">bool</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds whether the touch point is currently pressed.</p> </div></div><!-- @@@pressed --> <br/> <!-- $$$pressure --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="pressure-prop"> <td class="tblQmlPropNode"><p> <a name="pressure-prop"></a><span class="name">pressure</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold additional information about the current state of the touch point.</p> <ul> <li><code>pressure</code> is a value in the range of 0.0 to 1.0.</li> <li><code>velocity</code> is a vector with magnitude reported in pixels per second.</li> </ul> <p>Not all touch devices support velocity. If velocity is not supported, it will be reported as 0,0.</p> </div></div><!-- @@@pressure --> <br/> <!-- $$$previousX --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="previousX-prop"> <td class="tblQmlPropNode"><p> <a name="previousX-prop"></a><span class="name">previousX</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the previous position of the touch point.</p> </div></div><!-- @@@previousX --> <br/> <!-- $$$previousY --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="previousY-prop"> <td class="tblQmlPropNode"><p> <a name="previousY-prop"></a><span class="name">previousY</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the previous position of the touch point.</p> </div></div><!-- @@@previousY --> <br/> <!-- $$$rotation --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="rotation-prop"> <td class="tblQmlPropNode"><p> <a name="rotation-prop"></a><span class="name">rotation</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the angular orientation of this touch point. The return value is in degrees, where zero (the default) indicates the finger or token is pointing upwards, a negative angle means it's rotated to the left, and a positive angle means it's rotated to the right. Most touchscreens do not detect rotation, so zero is the most common value.</p> <p>This property was introduced in Qt 5.9.</p> <p><b>See also </b>QTouchEvent::TouchPoint::rotation().</p> </div></div><!-- @@@rotation --> <br/> <!-- $$$sceneX --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="sceneX-prop"> <td class="tblQmlPropNode"><p> <a name="sceneX-prop"></a><span class="name">sceneX</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the current position of the touch point in scene coordinates.</p> </div></div><!-- @@@sceneX --> <br/> <!-- $$$sceneY --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="sceneY-prop"> <td class="tblQmlPropNode"><p> <a name="sceneY-prop"></a><span class="name">sceneY</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the current position of the touch point in scene coordinates.</p> </div></div><!-- @@@sceneY --> <br/> <!-- $$$startX --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="startX-prop"> <td class="tblQmlPropNode"><p> <a name="startX-prop"></a><span class="name">startX</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the starting position of the touch point.</p> </div></div><!-- @@@startX --> <br/> <!-- $$$startY --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="startY-prop"> <td class="tblQmlPropNode"><p> <a name="startY-prop"></a><span class="name">startY</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the starting position of the touch point.</p> </div></div><!-- @@@startY --> <br/> <!-- $$$uniqueId --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="uniqueId-prop"> <td class="tblQmlPropNode"><p> <a name="uniqueId-prop"></a><span class="name">uniqueId</span> : <span class="type">PointingDeviceUniqueId</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the unique ID of the touch point or token.</p> <p>It is normally empty, because touchscreens cannot uniquely identify fingers. But when it is set, it is expected to uniquely identify a specific token (fiducial object).</p> <p>Interpreting the contents of this ID requires knowledge of the hardware and drivers in use (e.g. various TUIO-based touch surfaces).</p> <p>This property was introduced in Qt 5.9.</p> </div></div><!-- @@@uniqueId --> <br/> <!-- $$$velocity --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="velocity-prop"> <td class="tblQmlPropNode"><p> <a name="velocity-prop"></a><span class="name">velocity</span> : <span class="type"><a href="qml-vector2d.html">vector2d</a></span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold additional information about the current state of the touch point.</p> <ul> <li><code>pressure</code> is a value in the range of 0.0 to 1.0.</li> <li><code>velocity</code> is a vector with magnitude reported in pixels per second.</li> </ul> <p>Not all touch devices support velocity. If velocity is not supported, it will be reported as 0,0.</p> </div></div><!-- @@@velocity --> <br/> <!-- $$$x --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="x-prop"> <td class="tblQmlPropNode"><p> <a name="x-prop"></a><span class="name">x</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the current position of the touch point.</p> </div></div><!-- @@@x --> <br/> <!-- $$$y --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="y-prop"> <td class="tblQmlPropNode"><p> <a name="y-prop"></a><span class="name">y</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the current position of the touch point.</p> </div></div><!-- @@@y --> <br/> </div> </div> </div> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.<br/> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br/> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. </p> </div> </body> </html>