Product media placeholder
Replace this area with a screenshot or short walkthrough video during the media sweep.
Per-frame pointer velocity. One node emits five outputs in parallel — wire whichever fits.
Type mouseVelocityCategory inputsContext domDynamic ports noCompound no
Inputs
| Port | Type | Description |
|---|---|---|
mouseX | float | Normalized [0..1] pointer X. Wire from Pointer.normalizedX. |
mouseY | float | Normalized [0..1] pointer Y. Wire from Pointer.normalizedY. |
Outputs
| Port | Type | Description |
|---|---|---|
valueX | float | Signed delta on X remapped to [0..1] with 0.5 at rest. Drops into a 3-keyframe progress for left / neutral / right motion. |
valueY | float | Signed delta on Y remapped to [0..1] with 0.5 at rest. Use for up / neutral / down progress. |
absoluteX | float | Per-axis speed clamped to [0..1]. Direction-agnostic — only magnitude on X. |
absoluteY | float | Per-axis speed clamped to [0..1] on Y. |
magnitude | float | 2D speed √(dx²+dy²) clamped to [0..1]. Best single-output choice when direction doesn’t matter (cursor trail spawn rate, velocity-blur). |
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
sensitivity | float | 1 | Multiplier on the per-frame mouse delta before clamping. 1 = raw delta. Lower (0.3–0.5) for subtler effects, higher (2–5) when the cursor moves slowly and you still want strong velocity output. Example: 1 for cursor trail, 2 for parallax wiggle. min 0.01; step 0.1 |
smoothing | float | 0 | Per-frame retention factor on the raw delta (0 = no smoothing, raw frame-to-frame; 0.9 = very smooth, slow to react). Frame-rate independent. Example: 0 for snappy cursor trails, 0.4 for smooth parallax. min 0; max 1; step 0.01 |
decay | float | 0 | Per-frame retention of the peak/centered value after the cursor stops (0 = signal snaps back instantly, 0.95 = lingers for ~1 second). Without decay, velocity-driven effects vanish the instant motion stops. Example: 0.88 for velocity-blur that fades, 0 for instant cut-off. min 0; max 1; step 0.01 |
Use cases
- Velocity-reactive UI — skew, blur, or stretch elements proportional to cursor speed via `magnitude`. One node feeds all consumers.
- Directional parallax / tilt — `valueX` and `valueY` drop into a 3-stop progress (left / center / right) for subtle motion-aware depth.
- Distance-since-last-spawn — feed `magnitude` into `accumulatePulse` for spawn rates proportional to cursor speed (cursor trail, image trail).
Envelope
Use mouseVelocity as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.
Generated source
Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-inputs/