controls_ViewportControls.js.html 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>JSDoc: Source: controls/ViewportControls.js</title>
  6. <script src="scripts/prettify/prettify.js"> </script>
  7. <script src="scripts/prettify/lang-css.js"> </script>
  8. <!--[if lt IE 9]>
  9. <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  10. <![endif]-->
  11. <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
  12. <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
  13. </head>
  14. <body>
  15. <div id="main">
  16. <h1 class="page-title">Source: controls/ViewportControls.js</h1>
  17. <section>
  18. <article>
  19. <pre class="prettyprint source linenums"><code>import {Viewport} from "../Viewport.js";
  20. import {Pointer} from "../input/Pointer.js";
  21. import {Vector2} from "../math/Vector2.js";
  22. /**
  23. * Viewport controls are used to allow the user to control the viewport.
  24. *
  25. * @class
  26. * @param {Viewport} viewport
  27. */
  28. function ViewportControls(viewport)
  29. {
  30. /**
  31. * Viewport being controlled by this object.
  32. */
  33. this.viewport = viewport;
  34. /**
  35. * Button used to drag and viewport around.
  36. *
  37. * On touch enabled devices the touch event is represented as a LEFT button.
  38. */
  39. this.dragButton = Pointer.RIGHT;
  40. /**
  41. * Is set to true allow the viewport to be scalled.
  42. *
  43. * Scaling is performed using the pointer scroll.
  44. */
  45. this.allowScale = true;
  46. /**
  47. * Flag to indicate if the viewport should move when scalling.
  48. *
  49. * For some application its easier to focus the target if the viewport moves to the pointer location while scalling.
  50. */
  51. this.moveOnScale = false;
  52. /**
  53. * If true allows the viewport to be rotated.
  54. *
  55. * Rotation is performed by holding the RIGHT and LEFT pointer buttons and rotating around the initial point.
  56. */
  57. this.allowRotation = true;
  58. /**
  59. * Value of the initial point of rotation if the viewport is being rotated.
  60. *
  61. * Is set to null when the viewport is not being rotated.
  62. */
  63. this.rotationPoint = null;
  64. /**
  65. * Initial rotation of the viewport.
  66. */
  67. this.rotationInitial = 0;
  68. }
  69. /**
  70. * Update the viewport controls using the pointer object.
  71. *
  72. * Should be called every frame before rendering.
  73. *
  74. * @param {Pointer} pointer
  75. */
  76. ViewportControls.prototype.update = function(pointer)
  77. {
  78. // Scale
  79. if(this.allowScale &amp;&amp; pointer.wheel !== 0)
  80. {
  81. var scale = pointer.wheel * 1e-3 * this.viewport.scale;
  82. this.viewport.scale -= scale;
  83. this.viewport.matrixNeedsUpdate = true;
  84. // Move on scale
  85. if(this.moveOnScale &amp;&amp; pointer.canvas !== null)
  86. {
  87. this.viewport.updateMatrix();
  88. var pointerWorld = this.viewport.inverseMatrix.transformPoint(pointer.position);
  89. var centerWorld = new Vector2(pointer.canvas.width / 2.0, pointer.canvas.height / 2.0);
  90. centerWorld = this.viewport.inverseMatrix.transformPoint(centerWorld);
  91. var delta = pointerWorld.clone();
  92. delta.sub(centerWorld);
  93. delta.multiplyScalar(0.1);
  94. this.viewport.position.sub(delta);
  95. this.viewport.matrixNeedsUpdate = true;
  96. }
  97. }
  98. // Rotation
  99. if(this.allowRotation &amp;&amp; pointer.buttonPressed(Pointer.RIGHT) &amp;&amp; pointer.buttonPressed(Pointer.LEFT))
  100. {
  101. // Rotation pivot
  102. if(this.rotationPoint === null)
  103. {
  104. this.rotationPoint = pointer.position.clone();
  105. this.rotationInitial = this.viewport.rotation;
  106. }
  107. else
  108. {
  109. var pointer = pointer.position.clone();
  110. pointer.sub(this.rotationPoint);
  111. this.viewport.rotation = this.rotationInitial + pointer.angle();
  112. this.viewport.matrixNeedsUpdate = true;
  113. }
  114. }
  115. // Drag
  116. else
  117. {
  118. this.rotationPoint = null;
  119. if(pointer.buttonPressed(this.dragButton))
  120. {
  121. this.viewport.position.x += pointer.delta.x;
  122. this.viewport.position.y += pointer.delta.y;
  123. this.viewport.matrixNeedsUpdate = true;
  124. }
  125. }
  126. };
  127. export {ViewportControls};
  128. </code></pre>
  129. </article>
  130. </section>
  131. </div>
  132. <nav>
  133. <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AnimationTimer.html">AnimationTimer</a></li><li><a href="BezierCurve.html">BezierCurve</a></li><li><a href="Box.html">Box</a></li><li><a href="Box2.html">Box2</a></li><li><a href="BoxMask.html">BoxMask</a></li><li><a href="Circle.html">Circle</a></li><li><a href="DOM.html">DOM</a></li><li><a href="EventManager.html">EventManager</a></li><li><a href="FileUtils.html">FileUtils</a></li><li><a href="Graph.html">Graph</a></li><li><a href="Helpers.html">Helpers</a></li><li><a href="Image.html">Image</a></li><li><a href="Key.html">Key</a></li><li><a href="Line.html">Line</a></li><li><a href="Mask.html">Mask</a></li><li><a href="Matrix.html">Matrix</a></li><li><a href="MultiLineText.html">MultiLineText</a></li><li><a href="Node.html">Node</a></li><li><a href="NodeConnector.html">NodeConnector</a></li><li><a href="NodeGraph.html">NodeGraph</a></li><li><a href="NodeSocket.html">NodeSocket</a></li><li><a href="Object2D.html">Object2D</a></li><li><a href="Pattern.html">Pattern</a></li><li><a href="Pointer.html">Pointer</a></li><li><a href="QuadraticCurve.html">QuadraticCurve</a></li><li><a href="Renderer.html">Renderer</a></li><li><a href="RoundedBox.html">RoundedBox</a></li><li><a href="Text.html">Text</a></li><li><a href="UUID.html">UUID</a></li><li><a href="Vector2.html">Vector2</a></li><li><a href="Viewport.html">Viewport</a></li><li><a href="ViewportControls.html">ViewportControls</a></li></ul><h3>Global</h3><ul><li><a href="global.html#writeFile">writeFile</a></li></ul>
  134. </nav>
  135. <br class="clear">
  136. <footer>
  137. Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Tue May 19 2020 22:29:24 GMT+0100 (Western European Summer Time)
  138. </footer>
  139. <script> prettyPrint(); </script>
  140. <script src="scripts/linenumber.js"> </script>
  141. </body>
  142. </html>