title: PointerLockControls category: Addons layout: docs

PointerLockControls

The implementation of this class is based on the Pointer Lock API. PointerLockControls is a perfect choice for first person 3D games.

Code Example

const controls = new PointerLockControls( camera, document.body );
// add event listener to show/hide a UI (e.g. the game's menu)
controls.addEventListener( 'lock', function () {
	menu.style.display = 'none';
} );
controls.addEventListener( 'unlock', function () {
	menu.style.display = 'block';
} );

Import

PointerLockControls is an addon, and must be imported explicitly, see Installation#Addons.

import { PointerLockControls } from 'three/addons/controls/PointerLockControls.js';

Constructor

new PointerLockControls( camera : Camera, domElement : HTMLElement )

Constructs a new controls instance.

camera | The camera that is managed by the controls.
---|---
domElement | The HTML element used for event listeners. Default is null.

Properties

.isLocked : boolean (readonly)

Whether the controls are locked or not.

Default is false.

.maxPolarAngle : number

Camera pitch, upper limit. Range is '[0, Math.PI]' in radians.

Default is Math.PI.

.minPolarAngle : number

Camera pitch, lower limit. Range is '[0, Math.PI]' in radians.

Default is 0.

.pointerSpeed : number

Multiplier for how much the pointer movement influences the camera rotation.

Default is 1.

Methods

.getDirection( v : Vector3 ) : Vector3

Returns the look direction of the camera.

v | The target vector that is used to store the method's result.
---|---

Returns: The normalized direction vector.

.lock( unadjustedMovement : boolean )

Activates the pointer lock.

unadjustedMovement | Disables OS-level adjustment for mouse acceleration, and accesses raw mouse input instead. Setting it to true will disable mouse acceleration. Default is false.
---|---