TrackballControls.js 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808
  1. import {
  2. EventDispatcher,
  3. MOUSE,
  4. Quaternion,
  5. Vector2,
  6. Vector3
  7. } from '../../../build/three.module.js';
  8. const _changeEvent = { type: 'change' };
  9. const _startEvent = { type: 'start' };
  10. const _endEvent = { type: 'end' };
  11. class TrackballControls extends EventDispatcher {
  12. constructor( object, domElement ) {
  13. super();
  14. if ( domElement === undefined ) console.warn( 'THREE.TrackballControls: The second parameter "domElement" is now mandatory.' );
  15. if ( domElement === document ) console.error( 'THREE.TrackballControls: "document" should not be used as the target "domElement". Please use "renderer.domElement" instead.' );
  16. const scope = this;
  17. const STATE = { NONE: - 1, ROTATE: 0, ZOOM: 1, PAN: 2, TOUCH_ROTATE: 3, TOUCH_ZOOM_PAN: 4 };
  18. this.object = object;
  19. this.domElement = domElement;
  20. this.domElement.style.touchAction = 'none'; // disable touch scroll
  21. // API
  22. this.enabled = true;
  23. this.screen = { left: 0, top: 0, width: 0, height: 0 };
  24. this.rotateSpeed = 1.0;
  25. this.zoomSpeed = 1.2;
  26. this.panSpeed = 0.3;
  27. this.noRotate = false;
  28. this.noZoom = false;
  29. this.noPan = false;
  30. this.staticMoving = false;
  31. this.dynamicDampingFactor = 0.2;
  32. this.minDistance = 0;
  33. this.maxDistance = Infinity;
  34. this.keys = [ 'KeyA' /*A*/, 'KeyS' /*S*/, 'KeyD' /*D*/ ];
  35. this.mouseButtons = { LEFT: MOUSE.ROTATE, MIDDLE: MOUSE.DOLLY, RIGHT: MOUSE.PAN };
  36. // internals
  37. this.target = new Vector3();
  38. const EPS = 0.000001;
  39. const lastPosition = new Vector3();
  40. let lastZoom = 1;
  41. let _state = STATE.NONE,
  42. _keyState = STATE.NONE,
  43. _touchZoomDistanceStart = 0,
  44. _touchZoomDistanceEnd = 0,
  45. _lastAngle = 0;
  46. const _eye = new Vector3(),
  47. _movePrev = new Vector2(),
  48. _moveCurr = new Vector2(),
  49. _lastAxis = new Vector3(),
  50. _zoomStart = new Vector2(),
  51. _zoomEnd = new Vector2(),
  52. _panStart = new Vector2(),
  53. _panEnd = new Vector2(),
  54. _pointers = [],
  55. _pointerPositions = {};
  56. // for reset
  57. this.target0 = this.target.clone();
  58. this.position0 = this.object.position.clone();
  59. this.up0 = this.object.up.clone();
  60. this.zoom0 = this.object.zoom;
  61. // methods
  62. this.handleResize = function () {
  63. const box = scope.domElement.getBoundingClientRect();
  64. // adjustments come from similar code in the jquery offset() function
  65. const d = scope.domElement.ownerDocument.documentElement;
  66. scope.screen.left = box.left + window.pageXOffset - d.clientLeft;
  67. scope.screen.top = box.top + window.pageYOffset - d.clientTop;
  68. scope.screen.width = box.width;
  69. scope.screen.height = box.height;
  70. };
  71. const getMouseOnScreen = ( function () {
  72. const vector = new Vector2();
  73. return function getMouseOnScreen( pageX, pageY ) {
  74. vector.set(
  75. ( pageX - scope.screen.left ) / scope.screen.width,
  76. ( pageY - scope.screen.top ) / scope.screen.height
  77. );
  78. return vector;
  79. };
  80. }() );
  81. const getMouseOnCircle = ( function () {
  82. const vector = new Vector2();
  83. return function getMouseOnCircle( pageX, pageY ) {
  84. vector.set(
  85. ( ( pageX - scope.screen.width * 0.5 - scope.screen.left ) / ( scope.screen.width * 0.5 ) ),
  86. ( ( scope.screen.height + 2 * ( scope.screen.top - pageY ) ) / scope.screen.width ) // screen.width intentional
  87. );
  88. return vector;
  89. };
  90. }() );
  91. this.rotateCamera = ( function () {
  92. const axis = new Vector3(),
  93. quaternion = new Quaternion(),
  94. eyeDirection = new Vector3(),
  95. objectUpDirection = new Vector3(),
  96. objectSidewaysDirection = new Vector3(),
  97. moveDirection = new Vector3();
  98. return function rotateCamera() {
  99. moveDirection.set( _moveCurr.x - _movePrev.x, _moveCurr.y - _movePrev.y, 0 );
  100. let angle = moveDirection.length();
  101. if ( angle ) {
  102. _eye.copy( scope.object.position ).sub( scope.target );
  103. eyeDirection.copy( _eye ).normalize();
  104. objectUpDirection.copy( scope.object.up ).normalize();
  105. objectSidewaysDirection.crossVectors( objectUpDirection, eyeDirection ).normalize();
  106. objectUpDirection.setLength( _moveCurr.y - _movePrev.y );
  107. objectSidewaysDirection.setLength( _moveCurr.x - _movePrev.x );
  108. moveDirection.copy( objectUpDirection.add( objectSidewaysDirection ) );
  109. axis.crossVectors( moveDirection, _eye ).normalize();
  110. angle *= scope.rotateSpeed;
  111. quaternion.setFromAxisAngle( axis, angle );
  112. _eye.applyQuaternion( quaternion );
  113. scope.object.up.applyQuaternion( quaternion );
  114. _lastAxis.copy( axis );
  115. _lastAngle = angle;
  116. } else if ( ! scope.staticMoving && _lastAngle ) {
  117. _lastAngle *= Math.sqrt( 1.0 - scope.dynamicDampingFactor );
  118. _eye.copy( scope.object.position ).sub( scope.target );
  119. quaternion.setFromAxisAngle( _lastAxis, _lastAngle );
  120. _eye.applyQuaternion( quaternion );
  121. scope.object.up.applyQuaternion( quaternion );
  122. }
  123. _movePrev.copy( _moveCurr );
  124. };
  125. }() );
  126. this.zoomCamera = function () {
  127. let factor;
  128. if ( _state === STATE.TOUCH_ZOOM_PAN ) {
  129. factor = _touchZoomDistanceStart / _touchZoomDistanceEnd;
  130. _touchZoomDistanceStart = _touchZoomDistanceEnd;
  131. if ( scope.object.isPerspectiveCamera ) {
  132. _eye.multiplyScalar( factor );
  133. } else if ( scope.object.isOrthographicCamera ) {
  134. scope.object.zoom /= factor;
  135. scope.object.updateProjectionMatrix();
  136. } else {
  137. console.warn( 'THREE.TrackballControls: Unsupported camera type' );
  138. }
  139. } else {
  140. factor = 1.0 + ( _zoomEnd.y - _zoomStart.y ) * scope.zoomSpeed;
  141. if ( factor !== 1.0 && factor > 0.0 ) {
  142. if ( scope.object.isPerspectiveCamera ) {
  143. _eye.multiplyScalar( factor );
  144. } else if ( scope.object.isOrthographicCamera ) {
  145. scope.object.zoom /= factor;
  146. scope.object.updateProjectionMatrix();
  147. } else {
  148. console.warn( 'THREE.TrackballControls: Unsupported camera type' );
  149. }
  150. }
  151. if ( scope.staticMoving ) {
  152. _zoomStart.copy( _zoomEnd );
  153. } else {
  154. _zoomStart.y += ( _zoomEnd.y - _zoomStart.y ) * this.dynamicDampingFactor;
  155. }
  156. }
  157. };
  158. this.panCamera = ( function () {
  159. const mouseChange = new Vector2(),
  160. objectUp = new Vector3(),
  161. pan = new Vector3();
  162. return function panCamera() {
  163. mouseChange.copy( _panEnd ).sub( _panStart );
  164. if ( mouseChange.lengthSq() ) {
  165. if ( scope.object.isOrthographicCamera ) {
  166. const scale_x = ( scope.object.right - scope.object.left ) / scope.object.zoom / scope.domElement.clientWidth;
  167. const scale_y = ( scope.object.top - scope.object.bottom ) / scope.object.zoom / scope.domElement.clientWidth;
  168. mouseChange.x *= scale_x;
  169. mouseChange.y *= scale_y;
  170. }
  171. mouseChange.multiplyScalar( _eye.length() * scope.panSpeed );
  172. pan.copy( _eye ).cross( scope.object.up ).setLength( mouseChange.x );
  173. pan.add( objectUp.copy( scope.object.up ).setLength( mouseChange.y ) );
  174. scope.object.position.add( pan );
  175. scope.target.add( pan );
  176. if ( scope.staticMoving ) {
  177. _panStart.copy( _panEnd );
  178. } else {
  179. _panStart.add( mouseChange.subVectors( _panEnd, _panStart ).multiplyScalar( scope.dynamicDampingFactor ) );
  180. }
  181. }
  182. };
  183. }() );
  184. this.checkDistances = function () {
  185. if ( ! scope.noZoom || ! scope.noPan ) {
  186. if ( _eye.lengthSq() > scope.maxDistance * scope.maxDistance ) {
  187. scope.object.position.addVectors( scope.target, _eye.setLength( scope.maxDistance ) );
  188. _zoomStart.copy( _zoomEnd );
  189. }
  190. if ( _eye.lengthSq() < scope.minDistance * scope.minDistance ) {
  191. scope.object.position.addVectors( scope.target, _eye.setLength( scope.minDistance ) );
  192. _zoomStart.copy( _zoomEnd );
  193. }
  194. }
  195. };
  196. this.update = function () {
  197. _eye.subVectors( scope.object.position, scope.target );
  198. if ( ! scope.noRotate ) {
  199. scope.rotateCamera();
  200. }
  201. if ( ! scope.noZoom ) {
  202. scope.zoomCamera();
  203. }
  204. if ( ! scope.noPan ) {
  205. scope.panCamera();
  206. }
  207. scope.object.position.addVectors( scope.target, _eye );
  208. if ( scope.object.isPerspectiveCamera ) {
  209. scope.checkDistances();
  210. scope.object.lookAt( scope.target );
  211. if ( lastPosition.distanceToSquared( scope.object.position ) > EPS ) {
  212. scope.dispatchEvent( _changeEvent );
  213. lastPosition.copy( scope.object.position );
  214. }
  215. } else if ( scope.object.isOrthographicCamera ) {
  216. scope.object.lookAt( scope.target );
  217. if ( lastPosition.distanceToSquared( scope.object.position ) > EPS || lastZoom !== scope.object.zoom ) {
  218. scope.dispatchEvent( _changeEvent );
  219. lastPosition.copy( scope.object.position );
  220. lastZoom = scope.object.zoom;
  221. }
  222. } else {
  223. console.warn( 'THREE.TrackballControls: Unsupported camera type' );
  224. }
  225. };
  226. this.reset = function () {
  227. _state = STATE.NONE;
  228. _keyState = STATE.NONE;
  229. scope.target.copy( scope.target0 );
  230. scope.object.position.copy( scope.position0 );
  231. scope.object.up.copy( scope.up0 );
  232. scope.object.zoom = scope.zoom0;
  233. scope.object.updateProjectionMatrix();
  234. _eye.subVectors( scope.object.position, scope.target );
  235. scope.object.lookAt( scope.target );
  236. scope.dispatchEvent( _changeEvent );
  237. lastPosition.copy( scope.object.position );
  238. lastZoom = scope.object.zoom;
  239. };
  240. // listeners
  241. function onPointerDown( event ) {
  242. if ( scope.enabled === false ) return;
  243. if ( _pointers.length === 0 ) {
  244. scope.domElement.setPointerCapture( event.pointerId );
  245. scope.domElement.addEventListener( 'pointermove', onPointerMove );
  246. scope.domElement.addEventListener( 'pointerup', onPointerUp );
  247. }
  248. //
  249. addPointer( event );
  250. if ( event.pointerType === 'touch' ) {
  251. onTouchStart( event );
  252. } else {
  253. onMouseDown( event );
  254. }
  255. }
  256. function onPointerMove( event ) {
  257. if ( scope.enabled === false ) return;
  258. if ( event.pointerType === 'touch' ) {
  259. onTouchMove( event );
  260. } else {
  261. onMouseMove( event );
  262. }
  263. }
  264. function onPointerUp( event ) {
  265. if ( scope.enabled === false ) return;
  266. if ( event.pointerType === 'touch' ) {
  267. onTouchEnd( event );
  268. } else {
  269. onMouseUp();
  270. }
  271. //
  272. removePointer( event );
  273. if ( _pointers.length === 0 ) {
  274. scope.domElement.releasePointerCapture( event.pointerId );
  275. scope.domElement.removeEventListener( 'pointermove', onPointerMove );
  276. scope.domElement.removeEventListener( 'pointerup', onPointerUp );
  277. }
  278. }
  279. function onPointerCancel( event ) {
  280. removePointer( event );
  281. }
  282. function keydown( event ) {
  283. if ( scope.enabled === false ) return;
  284. window.removeEventListener( 'keydown', keydown );
  285. if ( _keyState !== STATE.NONE ) {
  286. return;
  287. } else if ( event.code === scope.keys[ STATE.ROTATE ] && ! scope.noRotate ) {
  288. _keyState = STATE.ROTATE;
  289. } else if ( event.code === scope.keys[ STATE.ZOOM ] && ! scope.noZoom ) {
  290. _keyState = STATE.ZOOM;
  291. } else if ( event.code === scope.keys[ STATE.PAN ] && ! scope.noPan ) {
  292. _keyState = STATE.PAN;
  293. }
  294. }
  295. function keyup() {
  296. if ( scope.enabled === false ) return;
  297. _keyState = STATE.NONE;
  298. window.addEventListener( 'keydown', keydown );
  299. }
  300. function onMouseDown( event ) {
  301. if ( _state === STATE.NONE ) {
  302. switch ( event.button ) {
  303. case scope.mouseButtons.LEFT:
  304. _state = STATE.ROTATE;
  305. break;
  306. case scope.mouseButtons.MIDDLE:
  307. _state = STATE.ZOOM;
  308. break;
  309. case scope.mouseButtons.RIGHT:
  310. _state = STATE.PAN;
  311. break;
  312. default:
  313. _state = STATE.NONE;
  314. }
  315. }
  316. const state = ( _keyState !== STATE.NONE ) ? _keyState : _state;
  317. if ( state === STATE.ROTATE && ! scope.noRotate ) {
  318. _moveCurr.copy( getMouseOnCircle( event.pageX, event.pageY ) );
  319. _movePrev.copy( _moveCurr );
  320. } else if ( state === STATE.ZOOM && ! scope.noZoom ) {
  321. _zoomStart.copy( getMouseOnScreen( event.pageX, event.pageY ) );
  322. _zoomEnd.copy( _zoomStart );
  323. } else if ( state === STATE.PAN && ! scope.noPan ) {
  324. _panStart.copy( getMouseOnScreen( event.pageX, event.pageY ) );
  325. _panEnd.copy( _panStart );
  326. }
  327. scope.dispatchEvent( _startEvent );
  328. }
  329. function onMouseMove( event ) {
  330. const state = ( _keyState !== STATE.NONE ) ? _keyState : _state;
  331. if ( state === STATE.ROTATE && ! scope.noRotate ) {
  332. _movePrev.copy( _moveCurr );
  333. _moveCurr.copy( getMouseOnCircle( event.pageX, event.pageY ) );
  334. } else if ( state === STATE.ZOOM && ! scope.noZoom ) {
  335. _zoomEnd.copy( getMouseOnScreen( event.pageX, event.pageY ) );
  336. } else if ( state === STATE.PAN && ! scope.noPan ) {
  337. _panEnd.copy( getMouseOnScreen( event.pageX, event.pageY ) );
  338. }
  339. }
  340. function onMouseUp() {
  341. _state = STATE.NONE;
  342. scope.dispatchEvent( _endEvent );
  343. }
  344. function onMouseWheel( event ) {
  345. if ( scope.enabled === false ) return;
  346. if ( scope.noZoom === true ) return;
  347. event.preventDefault();
  348. switch ( event.deltaMode ) {
  349. case 2:
  350. // Zoom in pages
  351. _zoomStart.y -= event.deltaY * 0.025;
  352. break;
  353. case 1:
  354. // Zoom in lines
  355. _zoomStart.y -= event.deltaY * 0.01;
  356. break;
  357. default:
  358. // undefined, 0, assume pixels
  359. _zoomStart.y -= event.deltaY * 0.00025;
  360. break;
  361. }
  362. scope.dispatchEvent( _startEvent );
  363. scope.dispatchEvent( _endEvent );
  364. }
  365. function onTouchStart( event ) {
  366. trackPointer( event );
  367. switch ( _pointers.length ) {
  368. case 1:
  369. _state = STATE.TOUCH_ROTATE;
  370. _moveCurr.copy( getMouseOnCircle( _pointers[ 0 ].pageX, _pointers[ 0 ].pageY ) );
  371. _movePrev.copy( _moveCurr );
  372. break;
  373. default: // 2 or more
  374. _state = STATE.TOUCH_ZOOM_PAN;
  375. const dx = _pointers[ 0 ].pageX - _pointers[ 1 ].pageX;
  376. const dy = _pointers[ 0 ].pageY - _pointers[ 1 ].pageY;
  377. _touchZoomDistanceEnd = _touchZoomDistanceStart = Math.sqrt( dx * dx + dy * dy );
  378. const x = ( _pointers[ 0 ].pageX + _pointers[ 1 ].pageX ) / 2;
  379. const y = ( _pointers[ 0 ].pageY + _pointers[ 1 ].pageY ) / 2;
  380. _panStart.copy( getMouseOnScreen( x, y ) );
  381. _panEnd.copy( _panStart );
  382. break;
  383. }
  384. scope.dispatchEvent( _startEvent );
  385. }
  386. function onTouchMove( event ) {
  387. trackPointer( event );
  388. switch ( _pointers.length ) {
  389. case 1:
  390. _movePrev.copy( _moveCurr );
  391. _moveCurr.copy( getMouseOnCircle( event.pageX, event.pageY ) );
  392. break;
  393. default: // 2 or more
  394. const position = getSecondPointerPosition( event );
  395. const dx = event.pageX - position.x;
  396. const dy = event.pageY - position.y;
  397. _touchZoomDistanceEnd = Math.sqrt( dx * dx + dy * dy );
  398. const x = ( event.pageX + position.x ) / 2;
  399. const y = ( event.pageY + position.y ) / 2;
  400. _panEnd.copy( getMouseOnScreen( x, y ) );
  401. break;
  402. }
  403. }
  404. function onTouchEnd( event ) {
  405. switch ( _pointers.length ) {
  406. case 0:
  407. _state = STATE.NONE;
  408. break;
  409. case 1:
  410. _state = STATE.TOUCH_ROTATE;
  411. _moveCurr.copy( getMouseOnCircle( event.pageX, event.pageY ) );
  412. _movePrev.copy( _moveCurr );
  413. break;
  414. case 2:
  415. _state = STATE.TOUCH_ZOOM_PAN;
  416. _moveCurr.copy( getMouseOnCircle( event.pageX - _movePrev.pageX, event.pageY - _movePrev.pageY ) );
  417. _movePrev.copy( _moveCurr );
  418. break;
  419. }
  420. scope.dispatchEvent( _endEvent );
  421. }
  422. function contextmenu( event ) {
  423. if ( scope.enabled === false ) return;
  424. event.preventDefault();
  425. }
  426. function addPointer( event ) {
  427. _pointers.push( event );
  428. }
  429. function removePointer( event ) {
  430. delete _pointerPositions[ event.pointerId ];
  431. for ( let i = 0; i < _pointers.length; i ++ ) {
  432. if ( _pointers[ i ].pointerId == event.pointerId ) {
  433. _pointers.splice( i, 1 );
  434. return;
  435. }
  436. }
  437. }
  438. function trackPointer( event ) {
  439. let position = _pointerPositions[ event.pointerId ];
  440. if ( position === undefined ) {
  441. position = new Vector2();
  442. _pointerPositions[ event.pointerId ] = position;
  443. }
  444. position.set( event.pageX, event.pageY );
  445. }
  446. function getSecondPointerPosition( event ) {
  447. const pointer = ( event.pointerId === _pointers[ 0 ].pointerId ) ? _pointers[ 1 ] : _pointers[ 0 ];
  448. return _pointerPositions[ pointer.pointerId ];
  449. }
  450. this.dispose = function () {
  451. scope.domElement.removeEventListener( 'contextmenu', contextmenu );
  452. scope.domElement.removeEventListener( 'pointerdown', onPointerDown );
  453. scope.domElement.removeEventListener( 'pointercancel', onPointerCancel );
  454. scope.domElement.removeEventListener( 'wheel', onMouseWheel );
  455. scope.domElement.removeEventListener( 'pointermove', onPointerMove );
  456. scope.domElement.removeEventListener( 'pointerup', onPointerUp );
  457. window.removeEventListener( 'keydown', keydown );
  458. window.removeEventListener( 'keyup', keyup );
  459. };
  460. this.domElement.addEventListener( 'contextmenu', contextmenu );
  461. this.domElement.addEventListener( 'pointerdown', onPointerDown );
  462. this.domElement.addEventListener( 'pointercancel', onPointerCancel );
  463. this.domElement.addEventListener( 'wheel', onMouseWheel, { passive: false } );
  464. window.addEventListener( 'keydown', keydown );
  465. window.addEventListener( 'keyup', keyup );
  466. this.handleResize();
  467. // force an update at start
  468. this.update();
  469. }
  470. }
  471. export { TrackballControls };