@sapui5/sap.ui.vbm 1.93.1 → 1.96.1

package/src/sap/ui/vbm/adapter3d/thirdparty/OrbitControls.js

@@ -1,860 +1,1164 @@
-/**
- * @author qiao / https://github.com/qiao
- * @author mrdoob / http://mrdoob.com
- * @author alteredq / http://alteredqualia.com/
- * @author WestLangley / http://github.com/WestLangley
- * @author erich666 / http://erichaines.com
- */
-
-// This set of controls performs orbiting, dollying (zooming), and panning.
-// Unlike TrackballControls, it maintains the "up" direction object.up (+Y by default).
-//
-// Orbit - left mouse / touch: one finger move
-// Zoom - middle mouse, or mousewheel / touch: two finger spread or squish
-// Pan - right mouse, or arrow keys / touch: three finger swipe
-
-THREE.OrbitControls = function ( object, domElement ) {
-	this.object = object;
-	this.domElement = ( domElement !== undefined ) ? domElement : document;
-
-	// Set to false to disable this control
-	this.enabled = true;
-
-	// "target" sets the location of focus, where the object orbits around
-	this.target = new THREE.Vector3();
-
-	// How far you can dolly in and out ( PerspectiveCamera only )
-	this.minDistance = 0;
-	this.maxDistance = Infinity;
-
-	// How far you can zoom in and out ( OrthographicCamera only )
-	this.minZoom = 0;
-	this.maxZoom = Infinity;
-
-	// How far you can orbit vertically, upper and lower limits.
-	// Range is 0 to Math.PI radians.
-	this.minPolarAngle = 0; // radians
-	this.maxPolarAngle = 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 ].
-	this.minAzimuthAngle = - Infinity; // radians
-	this.maxAzimuthAngle = Infinity; // radians
-
-	// Set to true to enable damping (inertia)
-	// If damping is enabled, you must call controls.update() in your animation loop
-	this.enableDamping = false;
-	this.dampingFactor = 0.25;
-
-	// This option actually enables dollying in and out; left as "zoom" for backwards compatibility.
-	// Set to false to disable zooming
-	this.enableZoom = true;
-	this.zoomSpeed = 1.0;
-
-	// Set to false to disable rotating
-	this.enableRotate = true;
-	this.rotateSpeed = 1.0;
-
-	// Set to false to disable panning
-	this.enablePan = true;
-	this.keyPanSpeed = 7.0;	// pixels moved per arrow key push
-	this.keyRotateSpeed = 9.0;	// 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
-	this.autoRotate = false;
-	this.autoRotateSpeed = 2.0; // 30 seconds per round when fps is 60
-
-	// Set to false to disable use of the keys
-	this.enableKeys = true;
-
-	// The four arrow keys
-	this.keys = {LEFT: 37, UP: 38, RIGHT: 39, DOWN: 40, PLUS: 187, MINUS: 189, NUMPLUS: 107, NUMMINUS: 109};
-
-	// Mouse buttons
-	this.mouseButtons = { ORBIT: THREE.MOUSE.LEFT, ZOOM: THREE.MOUSE.MIDDLE, PAN: THREE.MOUSE.RIGHT };
-
-	// for reset
-	this.target0 = this.target.clone();
-	this.position0 = this.object.position.clone();
-	this.zoom0 = this.object.zoom;
-
-	// public methods
-
-	this.getPolarAngle = function () {
-		return spherical.phi;
-	};
+( function () {
+
+	// Unlike TrackballControls, it maintains the "up" direction object.up (+Y by default).
+	//
+	//    Orbit - left mouse / touch: one-finger move
+	//    Zoom - middle mouse, or mousewheel / touch: two-finger spread or squish
+	//    Pan - right mouse, or left mouse + ctrl/meta/shiftKey, or arrow keys / touch: two-finger move
 
-	this.getAzimuthalAngle = function () {
-		return spherical.theta;
+	const _changeEvent = {
+		type: 'change'
+	};
+	const _startEvent = {
+		type: 'start'
+	};
+	const _endEvent = {
+		type: 'end'
 	};
 
-	this.saveState = function () {
-		var state = {};
+	class OrbitControls extends THREE.EventDispatcher {
 
-		state.target = scope.target.clone();
-		state.position = scope.object.position.clone();
-		state.zoom = scope.object.zoom;
+		constructor( object, domElement ) {
 
-		return state;
-	};
+			super();
+			if ( domElement === undefined ) console.warn( 'THREE.OrbitControls: The second parameter "domElement" is now mandatory.' );
+			if ( domElement === document ) console.error( 'THREE.OrbitControls: "document" should not be used as the target "domElement". Please use "renderer.domElement" instead.' );
+			this.object = object;
+			this.domElement = domElement;
+			this.domElement.style.touchAction = 'none'; // disable touch scroll
+			// Set to false to disable this control
 
-	this.reset = function (state) {
-		if (state) {
-			scope.target.copy(state.target);
-			scope.object.position.copy(state.position);
-			scope.object.zoom = state.zoom;
+			this.enabled = true; // "target" sets the location of focus, where the object orbits around
 
-			scope.object.updateProjectionMatrix();
-			scope.dispatchEvent(changeEvent);
+			this.target = new THREE.Vector3(); // How far you can dolly in and out ( PerspectiveCamera only )
 
-			scope.update();
-			state = STATE.NONE;
-		}
-	};
+			this.minDistance = 0;
+			this.maxDistance = Infinity; // How far you can zoom in and out ( OrthographicCamera only )
 
-	// this method is exposed, but perhaps it would be better if we can make it private...
-	this.update = function (tag) {
+			this.minZoom = 0;
+			this.maxZoom = Infinity; // How far you can orbit vertically, upper and lower limits.
+			// Range is 0 to Math.PI radians.
 
-		var offset = new THREE.Vector3();
+			this.minPolarAngle = 0; // radians
 
-		// so camera.up is the orbit axis
-		var quat = new THREE.Quaternion().setFromUnitVectors(object.up, new THREE.Vector3(0, 1, 0));
-		var quatInverse = quat.clone().inverse();
+			this.maxPolarAngle = Math.PI; // radians
+			// How far you can orbit horizontally, upper and lower limits.
+			// If set, the interval [ min, max ] must be a sub-interval of [ - 2 PI, 2 PI ], with ( max - min < 2 PI )
 
-		var lastPosition = new THREE.Vector3();
-		var lastQuaternion = new THREE.Quaternion();
+			this.minAzimuthAngle = - Infinity; // radians
 
-		return function update(tag) {
-			var position = scope.object.position;
-			offset.copy(position).sub(scope.target);
+			this.maxAzimuthAngle = Infinity; // radians
+			// Set to true to enable damping (inertia)
+			// If damping is enabled, you must call controls.update() in your animation loop
 
-			// rotate offset to "y-axis-is-up" space
-			offset.applyQuaternion(quat);
+			this.enableDamping = false;
+			this.dampingFactor = 0.05; // This option actually enables dollying in and out; left as "zoom" for backwards compatibility.
+			// Set to false to disable zooming
 
-			// angle from z-axis around y-axis
-			spherical.setFromVector3(offset);
+			this.enableZoom = true;
+			this.zoomSpeed = 1.0; // Set to false to disable rotating
 
-			if (scope.autoRotate && state === STATE.NONE) {
-				rotateLeft(getAutoRotationAngle());
-			}
+			this.enableRotate = true;
+			this.rotateSpeed = 1.0; // Set to false to disable panning
 
-			spherical.theta += sphericalDelta.theta;
-			spherical.phi += sphericalDelta.phi;
+			this.enablePan = true;
+			this.panSpeed = 1.0;
+			this.screenSpacePanning = true; // if false, pan orthogonal to world-space direction camera.up
 
-			// restrict theta to be between desired limits
-			spherical.theta = Math.max(scope.minAzimuthAngle, Math.min(scope.maxAzimuthAngle, spherical.theta));
+			this.keyPanSpeed = 7.0; // pixels moved per arrow key push
+			this.keyRotateSpeed = 9.0;	// pixels moved per arrow key push
 
-			// restrict phi to be between desired limits
-			spherical.phi = Math.max(scope.minPolarAngle, Math.min(scope.maxPolarAngle, spherical.phi));
+			// Set to true to automatically rotate around the target
+			// If auto-rotate is enabled, you must call controls.update() in your animation loop
+			this.autoRotate = false;
+			this.autoRotateSpeed = 2.0; // 30 seconds per orbit when fps is 60
 
-			spherical.makeSafe();
-			spherical.radius *= scale;
+			// The keyboard keys
+			this.keys = {
+				LEFT: 37,
+				UP: 38,
+				RIGHT: 39,
+				DOWN: 40,
+				PLUS: 187,
+				MINUS: 189,
+				NUMPLUS: 107,
+				NUMMINUS: 109
+			};
 
-			// restrict radius to be between desired limits
-			spherical.radius = Math.max(scope.minDistance, Math.min(scope.maxDistance, spherical.radius));
+			// Mouse buttons
+			this.mouseButtons = {
+				LEFT: THREE.MOUSE.ROTATE,
+				MIDDLE: THREE.MOUSE.DOLLY,
+				RIGHT: THREE.MOUSE.PAN
+			};
 
-			// move target to panned location
-			scope.target.add(panOffset);
+			// Touch fingers
+			this.touches = {
+				ONE: THREE.TOUCH.ROTATE,
+				TWO: THREE.TOUCH.DOLLY_PAN
+			};
 
-			offset.setFromSpherical(spherical);
+			// for reset
+			this.target0 = this.target.clone();
+			this.position0 = this.object.position.clone();
+			this.zoom0 = this.object.zoom; // the target DOM element for key events
 
-			// rotate offset back to "camera-up-vector-is-up" space
-			offset.applyQuaternion(quatInverse);
+			this._domElementKeyEvents = null; //
+			// public methods
+			//
 
-			position.copy(scope.target).add(offset);
-			scope.object.lookAt(scope.target);
+			this.getPolarAngle = function () {
 
-			if (scope.enableDamping === true) {
-				sphericalDelta.theta *= (1 - scope.dampingFactor);
-				sphericalDelta.phi *= (1 - scope.dampingFactor);
-			} else {
-				sphericalDelta.set(0, 0, 0);
-			}
+				return spherical.phi;
 
-			scale = 1;
-			panOffset.set(0, 0, 0);
+			};
 
-			// update condition is:
-			// min(camera displacement, camera rotation in radians)^2 > EPS
-			// using small-angle approximation cos(x/2) = 1 - x^2 / 8
+			this.getAzimuthalAngle = function () {
 
-			if (zoomChanged ||
-				lastPosition.distanceToSquared(scope.object.position) > EPS ||
-				8 * (1 - lastQuaternion.dot(scope.object.quaternion)) > EPS) {
+				return spherical.theta;
 
-				changeEvent.tag = tag;
-				scope.dispatchEvent(changeEvent);
-				delete changeEvent.tag;
+			};
 
-				lastPosition.copy(scope.object.position);
-				lastQuaternion.copy(scope.object.quaternion);
-				zoomChanged = false;
+			this.getDistance = function () {
 
-				return true;
-			}
-			return false;
-		};
-	}();
+				return this.object.position.distanceTo( this.target );
 
-	this.dispose = function () {
-		scope.domElement.removeEventListener('contextmenu', onContextMenu, false);
-		scope.domElement.removeEventListener('mousedown', onMouseDown, false);
-		scope.domElement.removeEventListener('wheel', onMouseWheel, false);
+			};
 
-		scope.domElement.removeEventListener('touchstart', onTouchStart, false);
-		scope.domElement.removeEventListener('touchend', onTouchEnd, false);
-		scope.domElement.removeEventListener('touchmove', onTouchMove, false);
+			this.listenToKeyEvents = function ( domElement ) {
 
-		document.removeEventListener('mousemove', onMouseMove, false);
-		document.removeEventListener('mouseup', onMouseUp, false);
+				domElement.addEventListener( 'keydown', onKeyDown );
+				this._domElementKeyEvents = domElement;
 
-		window.removeEventListener('keydown', onKeyDown, false);
+			};
 
-		// scope.dispatchEvent( { type: 'dispose' } ); // should this be added here?
-	};
-	// internals
-	var scope = this;
+			this.saveState = function () {
+				const state = {};
 
-	var changeEvent = { type: 'change' };
-	var startEvent = { type: 'start' };
-	var endEvent = { type: 'end' };
+				state.target = scope.target.clone();
+				state.position = scope.object.position.clone();
+				state.zoom = scope.object.zoom;
 
-	var STATE = { NONE: - 1, ROTATE: 0, DOLLY: 1, PAN: 2, TOUCH_ROTATE: 3, TOUCH_DOLLY: 4, TOUCH_PAN: 5 };
+				return state;
+			};
 
-	var state = STATE.NONE;
+			this.reset = function (state) {
+				scope.target.copy(state ? state.target : scope.target0);
+				scope.object.position.copy(state ? state.position: scope.position0);
+				scope.object.zoom = state ? state.zoom : scope.zoom0;
 
-	var EPS = 0.000001;
+				scope.object.updateProjectionMatrix();
+				scope.dispatchEvent(_changeEvent);
+				scope.update();
 
-	// current position in spherical coordinates
-	var spherical = new THREE.Spherical();
-	var sphericalDelta = new THREE.Spherical();
+				state = STATE.NONE;
+			};
 
-	var scale = 1;
-	var panOffset = new THREE.Vector3();
-	var zoomChanged = false;
 
-	var rotateStart = new THREE.Vector2();
-	var rotateEnd = new THREE.Vector2();
-	var rotateDelta = new THREE.Vector2();
+			this.update = function (tag) {
 
-	var panStart = new THREE.Vector2();
-	var panEnd = new THREE.Vector2();
-	var panDelta = new THREE.Vector2();
+				const offset = new THREE.Vector3(); // so camera.up is the orbit axis
 
-	var dollyStart = new THREE.Vector2();
-	var dollyEnd = new THREE.Vector2();
-	var dollyDelta = new THREE.Vector2();
+				const quat = new THREE.Quaternion().setFromUnitVectors( object.up, new THREE.Vector3( 0, 1, 0 ) );
+				const quatInverse = quat.clone().invert();
+				const lastPosition = new THREE.Vector3();
+				const lastQuaternion = new THREE.Quaternion();
+				const twoPI = 2 * Math.PI;
+				return function update(tag) {
 
-	function getAutoRotationAngle() {
-		return 2 * Math.PI / 60 / 60 * scope.autoRotateSpeed;
-	}
+					const position = scope.object.position;
+					offset.copy( position ).sub( scope.target ); // rotate offset to "y-axis-is-up" space
 
-	function getZoomScale() {
-		return Math.pow(0.95, scope.zoomSpeed);
-	}
+					offset.applyQuaternion( quat ); // angle from z-axis around y-axis
 
-	function rotateLeft(angle) {
-		sphericalDelta.theta -= angle;
-	}
+					spherical.setFromVector3( offset );
 
-	function rotateUp(angle) {
-		sphericalDelta.phi -= angle;
-	}
+					if ( scope.autoRotate && state === STATE.NONE ) {
 
-	var panLeft = function () {
-		var v = new THREE.Vector3();
-
-		return function panLeft(distance, objectMatrix) {
-			v.setFromMatrixColumn(objectMatrix, 0); // get X column of objectMatrix
-			v.multiplyScalar(- distance);
-
-			panOffset.add(v);
-		};
-	}();
-
-	var panUp = function () {
-		var v = new THREE.Vector3();
-
-		return function panUp(distance, objectMatrix) {
-			v.setFromMatrixColumn(objectMatrix, 1); // get Y column of objectMatrix
-			v.multiplyScalar(distance);
-
-			panOffset.add(v);
-		};
-	}();
-
-	// deltaX and deltaY are in pixels; right and down are positive
-	var pan = function () {
-		var offset = new THREE.Vector3();
-		var element = scope.domElement === document ? scope.domElement.body : scope.domElement;
-
-		return function pan(deltaX, deltaY) {
-			if (scope.object.isPerspectiveCamera) {
-				// perspective
-				var position = scope.object.position;
-				offset.copy(position).sub(scope.target);
-				var targetDistance = offset.length();
-
-				// half of the fov is center to top of screen
-				targetDistance *= Math.tan((scope.object.fov / 2) * Math.PI / 180.0);
-
-				// we actually don't use screenWidth, since perspective camera is fixed to screen height
-				panLeft(2 * deltaX * targetDistance / element.clientHeight, scope.object.matrix);
-				panUp(2 * deltaY * targetDistance / element.clientHeight, scope.object.matrix);
-			} else if (scope.object.isOrthographicCamera) {
-				// orthographic
-				panLeft(deltaX * (scope.object.right - scope.object.left) / scope.object.zoom / element.clientWidth, scope.object.matrix);
-				panUp(deltaY * (scope.object.top - scope.object.bottom) / scope.object.zoom / element.clientHeight, scope.object.matrix);
-			} else {
-				// camera neither orthographic nor perspective
-				console.warn('WARNING: OrbitControls.js encountered an unknown camera type - pan disabled.');
-				scope.enablePan = false;
-			}
-		};
-	}();
-
-	// deltaX and deltaY are in pixels; right and down are positive
-	var rotate = function () {
-		var element = scope.domElement === document ? scope.domElement.body : scope.domElement;
-
-		return function rotate(deltaX, deltaY) {
-			// rotating across whole screen goes 360 degrees around
-			rotateLeft(2 * Math.PI * deltaX / element.clientWidth * scope.rotateSpeed);
-
-			// rotating up and down along whole screen attempts to go 360, but limited to 180
-			rotateUp(2 * Math.PI * deltaY / element.clientHeight * scope.rotateSpeed);
-			};
-	}();
-
-	function dollyIn(dollyScale) {
-		if (scope.object.isPerspectiveCamera) {
-			scale /= dollyScale;
-		} else if (scope.object.isOrthographicCamera) {
-			scope.object.zoom = Math.max(scope.minZoom, Math.min(scope.maxZoom, scope.object.zoom * dollyScale));
-			scope.object.updateProjectionMatrix();
-			zoomChanged = true;
-		} else {
-			console.warn('WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.');
-			scope.enableZoom = false;
-		}
-	}
+						rotateLeft( getAutoRotationAngle() );
 
-	function dollyOut(dollyScale) {
-		if (scope.object.isPerspectiveCamera) {
-			scale *= dollyScale;
-		} else if (scope.object.isOrthographicCamera) {
-			scope.object.zoom = Math.max(scope.minZoom, Math.min(scope.maxZoom, scope.object.zoom / dollyScale));
-			scope.object.updateProjectionMatrix();
-			zoomChanged = true;
-		} else {
-			console.warn('WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.');
-			scope.enableZoom = false;
-		}
-	}
-	// event callbacks - update the object state
+					}
 
-	function handleMouseDownRotate(event) {
-		// console.log( 'handleMouseDownRotate' );
-		rotateStart.set(event.clientX, event.clientY);
-	}
+					if ( scope.enableDamping ) {
 
-	function handleMouseDownDolly(event) {
-		// console.log( 'handleMouseDownDolly' );
-		dollyStart.set(event.clientX, event.clientY);
-	}
+						spherical.theta += sphericalDelta.theta * scope.dampingFactor;
+						spherical.phi += sphericalDelta.phi * scope.dampingFactor;
 
-	function handleMouseDownPan(event) {
-		// console.log( 'handleMouseDownPan' );
-		panStart.set(event.clientX, event.clientY);
-	}
+					} else {
 
-	function handleMouseMoveRotate(event) {
-		// console.log( 'handleMouseMoveRotate' );
-		rotateEnd.set(event.clientX, event.clientY);
-		rotateDelta.subVectors(rotateEnd, rotateStart);
+						spherical.theta += sphericalDelta.theta;
+						spherical.phi += sphericalDelta.phi;
 
-		var element = scope.domElement === document ? scope.domElement.body : scope.domElement;
+					} // restrict theta to be between desired limits
 
-		// rotating across whole screen goes 360 degrees around
-		rotateLeft(2 * Math.PI * rotateDelta.x / element.clientWidth * scope.rotateSpeed);
 
-		// rotating up and down along whole screen attempts to go 360, but limited to 180
-		rotateUp(2 * Math.PI * rotateDelta.y / element.clientHeight * scope.rotateSpeed);
+					let min = scope.minAzimuthAngle;
+					let max = scope.maxAzimuthAngle;
 
-		rotateStart.copy(rotateEnd);
+					if ( isFinite( min ) && isFinite( max ) ) {
 
-		scope.update();
-	}
+						if ( min < - Math.PI ) min += twoPI; else if ( min > Math.PI ) min -= twoPI;
+						if ( max < - Math.PI ) max += twoPI; else if ( max > Math.PI ) max -= twoPI;
 
-	function handleMouseMoveDolly(event) {
-		// console.log( 'handleMouseMoveDolly' );
-		dollyEnd.set(event.clientX, event.clientY);
+						if ( min <= max ) {
 
-		dollyDelta.subVectors(dollyEnd, dollyStart);
+							spherical.theta = Math.max( min, Math.min( max, spherical.theta ) );
 
-		if (dollyDelta.y > 0) {
-			dollyIn(getZoomScale());
-		} else if (dollyDelta.y < 0) {
-			dollyOut(getZoomScale());
-		}
-		dollyStart.copy(dollyEnd);
+						} else {
 
-		scope.update();
-	}
+							spherical.theta = spherical.theta > ( min + max ) / 2 ? Math.max( min, spherical.theta ) : Math.min( max, spherical.theta );
 
-	function handleMouseMovePan(event) {
-		// console.log( 'handleMouseMovePan' );
-		panEnd.set(event.clientX, event.clientY);
-		panDelta.subVectors(panEnd, panStart);
-		pan(panDelta.x, panDelta.y);
-		panStart.copy(panEnd);
-		scope.update();
-	}
+						}
 
-	function handleMouseUp(event) {
-		// console.log( 'handleMouseUp' );
-	}
+					} // restrict phi to be between desired limits
 
-	function handleMouseWheel(event) {
-		// console.log( 'handleMouseWheel' );
-		if (event.deltaY < 0) {
-			dollyOut(getZoomScale());
-			scope.update(scope.keys.PLUS);
-		} else if (event.deltaY > 0) {
-			dollyIn(getZoomScale());
-			scope.update(scope.keys.MINUS);
-		}
-	}
 
-	function handleKeyDown(event) {
-		// console.log( 'handleKeyDown' );
+					spherical.phi = Math.max( scope.minPolarAngle, Math.min( scope.maxPolarAngle, spherical.phi ) );
+					spherical.makeSafe();
+					spherical.radius *= scale; // restrict radius to be between desired limits
+
+					spherical.radius = Math.max( scope.minDistance, Math.min( scope.maxDistance, spherical.radius ) ); // move target to panned location
+
+					if ( scope.enableDamping === true ) {
+
+						scope.target.addScaledVector( panOffset, scope.dampingFactor );
+
+					} else {
+
+						scope.target.add( panOffset );
 
-		switch (event.keyCode) {
-			case scope.keys.UP:
-				if (event.shiftKey) {
-					if (scope.enableRotate) {
-						rotate(0, scope.keyRotateSpeed);
 					}
-				} else if (scope.enablePan) {
-					pan(0, scope.keyPanSpeed);
-				}
-				scope.update(scope.keys.UP);
-				break;
-			case scope.keys.DOWN:
-				if (event.shiftKey) {
-					if (scope.enableRotate) {
-						rotate(0, - scope.keyRotateSpeed);
+
+					offset.setFromSpherical( spherical ); // rotate offset back to "camera-up-vector-is-up" space
+
+					offset.applyQuaternion( quatInverse );
+					position.copy( scope.target ).add( offset );
+					scope.object.lookAt( scope.target );
+
+					if ( scope.enableDamping === true ) {
+
+						sphericalDelta.theta *= 1 - scope.dampingFactor;
+						sphericalDelta.phi *= 1 - scope.dampingFactor;
+						panOffset.multiplyScalar( 1 - scope.dampingFactor );
+
+					} else {
+
+						sphericalDelta.set( 0, 0, 0 );
+						panOffset.set( 0, 0, 0 );
+
 					}
-				} else if (scope.enablePan) {
-					pan(0, - scope.keyPanSpeed);
-				}
-				scope.update(scope.keys.DOWN);
-				break;
-			case scope.keys.LEFT:
-				if (event.shiftKey) {
-					if (scope.enableRotate) {
-						rotate(scope.keyRotateSpeed, 0);
+
+					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 ( zoomChanged || lastPosition.distanceToSquared( scope.object.position ) > EPS || 8 * ( 1 - lastQuaternion.dot( scope.object.quaternion ) ) > EPS ) {
+						_changeEvent.tag = tag;
+						scope.dispatchEvent( _changeEvent );
+						delete _changeEvent.tag;
+
+						lastPosition.copy( scope.object.position );
+						lastQuaternion.copy( scope.object.quaternion );
+						zoomChanged = false;
+
+						return true;
 					}
-				} else if (scope.enablePan) {
-					pan(scope.keyPanSpeed, 0);
-				}
-				scope.update(scope.keys.LEFT);
-				break;
-			case scope.keys.RIGHT:
-				if (event.shiftKey) {
-					if (scope.enableRotate) {
-						rotate(-scope.keyRotateSpeed, 0);
+
+					return false;
+
+				};
+
+			}();
+
+			this.dispose = function () {
+
+				scope.domElement.removeEventListener( 'contextmenu', onContextMenu );
+				scope.domElement.removeEventListener( 'pointerdown', onPointerDown );
+				scope.domElement.removeEventListener( 'pointercancel', onPointerCancel );
+				scope.domElement.removeEventListener( 'wheel', onMouseWheel );
+				scope.domElement.removeEventListener( 'pointermove', onPointerMove );
+				scope.domElement.removeEventListener( 'pointerup', onPointerUp );
+
+				if ( scope._domElementKeyEvents !== null ) {
+
+					scope._domElementKeyEvents.removeEventListener( 'keydown', onKeyDown );
+
+				} //scope.dispatchEvent( { type: 'dispose' } ); // should this be added here?
+
+			}; //
+			// internals
+			//
+
+
+			const scope = this;
+			const STATE = {
+				NONE: - 1,
+				ROTATE: 0,
+				DOLLY: 1,
+				PAN: 2,
+				TOUCH_ROTATE: 3,
+				TOUCH_PAN: 4,
+				TOUCH_DOLLY_PAN: 5,
+				TOUCH_DOLLY_ROTATE: 6
+			};
+			let state = STATE.NONE;
+			const EPS = 0.000001; // current position in spherical coordinates
+
+			const spherical = new THREE.Spherical();
+			const sphericalDelta = new THREE.Spherical();
+			let scale = 1;
+			const panOffset = new THREE.Vector3();
+			let zoomChanged = false;
+			const rotateStart = new THREE.Vector2();
+			const rotateEnd = new THREE.Vector2();
+			const rotateDelta = new THREE.Vector2();
+			const panStart = new THREE.Vector2();
+			const panEnd = new THREE.Vector2();
+			const panDelta = new THREE.Vector2();
+			const dollyStart = new THREE.Vector2();
+			const dollyEnd = new THREE.Vector2();
+			const dollyDelta = new THREE.Vector2();
+			const pointers = [];
+			const pointerPositions = {};
+
+			function getAutoRotationAngle() {
+
+				return 2 * Math.PI / 60 / 60 * scope.autoRotateSpeed;
+
+			}
+
+			function getZoomScale() {
+
+				return Math.pow( 0.95, scope.zoomSpeed );
+
+			}
+
+			function rotateLeft( angle ) {
+
+				sphericalDelta.theta -= angle;
+
+			}
+
+			function rotateUp( angle ) {
+
+				sphericalDelta.phi -= angle;
+
+			}
+
+			const panLeft = function () {
+
+				const v = new THREE.Vector3();
+				return function panLeft( distance, objectMatrix ) {
+
+					v.setFromMatrixColumn( objectMatrix, 0 ); // get X column of objectMatrix
+
+					v.multiplyScalar( - distance );
+					panOffset.add( v );
+
+				};
+
+			}();
+
+			const panUp = function () {
+
+				const v = new THREE.Vector3();
+				return function panUp( distance, objectMatrix ) {
+
+					if ( scope.screenSpacePanning === true ) {
+
+						v.setFromMatrixColumn( objectMatrix, 1 );
+
+					} else {
+
+						v.setFromMatrixColumn( objectMatrix, 0 );
+						v.crossVectors( scope.object.up, v );
+
 					}
-				} else if (scope.enablePan) {
-					pan(- scope.keyPanSpeed, 0);
-				}
-				scope.update(scope.keys.RIGHT);
-				break;
-			case scope.keys.MINUS:
-			case scope.keys.NUMMINUS:
-				if (scope.enableZoom) {
-					dollyIn(getZoomScale());
+
+					v.multiplyScalar( distance );
+					panOffset.add( v );
+
+				};
+
+			}(); // deltaX and deltaY are in pixels; right and down are positive
+
+
+			const pan = function () {
+
+				const offset = new THREE.Vector3();
+				return function pan( deltaX, deltaY ) {
+
+					const element = scope.domElement;
+
+					if ( scope.object.isPerspectiveCamera ) {
+
+						// perspective
+						const position = scope.object.position;
+						offset.copy( position ).sub( scope.target );
+						let targetDistance = offset.length(); // half of the fov is center to top of screen
+
+						targetDistance *= Math.tan( scope.object.fov / 2 * Math.PI / 180.0 ); // we use only clientHeight here so aspect ratio does not distort speed
+
+						panLeft( 2 * deltaX * targetDistance / element.clientHeight, scope.object.matrix );
+						panUp( 2 * deltaY * targetDistance / element.clientHeight, scope.object.matrix );
+
+					} else if ( scope.object.isOrthographicCamera ) {
+
+						// orthographic
+						panLeft( deltaX * ( scope.object.right - scope.object.left ) / scope.object.zoom / element.clientWidth, scope.object.matrix );
+						panUp( deltaY * ( scope.object.top - scope.object.bottom ) / scope.object.zoom / element.clientHeight, scope.object.matrix );
+
+					} else {
+
+						// camera neither orthographic nor perspective
+						console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - pan disabled.' );
+						scope.enablePan = false;
+
+					}
+
+				};
+
+			}();
+
+			// deltaX and deltaY are in pixels; right and down are positive
+			const rotate = function () {
+				const element = scope.domElement;
+
+				return function rotate(deltaX, deltaY) {
+					// rotating across whole screen goes 360 degrees around
+					rotateLeft(2 * Math.PI * deltaX / element.clientWidth * scope.rotateSpeed);
+
+					// rotating up and down along whole screen attempts to go 360, but limited to 180
+					rotateUp(2 * Math.PI * deltaY / element.clientHeight * scope.rotateSpeed);
+				};
+			}();
+
+			function dollyOut( dollyScale ) {
+
+				if ( scope.object.isPerspectiveCamera ) {
+
+					scale /= dollyScale;
+
+				} else if ( scope.object.isOrthographicCamera ) {
+
+					scope.object.zoom = Math.max( scope.minZoom, Math.min( scope.maxZoom, scope.object.zoom * dollyScale ) );
+					scope.object.updateProjectionMatrix();
+					zoomChanged = true;
+
+				} else {
+
+					console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.' );
+					scope.enableZoom = false;
+
 				}
-				scope.update(scope.keys.MINUS);
-				break;
-			case scope.keys.PLUS:
-			case scope.keys.NUMPLUS:
-				if (scope.enableZoom) {
-					dollyOut(getZoomScale());
+
+			}
+
+			function dollyIn( dollyScale ) {
+
+				if ( scope.object.isPerspectiveCamera ) {
+
+					scale *= dollyScale;
+
+				} else if ( scope.object.isOrthographicCamera ) {
+
+					scope.object.zoom = Math.max( scope.minZoom, Math.min( scope.maxZoom, scope.object.zoom / dollyScale ) );
+					scope.object.updateProjectionMatrix();
+					zoomChanged = true;
+
+				} else {
+
+					console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.' );
+					scope.enableZoom = false;
+
 				}
-				scope.update(scope.keys.PLUS);
-				break;
+
+			} //
+			// event callbacks - update the object state
+			//
+
+
+			function handleMouseDownRotate( event ) {
+
+				rotateStart.set( event.clientX, event.clientY );
+
 			}
-	}
 
-	function handleTouchStartRotate(event) {
-		// console.log( 'handleTouchStartRotate' );
-		rotateStart.set(event.touches[0].pageX, event.touches[0].pageY);
-	}
+			function handleMouseDownDolly( event ) {
 
-	function handleTouchStartDolly(event) {
-		// console.log( 'handleTouchStartDolly' );
-		var dx = event.touches[0].pageX - event.touches[1].pageX;
-		var dy = event.touches[0].pageY - event.touches[1].pageY;
+				dollyStart.set( event.clientX, event.clientY );
 
-		var distance = Math.sqrt(dx * dx + dy * dy);
+			}
 
-		dollyStart.set(0, distance);
-	}
+			function handleMouseDownPan( event ) {
 
-	function handleTouchStartPan(event) {
-		// console.log( 'handleTouchStartPan' );
-		panStart.set(event.touches[0].pageX, event.touches[0].pageY);
-	}
+				panStart.set( event.clientX, event.clientY );
 
-	function handleTouchMoveRotate(event) {
-		// console.log( 'handleTouchMoveRotate' );
-		rotateEnd.set(event.touches[0].pageX, event.touches[0].pageY);
-		rotateDelta.subVectors(rotateEnd, rotateStart);
+			}
 
-		var element = scope.domElement === document ? scope.domElement.body : scope.domElement;
+			function handleMouseMoveRotate( event ) {
 
-		// rotating across whole screen goes 360 degrees around
-		rotateLeft(2 * Math.PI * rotateDelta.x / element.clientWidth * scope.rotateSpeed);
+				rotateEnd.set( event.clientX, event.clientY );
+				rotateDelta.subVectors( rotateEnd, rotateStart ).multiplyScalar( scope.rotateSpeed );
+				const element = scope.domElement;
+				rotateLeft( 2 * Math.PI * rotateDelta.x / element.clientHeight ); // yes, height
 
-		// rotating up and down along whole screen attempts to go 360, but limited to 180
-		rotateUp(2 * Math.PI * rotateDelta.y / element.clientHeight * scope.rotateSpeed);
+				rotateUp( 2 * Math.PI * rotateDelta.y / element.clientHeight );
+				rotateStart.copy( rotateEnd );
+				scope.update();
 
-		rotateStart.copy(rotateEnd);
+			}
 
-		scope.update();
-	}
+			function handleMouseMoveDolly( event ) {
 
-	function handleTouchMoveDolly(event) {
-		// console.log( 'handleTouchMoveDolly' );
-		var dx = event.touches[0].pageX - event.touches[1].pageX;
-		var dy = event.touches[0].pageY - event.touches[1].pageY;
+				dollyEnd.set( event.clientX, event.clientY );
+				dollyDelta.subVectors( dollyEnd, dollyStart );
 
-		var distance = Math.sqrt(dx * dx + dy * dy);
+				if ( dollyDelta.y > 0 ) {
 
-		dollyEnd.set(0, distance);
+					dollyOut( getZoomScale() );
 
-		dollyDelta.subVectors(dollyEnd, dollyStart);
+				} else if ( dollyDelta.y < 0 ) {
 
-		if (dollyDelta.y > 0) {
-			dollyOut(getZoomScale());
-		} else if (dollyDelta.y < 0) {
-			dollyIn(getZoomScale());
-		}
+					dollyIn( getZoomScale() );
 
-		dollyStart.copy(dollyEnd);
+				}
 
-		scope.update();
-	}
+				dollyStart.copy( dollyEnd );
+				scope.update();
 
-	function handleTouchMovePan(event) {
-		// console.log( 'handleTouchMovePan' );
-		panEnd.set(event.touches[0].pageX, event.touches[0].pageY);
+			}
 
-		panDelta.subVectors(panEnd, panStart);
+			function handleMouseMovePan( event ) {
 
-		pan(panDelta.x, panDelta.y);
+				panEnd.set( event.clientX, event.clientY );
+				panDelta.subVectors( panEnd, panStart ).multiplyScalar( scope.panSpeed );
+				pan( panDelta.x, panDelta.y );
+				panStart.copy( panEnd );
+				scope.update();
 
-		panStart.copy(panEnd);
+			}
 
-		scope.update();
-	}
+			function handleMouseUp() { // no-op
+			}
 
-	function handleTouchEnd(event) {
-		// console.log( 'handleTouchEnd' );
-	}
+			function handleMouseWheel( event ) {
+
+				if ( event.deltaY < 0 ) {
+					dollyIn( getZoomScale() );
+					scope.update(scope.keys.PLUS);
+				} else if ( event.deltaY > 0 ) {
+					dollyOut( getZoomScale() );
+					scope.update(scope.keys.MINUS);
+				}
 
-	// event handlers - FSM: listen for events and reset state
+			}
 
-	function onMouseDown(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		switch (event.button) {
-			case scope.mouseButtons.ORBIT:
-				if (scope.enableRotate === false) {
-					return;
+			function handleKeyDown( event ) {
+
+				let needsUpdate = true;
+
+				switch ( event.keyCode ) {
+
+					case scope.keys.UP:
+						if (event.shiftKey) {
+							if (scope.enableRotate) {
+								rotate(0, scope.keyRotateSpeed);
+							}
+						} else if (scope.enablePan) {
+							pan( 0, scope.keyPanSpeed );
+						}
+						break;
+
+					case scope.keys.DOWN:
+						if (event.shiftKey) {
+							if (scope.enableRotate) {
+								rotate(0, - scope.keyRotateSpeed);
+							}
+						} else if (scope.enablePan) {
+							pan( 0, - scope.keyPanSpeed );
+						}
+						break;
+
+					case scope.keys.LEFT:
+						if (event.shiftKey) {
+							if (scope.enableRotate) {
+								rotate(scope.keyRotateSpeed, 0);
+							}
+						} else if (scope.enablePan) {
+							pan( scope.keyPanSpeed, 0 );
+						}
+						break;
+
+					case scope.keys.RIGHT:
+						if (event.shiftKey) {
+							if (scope.enableRotate) {
+								rotate(-scope.keyRotateSpeed, 0);
+							}
+						} else if (scope.enablePan) {
+							pan( - scope.keyPanSpeed, 0 );
+						}
+						break;
+
+					case scope.keys.MINUS:
+					case scope.keys.NUMMINUS:
+						dollyOut(getZoomScale());
+						break;
+
+					case scope.keys.PLUS:
+					case scope.keys.NUMPLUS:
+						dollyIn(getZoomScale());
+						break;
+
+					default:
+						needsUpdate = false;
 				}
-				handleMouseDownRotate(event);
-				state = STATE.ROTATE;
-				break;
-			case scope.mouseButtons.ZOOM:
-				if (scope.enableZoom === false) {
-					return;
+
+				if ( needsUpdate ) {
+
+					// prevent the browser from scrolling on cursor keys
+					event.preventDefault();
+					scope.update(event.keyCode);
+
 				}
-				handleMouseDownDolly(event);
-				state = STATE.DOLLY;
-				break;
-			case scope.mouseButtons.PAN:
-				if (scope.enablePan === false) {
-					return;
+
+			}
+
+			function handleTouchStartRotate() {
+
+				if ( pointers.length === 1 ) {
+
+					rotateStart.set( pointers[ 0 ].pageX, pointers[ 0 ].pageY );
+
+				} else {
+
+					const x = 0.5 * ( pointers[ 0 ].pageX + pointers[ 1 ].pageX );
+					const y = 0.5 * ( pointers[ 0 ].pageY + pointers[ 1 ].pageY );
+					rotateStart.set( x, y );
+
 				}
-				handleMouseDownPan(event);
-				state = STATE.PAN;
-				break;
-		}
 
-		if (state !== STATE.NONE) {
-			document.addEventListener('mousemove', onMouseMove, false);
-			document.addEventListener('mouseup', onMouseUp, false);
-			scope.dispatchEvent(startEvent);
-		}
-	}
+			}
+
+			function handleTouchStartPan() {
+
+				if ( pointers.length === 1 ) {
+
+					panStart.set( pointers[ 0 ].pageX, pointers[ 0 ].pageY );
+
+				} else {
+
+					const x = 0.5 * ( pointers[ 0 ].pageX + pointers[ 1 ].pageX );
+					const y = 0.5 * ( pointers[ 0 ].pageY + pointers[ 1 ].pageY );
+					panStart.set( x, y );
 
-	function onMouseMove(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		switch (state) {
-			case STATE.ROTATE:
-				if (scope.enableRotate === false) {
-					return;
 				}
-				handleMouseMoveRotate(event);
-				event.preventDefault();
-				break;
-			case STATE.DOLLY:
-				if (scope.enableZoom === false) {
-					return;
+
+			}
+
+			function handleTouchStartDolly() {
+
+				const dx = pointers[ 0 ].pageX - pointers[ 1 ].pageX;
+				const dy = pointers[ 0 ].pageY - pointers[ 1 ].pageY;
+				const distance = Math.sqrt( dx * dx + dy * dy );
+				dollyStart.set( 0, distance );
+
+			}
+
+			function handleTouchStartDollyPan() {
+
+				if ( scope.enableZoom ) handleTouchStartDolly();
+				if ( scope.enablePan ) handleTouchStartPan();
+
+			}
+
+			function handleTouchStartDollyRotate() {
+
+				if ( scope.enableZoom ) handleTouchStartDolly();
+				if ( scope.enableRotate ) handleTouchStartRotate();
+
+			}
+
+			function handleTouchMoveRotate( event ) {
+
+				if ( pointers.length == 1 ) {
+
+					rotateEnd.set( event.pageX, event.pageY );
+
+				} else {
+
+					const position = getSecondPointerPosition( event );
+					const x = 0.5 * ( event.pageX + position.x );
+					const y = 0.5 * ( event.pageY + position.y );
+					rotateEnd.set( x, y );
+
 				}
-				handleMouseMoveDolly(event);
-				event.preventDefault();
-				break;
-			case STATE.PAN:
-				if (scope.enablePan === false) {
-					return;
+
+				rotateDelta.subVectors( rotateEnd, rotateStart ).multiplyScalar( scope.rotateSpeed );
+				const element = scope.domElement;
+				rotateLeft( 2 * Math.PI * rotateDelta.x / element.clientHeight ); // yes, height
+
+				rotateUp( 2 * Math.PI * rotateDelta.y / element.clientHeight );
+				rotateStart.copy( rotateEnd );
+
+			}
+
+			function handleTouchMovePan( event ) {
+
+				if ( pointers.length === 1 ) {
+
+					panEnd.set( event.pageX, event.pageY );
+
+				} else {
+
+					const position = getSecondPointerPosition( event );
+					const x = 0.5 * ( event.pageX + position.x );
+					const y = 0.5 * ( event.pageY + position.y );
+					panEnd.set( x, y );
+
 				}
-				handleMouseMovePan(event);
-				event.preventDefault();
-				break;
-		}
-	}
 
-	function onMouseUp(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		handleMouseUp(event);
+				panDelta.subVectors( panEnd, panStart ).multiplyScalar( scope.panSpeed );
+				pan( panDelta.x, panDelta.y );
+				panStart.copy( panEnd );
 
-		document.removeEventListener('mousemove', onMouseMove, false);
-		document.removeEventListener('mouseup', onMouseUp, false);
+			}
 
-		scope.dispatchEvent(endEvent);
+			function handleTouchMoveDolly( event ) {
 
-		state = STATE.NONE;
-	}
+				const position = getSecondPointerPosition( event );
+				const dx = event.pageX - position.x;
+				const dy = event.pageY - position.y;
+				const distance = Math.sqrt( dx * dx + dy * dy );
+				dollyEnd.set( 0, distance );
+				dollyDelta.set( 0, Math.pow( dollyEnd.y / dollyStart.y, scope.zoomSpeed ) );
+				dollyOut( dollyDelta.y );
+				dollyStart.copy( dollyEnd );
 
-	function onMouseWheel(event) {
-		if (scope.enabled === false || scope.enableZoom === false || (state !== STATE.NONE && state !== STATE.ROTATE)) {
-			return;
-		}
-		event.preventDefault();
-		event.stopPropagation();
+			}
 
-		handleMouseWheel(event);
+			function handleTouchMoveDollyPan( event ) {
 
-		scope.dispatchEvent(startEvent); // not sure why these are here...
-		scope.dispatchEvent(endEvent);
-	}
+				if ( scope.enableZoom ) handleTouchMoveDolly( event );
+				if ( scope.enablePan ) handleTouchMovePan( event );
 
-	function onKeyDown(event) {
-		if (scope.enabled === false || scope.enableKeys === false || scope.enablePan === false) {
-			return;
-		}
-		handleKeyDown(event);
-	}
+			}
+
+			function handleTouchMoveDollyRotate( event ) {
+
+				if ( scope.enableZoom ) handleTouchMoveDolly( event );
+				if ( scope.enableRotate ) handleTouchMoveRotate( event );
+
+			}
+
+			function handleTouchEnd() { // no-op
+			} //
+			// event handlers - FSM: listen for events and reset state
+			//
+
+
+			function onPointerDown( event ) {
+
+				if ( scope.enabled === false ) return;
+
+				if ( pointers.length === 0 ) {
+
+					scope.domElement.setPointerCapture( event.pointerId );
+					scope.domElement.addEventListener( 'pointermove', onPointerMove );
+					scope.domElement.addEventListener( 'pointerup', onPointerUp );
+
+				} //
+
+
+				addPointer( event );
+
+				if ( event.pointerType === 'touch' ) {
+
+					onTouchStart( event );
+
+				} else {
+
+					onMouseDown( event );
 
-	function onTouchStart(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		switch (event.touches.length) {
-			case 1:	// one-fingered touch: rotate
-				if (scope.enableRotate === false) {
-					return;
 				}
-				handleTouchStartRotate(event);
-				state = STATE.TOUCH_ROTATE;
-				break;
-			case 2:	// two-fingered touch: dolly
-				if (scope.enableZoom === false) {
-					return;
+
+			}
+
+			function onPointerMove( event ) {
+
+				if ( scope.enabled === false ) return;
+
+				if ( event.pointerType === 'touch' ) {
+
+					onTouchMove( event );
+
+				} else {
+
+					onMouseMove( event );
+
 				}
-				handleTouchStartDolly(event);
-				state = STATE.TOUCH_DOLLY;
-				break;
-			case 3: // three-fingered touch: pan
-				if (scope.enablePan === false) {
-					return;
+
+			}
+
+			function onPointerUp( event ) {
+
+				if ( scope.enabled === false ) return;
+
+				if ( event.pointerType === 'touch' ) {
+
+					onTouchEnd();
+
+				} else {
+
+					onMouseUp( event );
+
 				}
-				handleTouchStartPan(event);
-				state = STATE.TOUCH_PAN;
-				break;
-			default:
-				state = STATE.NONE;
-		}
 
-		if (state !== STATE.NONE) {
-			scope.dispatchEvent(startEvent);
-		}
-	}
+				removePointer( event ); //
 
-	function onTouchMove(event) {
+				if ( pointers.length === 0 ) {
 
-		if (scope.enabled === false) {
-			return;
-		}
-		event.preventDefault();
-		event.stopPropagation();
+					scope.domElement.releasePointerCapture( event.pointerId );
+					scope.domElement.removeEventListener( 'pointermove', onPointerMove );
+					scope.domElement.removeEventListener( 'pointerup', onPointerUp );
 
-		switch (event.touches.length) {
-			case 1: // one-fingered touch: rotate
-				if (scope.enableRotate === false) {
-					return;
 				}
-				if (state !== STATE.TOUCH_ROTATE) {
-					return; // is this needed?...
+
+			}
+
+			function onPointerCancel( event ) {
+
+				removePointer( event );
+
+			}
+
+			function onMouseDown( event ) {
+
+				let mouseAction;
+
+				switch ( event.button ) {
+
+					case 0:
+						mouseAction = scope.mouseButtons.LEFT;
+						break;
+
+					case 1:
+						mouseAction = scope.mouseButtons.MIDDLE;
+						break;
+
+					case 2:
+						mouseAction = scope.mouseButtons.RIGHT;
+						break;
+
+					default:
+						mouseAction = - 1;
+
 				}
-				handleTouchMoveRotate(event);
-				break;
-			case 2: // two-fingered touch: dolly
-				if (scope.enableZoom === false) {
-					return;
+
+				switch ( mouseAction ) {
+
+					case THREE.MOUSE.DOLLY:
+						if ( scope.enableZoom === false ) return;
+						handleMouseDownDolly( event );
+						state = STATE.DOLLY;
+						break;
+
+					case THREE.MOUSE.ROTATE:
+						if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
+
+							if ( scope.enablePan === false ) return;
+							handleMouseDownPan( event );
+							state = STATE.PAN;
+
+						} else {
+
+							if ( scope.enableRotate === false ) return;
+							handleMouseDownRotate( event );
+							state = STATE.ROTATE;
+
+						}
+
+						break;
+
+					case THREE.MOUSE.PAN:
+						if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
+
+							if ( scope.enableRotate === false ) return;
+							handleMouseDownRotate( event );
+							state = STATE.ROTATE;
+
+						} else {
+
+							if ( scope.enablePan === false ) return;
+							handleMouseDownPan( event );
+							state = STATE.PAN;
+
+						}
+
+						break;
+
+					default:
+						state = STATE.NONE;
+
 				}
-				if (state !== STATE.TOUCH_DOLLY) {
-					return; // is this needed?...
+
+				if ( state !== STATE.NONE ) {
+
+					scope.dispatchEvent( _startEvent );
+
+				}
+
+			}
+
+			function onMouseMove( event ) {
+
+				if ( scope.enabled === false ) return;
+
+				switch ( state ) {
+
+					case STATE.ROTATE:
+						if ( scope.enableRotate === false ) return;
+						handleMouseMoveRotate( event );
+						break;
+
+					case STATE.DOLLY:
+						if ( scope.enableZoom === false ) return;
+						handleMouseMoveDolly( event );
+						break;
+
+					case STATE.PAN:
+						if ( scope.enablePan === false ) return;
+						handleMouseMovePan( event );
+						break;
+
+				}
+
+			}
+
+			function onMouseUp( event ) {
+
+				handleMouseUp( event );
+				scope.dispatchEvent( _endEvent );
+				state = STATE.NONE;
+
+			}
+
+			function onMouseWheel( event ) {
+
+				if ( scope.enabled === false || scope.enableZoom === false || state !== STATE.NONE && state !== STATE.ROTATE ) return;
+				event.preventDefault();
+				scope.dispatchEvent( _startEvent );
+				handleMouseWheel( event );
+				scope.dispatchEvent( _endEvent );
+
+			}
+
+			function onKeyDown( event ) {
+
+				if ( scope.enabled === false || scope.enablePan === false ) return;
+				handleKeyDown( event );
+
+			}
+
+			function onTouchStart( event ) {
+
+				trackPointer( event );
+
+				switch ( pointers.length ) {
+
+					case 1:
+						switch ( scope.touches.ONE ) {
+
+							case THREE.TOUCH.ROTATE:
+								if ( scope.enableRotate === false ) return;
+								handleTouchStartRotate();
+								state = STATE.TOUCH_ROTATE;
+								break;
+
+							case THREE.TOUCH.PAN:
+								if ( scope.enablePan === false ) return;
+								handleTouchStartPan();
+								state = STATE.TOUCH_PAN;
+								break;
+
+							default:
+								state = STATE.NONE;
+
+						}
+
+						break;
+
+					case 2:
+						switch ( scope.touches.TWO ) {
+
+							case THREE.TOUCH.DOLLY_PAN:
+								if ( scope.enableZoom === false && scope.enablePan === false ) return;
+								handleTouchStartDollyPan();
+								state = STATE.TOUCH_DOLLY_PAN;
+								break;
+
+							case THREE.TOUCH.DOLLY_ROTATE:
+								if ( scope.enableZoom === false && scope.enableRotate === false ) return;
+								handleTouchStartDollyRotate();
+								state = STATE.TOUCH_DOLLY_ROTATE;
+								break;
+
+							default:
+								state = STATE.NONE;
+
+						}
+
+						break;
+
+					default:
+						state = STATE.NONE;
+
 				}
-				handleTouchMoveDolly(event);
-				break;
-			case 3: // three-fingered touch: pan
-				if (scope.enablePan === false) {
-					return;
+
+				if ( state !== STATE.NONE ) {
+
+					scope.dispatchEvent( _startEvent );
+
 				}
-				if (state !== STATE.TOUCH_PAN) {
-					return; // is this needed?...
+
+			}
+
+			function onTouchMove( event ) {
+
+				trackPointer( event );
+
+				switch ( state ) {
+
+					case STATE.TOUCH_ROTATE:
+						if ( scope.enableRotate === false ) return;
+						handleTouchMoveRotate( event );
+						scope.update();
+						break;
+
+					case STATE.TOUCH_PAN:
+						if ( scope.enablePan === false ) return;
+						handleTouchMovePan( event );
+						scope.update();
+						break;
+
+					case STATE.TOUCH_DOLLY_PAN:
+						if ( scope.enableZoom === false && scope.enablePan === false ) return;
+						handleTouchMoveDollyPan( event );
+						scope.update();
+						break;
+
+					case STATE.TOUCH_DOLLY_ROTATE:
+						if ( scope.enableZoom === false && scope.enableRotate === false ) return;
+						handleTouchMoveDollyRotate( event );
+						scope.update();
+						break;
+
+					default:
+						state = STATE.NONE;
+
 				}
-				handleTouchMovePan(event);
-				break;
-			default:
+
+			}
+
+			function onTouchEnd( event ) {
+
+				handleTouchEnd( event );
+				scope.dispatchEvent( _endEvent );
 				state = STATE.NONE;
-		}
-	}
 
-	function onTouchEnd(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		handleTouchEnd(event);
-		scope.dispatchEvent(endEvent);
-		state = STATE.NONE;
-	}
+			}
 
-	function onContextMenu(event) {
-		if (scope.enabled === false) {
-			return;
-		}
-		event.preventDefault();
-	}
+			function onContextMenu( event ) {
 
-	scope.domElement.addEventListener('contextmenu', onContextMenu, false);
+				if ( scope.enabled === false ) return;
+				event.preventDefault();
 
-	scope.domElement.addEventListener('mousedown', onMouseDown, false);
-	scope.domElement.addEventListener('wheel', onMouseWheel, false);
+			}
 
-	scope.domElement.addEventListener('touchstart', onTouchStart, false);
-	scope.domElement.addEventListener('touchend', onTouchEnd, false);
-	scope.domElement.addEventListener('touchmove', onTouchMove, false);
+			function addPointer( event ) {
 
-	scope.domElement.addEventListener('keydown', onKeyDown, false);
+				pointers.push( event );
 
-	// force an update at start
-	this.update();
-};
+			}
 
-THREE.OrbitControls.prototype = Object.create(THREE.EventDispatcher.prototype);
-THREE.OrbitControls.prototype.constructor = THREE.OrbitControls;
+			function removePointer( event ) {
 
-Object.defineProperties(THREE.OrbitControls.prototype, {
-	center: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .center has been renamed to .target');
-			return this.target;
-		}
-	},
+				delete pointerPositions[ event.pointerId ];
 
-	// backward compatibility
+				for ( let i = 0; i < pointers.length; i ++ ) {
 
-	noZoom: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .noZoom has been deprecated. Use .enableZoom instead.');
-			return !this.enableZoom;
-		},
+					if ( pointers[ i ].pointerId == event.pointerId ) {
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .noZoom has been deprecated. Use .enableZoom instead.');
-			this.enableZoom = !value;
-		}
-	},
+						pointers.splice( i, 1 );
+						return;
 
-	noRotate: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .noRotate has been deprecated. Use .enableRotate instead.');
-			return !this.enableRotate;
-		},
+					}
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .noRotate has been deprecated. Use .enableRotate instead.');
-			this.enableRotate = !value;
-		}
-	},
+				}
 
-	noPan: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .noPan has been deprecated. Use .enablePan instead.');
-			return !this.enablePan;
-		},
+			}
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .noPan has been deprecated. Use .enablePan instead.');
-			this.enablePan = !value;
-		}
-	},
+			function trackPointer( event ) {
 
-	noKeys: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .noKeys has been deprecated. Use .enableKeys instead.');
-			return !this.enableKeys;
-		},
+				let position = pointerPositions[ event.pointerId ];
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .noKeys has been deprecated. Use .enableKeys instead.');
-			this.enableKeys = !value;
-		}
-	},
+				if ( position === undefined ) {
+
+					position = new THREE.Vector2();
+					pointerPositions[ event.pointerId ] = position;
+
+				}
+
+				position.set( event.pageX, event.pageY );
+
+			}
+
+			function getSecondPointerPosition( event ) {
 
-	staticMoving: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .staticMoving has been deprecated. Use .enableDamping instead.');
-			return !this.enableDamping;
-		},
+				const pointer = event.pointerId === pointers[ 0 ].pointerId ? pointers[ 1 ] : pointers[ 0 ];
+				return pointerPositions[ pointer.pointerId ];
+
+			} //
+
+
+			scope.domElement.addEventListener( 'contextmenu', onContextMenu );
+			scope.domElement.addEventListener( 'pointerdown', onPointerDown );
+			scope.domElement.addEventListener( 'pointercancel', onPointerCancel );
+			scope.domElement.addEventListener( 'wheel', onMouseWheel, {
+				passive: false
+			} ); // force an update at start
+
+			this.update();
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .staticMoving has been deprecated. Use .enableDamping instead.');
-			this.enableDamping = !value;
 		}
-	},
 
-	dynamicDampingFactor: {
-		get: function () {
-			console.warn('THREE.OrbitControls: .dynamicDampingFactor has been renamed. Use .dampingFactor instead.');
-			return this.dampingFactor;
-		},
+	}
+
+	// This set of controls performs orbiting, dollying (zooming), and panning.
+	// Unlike TrackballControls, it maintains the "up" direction object.up (+Y by default).
+	// This is very similar to OrbitControls, another set of touch behavior
+	//
+	//    Orbit - right mouse, or left mouse + ctrl/meta/shiftKey / touch: two-finger rotate
+	//    Zoom - middle mouse, or mousewheel / touch: two-finger spread or squish
+	//    Pan - left mouse, or arrow keys / touch: one-finger move
+
+	class MapControls extends OrbitControls {
+
+		constructor( object, domElement ) {
+
+			super( object, domElement );
+			this.screenSpacePanning = false; // pan orthogonal to world-space direction camera.up
+
+			this.mouseButtons.LEFT = THREE.MOUSE.PAN;
+			this.mouseButtons.RIGHT = THREE.MOUSE.ROTATE;
+			this.touches.ONE = THREE.TOUCH.PAN;
+			this.touches.TWO = THREE.TOUCH.DOLLY_ROTATE;
 
-		set: function (value) {
-			console.warn('THREE.OrbitControls: .dynamicDampingFactor has been renamed. Use .dampingFactor instead.');
-			this.dampingFactor = value;
 		}
+
 	}
-});
 
+	THREE.MapControls = MapControls;
+	THREE.OrbitControls = OrbitControls;
+
+} )();