initial revision

English.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+/* Localized versions of Info.plist keys */
+

JFHotkeyManager-Info.plist

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>${EXECUTABLE_NAME}</string>
+	<key>CFBundleIconFile</key>
+	<string></string>
+	<key>CFBundleIdentifier</key>
+	<string>com.yourcompany.${PRODUCT_NAME:rfc1034identifier}</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>${PRODUCT_NAME}</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>${MACOSX_DEPLOYMENT_TARGET}</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>NSMainNibFile</key>
+	<string>MainMenu</string>
+	<key>NSPrincipalClass</key>
+	<string>NSApplication</string>
+</dict>
+</plist>

JFHotkeyManager.h

@@ -0,0 +1,50 @@
+//
+//  JFHotkeyManager.m
+//  JFHotkeyManager
+//
+//  Created by Jason Frame on 23/02/2010.
+//  Copyright 2010 Jason Frame. All rights reserved.
+//
+
+#import <Cocoa/Cocoa.h>
+#import <Carbon/Carbon.h>
+
+typedef NSUInteger JFHotKeyRef;
+
+@interface JFHotkeyManager : NSObject {
+
+	NSMutableDictionary		*_hotkeys;
+	NSUInteger				_nextId;
+
+}
+
+- (JFHotKeyRef)bind:(NSString *)commandString
+			 target:(id)target
+			 action:(SEL)selector;
+
+- (JFHotKeyRef)bindKeyRef:(NSUInteger)keyRef
+			withModifiers:(NSUInteger)modifiers
+				   target:(id)target
+				   action:(SEL)selector;
+
+- (void)unbind:(JFHotKeyRef)keyRef;
+
+- (void)_dispatch:(NSUInteger)hotkeyId;
+
+@end
+
+@interface __JFHotkey : NSObject {
+	id				_target;
+	SEL				_action;
+	EventHotKeyRef	_ref;
+}
+
+- (id)initWithHotkeyID:(NSUInteger)hotkeyID
+				keyRef:(NSUInteger)keyRef
+			 modifiers:(NSUInteger)modifiers
+				target:(id)target
+				action:(SEL)selector;
+
+- (void)invoke;
+
+@end

JFHotkeyManager.m

@@ -0,0 +1,265 @@
+//
+//  JFHotkeyManager.m
+//  JFHotkeyManager
+//
+//  Created by Jason Frame on 23/02/2010.
+//  Copyright 2010 Jason Frame. All rights reserved.
+//
+
+#import "JFHotkeyManager.h"
+
+static OSStatus hotkeyHandler(EventHandlerCallRef hnd,
+							  EventRef evt,
+							  void *data) {
+
+	EventHotKeyID hkID;
+	GetEventParameter(evt, kEventParamDirectObject, typeEventHotKeyID, NULL, sizeof(hkID), NULL, &hkID);
+
+	JFHotkeyManager *hkm = (JFHotkeyManager *)data;
+	[hkm _dispatch:hkID.id];
+
+	return noErr;
+
+}
+
+static NSMutableDictionary *keyMap;
+static NSMutableDictionary *modMap;
+
+static void mapKey(NSString *s, NSUInteger key) {
+	[keyMap setObject:[NSNumber numberWithUnsignedInt:key] forKey:s];
+}
+
+static void mapMod(NSString *s, NSUInteger mod) {
+	[modMap setObject:[NSNumber numberWithUnsignedInt:mod] forKey:s];
+}
+
+
+@implementation __JFHotkey
+- (id)initWithHotkeyID:(NSUInteger)hotkeyID
+				keyRef:(NSUInteger)keyRef
+			 modifiers:(NSUInteger)modifiers
+				target:(id)target
+				action:(SEL)selector {
+	if (self = [super init]) {
+
+		EventHotKeyID kID;
+		kID.id = kID.signature = hotkeyID;
+
+		RegisterEventHotKey(keyRef, modifiers, kID, GetApplicationEventTarget(), 0, &_ref);
+
+		_target = target;
+		_action = selector;
+
+		[_target retain];
+
+	}
+	return self;
+}
+
+- (void)dealloc {
+	UnregisterEventHotKey(_ref);
+	[_target release];
+	[super dealloc];
+}
+
+- (void)invoke {
+	[_target performSelector:_action withObject:nil];
+}
+@end
+
+
+@implementation JFHotkeyManager
+
++ (void)initialize {
+
+	modMap = [[NSMutableDictionary alloc] init];
+	keyMap = [[NSMutableDictionary alloc] init];
+
+	// Is this guaranteed to be the same across systems/keyboards?
+	// Probably not.
+
+	//
+	// Keys
+
+	mapKey(@"a",		0x00);
+	mapKey(@"b",		0x0B);
+	mapKey(@"c",		0x09);
+	mapKey(@"d",		0x02);
+	mapKey(@"e",		0x0E);
+	mapKey(@"f",		0x03);
+	mapKey(@"g",		0x05);
+	mapKey(@"h",		0x04);
+	mapKey(@"i",		0x22);
+	mapKey(@"j",		0x26);
+	mapKey(@"k",		0x29);
+	mapKey(@"l",		0x25);
+	mapKey(@"m",		0x2E);
+	mapKey(@"n",		0x2D);
+	mapKey(@"o",		0x1F);
+	mapKey(@"p",		0x23);
+	mapKey(@"q",		0x0C);
+	mapKey(@"r",		0x0F);
+	mapKey(@"s",		0x01);
+	mapKey(@"t",		0x11);
+	mapKey(@"u",		0x20);
+	mapKey(@"v",		0x09);
+	mapKey(@"w",		0x0D);
+	mapKey(@"x",		0x07);
+	mapKey(@"y",		0x10);
+	mapKey(@"z",		0x06);
+
+	mapKey(@"0",		0x1D);
+	mapKey(@"1",		0x12);
+	mapKey(@"2",		0x13);
+	mapKey(@"3",		0x14);
+	mapKey(@"4",		0x15);
+	mapKey(@"5",		0x17);
+	mapKey(@"6",		0x16);
+	mapKey(@"7",		0x1A);
+	mapKey(@"8",		0x1C);
+	mapKey(@"9",		0x19);
+
+	mapKey(@",",		0x2B);
+	mapKey(@".",		0x2F);
+	mapKey(@"/",		0x2C);
+
+	mapKey(@"f1",		0x7A);
+	mapKey(@"f2",		0x79);
+	mapKey(@"f3",		0x63);
+	mapKey(@"f4",		0x76);
+	mapKey(@"f5",		0x60);
+	mapKey(@"f6",		0x61);
+	mapKey(@"f7",		0x62);
+	mapKey(@"f8",		0x64);
+	mapKey(@"f9",		0x65);
+	mapKey(@"f10",		0x6D);
+	mapKey(@"f11",		0x67);
+	mapKey(@"f12",		0x6F);
+	mapKey(@"f13",		0x69);
+	mapKey(@"f14",		0x6B);
+	mapKey(@"f15",		0x71);
+
+	mapKey(@"escape",	0x35);
+	mapKey(@"esc",		0x35);
+	mapKey(@"space",	0x31);
+	mapKey(@"enter",	0x24);
+	mapKey(@"tab",		0x30);
+	mapKey(@"backspace",0x33);
+	mapKey(@"bkspc",	0x33);
+
+	mapKey(@"left",		0x7B);
+	mapKey(@"right",	0x7C);
+	mapKey(@"down",		0x7D);
+	mapKey(@"up",		0x7E);
+
+	//
+	// Modifiers
+
+	mapMod(@"apple",	cmdKey);
+
+	mapMod(@"ctrl",		controlKey);
+	mapMod(@"ctl",		controlKey);
+	mapMod(@"control",	controlKey);
+
+	mapMod(@"opt",		optionKey);
+	mapMod(@"option",	optionKey);
+	mapMod(@"alt",		optionKey);
+
+	mapMod(@"cmd",		cmdKey);
+	mapMod(@"command",	cmdKey);
+	mapMod(@"apple",	cmdKey);
+
+	mapMod(@"shift",	shiftKey);
+
+}
+
+- (id)init {
+	if (self = [super init]) {
+
+		_hotkeys = [[NSMutableDictionary alloc] init];
+		_nextId = 1;
+
+		EventTypeSpec evtType;
+		evtType.eventClass = kEventClassKeyboard;
+		evtType.eventKind = kEventHotKeyPressed;
+		InstallApplicationEventHandler(&hotkeyHandler,
+									   1,
+									   &evtType,
+									   self,
+									   NULL);
+
+	}
+	return self;
+}
+
+- (void)dealloc {
+
+	// TODO: uninstall application event handler? couldn't find
+	// relevant method. didn't look for long though.
+
+	[_hotkeys release];
+	[super dealloc];
+
+}
+
+- (JFHotKeyRef)bind:(NSString *)commandString
+	  target:(id)target
+	  action:(SEL)selector {
+
+	NSUInteger keyRef		= 0;
+	NSUInteger modifiers	= 0;
+
+	NSArray *bits = [[commandString lowercaseString] componentsSeparatedByString:@" "];
+	for (NSString *bit in bits) {
+
+		NSNumber *code = [modMap objectForKey:bit];
+		if (code != nil) {
+			modifiers += [code unsignedLongValue];
+			continue;
+		}
+
+		code = [keyMap objectForKey:bit];
+		if (code != nil) {
+			keyRef = [code unsignedLongValue];
+			continue;
+		}
+
+	}
+
+	return [self bindKeyRef:keyRef
+			  withModifiers:modifiers
+				     target:target
+					 action:selector];
+
+}
+
+- (JFHotKeyRef)bindKeyRef:(NSUInteger)keyRef
+	 withModifiers:(NSUInteger)modifiers
+		    target:(id)target
+			action:(SEL)selector {
+
+	NSUInteger keyID = _nextId;
+	_nextId++;
+
+	__JFHotkey *hk = [[__JFHotkey alloc] initWithHotkeyID:keyID
+												   keyRef:keyRef
+												modifiers:modifiers
+												   target:target
+												   action:selector];
+
+	[_hotkeys setObject:hk forKey:[NSNumber numberWithUnsignedInt:keyID]];
+	[hk release];
+
+	return keyID;
+
+}
+
+- (void)unbind:(JFHotKeyRef)keyRef {
+	[_hotkeys removeObjectForKey:[NSNumber numberWithUnsignedInt:keyRef]];
+}
+
+- (void)_dispatch:(NSUInteger)hotkeyId {
+	[[_hotkeys objectForKey:[NSNumber numberWithUnsignedInt:hotkeyId]] invoke];
+}
+
+@end

JFHotkeyManager.xcodeproj/.gitignore

@@ -0,0 +1,3 @@
+jason.*
+*.pbxuser
+