<!DOCTYPE html> <html> <head> <title>ToolEvent</title> <base target="classFrame"> <link rel="stylesheet" href="../resources/css/reference.css" type="text/css"> <link rel="stylesheet" href="../resources/css/style.css" type="text/css"> <link rel="stylesheet" href="../resources/css/paperscript.css" type="text/css"> <link rel="stylesheet" href="../resources/css/codemirror.css" type="text/css"> <script src="../resources/js/bootstrap.js" type="text/javascript"></script> <script src="../resources/js/paper.js" type="text/javascript"></script> <script src="../resources/js/codemirror.js" type="text/javascript"></script> <script src="../resources/js/reference.js" type="text/javascript"></script> </head> <body class="reference"> <div class="reference-class"> <h1>ToolEvent</h1> <p>ToolEvent The ToolEvent object is received by the <a href="../classes/Tool.html"><tt>Tool</tt></a>'s mouse event handlers <a href="../classes/Tool.html#onmousedown"><tt>tool.onMouseDown</tt></a>, <a href="../classes/Tool.html#onmousedrag"><tt>tool.onMouseDrag</tt></a>, <a href="../classes/Tool.html#onmousemove"><tt>tool.onMouseMove</tt></a> and <a href="../classes/Tool.html#onmouseup"><tt>tool.onMouseUp</tt></a>. The ToolEvent object is the only parameter passed to these functions and contains information about the mouse event.</p> </div> <div class="reference-members"><h2>Properties</h2> <div id="point-member" class="member"> <div id="point-link" class="member-link"> <a name="point" href="#" onClick="return toggleMember('point', false);"><tt><b>point</b></tt></a> </div> <div id="point-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('point', false);"><tt><b>point</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('point', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The position of the mouse in project coordinates when the event was fired.</p> <ul><b>Type:</b> <li> <a href="../classes/Point.html"><tt>Point</tt></a> </li> </ul> <p> <b>Example</b> </p> <pre class="code">function onMouseDrag(event) { // the position of the mouse when it is dragged console.log(event.point); } function onMouseUp(event) { // the position of the mouse when it is released console.log(event.point); }</pre> </div> </div> </div> <div id="lastpoint-member" class="member"> <div id="lastpoint-link" class="member-link"> <a name="lastpoint" href="#" onClick="return toggleMember('lastpoint', false);"><tt><b>lastPoint</b></tt></a> </div> <div id="lastpoint-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('lastpoint', false);"><tt><b>lastPoint</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('lastpoint', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The position of the mouse in project coordinates when the previous event was fired.</p> <ul><b>Type:</b> <li> <a href="../classes/Point.html"><tt>Point</tt></a> </li> </ul> </div> </div> </div> <div id="downpoint-member" class="member"> <div id="downpoint-link" class="member-link"> <a name="downpoint" href="#" onClick="return toggleMember('downpoint', false);"><tt><b>downPoint</b></tt></a> </div> <div id="downpoint-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('downpoint', false);"><tt><b>downPoint</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('downpoint', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The position of the mouse in project coordinates when the mouse button was last clicked.</p> <ul><b>Type:</b> <li> <a href="../classes/Point.html"><tt>Point</tt></a> </li> </ul> </div> </div> </div> <div id="middlepoint-member" class="member"> <div id="middlepoint-link" class="member-link"> <a name="middlepoint" href="#" onClick="return toggleMember('middlepoint', false);"><tt><b>middlePoint</b></tt></a> </div> <div id="middlepoint-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('middlepoint', false);"><tt><b>middlePoint</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('middlepoint', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The point in the middle between <a href="../classes/ToolEvent.html#lastpoint" onclick="return toggleMember('lastpoint', true);"><tt>lastPoint</tt></a> and <a href="../classes/ToolEvent.html#point" onclick="return toggleMember('point', true);"><tt>point</tt></a>. This is a useful position to use when creating artwork based on the moving direction of the mouse, as returned by <a href="../classes/ToolEvent.html#delta" onclick="return toggleMember('delta', true);"><tt>delta</tt></a>.</p> <ul><b>Type:</b> <li> <a href="../classes/Point.html"><tt>Point</tt></a> </li> </ul> </div> </div> </div> <div id="delta-member" class="member"> <div id="delta-link" class="member-link"> <a name="delta" href="#" onClick="return toggleMember('delta', false);"><tt><b>delta</b></tt></a> </div> <div id="delta-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('delta', false);"><tt><b>delta</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('delta', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The difference between the current position and the last position of the mouse when the event was fired. In case of the mouseup event, the difference to the mousedown position is returned.</p> <ul><b>Type:</b> <li> <a href="../classes/Point.html"><tt>Point</tt></a> </li> </ul> </div> </div> </div> <div id="count-member" class="member"> <div id="count-link" class="member-link"> <a name="count" href="#" onClick="return toggleMember('count', false);"><tt><b>count</b></tt></a> </div> <div id="count-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('count', false);"><tt><b>count</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('count', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <p>The number of times the mouse event was fired.</p> <ul><b>Type:</b> <li> Number </li> </ul> </div> </div> </div> <div id="modifiers-member" class="member"> <div id="modifiers-link" class="member-link"> <a name="modifiers" href="#" onClick="return toggleMember('modifiers', false);"><tt><b>modifiers</b></tt></a> </div> <div id="modifiers-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('modifiers', false);"><tt><b>modifiers</b></tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('modifiers', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <ul><b>Type:</b> <li> object </li> </ul> </div> </div> </div> </div> <!-- ============================== methods ================================ --> <div class="reference-members"><h2>Functions</h2> <div id="tostring-member" class="member"> <div id="tostring-link" class="member-link"> <a name="tostring" href="#" onClick="return toggleMember('tostring', false);"><tt><b>toString</b>()</tt></a> </div> <div id="tostring-description" class="member-description hidden"> <div class="member-header"> <div class="member-title"> <div class="member-link"> <a href="#" onClick="return toggleMember('tostring', false);"><tt><b>toString</b>()</tt></a> </div> </div> <div class="member-close"><input type="button" value="Close" onClick="toggleMember('tostring', false);"></div> <div class="clear"></div> </div> <div class="member-text"> <ul><b>Returns:</b> <li> <tt>String</tt> — A string representation of the tool event. </li> </ul> </div> </div> </div> </div> <!-- =========================== copyright notice ========================= --> <p class="footer">Copyright © 21011 <a href="http://www.lehni.org" target="_blank">Jürg Lehni</a> & <a href="http://www.jonathanpuckey.com" target="_blank">Jonathan Puckey</a>. All Rights Reserved.</p> </body>