UNPKG

three

Version:

JavaScript 3D library

159 lines (88 loc) 3.77 kB
console.warn( "THREE.PointerLockControls: As part of the transition to ES6 Modules, the files in 'examples/js' were deprecated in May 2020 (r117) and will be deleted in December 2020 (r124). You can find more information about developing using ES6 Modules in https://threejs.org/docs/#manual/en/introduction/Installation." ); THREE.PointerLockControls = function ( camera, domElement ) { if ( domElement === undefined ) { console.warn( 'THREE.PointerLockControls: The second parameter "domElement" is now mandatory.' ); domElement = document.body; } this.domElement = domElement; this.isLocked = false; // Set to constrain the pitch of the camera // Range is 0 to Math.PI radians this.minPolarAngle = 0; // radians this.maxPolarAngle = Math.PI; // radians // // internals // var scope = this; var changeEvent = { type: 'change' }; var lockEvent = { type: 'lock' }; var unlockEvent = { type: 'unlock' }; var euler = new THREE.Euler( 0, 0, 0, 'YXZ' ); var PI_2 = Math.PI / 2; var vec = new THREE.Vector3(); function onMouseMove( event ) { if ( scope.isLocked === false ) return; var movementX = event.movementX || event.mozMovementX || event.webkitMovementX || 0; var movementY = event.movementY || event.mozMovementY || event.webkitMovementY || 0; euler.setFromQuaternion( camera.quaternion ); euler.y -= movementX * 0.002; euler.x -= movementY * 0.002; euler.x = Math.max( PI_2 - scope.maxPolarAngle, Math.min( PI_2 - scope.minPolarAngle, euler.x ) ); camera.quaternion.setFromEuler( euler ); scope.dispatchEvent( changeEvent ); } function onPointerlockChange() { if ( scope.domElement.ownerDocument.pointerLockElement === scope.domElement ) { scope.dispatchEvent( lockEvent ); scope.isLocked = true; } else { scope.dispatchEvent( unlockEvent ); scope.isLocked = false; } } function onPointerlockError() { console.error( 'THREE.PointerLockControls: Unable to use Pointer Lock API' ); } this.connect = function () { scope.domElement.ownerDocument.addEventListener( 'mousemove', onMouseMove, false ); scope.domElement.ownerDocument.addEventListener( 'pointerlockchange', onPointerlockChange, false ); scope.domElement.ownerDocument.addEventListener( 'pointerlockerror', onPointerlockError, false ); }; this.disconnect = function () { scope.domElement.ownerDocument.removeEventListener( 'mousemove', onMouseMove, false ); scope.domElement.ownerDocument.removeEventListener( 'pointerlockchange', onPointerlockChange, false ); scope.domElement.ownerDocument.removeEventListener( 'pointerlockerror', onPointerlockError, false ); }; this.dispose = function () { this.disconnect(); }; this.getObject = function () { // retaining this method for backward compatibility return camera; }; this.getDirection = function () { var direction = new THREE.Vector3( 0, 0, - 1 ); return function ( v ) { return v.copy( direction ).applyQuaternion( camera.quaternion ); }; }(); this.moveForward = function ( distance ) { // move forward parallel to the xz-plane // assumes camera.up is y-up vec.setFromMatrixColumn( camera.matrix, 0 ); vec.crossVectors( camera.up, vec ); camera.position.addScaledVector( vec, distance ); }; this.moveRight = function ( distance ) { vec.setFromMatrixColumn( camera.matrix, 0 ); camera.position.addScaledVector( vec, distance ); }; this.lock = function () { this.domElement.requestPointerLock(); }; this.unlock = function () { scope.domElement.ownerDocument.exitPointerLock(); }; this.connect(); }; THREE.PointerLockControls.prototype = Object.create( THREE.EventDispatcher.prototype ); THREE.PointerLockControls.prototype.constructor = THREE.PointerLockControls;