multitouch 0.3.2

Raw macOS multitouch, gesture recognition, device monitoring, and Force Touch haptics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# multitouch

raw macOS multitouch, gesture recognition, device monitoring, and force touch haptics in rust

## documentation

documentation is available on [docs.rs](https://docs.rs/multitouch).

## synchronous gestures

For latency-sensitive clients, recognize borrowed contact frames on the native
callback thread without frame copies, queues, or a pump thread:

```rust
use multitouch::{GestureRecognizer, GestureTypes, Monitor};

let monitor = Monitor::with_gesture_handler(
    |_| GestureRecognizer::new(3).with_gesture_types(GestureTypes::SWIPE),
    |device, event| {
        // Each device owns an independent recognizer. Keep this handler short.
        println!("{device:?}: {event:?}");
    },
);
assert!(monitor.start());
// Keep `monitor` alive while your application runs. Drop/stop synchronizes with
// outstanding callbacks and cancels any active recognition.
```

`Device::subscribe_gestures` provides the same path for a specific device; keep
its `ContactSubscription` alive. `subscribe_contacts` and
`Monitor::with_device_handler` expose borrowed frames plus stop/reset events for
clients that need their own admission or release policy. Reset cancels recognition
without retiring the subscription. Wake recovery resets these handlers before
restarting native delivery.

Callbacks for one subscription are serialized; different devices may deliver
concurrently. Do not start/stop a device or monitor, reset a subscription, or drop
it from its own callback. Inline subscriptions end on lift, reset, or stop;
they do not schedule inactivity timers. Existing queue-backed gesture streams
retain their inactivity timeout behavior.

The delivery benchmark can be run with:

```sh
cargo test --release benchmark_delivery -- --ignored --nocapture
```

## license

licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.