PointerLockControls.js 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. import {
  2. Euler,
  3. EventDispatcher,
  4. Vector3
  5. } from 'three';
  6. const _euler = new Euler( 0, 0, 0, 'YXZ' );
  7. const _vector = new Vector3();
  8. const _changeEvent = { type: 'change' };
  9. const _lockEvent = { type: 'lock' };
  10. const _unlockEvent = { type: 'unlock' };
  11. const _PI_2 = Math.PI / 2;
  12. class PointerLockControls extends EventDispatcher {
  13. constructor( camera, domElement ) {
  14. super();
  15. this.camera = camera;
  16. this.domElement = domElement;
  17. this.isLocked = false;
  18. // Set to constrain the pitch of the camera
  19. // Range is 0 to Math.PI radians
  20. this.minPolarAngle = 0; // radians
  21. this.maxPolarAngle = Math.PI; // radians
  22. this.pointerSpeed = 1.0;
  23. this._onMouseMove = onMouseMove.bind( this );
  24. this._onPointerlockChange = onPointerlockChange.bind( this );
  25. this._onPointerlockError = onPointerlockError.bind( this );
  26. this.connect();
  27. }
  28. connect() {
  29. this.domElement.ownerDocument.addEventListener( 'mousemove', this._onMouseMove );
  30. this.domElement.ownerDocument.addEventListener( 'pointerlockchange', this._onPointerlockChange );
  31. this.domElement.ownerDocument.addEventListener( 'pointerlockerror', this._onPointerlockError );
  32. }
  33. disconnect() {
  34. this.domElement.ownerDocument.removeEventListener( 'mousemove', this._onMouseMove );
  35. this.domElement.ownerDocument.removeEventListener( 'pointerlockchange', this._onPointerlockChange );
  36. this.domElement.ownerDocument.removeEventListener( 'pointerlockerror', this._onPointerlockError );
  37. }
  38. dispose() {
  39. this.disconnect();
  40. }
  41. getObject() { // retaining this method for backward compatibility
  42. return this.camera;
  43. }
  44. getDirection( v ) {
  45. return v.set( 0, 0, - 1 ).applyQuaternion( this.camera.quaternion );
  46. }
  47. moveForward( distance ) {
  48. // move forward parallel to the xz-plane
  49. // assumes camera.up is y-up
  50. const camera = this.camera;
  51. _vector.setFromMatrixColumn( camera.matrix, 0 );
  52. _vector.crossVectors( camera.up, _vector );
  53. camera.position.addScaledVector( _vector, distance );
  54. }
  55. moveRight( distance ) {
  56. const camera = this.camera;
  57. _vector.setFromMatrixColumn( camera.matrix, 0 );
  58. camera.position.addScaledVector( _vector, distance );
  59. }
  60. lock() {
  61. this.domElement.requestPointerLock();
  62. }
  63. unlock() {
  64. this.domElement.ownerDocument.exitPointerLock();
  65. }
  66. }
  67. // event listeners
  68. function onMouseMove( event ) {
  69. if ( this.isLocked === false ) return;
  70. const movementX = event.movementX || event.mozMovementX || event.webkitMovementX || 0;
  71. const movementY = event.movementY || event.mozMovementY || event.webkitMovementY || 0;
  72. const camera = this.camera;
  73. _euler.setFromQuaternion( camera.quaternion );
  74. _euler.y -= movementX * 0.002 * this.pointerSpeed;
  75. _euler.x -= movementY * 0.002 * this.pointerSpeed;
  76. _euler.x = Math.max( _PI_2 - this.maxPolarAngle, Math.min( _PI_2 - this.minPolarAngle, _euler.x ) );
  77. camera.quaternion.setFromEuler( _euler );
  78. this.dispatchEvent( _changeEvent );
  79. }
  80. function onPointerlockChange() {
  81. if ( this.domElement.ownerDocument.pointerLockElement === this.domElement ) {
  82. this.dispatchEvent( _lockEvent );
  83. this.isLocked = true;
  84. } else {
  85. this.dispatchEvent( _unlockEvent );
  86. this.isLocked = false;
  87. }
  88. }
  89. function onPointerlockError() {
  90. console.error( 'THREE.PointerLockControls: Unable to use Pointer Lock API' );
  91. }
  92. export { PointerLockControls };