three-stdlib 2.15.2 → 2.16.1

package/controls/experimental/CameraControls.js

@@ -1,80 +1,215 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const THREE = require("three");
-var STATE = /* @__PURE__ */ ((STATE2) => {
-  STATE2[STATE2["NONE"] = -1] = "NONE";
-  STATE2[STATE2["ROTATE"] = 0] = "ROTATE";
-  STATE2[STATE2["DOLLY"] = 1] = "DOLLY";
-  STATE2[STATE2["PAN"] = 2] = "PAN";
-  STATE2[STATE2["TOUCH_ROTATE"] = 3] = "TOUCH_ROTATE";
-  STATE2[STATE2["TOUCH_PAN"] = 4] = "TOUCH_PAN";
-  STATE2[STATE2["TOUCH_DOLLY_PAN"] = 5] = "TOUCH_DOLLY_PAN";
-  STATE2[STATE2["TOUCH_DOLLY_ROTATE"] = 6] = "TOUCH_DOLLY_ROTATE";
-  return STATE2;
-})(STATE || {});
-class CameraControls extends THREE.EventDispatcher {
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import { EventDispatcher, Vector3, TOUCH, Spherical, Vector2, Quaternion, PerspectiveCamera, OrthographicCamera, MOUSE } from 'three';
+
+let STATE;
+
+(function (STATE) {
+  STATE[STATE["NONE"] = -1] = "NONE";
+  STATE[STATE["ROTATE"] = 0] = "ROTATE";
+  STATE[STATE["DOLLY"] = 1] = "DOLLY";
+  STATE[STATE["PAN"] = 2] = "PAN";
+  STATE[STATE["TOUCH_ROTATE"] = 3] = "TOUCH_ROTATE";
+  STATE[STATE["TOUCH_PAN"] = 4] = "TOUCH_PAN";
+  STATE[STATE["TOUCH_DOLLY_PAN"] = 5] = "TOUCH_DOLLY_PAN";
+  STATE[STATE["TOUCH_DOLLY_ROTATE"] = 6] = "TOUCH_DOLLY_ROTATE";
+})(STATE || (STATE = {}));
+
+class CameraControls extends EventDispatcher {
+  /** Set to false to disable this control */
+
+  /** "target" sets the location of focus, where the object orbits around */
+
+  /** Set to true to enable trackball behavior */
+
+  /** How far you can dolly in ( PerspectiveCamera only ) */
+
+  /** How far you can dolly out ( PerspectiveCamera only ) */
+  // How far you can zoom in and out ( OrthographicCamera only )
+  // How far you can orbit vertically, upper and lower limits.
+  // Range is 0 to Math.PI radians.
+  // How far you can orbit horizontally, upper and lower limits.
+  // If set, must be a sub-interval of the interval [ - Math.PI, Math.PI ].
+  // radians
+  // radians
+  // Set to true to enable damping (inertia)
+  // If damping is enabled, you must call controls.update() in your animation loop
+
+  /**
+   * This option enables dollying in and out; property named as "zoom" for backwards compatibility
+   * Set to false to disable zooming
+   */
+
+  /** Set to false to disable rotating */
+
+  /** Set to false to disable panning */
+
+  /** if true, pan in screen-space */
+
+  /** pixels moved per arrow key push */
+
+  /**
+   * Set to true to automatically rotate around the target
+   * If auto-rotate is enabled, you must call controls.update() in your animation loop
+   * auto-rotate is not supported for trackball behavior
+   */
+  // 30 seconds per round when fps is 60
+
+  /** Set to false to disable use of the keys */
+
+  /** The four arrow keys */
+
+  /** Touch fingers */
+  // for reset
+  // current position in spherical coordinates
   constructor(object, domElement) {
     super();
-    this.enabled = true;
-    this.target = new THREE.Vector3();
-    this.trackball = false;
-    this.minDistance = 0;
-    this.maxDistance = Infinity;
-    this.minZoom = 0;
-    this.maxZoom = Infinity;
-    this.minPolarAngle = 0;
-    this.maxPolarAngle = Math.PI;
-    this.minAzimuthAngle = -Infinity;
-    this.maxAzimuthAngle = Infinity;
-    this.enableDamping = false;
-    this.dampingFactor = 0.05;
-    this.enableZoom = true;
-    this.zoomSpeed = 1;
-    this.enableRotate = true;
-    this.rotateSpeed = 1;
-    this.enablePan = true;
-    this.panSpeed = 1;
-    this.screenSpacePanning = false;
-    this.keyPanSpeed = 7;
-    this.autoRotate = false;
-    this.autoRotateSpeed = 2;
-    this.enableKeys = true;
-    this.keys = { LEFT: "ArrowLeft", UP: "ArrowUp", RIGHT: "ArrowRight", BOTTOM: "ArrowDown" };
-    this.touches = { ONE: THREE.TOUCH.ROTATE, TWO: THREE.TOUCH.DOLLY_PAN };
-    this.spherical = new THREE.Spherical();
-    this.sphericalDelta = new THREE.Spherical();
-    this.changeEvent = { type: "change" };
-    this.startEvent = { type: "start" };
-    this.endEvent = { type: "end" };
-    this.state = -1;
-    this.EPS = 1e-6;
-    this.scale = 1;
-    this.panOffset = new THREE.Vector3();
-    this.zoomChanged = false;
-    this.rotateStart = new THREE.Vector2();
-    this.rotateEnd = new THREE.Vector2();
-    this.rotateDelta = new THREE.Vector2();
-    this.panStart = new THREE.Vector2();
-    this.panEnd = new THREE.Vector2();
-    this.panDelta = new THREE.Vector2();
-    this.dollyStart = new THREE.Vector2();
-    this.dollyEnd = new THREE.Vector2();
-    this.dollyDelta = new THREE.Vector2();
-    this.offset = new THREE.Vector3();
-    this.lastPosition = new THREE.Vector3();
-    this.lastQuaternion = new THREE.Quaternion();
-    this.q = new THREE.Quaternion();
-    this.v = new THREE.Vector3();
-    this.vec = new THREE.Vector3();
-    this.getPolarAngle = () => this.spherical.phi;
-    this.getAzimuthalAngle = () => this.spherical.theta;
-    this.saveState = () => {
+
+    _defineProperty(this, "object", void 0);
+
+    _defineProperty(this, "domElement", void 0);
+
+    _defineProperty(this, "enabled", true);
+
+    _defineProperty(this, "target", new Vector3());
+
+    _defineProperty(this, "trackball", false);
+
+    _defineProperty(this, "minDistance", 0);
+
+    _defineProperty(this, "maxDistance", Infinity);
+
+    _defineProperty(this, "minZoom", 0);
+
+    _defineProperty(this, "maxZoom", Infinity);
+
+    _defineProperty(this, "minPolarAngle", 0);
+
+    _defineProperty(this, "maxPolarAngle", Math.PI);
+
+    _defineProperty(this, "minAzimuthAngle", -Infinity);
+
+    _defineProperty(this, "maxAzimuthAngle", Infinity);
+
+    _defineProperty(this, "enableDamping", false);
+
+    _defineProperty(this, "dampingFactor", 0.05);
+
+    _defineProperty(this, "enableZoom", true);
+
+    _defineProperty(this, "zoomSpeed", 1.0);
+
+    _defineProperty(this, "enableRotate", true);
+
+    _defineProperty(this, "rotateSpeed", 1.0);
+
+    _defineProperty(this, "enablePan", true);
+
+    _defineProperty(this, "panSpeed", 1.0);
+
+    _defineProperty(this, "screenSpacePanning", false);
+
+    _defineProperty(this, "keyPanSpeed", 7.0);
+
+    _defineProperty(this, "autoRotate", false);
+
+    _defineProperty(this, "autoRotateSpeed", 2.0);
+
+    _defineProperty(this, "enableKeys", true);
+
+    _defineProperty(this, "keys", {
+      LEFT: 'ArrowLeft',
+      UP: 'ArrowUp',
+      RIGHT: 'ArrowRight',
+      BOTTOM: 'ArrowDown'
+    });
+
+    _defineProperty(this, "mouseButtons", void 0);
+
+    _defineProperty(this, "touches", {
+      ONE: TOUCH.ROTATE,
+      TWO: TOUCH.DOLLY_PAN
+    });
+
+    _defineProperty(this, "target0", void 0);
+
+    _defineProperty(this, "position0", void 0);
+
+    _defineProperty(this, "quaternion0", void 0);
+
+    _defineProperty(this, "zoom0", void 0);
+
+    _defineProperty(this, "spherical", new Spherical());
+
+    _defineProperty(this, "sphericalDelta", new Spherical());
+
+    _defineProperty(this, "changeEvent", {
+      type: 'change'
+    });
+
+    _defineProperty(this, "startEvent", {
+      type: 'start'
+    });
+
+    _defineProperty(this, "endEvent", {
+      type: 'end'
+    });
+
+    _defineProperty(this, "state", STATE.NONE);
+
+    _defineProperty(this, "EPS", 0.000001);
+
+    _defineProperty(this, "scale", 1);
+
+    _defineProperty(this, "panOffset", new Vector3());
+
+    _defineProperty(this, "zoomChanged", false);
+
+    _defineProperty(this, "rotateStart", new Vector2());
+
+    _defineProperty(this, "rotateEnd", new Vector2());
+
+    _defineProperty(this, "rotateDelta", new Vector2());
+
+    _defineProperty(this, "panStart", new Vector2());
+
+    _defineProperty(this, "panEnd", new Vector2());
+
+    _defineProperty(this, "panDelta", new Vector2());
+
+    _defineProperty(this, "dollyStart", new Vector2());
+
+    _defineProperty(this, "dollyEnd", new Vector2());
+
+    _defineProperty(this, "dollyDelta", new Vector2());
+
+    _defineProperty(this, "offset", new Vector3());
+
+    _defineProperty(this, "lastPosition", new Vector3());
+
+    _defineProperty(this, "lastQuaternion", new Quaternion());
+
+    _defineProperty(this, "q", new Quaternion());
+
+    _defineProperty(this, "v", new Vector3());
+
+    _defineProperty(this, "vec", new Vector3());
+
+    _defineProperty(this, "quat", void 0);
+
+    _defineProperty(this, "quatInverse", void 0);
+
+    _defineProperty(this, "getPolarAngle", () => this.spherical.phi);
+
+    _defineProperty(this, "getAzimuthalAngle", () => this.spherical.theta);
+
+    _defineProperty(this, "saveState", () => {
       this.target0.copy(this.target);
       this.position0.copy(this.object.position);
       this.quaternion0.copy(this.object.quaternion);
       this.zoom0 = this.object.zoom;
-    };
-    this.reset = () => {
+    });
+
+    _defineProperty(this, "reset", () => {
       this.target.copy(this.target0);
       this.object.position.copy(this.position0);
       this.object.quaternion.copy(this.quaternion0);
@@ -82,30 +217,36 @@ class CameraControls extends THREE.EventDispatcher {
       this.object.updateProjectionMatrix();
       this.dispatchEvent(this.changeEvent);
       this.update();
-      this.state = -1;
-    };
-    this.dispose = () => {
-      this.domElement.removeEventListener("contextmenu", this.onContextMenu, false);
-      this.domElement.removeEventListener("mousedown", this.onMouseDown, false);
-      this.domElement.removeEventListener("wheel", this.onMouseWheel, false);
-      this.domElement.removeEventListener("touchstart", this.onTouchStart, false);
-      this.domElement.removeEventListener("touchend", this.onTouchEnd, false);
-      this.domElement.removeEventListener("touchmove", this.onTouchMove, false);
-      document.removeEventListener("mousemove", this.onMouseMove, false);
-      document.removeEventListener("mouseup", this.onMouseUp, false);
-      this.domElement.removeEventListener("keydown", this.onKeyDown, false);
-    };
-    this.update = () => {
+      this.state = STATE.NONE;
+    });
+
+    _defineProperty(this, "dispose", () => {
+      this.domElement.removeEventListener('contextmenu', this.onContextMenu, false);
+      this.domElement.removeEventListener('mousedown', this.onMouseDown, false);
+      this.domElement.removeEventListener('wheel', this.onMouseWheel, false);
+      this.domElement.removeEventListener('touchstart', this.onTouchStart, false);
+      this.domElement.removeEventListener('touchend', this.onTouchEnd, false);
+      this.domElement.removeEventListener('touchmove', this.onTouchMove, false);
+      document.removeEventListener('mousemove', this.onMouseMove, false);
+      document.removeEventListener('mouseup', this.onMouseUp, false);
+      this.domElement.removeEventListener('keydown', this.onKeyDown, false); //this.dispatchEvent( { type: 'dispose' } ); // should this be added here?
+    });
+
+    _defineProperty(this, "update", () => {
       const position = this.object.position;
       this.offset.copy(position).sub(this.target);
+
       if (this.trackball) {
+        // rotate around screen-space y-axis
         if (this.sphericalDelta.theta) {
           this.vec.set(0, 1, 0).applyQuaternion(this.object.quaternion);
           const factor = this.enableDamping ? this.dampingFactor : 1;
           this.q.setFromAxisAngle(this.vec, this.sphericalDelta.theta * factor);
           this.object.quaternion.premultiply(this.q);
           this.offset.applyQuaternion(this.q);
-        }
+        } // rotate around screen-space x-axis
+
+
         if (this.sphericalDelta.phi) {
           this.vec.set(1, 0, 0).applyQuaternion(this.object.quaternion);
           const factor = this.enableDamping ? this.dampingFactor : 1;
@@ -113,38 +254,53 @@ class CameraControls extends THREE.EventDispatcher {
           this.object.quaternion.premultiply(this.q);
           this.offset.applyQuaternion(this.q);
         }
+
         this.offset.multiplyScalar(this.scale);
         this.offset.clampLength(this.minDistance, this.maxDistance);
       } else {
+        // rotate offset to "y-axis-is-up" space
         this.offset.applyQuaternion(this.quat);
-        if (this.autoRotate && this.state === -1) {
+
+        if (this.autoRotate && this.state === STATE.NONE) {
           this.rotateLeft(this.getAutoRotationAngle());
         }
+
         this.spherical.setFromVector3(this.offset);
+
         if (this.enableDamping) {
           this.spherical.theta += this.sphericalDelta.theta * this.dampingFactor;
           this.spherical.phi += this.sphericalDelta.phi * this.dampingFactor;
         } else {
           this.spherical.theta += this.sphericalDelta.theta;
           this.spherical.phi += this.sphericalDelta.phi;
-        }
-        this.spherical.theta = Math.max(this.minAzimuthAngle, Math.min(this.maxAzimuthAngle, this.spherical.theta));
+        } // restrict theta to be between desired limits
+
+
+        this.spherical.theta = Math.max(this.minAzimuthAngle, Math.min(this.maxAzimuthAngle, this.spherical.theta)); // restrict phi to be between desired limits
+
         this.spherical.phi = Math.max(this.minPolarAngle, Math.min(this.maxPolarAngle, this.spherical.phi));
         this.spherical.makeSafe();
-        this.spherical.radius *= this.scale;
+        this.spherical.radius *= this.scale; // restrict radius to be between desired limits
+
         this.spherical.radius = Math.max(this.minDistance, Math.min(this.maxDistance, this.spherical.radius));
-        this.offset.setFromSpherical(this.spherical);
+        this.offset.setFromSpherical(this.spherical); // rotate offset back to "camera-up-vector-is-up" space
+
         this.offset.applyQuaternion(this.quatInverse);
-      }
+      } // move target to panned location
+
+
       if (this.enableDamping === true) {
         this.target.addScaledVector(this.panOffset, this.dampingFactor);
       } else {
         this.target.add(this.panOffset);
       }
+
       position.copy(this.target).add(this.offset);
+
       if (this.trackball === false) {
         this.object.lookAt(this.target);
       }
+
       if (this.enableDamping === true) {
         this.sphericalDelta.theta *= 1 - this.dampingFactor;
         this.sphericalDelta.phi *= 1 - this.dampingFactor;
@@ -153,7 +309,11 @@ class CameraControls extends THREE.EventDispatcher {
         this.sphericalDelta.set(0, 0, 0);
         this.panOffset.set(0, 0, 0);
       }
-      this.scale = 1;
+
+      this.scale = 1; // update condition is:
+      // min(camera displacement, camera rotation in radians)^2 > EPS
+      // using small-angle approximation cos(x/2) = 1 - x^2 / 8
+
       if (this.zoomChanged || this.lastPosition.distanceToSquared(this.object.position) > this.EPS || 8 * (1 - this.lastQuaternion.dot(this.object.quaternion)) > this.EPS) {
         this.dispatchEvent(this.changeEvent);
         this.lastPosition.copy(this.object.position);
@@ -161,148 +321,181 @@ class CameraControls extends THREE.EventDispatcher {
         this.zoomChanged = false;
         return true;
       }
+
       return false;
-    };
-    this.getAutoRotationAngle = () => 2 * Math.PI / 60 / 60 * this.autoRotateSpeed;
-    this.getZoomScale = () => Math.pow(0.95, this.zoomSpeed);
-    this.rotateLeft = (angle) => {
+    });
+
+    _defineProperty(this, "getAutoRotationAngle", () => 2 * Math.PI / 60 / 60 * this.autoRotateSpeed);
+
+    _defineProperty(this, "getZoomScale", () => Math.pow(0.95, this.zoomSpeed));
+
+    _defineProperty(this, "rotateLeft", angle => {
       this.sphericalDelta.theta -= angle;
-    };
-    this.rotateUp = (angle) => {
+    });
+
+    _defineProperty(this, "rotateUp", angle => {
       this.sphericalDelta.phi -= angle;
-    };
-    this.panLeft = (distance, objectMatrix) => {
-      this.v.setFromMatrixColumn(objectMatrix, 0);
+    });
+
+    _defineProperty(this, "panLeft", (distance, objectMatrix) => {
+      this.v.setFromMatrixColumn(objectMatrix, 0); // get X column of objectMatrix
+
       this.v.multiplyScalar(-distance);
       this.panOffset.add(this.v);
-    };
-    this.panUp = (distance, objectMatrix) => {
+    });
+
+    _defineProperty(this, "panUp", (distance, objectMatrix) => {
       if (this.screenSpacePanning === true) {
         this.v.setFromMatrixColumn(objectMatrix, 1);
       } else {
         this.v.setFromMatrixColumn(objectMatrix, 0);
         this.v.crossVectors(this.object.up, this.v);
       }
+
       this.v.multiplyScalar(distance);
       this.panOffset.add(this.v);
-    };
-    this.pan = (deltaX, deltaY) => {
+    });
+
+    _defineProperty(this, "pan", (deltaX, deltaY) => {
       const element = this.domElement;
-      if (this.object instanceof THREE.PerspectiveCamera) {
+
+      if (this.object instanceof PerspectiveCamera) {
+        // perspective
         const position = this.object.position;
         this.offset.copy(position).sub(this.target);
-        let targetDistance = this.offset.length();
-        targetDistance *= Math.tan(this.object.fov / 2 * Math.PI / 180);
+        let targetDistance = this.offset.length(); // half of the fov is center to top of screen
+
+        targetDistance *= Math.tan(this.object.fov / 2 * Math.PI / 180.0); // we use only clientHeight here so aspect ratio does not distort speed
+
         this.panLeft(2 * deltaX * targetDistance / element.clientHeight, this.object.matrix);
         this.panUp(2 * deltaY * targetDistance / element.clientHeight, this.object.matrix);
       } else if (this.object.isOrthographicCamera) {
-        this.panLeft(
-          deltaX * (this.object.right - this.object.left) / this.object.zoom / element.clientWidth,
-          this.object.matrix
-        );
-        this.panUp(
-          deltaY * (this.object.top - this.object.bottom) / this.object.zoom / element.clientHeight,
-          this.object.matrix
-        );
+        // orthographic
+        this.panLeft(deltaX * (this.object.right - this.object.left) / this.object.zoom / element.clientWidth, this.object.matrix);
+        this.panUp(deltaY * (this.object.top - this.object.bottom) / this.object.zoom / element.clientHeight, this.object.matrix);
       } else {
-        console.warn("WARNING: CameraControls.js encountered an unknown camera type - pan disabled.");
+        // camera neither orthographic nor perspective
+        console.warn('WARNING: CameraControls.js encountered an unknown camera type - pan disabled.');
         this.enablePan = false;
       }
-    };
-    this.dollyIn = (dollyScale) => {
-      if (this.object instanceof THREE.PerspectiveCamera) {
-        this.scale /= dollyScale;
-      } else if (this.object instanceof THREE.OrthographicCamera) {
+    });
+
+    _defineProperty(this, "dollyIn", dollyScale => {
+      // TODO: replace w/.isPerspectiveCamera ?
+      if (this.object instanceof PerspectiveCamera) {
+        this.scale /= dollyScale; // TODO: replace w/.isOrthographicCamera ?
+      } else if (this.object instanceof OrthographicCamera) {
         this.object.zoom = Math.max(this.minZoom, Math.min(this.maxZoom, this.object.zoom * dollyScale));
         this.object.updateProjectionMatrix();
         this.zoomChanged = true;
       } else {
-        console.warn("WARNING: CameraControls.js encountered an unknown camera type - dolly/zoom disabled.");
+        console.warn('WARNING: CameraControls.js encountered an unknown camera type - dolly/zoom disabled.');
         this.enableZoom = false;
       }
-    };
-    this.dollyOut = (dollyScale) => {
-      if (this.object instanceof THREE.PerspectiveCamera) {
-        this.scale *= dollyScale;
-      } else if (this.object instanceof THREE.OrthographicCamera) {
+    });
+
+    _defineProperty(this, "dollyOut", dollyScale => {
+      // TODO: replace w/.isPerspectiveCamera ?
+      if (this.object instanceof PerspectiveCamera) {
+        this.scale *= dollyScale; // TODO: replace w/.isOrthographicCamera ?
+      } else if (this.object instanceof OrthographicCamera) {
         this.object.zoom = Math.max(this.minZoom, Math.min(this.maxZoom, this.object.zoom / dollyScale));
         this.object.updateProjectionMatrix();
         this.zoomChanged = true;
       } else {
-        console.warn("WARNING: CameraControls.js encountered an unknown camera type - dolly/zoom disabled.");
+        console.warn('WARNING: CameraControls.js encountered an unknown camera type - dolly/zoom disabled.');
         this.enableZoom = false;
       }
-    };
-    this.handleMouseDownRotate = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseDownRotate", event => {
       this.rotateStart.set(event.clientX, event.clientY);
-    };
-    this.handleMouseDownDolly = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseDownDolly", event => {
       this.dollyStart.set(event.clientX, event.clientY);
-    };
-    this.handleMouseDownPan = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseDownPan", event => {
       this.panStart.set(event.clientX, event.clientY);
-    };
-    this.handleMouseMoveRotate = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseMoveRotate", event => {
       this.rotateEnd.set(event.clientX, event.clientY);
       this.rotateDelta.subVectors(this.rotateEnd, this.rotateStart).multiplyScalar(this.rotateSpeed);
       const element = this.domElement;
-      this.rotateLeft(2 * Math.PI * this.rotateDelta.x / element.clientHeight);
+      this.rotateLeft(2 * Math.PI * this.rotateDelta.x / element.clientHeight); // yes, height
+
       this.rotateUp(2 * Math.PI * this.rotateDelta.y / element.clientHeight);
       this.rotateStart.copy(this.rotateEnd);
       this.update();
-    };
-    this.handleMouseMoveDolly = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseMoveDolly", event => {
       this.dollyEnd.set(event.clientX, event.clientY);
       this.dollyDelta.subVectors(this.dollyEnd, this.dollyStart);
+
       if (this.dollyDelta.y > 0) {
         this.dollyIn(this.getZoomScale());
       } else if (this.dollyDelta.y < 0) {
         this.dollyOut(this.getZoomScale());
       }
+
       this.dollyStart.copy(this.dollyEnd);
       this.update();
-    };
-    this.handleMouseMovePan = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseMovePan", event => {
       this.panEnd.set(event.clientX, event.clientY);
       this.panDelta.subVectors(this.panEnd, this.panStart).multiplyScalar(this.panSpeed);
       this.pan(this.panDelta.x, this.panDelta.y);
       this.panStart.copy(this.panEnd);
       this.update();
-    };
-    this.handleMouseWheel = (event) => {
+    });
+
+    _defineProperty(this, "handleMouseWheel", event => {
       if (event.deltaY < 0) {
         this.dollyOut(this.getZoomScale());
       } else if (event.deltaY > 0) {
         this.dollyIn(this.getZoomScale());
       }
+
       this.update();
-    };
-    this.handleKeyDown = (event) => {
+    });
+
+    _defineProperty(this, "handleKeyDown", event => {
       let needsUpdate = false;
+
       switch (event.code) {
         case this.keys.UP:
           this.pan(0, this.keyPanSpeed);
           needsUpdate = true;
           break;
+
         case this.keys.BOTTOM:
           this.pan(0, -this.keyPanSpeed);
           needsUpdate = true;
           break;
+
         case this.keys.LEFT:
           this.pan(this.keyPanSpeed, 0);
           needsUpdate = true;
           break;
+
         case this.keys.RIGHT:
           this.pan(-this.keyPanSpeed, 0);
           needsUpdate = true;
           break;
       }
+
       if (needsUpdate) {
+        // prevent the browser from scrolling on cursor keys
         event.preventDefault();
         this.update();
       }
-    };
-    this.handleTouchStartRotate = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchStartRotate", event => {
       if (event.touches.length == 1) {
         this.rotateStart.set(event.touches[0].pageX, event.touches[0].pageY);
       } else {
@@ -310,8 +503,9 @@ class CameraControls extends THREE.EventDispatcher {
         const y = 0.5 * (event.touches[0].pageY + event.touches[1].pageY);
         this.rotateStart.set(x, y);
       }
-    };
-    this.handleTouchStartPan = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchStartPan", event => {
       if (event.touches.length == 1) {
         this.panStart.set(event.touches[0].pageX, event.touches[0].pageY);
       } else {
@@ -319,26 +513,26 @@ class CameraControls extends THREE.EventDispatcher {
         const y = 0.5 * (event.touches[0].pageY + event.touches[1].pageY);
         this.panStart.set(x, y);
       }
-    };
-    this.handleTouchStartDolly = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchStartDolly", event => {
       const dx = event.touches[0].pageX - event.touches[1].pageX;
       const dy = event.touches[0].pageY - event.touches[1].pageY;
       const distance = Math.sqrt(dx * dx + dy * dy);
       this.dollyStart.set(0, distance);
-    };
-    this.handleTouchStartDollyPan = (event) => {
-      if (this.enableZoom)
-        this.handleTouchStartDolly(event);
-      if (this.enablePan)
-        this.handleTouchStartPan(event);
-    };
-    this.handleTouchStartDollyRotate = (event) => {
-      if (this.enableZoom)
-        this.handleTouchStartDolly(event);
-      if (this.enableRotate)
-        this.handleTouchStartRotate(event);
-    };
-    this.handleTouchMoveRotate = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchStartDollyPan", event => {
+      if (this.enableZoom) this.handleTouchStartDolly(event);
+      if (this.enablePan) this.handleTouchStartPan(event);
+    });
+
+    _defineProperty(this, "handleTouchStartDollyRotate", event => {
+      if (this.enableZoom) this.handleTouchStartDolly(event);
+      if (this.enableRotate) this.handleTouchStartRotate(event);
+    });
+
+    _defineProperty(this, "handleTouchMoveRotate", event => {
       if (event.touches.length == 1) {
         this.rotateEnd.set(event.touches[0].pageX, event.touches[0].pageY);
       } else {
@@ -346,13 +540,16 @@ class CameraControls extends THREE.EventDispatcher {
         const y = 0.5 * (event.touches[0].pageY + event.touches[1].pageY);
         this.rotateEnd.set(x, y);
       }
+
       this.rotateDelta.subVectors(this.rotateEnd, this.rotateStart).multiplyScalar(this.rotateSpeed);
       const element = this.domElement;
-      this.rotateLeft(2 * Math.PI * this.rotateDelta.x / element.clientHeight);
+      this.rotateLeft(2 * Math.PI * this.rotateDelta.x / element.clientHeight); // yes, height
+
       this.rotateUp(2 * Math.PI * this.rotateDelta.y / element.clientHeight);
       this.rotateStart.copy(this.rotateEnd);
-    };
-    this.handleTouchMovePan = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchMovePan", event => {
       if (event.touches.length == 1) {
         this.panEnd.set(event.touches[0].pageX, event.touches[0].pageY);
       } else {
@@ -360,11 +557,13 @@ class CameraControls extends THREE.EventDispatcher {
         const y = 0.5 * (event.touches[0].pageY + event.touches[1].pageY);
         this.panEnd.set(x, y);
       }
+
       this.panDelta.subVectors(this.panEnd, this.panStart).multiplyScalar(this.panSpeed);
       this.pan(this.panDelta.x, this.panDelta.y);
       this.panStart.copy(this.panEnd);
-    };
-    this.handleTouchMoveDolly = (event) => {
+    });
+
+    _defineProperty(this, "handleTouchMoveDolly", event => {
       const dx = event.touches[0].pageX - event.touches[1].pageX;
       const dy = event.touches[0].pageY - event.touches[1].pageY;
       const distance = Math.sqrt(dx * dx + dy * dy);
@@ -372,302 +571,383 @@ class CameraControls extends THREE.EventDispatcher {
       this.dollyDelta.set(0, Math.pow(this.dollyEnd.y / this.dollyStart.y, this.zoomSpeed));
       this.dollyIn(this.dollyDelta.y);
       this.dollyStart.copy(this.dollyEnd);
-    };
-    this.handleTouchMoveDollyPan = (event) => {
-      if (this.enableZoom)
-        this.handleTouchMoveDolly(event);
-      if (this.enablePan)
-        this.handleTouchMovePan(event);
-    };
-    this.handleTouchMoveDollyRotate = (event) => {
-      if (this.enableZoom)
-        this.handleTouchMoveDolly(event);
-      if (this.enableRotate)
-        this.handleTouchMoveRotate(event);
-    };
-    this.onMouseDown = (event) => {
-      if (this.enabled === false)
-        return;
-      event.preventDefault();
+    });
+
+    _defineProperty(this, "handleTouchMoveDollyPan", event => {
+      if (this.enableZoom) this.handleTouchMoveDolly(event);
+      if (this.enablePan) this.handleTouchMovePan(event);
+    });
+
+    _defineProperty(this, "handleTouchMoveDollyRotate", event => {
+      if (this.enableZoom) this.handleTouchMoveDolly(event);
+      if (this.enableRotate) this.handleTouchMoveRotate(event);
+    });
+
+    _defineProperty(this, "onMouseDown", event => {
+      if (this.enabled === false) return; // Prevent the browser from scrolling.
+
+      event.preventDefault(); // Manually set the focus since calling preventDefault above
+      // prevents the browser from setting it automatically.
+
       this.domElement.focus ? this.domElement.focus() : window.focus();
       let mouseAction;
+
       switch (event.button) {
         case 0:
           mouseAction = this.mouseButtons.LEFT;
           break;
+
         case 1:
           mouseAction = this.mouseButtons.MIDDLE;
           break;
+
         case 2:
           mouseAction = this.mouseButtons.RIGHT;
           break;
+
         default:
           mouseAction = -1;
       }
+
       switch (mouseAction) {
-        case THREE.MOUSE.DOLLY:
-          if (this.enableZoom === false)
-            return;
+        case MOUSE.DOLLY:
+          if (this.enableZoom === false) return;
           this.handleMouseDownDolly(event);
-          this.state = 1;
+          this.state = STATE.DOLLY;
           break;
-        case THREE.MOUSE.ROTATE:
+
+        case MOUSE.ROTATE:
           if (event.ctrlKey || event.metaKey || event.shiftKey) {
-            if (this.enablePan === false)
-              return;
+            if (this.enablePan === false) return;
             this.handleMouseDownPan(event);
-            this.state = 2;
+            this.state = STATE.PAN;
           } else {
-            if (this.enableRotate === false)
-              return;
+            if (this.enableRotate === false) return;
             this.handleMouseDownRotate(event);
-            this.state = 0;
+            this.state = STATE.ROTATE;
           }
+
           break;
-        case THREE.MOUSE.PAN:
+
+        case MOUSE.PAN:
           if (event.ctrlKey || event.metaKey || event.shiftKey) {
-            if (this.enableRotate === false)
-              return;
+            if (this.enableRotate === false) return;
             this.handleMouseDownRotate(event);
-            this.state = 0;
+            this.state = STATE.ROTATE;
           } else {
-            if (this.enablePan === false)
-              return;
+            if (this.enablePan === false) return;
             this.handleMouseDownPan(event);
-            this.state = 2;
+            this.state = STATE.PAN;
           }
+
           break;
+
         default:
-          this.state = -1;
+          this.state = STATE.NONE;
       }
-      if (this.state !== -1) {
-        document.addEventListener("mousemove", this.onMouseMove, false);
-        document.addEventListener("mouseup", this.onMouseUp, false);
+
+      if (this.state !== STATE.NONE) {
+        document.addEventListener('mousemove', this.onMouseMove, false);
+        document.addEventListener('mouseup', this.onMouseUp, false);
         this.dispatchEvent(this.startEvent);
       }
-    };
-    this.onMouseMove = (event) => {
-      if (this.enabled === false)
-        return;
+    });
+
+    _defineProperty(this, "onMouseMove", event => {
+      if (this.enabled === false) return;
       event.preventDefault();
+
       switch (this.state) {
-        case 0:
-          if (this.enableRotate === false)
-            return;
+        case STATE.ROTATE:
+          if (this.enableRotate === false) return;
           this.handleMouseMoveRotate(event);
           break;
-        case 1:
-          if (this.enableZoom === false)
-            return;
+
+        case STATE.DOLLY:
+          if (this.enableZoom === false) return;
           this.handleMouseMoveDolly(event);
           break;
-        case 2:
-          if (this.enablePan === false)
-            return;
+
+        case STATE.PAN:
+          if (this.enablePan === false) return;
           this.handleMouseMovePan(event);
           break;
       }
-    };
-    this.onMouseUp = () => {
-      if (this.enabled === false)
-        return;
-      document.removeEventListener("mousemove", this.onMouseMove, false);
-      document.removeEventListener("mouseup", this.onMouseUp, false);
+    });
+
+    _defineProperty(this, "onMouseUp", () => {
+      if (this.enabled === false) return; // this.handleMouseUp()
+
+      document.removeEventListener('mousemove', this.onMouseMove, false);
+      document.removeEventListener('mouseup', this.onMouseUp, false);
       this.dispatchEvent(this.endEvent);
-      this.state = -1;
-    };
-    this.onMouseWheel = (event) => {
-      if (this.enabled === false || this.enableZoom === false || this.state !== -1 && this.state !== 0) {
+      this.state = STATE.NONE;
+    });
+
+    _defineProperty(this, "onMouseWheel", event => {
+      if (this.enabled === false || this.enableZoom === false || this.state !== STATE.NONE && this.state !== STATE.ROTATE) {
         return;
       }
+
       event.preventDefault();
       this.dispatchEvent(this.startEvent);
       this.handleMouseWheel(event);
       this.dispatchEvent(this.endEvent);
-    };
-    this.onKeyDown = (event) => {
-      if (this.enabled === false || this.enableKeys === false || this.enablePan === false)
-        return;
+    });
+
+    _defineProperty(this, "onKeyDown", event => {
+      if (this.enabled === false || this.enableKeys === false || this.enablePan === false) return;
       this.handleKeyDown(event);
-    };
-    this.onTouchStart = (event) => {
-      if (this.enabled === false)
-        return;
+    });
+
+    _defineProperty(this, "onTouchStart", event => {
+      if (this.enabled === false) return;
       event.preventDefault();
+
       switch (event.touches.length) {
         case 1:
           switch (this.touches.ONE) {
-            case THREE.TOUCH.ROTATE:
-              if (this.enableRotate === false)
-                return;
+            case TOUCH.ROTATE:
+              if (this.enableRotate === false) return;
               this.handleTouchStartRotate(event);
-              this.state = 3;
+              this.state = STATE.TOUCH_ROTATE;
               break;
-            case THREE.TOUCH.PAN:
-              if (this.enablePan === false)
-                return;
+
+            case TOUCH.PAN:
+              if (this.enablePan === false) return;
               this.handleTouchStartPan(event);
-              this.state = 4;
+              this.state = STATE.TOUCH_PAN;
               break;
+
             default:
-              this.state = -1;
+              this.state = STATE.NONE;
           }
+
           break;
+
         case 2:
           switch (this.touches.TWO) {
-            case THREE.TOUCH.DOLLY_PAN:
-              if (this.enableZoom === false && this.enablePan === false)
-                return;
+            case TOUCH.DOLLY_PAN:
+              if (this.enableZoom === false && this.enablePan === false) return;
               this.handleTouchStartDollyPan(event);
-              this.state = 5;
+              this.state = STATE.TOUCH_DOLLY_PAN;
               break;
-            case THREE.TOUCH.DOLLY_ROTATE:
-              if (this.enableZoom === false && this.enableRotate === false)
-                return;
+
+            case TOUCH.DOLLY_ROTATE:
+              if (this.enableZoom === false && this.enableRotate === false) return;
               this.handleTouchStartDollyRotate(event);
-              this.state = 6;
+              this.state = STATE.TOUCH_DOLLY_ROTATE;
               break;
+
             default:
-              this.state = -1;
+              this.state = STATE.NONE;
           }
+
           break;
+
         default:
-          this.state = -1;
+          this.state = STATE.NONE;
       }
-      if (this.state !== -1) {
+
+      if (this.state !== STATE.NONE) {
         this.dispatchEvent(this.startEvent);
       }
-    };
-    this.onTouchMove = (event) => {
-      if (this.enabled === false)
-        return;
+    });
+
+    _defineProperty(this, "onTouchMove", event => {
+      if (this.enabled === false) return;
       event.preventDefault();
+
       switch (this.state) {
-        case 3:
-          if (this.enableRotate === false)
-            return;
+        case STATE.TOUCH_ROTATE:
+          if (this.enableRotate === false) return;
           this.handleTouchMoveRotate(event);
           this.update();
           break;
-        case 4:
-          if (this.enablePan === false)
-            return;
+
+        case STATE.TOUCH_PAN:
+          if (this.enablePan === false) return;
           this.handleTouchMovePan(event);
           this.update();
           break;
-        case 5:
-          if (this.enableZoom === false && this.enablePan === false)
-            return;
+
+        case STATE.TOUCH_DOLLY_PAN:
+          if (this.enableZoom === false && this.enablePan === false) return;
           this.handleTouchMoveDollyPan(event);
           this.update();
           break;
-        case 6:
-          if (this.enableZoom === false && this.enableRotate === false)
-            return;
+
+        case STATE.TOUCH_DOLLY_ROTATE:
+          if (this.enableZoom === false && this.enableRotate === false) return;
           this.handleTouchMoveDollyRotate(event);
           this.update();
           break;
+
         default:
-          this.state = -1;
+          this.state = STATE.NONE;
       }
-    };
-    this.onTouchEnd = () => {
-      if (this.enabled === false)
-        return;
+    });
+
+    _defineProperty(this, "onTouchEnd", () => {
+      if (this.enabled === false) return; // this.handleTouchEnd()
+
       this.dispatchEvent(this.endEvent);
-      this.state = -1;
-    };
-    this.onContextMenu = (event) => {
-      if (this.enabled === false)
-        return;
+      this.state = STATE.NONE;
+    });
+
+    _defineProperty(this, "onContextMenu", event => {
+      if (this.enabled === false) return;
       event.preventDefault();
-    };
-    if (domElement === void 0) {
+    });
+
+    if (domElement === undefined) {
       console.warn('THREE.CameraControls: The second parameter "domElement" is now mandatory.');
     }
+
     if (domElement instanceof Document) {
-      console.error(
-        'THREE.CameraControls: "document" should not be used as the target "domElement". Please use "renderer.domElement" instead.'
-      );
+      console.error('THREE.CameraControls: "document" should not be used as the target "domElement". Please use "renderer.domElement" instead.');
     }
+
     this.object = object;
     this.domElement = domElement;
     this.mouseButtons = {
-      LEFT: THREE.MOUSE.ROTATE,
-      MIDDLE: THREE.MOUSE.DOLLY,
-      RIGHT: THREE.MOUSE.PAN
-    };
+      LEFT: MOUSE.ROTATE,
+      MIDDLE: MOUSE.DOLLY,
+      RIGHT: MOUSE.PAN
+    }; // for reset
+
     this.target0 = this.target.clone();
     this.position0 = this.object.position.clone();
     this.quaternion0 = this.object.quaternion.clone();
-    this.zoom0 = this.object.zoom;
-    this.quat = new THREE.Quaternion().setFromUnitVectors(this.object.up, new THREE.Vector3(0, 1, 0));
+    this.zoom0 = this.object.zoom; //
+    // internals
+    //
+    // so camera.up is the orbit axis
+
+    this.quat = new Quaternion().setFromUnitVectors(this.object.up, new Vector3(0, 1, 0));
     this.quatInverse = this.quat.clone().invert();
-    this.lastPosition = new THREE.Vector3();
-    this.lastQuaternion = new THREE.Quaternion();
-    this.domElement.addEventListener("contextmenu", this.onContextMenu, false);
-    this.domElement.addEventListener("mousedown", this.onMouseDown, false);
-    this.domElement.addEventListener("wheel", this.onMouseWheel, false);
-    this.domElement.addEventListener("touchstart", this.onTouchStart, false);
-    this.domElement.addEventListener("touchend", this.onTouchEnd, false);
-    this.domElement.addEventListener("touchmove", this.onTouchMove, false);
-    this.domElement.addEventListener("keydown", this.onKeyDown, false);
+    this.lastPosition = new Vector3();
+    this.lastQuaternion = new Quaternion();
+    this.domElement.addEventListener('contextmenu', this.onContextMenu, false);
+    this.domElement.addEventListener('mousedown', this.onMouseDown, false);
+    this.domElement.addEventListener('wheel', this.onMouseWheel, false);
+    this.domElement.addEventListener('touchstart', this.onTouchStart, false);
+    this.domElement.addEventListener('touchend', this.onTouchEnd, false);
+    this.domElement.addEventListener('touchmove', this.onTouchMove, false);
+    this.domElement.addEventListener('keydown', this.onKeyDown, false); // make sure element can receive keys.
+
     if (this.domElement.tabIndex === -1) {
       this.domElement.tabIndex = 0;
-    }
+    } // force an update at start
+
+
     this.object.lookAt(this.target);
     this.update();
     this.saveState();
   }
-  handleMouseUp() {
-  }
-  handleTouchEnd() {
+
+  handleMouseUp() {// no-op
   }
+
+  handleTouchEnd() {// no-op
+  } //
+  // event handlers - FSM: listen for events and reset state
+  //
+
+
 }
+/**
+ * OrbitControls maintains the "up" direction, camera.up (+Y by default).
+ *
+ * @event Orbit - left mouse / touch: one-finger move
+ * @event Zoom - middle mouse, or mousewheel / touch: two-finger spread or squish
+ * @event Pan - right mouse, or left mouse + ctrl/meta/shiftKey, or arrow keys / touch: two-finger move
+ */
+
+
 class OrbitControlsExp extends CameraControls {
   constructor(object, domElement) {
     super(object, domElement);
+
+    _defineProperty(this, "mouseButtons", void 0);
+
+    _defineProperty(this, "touches", void 0);
+
     this.mouseButtons = {
-      LEFT: THREE.MOUSE.ROTATE,
-      RIGHT: THREE.MOUSE.PAN
+      LEFT: MOUSE.ROTATE,
+      RIGHT: MOUSE.PAN
     };
     this.touches = {
-      ONE: THREE.TOUCH.ROTATE,
-      TWO: THREE.TOUCH.DOLLY_PAN
+      ONE: TOUCH.ROTATE,
+      TWO: TOUCH.DOLLY_PAN
     };
   }
+
 }
+/**
+ * MapControls maintains the "up" direction, camera.up (+Y by default)
+ *
+ * @event Orbit - right mouse, or left mouse + ctrl/meta/shiftKey / touch: two-finger rotate
+ * @event Zoom - middle mouse, or mousewheel / touch: two-finger spread or squish
+ * @event Pan - left mouse, or left right + ctrl/meta/shiftKey, or arrow keys / touch: one-finger move
+ */
+
+
 class MapControlsExp extends CameraControls {
   constructor(object, domElement) {
     super(object, domElement);
+
+    _defineProperty(this, "mouseButtons", void 0);
+
+    _defineProperty(this, "touches", void 0);
+
     this.mouseButtons = {
-      LEFT: THREE.MOUSE.PAN,
-      RIGHT: THREE.MOUSE.ROTATE
+      LEFT: MOUSE.PAN,
+      RIGHT: MOUSE.ROTATE
     };
     this.touches = {
-      ONE: THREE.TOUCH.PAN,
-      TWO: THREE.TOUCH.DOLLY_ROTATE
+      ONE: TOUCH.PAN,
+      TWO: TOUCH.DOLLY_ROTATE
     };
   }
+
 }
+/**
+ * TrackballControls allows the camera to rotate over the polls and does not maintain camera.up
+ *
+ * @event Orbit - left mouse / touch: one-finger move
+ * @event Zoom - middle mouse, or mousewheel / touch: two-finger spread or squish
+ * @event Pan - right mouse, or left mouse + ctrl/meta/shiftKey, or arrow keys / touch: two-finger move
+ */
+
+
 class TrackballControlsExp extends CameraControls {
   constructor(object, domElement) {
     super(object, domElement);
+
+    _defineProperty(this, "trackball", void 0);
+
+    _defineProperty(this, "screenSpacePanning", void 0);
+
+    _defineProperty(this, "autoRotate", void 0);
+
+    _defineProperty(this, "mouseButtons", void 0);
+
+    _defineProperty(this, "touches", void 0);
+
     this.trackball = true;
     this.screenSpacePanning = true;
     this.autoRotate = false;
     this.mouseButtons = {
-      LEFT: THREE.MOUSE.ROTATE,
-      RIGHT: THREE.MOUSE.PAN
+      LEFT: MOUSE.ROTATE,
+      RIGHT: MOUSE.PAN
     };
     this.touches = {
-      ONE: THREE.TOUCH.ROTATE,
-      TWO: THREE.TOUCH.DOLLY_PAN
+      ONE: TOUCH.ROTATE,
+      TWO: TOUCH.DOLLY_PAN
     };
   }
+
 }
-exports.CameraControls = CameraControls;
-exports.MapControlsExp = MapControlsExp;
-exports.OrbitControlsExp = OrbitControlsExp;
-exports.STATE = STATE;
-exports.TrackballControlsExp = TrackballControlsExp;
+
+export { CameraControls, MapControlsExp, OrbitControlsExp, STATE, TrackballControlsExp };