Deadzone (#19)

Author: hmans

.changeset/purple-goats-joke.md

@@ -0,0 +1,13 @@
+---
+"@hmans/controlfreak": patch
+---
+
+New processor: `deadzone`. Applies a deadzone to a `VectorControl`.
+
+```ts
+controller
+  .addControl("move", VectorControl)
+  .addStep(gamepad.axisVector(0, 1))
+  .addStep(processors.clampVector(1))
+  .addStep(processors.deadzone(0.15))
+```

apps/demo/src/controller.ts

@@ -23,6 +23,7 @@ controller
   .addStep(keyboard.compositeVector("KeyW", "KeyS", "KeyA", "KeyD"))
   .addStep(gamepad.axisVector(0, 1))
   .addStep(processors.clampVector(1))
+  .addStep(processors.deadzone(0.15))
 
 controller
   .addControl("fire", BooleanControl)
@@ -35,6 +36,7 @@ controller
     keyboard.compositeVector("ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight")
   )
   .addStep(gamepad.axisVector(2, 3))
+  .addStep(processors.deadzone(0.15))
   .addStep(processors.normalizeVector)
 
 controller.onDeviceChange.add((d) => console.log("new device:", d))

packages/controlfreak/src/processors.ts

@@ -13,3 +13,14 @@ export const clampVector = (maxLength = 1) => ({ value }: VectorControl) => {
     value.y *= factor
   }
 }
+
+export const deadzone = (threshold = 0.1) => ({ value }: VectorControl) => {
+  const length = vector.magnitude(value)
+
+  if (length < threshold) {
+    value.x = 0
+    value.y = 0
+  } else {
+    vector.multiply(value, (length - threshold) / (length - length * threshold))
+  }
+}