M5MultitouchSupport
Easily and (thread/memory) safely consume global OS X multitouch (trackpad, Magic Mouse) events.
Installation
From CocoaPods
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like M5MultitouchSupport
in your projects. Simply add the following line to your Podfile:
pod 'M5MultitouchSupport'
If you want to use the latest features of M5MultitouchSupport
add :head
:
pod 'M5MultitouchSupport', :head
This pulls from the master
branch directly, which is almost always usually stable.
Manually
Note: Requires ARC, and Mac OS 10.8+
Using Framework
- Open the
M5MultitouchSupport/M5MultitouchSupport.xcodeproj
project, and build the default target. - Add the resulting
Products/M5MultitouchSupport.framework
to your project. - Add /System/Library/PrivateFrameworks/MultitouchSupport.framework to your project.
Using Source Files
- Drag the
M5MultitouchSupport/M5MultitouchSupport
folder into your project. - Add /System/Library/PrivateFrameworks/MultitouchSupport.framework to your project.
Usage
Using M5MultitouchSupport
in your app or framework is as simple as...
#import <M5MultitouchSupport.h>
Using Blocks
[M5MultitouchManager.sharedManager addListenerWithCallback:^(M5MultitouchEvent *event) {
NSLog(event.description);
/*
Touches: (
"ID: 3, State: 4 (Touching), Position: [0.251363, 0.475246], Velocity: [0.009912, -0.003619], Minor Axis: 8.160000, Major Axis: 9.920000, Angle: 1.911052, Size: 0.750000",
"ID: 6, State: 4 (Touching), Position: [0.618595, 0.839751], Velocity: [-0.007434, -0.014476], Minor Axis: 8.230000, Major Axis: 9.220000, Angle: 1.570796, Size: 0.625000",
"ID: 8, State: 4 (Touching), Position: [0.410051, 0.792415], Velocity: [0.008673, 0.018095], Minor Axis: 7.660000, Major Axis: 8.890000, Angle: 1.570796, Size: 0.628906"
), Device ID: 25381376, Frame ID: 1435, Timestamp: 3827.383000
*/
}];
Note: Multitouch event processing happens on a separate thread, but your listener will be passed events on the thread it was created (or the main thread if the original thread ever stops).
Using Targets/Selectors
[M5MultitouchManager.sharedManager addListenerWithTarget:self
selector:@selector(handleMultitouchEvent:)];
- (void)handleMultitouchEvent:(M5MultitouchEvent *)event {
NSLog(event.description);
}
Note: Only a weak reference is held to the target, and M5MultitouchManager
will safely remove the listener if that reference zeroes out.
Managing Listeners
M5MultitouchListener *listener = [M5MultitouchManager.sharedManager addListenerWith...
listener.listening = NO;
//Listener will stop receiving events until set to YES
[M5MultitouchManager.sharedManager removeListener:listener];
//Will stop/remove the listener altogether
Contributing to this project
If you have feature requests or bug reports, feel free to help out by sending pull requests or by creating new issues.
Credits
M5MultitouchSupport
is brought to you by Mathew Huusko V and contributors to the project. If you're using M5MultitouchSupport
in your project, attribution would be very appreciated.