public
Description: KeyCastr, an open-source keystroke visualizer
Homepage: http://stephendeken.net/software/keycastr/
Clone URL: git://github.com/sdeken/keycastr.git
keycastr / KCVisualizer.m
100644 126 lines (102 sloc) 3.807 kb
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
// Copyright (c) 2009 Stephen Deken
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without modification,
// are permitted provided that the following conditions are met:
//
// * Redistributions of source code must retain the above copyright notice, this
// list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright notice,
// this list of conditions and the following disclaimer in the documentation
// and/or other materials provided with the distribution.
// * Neither the name KeyCastr nor the names of its contributors may be used to
// endorse or promote products derived from this software without specific
// prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
// WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
// IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
// INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
// BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
// OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
#import "KCVisualizer.h"
 
@interface KCVisualizer (Private)
 
+(NSMutableDictionary*) _registry;
 
@end
 
@implementation KCVisualizer
 
+(NSMutableDictionary*) _registry
{
static NSMutableDictionary* registry = nil;
if (registry == nil)
registry = [[NSMutableDictionary alloc] initWithCapacity:2];
return registry;
}
 
+(void) registerVisualizerFactory:(id<KCVisualizerFactory>)factory withName:(NSString*)name
{
[[KCVisualizer _registry] setObject:factory forKey:name];
}
 
+(id<KCVisualizer>) visualizerWithName:(NSString*)visualizerName
{
return [[[KCVisualizer _registry] objectForKey:visualizerName] constructVisualizer];
}
 
+(NSArray*) availableVisualizerFactories
{
return [[KCVisualizer _registry] allValues];
}
 
-(NSView*) preferencesView
{
return preferencesView;
}
 
-(NSString*) visualizerName
{
@throw [NSException exceptionWithName:@"KCNotImplementedException" reason:@"The method visualizerName must be implemented in a subclass." userInfo:nil];
return nil;
}
 
-(void) showVisualizer:(id)sender
{
}
 
-(void) hideVisualizer:(id)sender
{
}
 
-(void) deactivateVisualizer:(id)sender
{
}
 
-(void) noteKeyEvent:(KCKeystroke*)keystroke
{
// Default implementation does nothing.
}
 
-(void) noteFlagsChanged:(uint32_t)flags
{
// Default implementation does nothing.
}
 
@end
 
@implementation KCVisualizerFactory
 
-(NSString*) visualizerNibName
{
@throw [NSException exceptionWithName:@"KCNotImplementedException" reason:@"The method visualizerNibName must be implemented in a subclass." userInfo:nil];
return nil;
}
 
-(Class) visualizerClass
{
@throw [NSException exceptionWithName:@"KCNotImplementedException" reason:@"The method visualizerClass must be implemented in a subclass." userInfo:nil];
return nil;
}
 
-(id<KCVisualizer>) constructVisualizer
{
Class c = [self visualizerClass];
id<KCVisualizer> v = [[[c alloc] init] retain];
NSNib* nib = [[NSNib alloc] initWithNibNamed:[self visualizerNibName] bundle:[NSBundle bundleForClass:[self class]]];
if (![nib instantiateNibWithOwner:v topLevelObjects:nil])
return nil;
return v;
}
 
-(NSString*) visualizerName
{
@throw [NSException exceptionWithName:@"KCNotImplementedException" reason:@"The method visualizerName must be implemented in a subclass." userInfo:nil];
return nil;
}
 
@end