From 4b84be30cc64744234cab0aabbbc5da472ce9139 Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Sat, 4 Dec 2021 21:36:00 +0100
Subject: [PATCH 1/6] add first try on pointerlockcontrols

---
 .../controls/PointerLockControls.svelte       | 154 ++++++++++++++++++
 src/lib/index.js                              |   1 +
 .../03-first-person-camera/index.svelte       |  36 ++++
 .../_content/03-first-person-camera/meta.json |   3 +
 4 files changed, 194 insertions(+)
 create mode 100644 src/lib/components/controls/PointerLockControls.svelte
 create mode 100644 src/routes/examples/_content/03-first-person-camera/index.svelte
 create mode 100644 src/routes/examples/_content/03-first-person-camera/meta.json

diff --git a/src/lib/components/controls/PointerLockControls.svelte b/src/lib/components/controls/PointerLockControls.svelte
new file mode 100644
index 0000000..f0745b7
--- /dev/null
+++ b/src/lib/components/controls/PointerLockControls.svelte
@@ -0,0 +1,154 @@
+<script>
+	import * as THREE from 'three';
+	import { setup } from '../../utils/context.js';
+	import { PointerLockControls } from 'three/examples/jsm/controls/PointerLockControls.js';
+	import { createEventDispatcher } from 'svelte';
+	import { onFrame } from '../../utils/lifecycle.js';
+
+	export let maxPolarAngle = Math.PI;
+	export let minPolarAngle = 0;
+	export let velocity = new THREE.Vector3();
+
+	export let moveForward = false;
+	export let moveBackward = false;
+	export let moveLeft = false;
+	export let moveRight = false;
+	export let canJump = false;
+
+	let isLocked = false;
+	let prevTime = performance.now();
+	const direction = new THREE.Vector3();
+
+	const { root } = setup();
+	const dispatch = createEventDispatcher();
+
+	/** @type {PointerLockControls} */
+	let controls;
+
+	root.controls.set((camera, canvas) => {
+		controls = new PointerLockControls(camera, canvas);
+
+		controls.addEventListener('start', (e) => {
+			dispatch('start', e);
+		});
+
+		controls.addEventListener('end', (e) => {
+			dispatch('end', e);
+		});
+
+		controls.addEventListener('lock', (e) => {
+			isLocked = true;
+			dispatch('lock', e);
+		});
+
+		controls.addEventListener('unlock', (e) => {
+			isLocked = false;
+			dispatch('unlock', e);
+		});
+
+		canvas.addEventListener('click', () => {
+			controls.lock();
+		});
+
+		canvas.addEventListener('keydown', (e) => {
+			switch (e.code) {
+				case 'ArrowUp':
+				case 'KeyW':
+					moveForward = true;
+					break;
+
+				case 'ArrowLeft':
+				case 'KeyA':
+					moveLeft = true;
+					break;
+
+				case 'ArrowDown':
+				case 'KeyS':
+					moveBackward = true;
+					break;
+
+				case 'ArrowRight':
+				case 'KeyD':
+					moveRight = true;
+					break;
+
+				case 'Space':
+					if (canJump === true) velocity.y += 350;
+					canJump = false;
+					break;
+			}
+		});
+
+		canvas.addEventListener('keyup', (e) => {
+			switch (e.code) {
+				case 'ArrowUp':
+				case 'KeyW':
+					moveForward = false;
+					break;
+
+				case 'ArrowLeft':
+				case 'KeyA':
+					moveLeft = false;
+					break;
+
+				case 'ArrowDown':
+				case 'KeyS':
+					moveBackward = false;
+					break;
+
+				case 'ArrowRight':
+				case 'KeyD':
+					moveRight = false;
+					break;
+			}
+		});
+
+		return controls;
+	});
+
+	onFrame(() => {
+		if (controls && isLocked) {
+			const camera = controls.getObject()
+			const time = performance.now();
+
+			const delta = (time - prevTime) / 1000;
+
+			velocity.x -= velocity.x * 10.0 * delta;
+			velocity.z -= velocity.z * 10.0 * delta;
+
+			velocity.y -= 9.8 * 100.0 * delta; // 100.0 = mass
+
+			direction.z = Number(moveForward) - Number(moveBackward);
+			direction.x = Number(moveRight) - Number(moveLeft);
+			direction.normalize(); // this ensures consistent movements in all directions
+
+			if (moveForward || moveBackward) velocity.z -= direction.z * 400.0 * delta;
+			if (moveLeft || moveRight) velocity.x -= direction.x * 400.0 * delta;
+
+			// if (onObject === true) {
+			// 	velocity.y = Math.max(0, velocity.y);
+			// 	canJump = true;
+			// }
+
+			controls.moveRight(-velocity.x * delta);
+			controls.moveForward(-velocity.z * delta);
+
+			camera.position.y += velocity.y * delta; // new behavior
+
+			if (camera.position.y < 10) {
+				velocity.y = 0;
+				camera.position.y = 10;
+
+				canJump = true;
+			}
+
+			prevTime = time;
+		}
+	});
+
+	$: if (controls) {
+		controls.isLocked = isLocked;
+		controls.maxPolarAngle = maxPolarAngle;
+		controls.minPolarAngle = minPolarAngle;
+	}
+</script>
diff --git a/src/lib/index.js b/src/lib/index.js
index a4e3a76..95558fb 100644
--- a/src/lib/index.js
+++ b/src/lib/index.js
@@ -14,6 +14,7 @@ export { default as OrthographicCamera } from './components/cameras/Orthographic
 
 // controls
 export { default as OrbitControls } from './components/controls/OrbitControls.svelte';
+export { default as PointerLockControls } from './components/controls/PointerLockControls.svelte';
 
 // lights
 export { default as AmbientLight } from './components/lights/AmbientLight.svelte';
diff --git a/src/routes/examples/_content/03-first-person-camera/index.svelte b/src/routes/examples/_content/03-first-person-camera/index.svelte
new file mode 100644
index 0000000..e24a387
--- /dev/null
+++ b/src/routes/examples/_content/03-first-person-camera/index.svelte
@@ -0,0 +1,36 @@
+<script>
+	import * as THREE from 'three';
+	import * as SC from 'svelte-cubed';
+</script>
+
+<SC.Canvas
+	antialias
+	background={new THREE.Color('papayawhip')}
+	fog={new THREE.FogExp2('papayawhip', 0.1)}
+	shadows
+>
+	<SC.Group position={[0, -1 / 2, 0]}>
+		<SC.Mesh
+			geometry={new THREE.PlaneGeometry(50, 50)}
+			material={new THREE.MeshStandardMaterial({ color: 'burlywood' })}
+			rotation={[-Math.PI / 2, 0, 0]}
+			receiveShadow
+		/>
+		<SC.Primitive
+			object={new THREE.GridHelper(50, 50, 'papayawhip', 'papayawhip')}
+			position={[0, 0.001, 0]}
+		/>
+	</SC.Group>
+
+	<SC.Mesh
+		geometry={new THREE.BoxGeometry()}
+		material={new THREE.MeshStandardMaterial({ color: 0xff3e00 })}
+		scale={[1, 1, 1]}
+		castShadow
+	/>
+
+	<SC.PerspectiveCamera position={[1, 1, 3]} />
+	<SC.PointerLockControls maxPolarAngle={Math.PI * 0.51} />
+	<SC.AmbientLight intensity={0.6} />
+	<SC.DirectionalLight intensity={0.6} position={[-2, 3, 2]} shadow={{ mapSize: [2048, 2048] }} />
+</SC.Canvas>
diff --git a/src/routes/examples/_content/03-first-person-camera/meta.json b/src/routes/examples/_content/03-first-person-camera/meta.json
new file mode 100644
index 0000000..a7a0f66
--- /dev/null
+++ b/src/routes/examples/_content/03-first-person-camera/meta.json
@@ -0,0 +1,3 @@
+{
+	"title": "First Person Controls"
+}

From 14a6d0ad42b90bcdeb2eba697db61749c938cace Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Sat, 4 Dec 2021 21:36:52 +0100
Subject: [PATCH 2/6] update pointerlockcontrols

---
 .../controls/PointerLockControls.svelte           | 15 +++++++++++++++
 .../_content/03-first-person-camera/index.svelte  |  7 ++++++-
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/src/lib/components/controls/PointerLockControls.svelte b/src/lib/components/controls/PointerLockControls.svelte
index f0745b7..d053d1f 100644
--- a/src/lib/components/controls/PointerLockControls.svelte
+++ b/src/lib/components/controls/PointerLockControls.svelte
@@ -4,6 +4,7 @@
 	import { PointerLockControls } from 'three/examples/jsm/controls/PointerLockControls.js';
 	import { createEventDispatcher } from 'svelte';
 	import { onFrame } from '../../utils/lifecycle.js';
+	import * as SC from 'svelte-cubed';
 
 	export let maxPolarAngle = Math.PI;
 	export let minPolarAngle = 0;
@@ -14,10 +15,14 @@
 	export let moveLeft = false;
 	export let moveRight = false;
 	export let canJump = false;
+	/** @type {SC.Mesh[]} */
+	export let objects = [];
 
 	let isLocked = false;
 	let prevTime = performance.now();
 	const direction = new THREE.Vector3();
+	/** @type {THREE.Raycaster} */
+	let raycaster
 
 	const { root } = setup();
 	const dispatch = createEventDispatcher();
@@ -26,6 +31,8 @@
 	let controls;
 
 	root.controls.set((camera, canvas) => {
+		raycaster = new THREE.Raycaster( new THREE.Vector3(), new THREE.Vector3( 0, - 1, 0 ), 0, 10 );
+
 		controls = new PointerLockControls(camera, canvas);
 
 		controls.addEventListener('start', (e) => {
@@ -125,6 +132,14 @@
 			if (moveForward || moveBackward) velocity.z -= direction.z * 400.0 * delta;
 			if (moveLeft || moveRight) velocity.x -= direction.x * 400.0 * delta;
 
+			raycaster.ray.origin.copy( camera.position );
+			raycaster.ray.origin.y -= 10;
+
+			console.log(objects);
+			// const intersections = raycaster.intersectObjects( objects.map(object => object.mesh), false );
+
+			// const onObject = intersections.length > 0;
+
 			// if (onObject === true) {
 			// 	velocity.y = Math.max(0, velocity.y);
 			// 	canJump = true;
diff --git a/src/routes/examples/_content/03-first-person-camera/index.svelte b/src/routes/examples/_content/03-first-person-camera/index.svelte
index e24a387..026170c 100644
--- a/src/routes/examples/_content/03-first-person-camera/index.svelte
+++ b/src/routes/examples/_content/03-first-person-camera/index.svelte
@@ -1,6 +1,9 @@
 <script>
 	import * as THREE from 'three';
 	import * as SC from 'svelte-cubed';
+
+	let floor
+	let cube
 </script>
 
 <SC.Canvas
@@ -11,6 +14,7 @@
 >
 	<SC.Group position={[0, -1 / 2, 0]}>
 		<SC.Mesh
+		bind:this={floor}
 			geometry={new THREE.PlaneGeometry(50, 50)}
 			material={new THREE.MeshStandardMaterial({ color: 'burlywood' })}
 			rotation={[-Math.PI / 2, 0, 0]}
@@ -23,6 +27,7 @@
 	</SC.Group>
 
 	<SC.Mesh
+		bind:this={cube}
 		geometry={new THREE.BoxGeometry()}
 		material={new THREE.MeshStandardMaterial({ color: 0xff3e00 })}
 		scale={[1, 1, 1]}
@@ -30,7 +35,7 @@
 	/>
 
 	<SC.PerspectiveCamera position={[1, 1, 3]} />
-	<SC.PointerLockControls maxPolarAngle={Math.PI * 0.51} />
+	<SC.PointerLockControls maxPolarAngle={Math.PI * 0.51} objects={[floor, cube]} />
 	<SC.AmbientLight intensity={0.6} />
 	<SC.DirectionalLight intensity={0.6} position={[-2, 3, 2]} shadow={{ mapSize: [2048, 2048] }} />
 </SC.Canvas>

From 2c5cc57b7f974f0e6c721aa8adc8b7ba18157be1 Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Mon, 6 Dec 2021 21:51:33 +0100
Subject: [PATCH 3/6] add basic pointer lock controls

---
 src/lib/components/Canvas.svelte              |   3 +
 .../controls/PointerLockControls.svelte       | 123 +-----------------
 .../03-first-person-camera/index.svelte       |   4 +-
 3 files changed, 11 insertions(+), 119 deletions(-)

diff --git a/src/lib/components/Canvas.svelte b/src/lib/components/Canvas.svelte
index ef93737..9717208 100644
--- a/src/lib/components/Canvas.svelte
+++ b/src/lib/components/Canvas.svelte
@@ -85,6 +85,9 @@
 	/** @param {Function} fn */
 	const run = (fn) => fn();
 
+	/**
+	 * @description is required to rerender the scene if something has changed
+	 */
 	const invalidate = () => {
 		if (frame) return;
 
diff --git a/src/lib/components/controls/PointerLockControls.svelte b/src/lib/components/controls/PointerLockControls.svelte
index d053d1f..eb8c949 100644
--- a/src/lib/components/controls/PointerLockControls.svelte
+++ b/src/lib/components/controls/PointerLockControls.svelte
@@ -1,28 +1,12 @@
 <script>
-	import * as THREE from 'three';
 	import { setup } from '../../utils/context.js';
 	import { PointerLockControls } from 'three/examples/jsm/controls/PointerLockControls.js';
 	import { createEventDispatcher } from 'svelte';
-	import { onFrame } from '../../utils/lifecycle.js';
-	import * as SC from 'svelte-cubed';
 
 	export let maxPolarAngle = Math.PI;
 	export let minPolarAngle = 0;
-	export let velocity = new THREE.Vector3();
-
-	export let moveForward = false;
-	export let moveBackward = false;
-	export let moveLeft = false;
-	export let moveRight = false;
-	export let canJump = false;
-	/** @type {SC.Mesh[]} */
-	export let objects = [];
 
 	let isLocked = false;
-	let prevTime = performance.now();
-	const direction = new THREE.Vector3();
-	/** @type {THREE.Raycaster} */
-	let raycaster
 
 	const { root } = setup();
 	const dispatch = createEventDispatcher();
@@ -31,7 +15,6 @@
 	let controls;
 
 	root.controls.set((camera, canvas) => {
-		raycaster = new THREE.Raycaster( new THREE.Vector3(), new THREE.Vector3( 0, - 1, 0 ), 0, 10 );
 
 		controls = new PointerLockControls(camera, canvas);
 
@@ -53,114 +36,20 @@
 			dispatch('unlock', e);
 		});
 
-		canvas.addEventListener('click', () => {
-			controls.lock();
-		});
-
-		canvas.addEventListener('keydown', (e) => {
-			switch (e.code) {
-				case 'ArrowUp':
-				case 'KeyW':
-					moveForward = true;
-					break;
-
-				case 'ArrowLeft':
-				case 'KeyA':
-					moveLeft = true;
-					break;
-
-				case 'ArrowDown':
-				case 'KeyS':
-					moveBackward = true;
-					break;
-
-				case 'ArrowRight':
-				case 'KeyD':
-					moveRight = true;
-					break;
+		// allows rotating the camera
+		controls.addEventListener('change', (e) => {
+			dispatch('change', e);
 
-				case 'Space':
-					if (canJump === true) velocity.y += 350;
-					canJump = false;
-					break;
-			}
+			root.invalidate();
 		});
 
-		canvas.addEventListener('keyup', (e) => {
-			switch (e.code) {
-				case 'ArrowUp':
-				case 'KeyW':
-					moveForward = false;
-					break;
-
-				case 'ArrowLeft':
-				case 'KeyA':
-					moveLeft = false;
-					break;
-
-				case 'ArrowDown':
-				case 'KeyS':
-					moveBackward = false;
-					break;
-
-				case 'ArrowRight':
-				case 'KeyD':
-					moveRight = false;
-					break;
-			}
+		canvas.addEventListener('click', () => {
+			controls.lock();
 		});
 
 		return controls;
 	});
 
-	onFrame(() => {
-		if (controls && isLocked) {
-			const camera = controls.getObject()
-			const time = performance.now();
-
-			const delta = (time - prevTime) / 1000;
-
-			velocity.x -= velocity.x * 10.0 * delta;
-			velocity.z -= velocity.z * 10.0 * delta;
-
-			velocity.y -= 9.8 * 100.0 * delta; // 100.0 = mass
-
-			direction.z = Number(moveForward) - Number(moveBackward);
-			direction.x = Number(moveRight) - Number(moveLeft);
-			direction.normalize(); // this ensures consistent movements in all directions
-
-			if (moveForward || moveBackward) velocity.z -= direction.z * 400.0 * delta;
-			if (moveLeft || moveRight) velocity.x -= direction.x * 400.0 * delta;
-
-			raycaster.ray.origin.copy( camera.position );
-			raycaster.ray.origin.y -= 10;
-
-			console.log(objects);
-			// const intersections = raycaster.intersectObjects( objects.map(object => object.mesh), false );
-
-			// const onObject = intersections.length > 0;
-
-			// if (onObject === true) {
-			// 	velocity.y = Math.max(0, velocity.y);
-			// 	canJump = true;
-			// }
-
-			controls.moveRight(-velocity.x * delta);
-			controls.moveForward(-velocity.z * delta);
-
-			camera.position.y += velocity.y * delta; // new behavior
-
-			if (camera.position.y < 10) {
-				velocity.y = 0;
-				camera.position.y = 10;
-
-				canJump = true;
-			}
-
-			prevTime = time;
-		}
-	});
-
 	$: if (controls) {
 		controls.isLocked = isLocked;
 		controls.maxPolarAngle = maxPolarAngle;
diff --git a/src/routes/examples/_content/03-first-person-camera/index.svelte b/src/routes/examples/_content/03-first-person-camera/index.svelte
index 026170c..2931c10 100644
--- a/src/routes/examples/_content/03-first-person-camera/index.svelte
+++ b/src/routes/examples/_content/03-first-person-camera/index.svelte
@@ -14,7 +14,7 @@
 >
 	<SC.Group position={[0, -1 / 2, 0]}>
 		<SC.Mesh
-		bind:this={floor}
+			bind:this={floor}
 			geometry={new THREE.PlaneGeometry(50, 50)}
 			material={new THREE.MeshStandardMaterial({ color: 'burlywood' })}
 			rotation={[-Math.PI / 2, 0, 0]}
@@ -35,7 +35,7 @@
 	/>
 
 	<SC.PerspectiveCamera position={[1, 1, 3]} />
-	<SC.PointerLockControls maxPolarAngle={Math.PI * 0.51} objects={[floor, cube]} />
+	<SC.PointerLockControls />
 	<SC.AmbientLight intensity={0.6} />
 	<SC.DirectionalLight intensity={0.6} position={[-2, 3, 2]} shadow={{ mapSize: [2048, 2048] }} />
 </SC.Canvas>

From 358d37f065e4add8339604d28e46df73fe3309ad Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Tue, 7 Dec 2021 17:59:09 +0100
Subject: [PATCH 4/6] add preview image

---
 .../example-thumbnails/first-person-camera.jpg  | Bin 0 -> 25105 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 static/example-thumbnails/first-person-camera.jpg

diff --git a/static/example-thumbnails/first-person-camera.jpg b/static/example-thumbnails/first-person-camera.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..9cd78bcece3e3ebd80fccdd1654aa1a9444070fe
GIT binary patch
literal 25105
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

literal 0
HcmV?d00001


From 50991eae1e03d3c75d9e07e3a6bc3c90dcb85b86 Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Sun, 12 Dec 2021 09:49:18 +0100
Subject: [PATCH 5/6] Add placeholder for pointerlockcontrols in docs

---
 src/routes/docs/_content/02-reference/index.svelte.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/routes/docs/_content/02-reference/index.svelte.md b/src/routes/docs/_content/02-reference/index.svelte.md
index 00f95ea..ae60513 100644
--- a/src/routes/docs/_content/02-reference/index.svelte.md
+++ b/src/routes/docs/_content/02-reference/index.svelte.md
@@ -161,6 +161,10 @@ TODO
 
 TODO
 
+### <PointerLockControls>
+
+TODO
+
 ## Helpers
 
 ### <SkeletonHelper>

From 4999dfbba4668cd4ea26ba2690b77d44d13745fa Mon Sep 17 00:00:00 2001
From: Pascal Galle <pascal.galle@gmx.de>
Date: Sun, 12 Dec 2021 13:19:56 +0100
Subject: [PATCH 6/6] add keyboard movement to pointerlockcontrols

---
 .../controls/PointerLockControls.svelte       | 88 ++++++++++++++++++-
 .../03-first-person-camera/index.svelte       | 16 ++--
 2 files changed, 97 insertions(+), 7 deletions(-)

diff --git a/src/lib/components/controls/PointerLockControls.svelte b/src/lib/components/controls/PointerLockControls.svelte
index eb8c949..14931bc 100644
--- a/src/lib/components/controls/PointerLockControls.svelte
+++ b/src/lib/components/controls/PointerLockControls.svelte
@@ -1,7 +1,9 @@
 <script>
+	import * as THREE from 'three';
 	import { setup } from '../../utils/context.js';
 	import { PointerLockControls } from 'three/examples/jsm/controls/PointerLockControls.js';
-	import { createEventDispatcher } from 'svelte';
+	import { createEventDispatcher, onDestroy } from 'svelte';
+	import { onFrame } from '$lib/utils/lifecycle.js';
 
 	export let maxPolarAngle = Math.PI;
 	export let minPolarAngle = 0;
@@ -12,7 +14,7 @@
 	const dispatch = createEventDispatcher();
 
 	/** @type {PointerLockControls} */
-	let controls;
+	export let controls = undefined;
 
 	root.controls.set((camera, canvas) => {
 
@@ -28,11 +30,19 @@
 
 		controls.addEventListener('lock', (e) => {
 			isLocked = true;
+			if (enableMovement) {
+				document.addEventListener('keydown', setPressedKeys);
+				document.addEventListener('keyup', removePressedKeys);
+			}
 			dispatch('lock', e);
 		});
 
 		controls.addEventListener('unlock', (e) => {
 			isLocked = false;
+			if (enableMovement) {
+				document.removeEventListener('keydown', setPressedKeys);
+				document.removeEventListener('keyup', removePressedKeys);
+			}
 			dispatch('unlock', e);
 		});
 
@@ -55,4 +65,78 @@
 		controls.maxPolarAngle = maxPolarAngle;
 		controls.minPolarAngle = minPolarAngle;
 	}
+
+	// Movement stuff only
+	/** @type {Record<string | number | symbol, boolean>} */
+	export let pressedKeys = {}
+	export let speed = 1
+	export let enableMovement = false
+
+	const velocity = new THREE.Vector3();
+	const direction = new THREE.Vector3();
+	/** @type {number} */
+	let prevTime;
+
+	let time = performance.now()
+	$: if (enableMovement && controls.isLocked) {
+		const moveForward = [
+			pressedKeys['w'],
+			pressedKeys['ArrowUp'],
+		].includes(true);
+
+		const moveLeft = [
+			pressedKeys['a'],
+			pressedKeys['ArrowLeft'],
+		].includes(true);
+
+		const moveBackward = [
+			pressedKeys['s'],
+			pressedKeys['ArrowDown'],
+		].includes(true);
+
+		const moveRight = [
+			pressedKeys['d'],
+			pressedKeys['ArrowRight'],
+		].includes(true);
+
+		const moved = moveForward || moveLeft || moveBackward || moveRight;
+
+		if (moved) {
+			const delta = (time - prevTime) / 1000;
+
+			velocity.x -= velocity.x * 10 * delta;
+			velocity.z -= velocity.z * 10 * delta;
+
+			direction.z = Number( moveForward ) - Number( moveBackward );
+			direction.x = Number( moveRight ) - Number( moveLeft );
+			direction.normalize(); // this ensures consistent movements in all directions
+
+			if ( moveForward || moveBackward ) velocity.z -= direction.z * delta;
+			if ( moveLeft || moveRight ) velocity.x -= direction.x * delta;
+
+			controls.moveRight( -velocity.x * delta * speed * 10 );
+			controls.moveForward( -velocity.z * delta * speed * 10);
+
+			root.invalidate();
+		} else {
+			velocity.set(0,0,0);
+		}
+	}
+
+	onFrame(() => {
+		prevTime = time;
+		time = performance.now();
+	})
+
+	onDestroy(() => {
+		document.removeEventListener('keydown', setPressedKeys);
+		document.removeEventListener('keyup', removePressedKeys);
+	})
+
+	function setPressedKeys(e) {
+		pressedKeys[e.key] = true
+	}
+	function removePressedKeys(e) {
+		pressedKeys[e.key] = false
+	}
 </script>
diff --git a/src/routes/examples/_content/03-first-person-camera/index.svelte b/src/routes/examples/_content/03-first-person-camera/index.svelte
index 2931c10..24eecd9 100644
--- a/src/routes/examples/_content/03-first-person-camera/index.svelte
+++ b/src/routes/examples/_content/03-first-person-camera/index.svelte
@@ -2,8 +2,16 @@
 	import * as THREE from 'three';
 	import * as SC from 'svelte-cubed';
 
-	let floor
-	let cube
+	/** @type {Record<string | number | symbol, boolean>} */
+	let pressedKeys = {}
+	let speed = 1
+	$: {
+		if (pressedKeys['Shift']) {
+			speed = 5
+		} else {
+			speed = 1
+		}
+	}
 </script>
 
 <SC.Canvas
@@ -14,7 +22,6 @@
 >
 	<SC.Group position={[0, -1 / 2, 0]}>
 		<SC.Mesh
-			bind:this={floor}
 			geometry={new THREE.PlaneGeometry(50, 50)}
 			material={new THREE.MeshStandardMaterial({ color: 'burlywood' })}
 			rotation={[-Math.PI / 2, 0, 0]}
@@ -27,7 +34,6 @@
 	</SC.Group>
 
 	<SC.Mesh
-		bind:this={cube}
 		geometry={new THREE.BoxGeometry()}
 		material={new THREE.MeshStandardMaterial({ color: 0xff3e00 })}
 		scale={[1, 1, 1]}
@@ -35,7 +41,7 @@
 	/>
 
 	<SC.PerspectiveCamera position={[1, 1, 3]} />
-	<SC.PointerLockControls />
+	<SC.PointerLockControls enableMovement bind:speed bind:pressedKeys />
 	<SC.AmbientLight intensity={0.6} />
 	<SC.DirectionalLight intensity={0.6} position={[-2, 3, 2]} shadow={{ mapSize: [2048, 2048] }} />
 </SC.Canvas>