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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

#![allow(non_camel_case_types, non_snake_case, dead_code)]

use crate::Contact;
use objc2_core_foundation::{CFArray, CFDictionary, CFMutableDictionary, CFString};
use std::ffi::{c_char, c_long, c_void};
use std::ptr::NonNull;

pub type MTDeviceRef = *mut c_void;
pub type MTActuatorRef = *mut c_void;
pub type MTActuationRef = *const c_void;

pub type kern_return_t = i32;
pub type IOReturn = kern_return_t;
pub type OSStatus = i32;
pub type mach_port_t = u32;
pub type io_object_t = u32;
pub type io_iterator_t = io_object_t;
pub type io_service_t = io_object_t;
pub type io_connect_t = io_object_t;
pub type natural_t = u32;
pub type IONotificationPortRef = *mut c_void;
pub type dispatch_queue_t = *mut c_void;

pub const KERN_SUCCESS: kern_return_t = 0;
pub const K_IO_RETURN_SUCCESS: IOReturn = 0;
pub const K_IO_MAIN_PORT_DEFAULT: mach_port_t = 0;

const SYS_IOKIT: u32 = 0xE000_0000;
pub const K_IO_MESSAGE_CAN_SYSTEM_SLEEP: u32 = SYS_IOKIT | 0x270;
pub const K_IO_MESSAGE_SYSTEM_WILL_SLEEP: u32 = SYS_IOKIT | 0x280;
pub const K_IO_MESSAGE_SYSTEM_HAS_POWERED_ON: u32 = SYS_IOKIT | 0x300;

pub type ContactCallback = unsafe extern "C" fn(
    MTDeviceRef,
    *mut Contact,
    i32,
    f64,
    i32,
) -> i32;

pub type ContactCallbackWithRefcon = unsafe extern "C" fn(
    MTDeviceRef,
    *mut Contact,
    i32,
    f64,
    i32,
    *mut c_void,
);

pub type PathCallback = unsafe extern "C" fn(MTDeviceRef, isize, isize, *mut Contact);
pub type PathCallbackWithRefcon =
    unsafe extern "C" fn(MTDeviceRef, isize, isize, *mut Contact, *mut c_void);

pub type IOServiceMatchingCallback = unsafe extern "C" fn(*mut c_void, io_iterator_t);
pub type IOServiceInterestCallback = unsafe extern "C" fn(
    *mut c_void,
    io_service_t,
    natural_t,
    *mut c_void,
);

unsafe extern "C" {
    // MultitouchSupport.framework
    pub fn MTAbsoluteTimeGetCurrent() -> f64;
    pub fn MTDeviceIsAvailable() -> bool;
    pub fn MTDeviceCreateDefault() -> MTDeviceRef;
    pub fn MTDeviceCreateList() -> Option<NonNull<CFArray>>;
    pub fn MTDeviceCreateFromDeviceID(device_id: u64) -> MTDeviceRef;
    pub fn MTDeviceCreateFromService(service: io_service_t) -> MTDeviceRef;
    pub fn MTDeviceRelease(device: MTDeviceRef);
    pub fn MTDeviceStart(device: MTDeviceRef, mode: i32) -> OSStatus;
    pub fn MTDeviceStop(device: MTDeviceRef) -> OSStatus;

    pub fn MTDeviceIsRunning(device: MTDeviceRef) -> bool;
    pub fn MTDeviceIsBuiltIn(device: MTDeviceRef) -> bool;
    pub fn MTDeviceIsOpaqueSurface(device: MTDeviceRef) -> bool;
    pub fn MTDeviceIsAlive(device: MTDeviceRef) -> bool;
    pub fn MTDeviceIsMTHIDDevice(device: MTDeviceRef) -> bool;
    pub fn MTDeviceSupportsForce(device: MTDeviceRef) -> bool;
    pub fn MTDeviceSupportsActuation(device: MTDeviceRef) -> bool;
    pub fn MTDeviceDriverIsReady(device: MTDeviceRef) -> bool;
    pub fn MTDevicePowerControlSupported(device: MTDeviceRef) -> bool;

    pub fn MTDeviceGetService(device: MTDeviceRef) -> io_service_t;
    pub fn MTDeviceGetSensorSurfaceDimensions(device: MTDeviceRef, width: *mut i32, height: *mut i32) -> OSStatus;
    pub fn MTDeviceGetSensorDimensions(device: MTDeviceRef, rows: *mut i32, columns: *mut i32) -> OSStatus;
    pub fn MTDeviceGetFamilyID(device: MTDeviceRef, family_id: *mut i32) -> OSStatus;
    pub fn MTDeviceGetDeviceID(device: MTDeviceRef, device_id: *mut u64) -> OSStatus;
    pub fn MTDeviceGetVersion(device: MTDeviceRef, version: *mut i32) -> OSStatus;
    pub fn MTDeviceGetDriverType(device: MTDeviceRef, driver_type: *mut i32) -> OSStatus;
    pub fn MTDeviceGetTransportMethod(device: MTDeviceRef, transport: *mut i32) -> OSStatus;
    pub fn MTDeviceGetSerialNumber(device: MTDeviceRef, serial: *mut *const CFString) -> OSStatus;

    pub fn MTDeviceGetSystemForceResponseEnabled(device: MTDeviceRef) -> bool;
    pub fn MTDeviceSetSystemForceResponseEnabled(device: MTDeviceRef, enabled: bool);
    pub fn MTDeviceSupportsSilentClick(device: MTDeviceRef, supported: *mut bool) -> OSStatus;
    pub fn MTDevicePowerSetEnabled(device: MTDeviceRef, enabled: bool) -> OSStatus;
    pub fn MTDevicePowerGetEnabled(device: MTDeviceRef, enabled: *mut bool);

    pub fn MTRegisterContactFrameCallback(device: MTDeviceRef, callback: Option<ContactCallback>);
    pub fn MTUnregisterContactFrameCallback(
        device: MTDeviceRef,
        callback: Option<ContactCallbackWithRefcon>,
    );
    pub fn MTRegisterContactFrameCallbackWithRefcon(
        device: MTDeviceRef,
        callback: Option<ContactCallbackWithRefcon>,
        refcon: *mut c_void,
    );
    pub fn MTRegisterPathCallback(device: MTDeviceRef, callback: Option<PathCallback>);
    pub fn MTUnregisterPathCallback(device: MTDeviceRef, callback: Option<PathCallback>);
    pub fn MTRegisterPathCallbackWithRefcon(
        device: MTDeviceRef,
        callback: Option<PathCallbackWithRefcon>,
        refcon: *mut c_void,
    ) -> bool;
    pub fn MTUnregisterPathCallbackWithRefcon(
        device: MTDeviceRef,
        callback: Option<PathCallbackWithRefcon>,
    ) -> bool;

    pub fn MTDeviceGetMTActuator(device: MTDeviceRef) -> MTActuatorRef;
    pub fn MTActuatorGetSystemActuationsEnabled(actuator: MTActuatorRef) -> bool;
    pub fn MTActuatorSetSystemActuationsEnabled(actuator: MTActuatorRef, enabled: bool) -> OSStatus;
    pub fn MTActuatorCreateFromDeviceID(device_id: u64) -> MTActuatorRef;
    pub fn MTActuatorOpen(actuator: MTActuatorRef) -> IOReturn;
    pub fn MTActuatorClose(actuator: MTActuatorRef) -> IOReturn;
    pub fn MTActuatorActuate(actuator: MTActuatorRef, pattern: i32, flags: u32, intensity: f32, scale: f32) -> IOReturn;
    pub fn MTActuatorIsOpen(actuator: MTActuatorRef) -> bool;
    pub fn MTActuationActuate(actuation: MTActuationRef, actuator: MTActuatorRef, flags: u32) -> IOReturn;
    pub fn MTActuationCreateFromDictionary(dictionary: &CFDictionary, actuator: MTActuatorRef) -> MTActuationRef;

    // IOKit.framework
    pub fn IOServiceMatching(name: *const c_char) -> *mut CFMutableDictionary;
    pub fn IONotificationPortCreate(master_port: mach_port_t) -> IONotificationPortRef;
    pub fn IONotificationPortDestroy(port: IONotificationPortRef);
    pub fn IONotificationPortSetDispatchQueue(port: IONotificationPortRef, queue: dispatch_queue_t);
    pub fn IOServiceAddMatchingNotification(
        port: IONotificationPortRef,
        notification_type: *const c_char,
        matching: *const CFMutableDictionary,
        callback: Option<IOServiceMatchingCallback>,
        refcon: *mut c_void,
        iterator: *mut io_iterator_t,
    ) -> kern_return_t;
    pub fn IOIteratorNext(iterator: io_iterator_t) -> io_object_t;
    pub fn IOObjectRetain(object: io_object_t) -> kern_return_t;
    pub fn IOObjectRelease(object: io_object_t) -> kern_return_t;
    pub fn IORegisterForSystemPower(
        refcon: *mut c_void,
        port: *mut IONotificationPortRef,
        callback: Option<IOServiceInterestCallback>,
        notifier: *mut io_object_t,
    ) -> io_connect_t;
    pub fn IOAllowPowerChange(root_port: io_connect_t, notification_id: c_long) -> IOReturn;

    // libSystem / libdispatch
    pub fn dispatch_get_global_queue(identifier: isize, flags: usize) -> dispatch_queue_t;
}