Skip to main content

vibe/animation/families/
haptics.rs

1//! Outbound Sensory Haptics Animation Family (Vibro clicks, Heartbeats, Kinesthetic resistance).
2
3use crate::animation::pga::Motor;
4use crate::animation::presets::AnimationSample;
5
6/// Evaluates the families family.
7pub fn eval(preset: &str, t: f64) -> AnimationSample {
8    match preset {
9        "vibro_click" | "click" => {
10            let dur = 0.030; // 30ms click
11            let intensity = if t <= dur {
12                (1.0 - t / dur) * (t * 1000.0).sin()
13            } else {
14                0.0
15            };
16            AnimationSample {
17                scalar: intensity,
18                vector: [intensity, 0.0, 0.0],
19                motor: Motor::identity(),
20                secondary: intensity.abs(),
21                settled: t > dur,
22            }
23        }
24        "heartbeat_pulse" | "heartbeat" => {
25            let cycle = t % 0.85; // ~70 BPM
26            let s1 = if cycle < 0.12 {
27                (cycle / 0.12 * std::f64::consts::PI).sin()
28            } else {
29                0.0
30            };
31            let s2 = if cycle > 0.22 && cycle < 0.34 {
32                ((cycle - 0.22) / 0.12 * std::f64::consts::PI).sin() * 0.6
33            } else {
34                0.0
35            };
36            let amp = s1 + s2;
37            AnimationSample {
38                scalar: amp,
39                vector: [amp, amp * 0.5, 0.0],
40                motor: Motor::identity(),
41                secondary: cycle,
42                settled: false,
43            }
44        }
45        "kinesthetic_resist" | "resist" => {
46            let v = (t * 5.0).sin();
47            let torque = -1.5 * v.signum() * v.abs().powf(1.8);
48            AnimationSample {
49                scalar: torque,
50                vector: [torque, 0.0, 0.0],
51                motor: Motor::identity(),
52                secondary: v,
53                settled: false,
54            }
55        }
56        _ => AnimationSample::default(),
57    }
58}