src/video/cocoa/SDL_cocoakeyboard.m
author Sam Lantinga
Sat, 19 Sep 2009 13:29:40 +0000
changeset 3280 00cace2d9080
parent 3247 2dcfb4e07a57
child 3286 d390778b59c1
permissions -rw-r--r--
Merged a cleaned up version of Jiang's code changes from Google Summer of Code 2009
slouken@1931
     1
/*
slouken@1931
     2
    SDL - Simple DirectMedia Layer
slouken@2859
     3
    Copyright (C) 1997-2009 Sam Lantinga
slouken@1931
     4
slouken@1931
     5
    This library is free software; you can redistribute it and/or
slouken@1931
     6
    modify it under the terms of the GNU Lesser General Public
slouken@1931
     7
    License as published by the Free Software Foundation; either
slouken@1931
     8
    version 2.1 of the License, or (at your option) any later version.
slouken@1931
     9
slouken@1931
    10
    This library is distributed in the hope that it will be useful,
slouken@1931
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@1931
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@1931
    13
    Lesser General Public License for more details.
slouken@1931
    14
slouken@1931
    15
    You should have received a copy of the GNU Lesser General Public
slouken@1931
    16
    License along with this library; if not, write to the Free Software
slouken@1931
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
slouken@1931
    18
slouken@1931
    19
    Sam Lantinga
slouken@1931
    20
    slouken@libsdl.org
slouken@1931
    21
*/
slouken@1931
    22
#include "SDL_config.h"
slouken@1931
    23
slouken@1931
    24
#include "SDL_cocoavideo.h"
slouken@1931
    25
slouken@1931
    26
#include "../../events/SDL_keyboard_c.h"
slouken@2305
    27
#include "../../events/scancodes_darwin.h"
slouken@1931
    28
slouken@2268
    29
#include <Carbon/Carbon.h>
slouken@2268
    30
slouken@3280
    31
//#define DEBUG_IME NSLog
slouken@3280
    32
#define DEBUG_IME
slouken@1959
    33
slouken@1959
    34
#ifndef NX_DEVICERCTLKEYMASK
slouken@1959
    35
    #define NX_DEVICELCTLKEYMASK    0x00000001
slouken@1959
    36
#endif
slouken@1959
    37
#ifndef NX_DEVICELSHIFTKEYMASK
slouken@1959
    38
    #define NX_DEVICELSHIFTKEYMASK  0x00000002
slouken@1959
    39
#endif
slouken@1959
    40
#ifndef NX_DEVICERSHIFTKEYMASK
slouken@1959
    41
    #define NX_DEVICERSHIFTKEYMASK  0x00000004
slouken@1959
    42
#endif
slouken@1959
    43
#ifndef NX_DEVICELCMDKEYMASK
slouken@1959
    44
    #define NX_DEVICELCMDKEYMASK    0x00000008
slouken@1959
    45
#endif
slouken@1959
    46
#ifndef NX_DEVICERCMDKEYMASK
slouken@1959
    47
    #define NX_DEVICERCMDKEYMASK    0x00000010
slouken@1959
    48
#endif
slouken@1959
    49
#ifndef NX_DEVICELALTKEYMASK
slouken@1959
    50
    #define NX_DEVICELALTKEYMASK    0x00000020
slouken@1959
    51
#endif
slouken@1959
    52
#ifndef NX_DEVICERALTKEYMASK
slouken@1959
    53
    #define NX_DEVICERALTKEYMASK    0x00000040
slouken@1959
    54
#endif
slouken@1959
    55
#ifndef NX_DEVICERCTLKEYMASK
slouken@1959
    56
    #define NX_DEVICERCTLKEYMASK    0x00002000
slouken@1959
    57
#endif
slouken@1959
    58
slouken@3280
    59
@interface SDLTranslatorResponder : NSView <NSTextInput>
slouken@2289
    60
{
slouken@3280
    61
    NSString *_markedText;
slouken@3280
    62
    NSRange   _markedRange;
slouken@3280
    63
    NSRange   _selectedRange;
slouken@3280
    64
    SDL_Rect  _inputRect;
slouken@3280
    65
    int       _keyboard;
slouken@2289
    66
}
slouken@2289
    67
- (void) doCommandBySelector:(SEL)myselector;
slouken@3280
    68
- (void) setInputRect:(SDL_Rect *) rect;
slouken@3280
    69
- (void) setKeyboard:(int) keyboard;
slouken@2289
    70
@end
slouken@2289
    71
slouken@2289
    72
@implementation SDLTranslatorResponder
slouken@3280
    73
slouken@3280
    74
- (void) setKeyboard:(int) keyboard
slouken@3280
    75
{
slouken@3280
    76
    _keyboard = keyboard;
slouken@3280
    77
}
slouken@3280
    78
slouken@3280
    79
- (void) setInputRect:(SDL_Rect *) rect
slouken@3280
    80
{
slouken@3280
    81
    _inputRect = *rect;
slouken@3280
    82
}
slouken@3280
    83
slouken@3280
    84
- (void) insertText:(id) aString
slouken@3280
    85
{
slouken@3280
    86
    const char *str;
slouken@3280
    87
slouken@3280
    88
    DEBUG_IME(@"insertText: %@", aString);
slouken@3280
    89
slouken@3280
    90
    /* Could be NSString or NSAttributedString, so we have
slouken@3280
    91
     * to test and convert it before return as SDL event */
slouken@3280
    92
    if ([aString isKindOfClass: [NSAttributedString class]])
slouken@3280
    93
        str = [[aString string] UTF8String];
slouken@3280
    94
    else
slouken@3280
    95
        str = [aString UTF8String];
slouken@3280
    96
slouken@3280
    97
    SDL_SendKeyboardText(_keyboard, str);
slouken@3280
    98
}
slouken@3280
    99
slouken@3280
   100
- (void) doCommandBySelector:(SEL) myselector
slouken@3280
   101
{
slouken@3280
   102
    [super doCommandBySelector: myselector];
slouken@3280
   103
}
slouken@3280
   104
slouken@3280
   105
- (BOOL) hasMarkedText
slouken@3280
   106
{
slouken@3280
   107
    return _markedText != nil;
slouken@3280
   108
}
slouken@3280
   109
slouken@3280
   110
- (NSRange) markedRange
slouken@3280
   111
{
slouken@3280
   112
    return _markedRange;
slouken@3280
   113
}
slouken@3280
   114
slouken@3280
   115
- (NSRange) selectedRange
slouken@3280
   116
{
slouken@3280
   117
    return _selectedRange;
slouken@3280
   118
}
slouken@3280
   119
slouken@3280
   120
- (void) setMarkedText:(id) aString
slouken@3280
   121
         selectedRange:(NSRange) selRange
slouken@3280
   122
{
slouken@3280
   123
    if ([aString isKindOfClass: [NSAttributedString class]])
slouken@3280
   124
        aString = [aString string];
slouken@3280
   125
slouken@3280
   126
    if ([aString length] == 0)
slouken@3280
   127
    {
slouken@3280
   128
        [self unmarkText];
slouken@3280
   129
        return;
slouken@3280
   130
    }
slouken@3280
   131
slouken@3280
   132
    if (_markedText != aString)
slouken@3280
   133
    {
slouken@3280
   134
        [_markedText release];
slouken@3280
   135
        _markedText = [aString retain];
slouken@3280
   136
    }
slouken@3280
   137
slouken@3280
   138
    _selectedRange = selRange;
slouken@3280
   139
    _markedRange = NSMakeRange(0, [aString length]);
slouken@3280
   140
slouken@3280
   141
    SDL_SendEditingText([aString UTF8String], selRange.location, selRange.length);
slouken@3280
   142
slouken@3280
   143
    DEBUG_IME(@"setMarkedText: %@, (%d, %d)", _markedText,
slouken@3280
   144
          selRange.location, selRange.length);
slouken@3280
   145
}
slouken@3280
   146
slouken@3280
   147
- (void) unmarkText
slouken@3280
   148
{
slouken@3280
   149
    [_markedText release];
slouken@3280
   150
    _markedText = nil;
slouken@3280
   151
}
slouken@3280
   152
slouken@3280
   153
- (NSRect) firstRectForCharacterRange: (NSRange) theRange
slouken@3280
   154
{
slouken@3280
   155
    float windowHeight = [[self window] frame].size.height;
slouken@3280
   156
    NSRect rect = NSMakeRect(_inputRect.x, windowHeight - _inputRect.y - _inputRect.h,
slouken@3280
   157
                             _inputRect.w, _inputRect.h);
slouken@3280
   158
slouken@3280
   159
    DEBUG_IME(@"firstRectForCharacterRange: (%d, %d): windowHeight = %g, rect = %@",
slouken@3280
   160
            theRange.location, theRange.length, windowHeight,
slouken@3280
   161
            NSStringFromRect(rect));
slouken@3280
   162
    rect.origin = [[self window] convertBaseToScreen: rect.origin];
slouken@3280
   163
slouken@3280
   164
    return rect;
slouken@3280
   165
}
slouken@3280
   166
slouken@3280
   167
- (NSAttributedString *) attributedSubstringFromRange: (NSRange) theRange
slouken@3280
   168
{
slouken@3280
   169
    DEBUG_IME(@"attributedSubstringFromRange: (%d, %d)", theRange.location, theRange.length);
slouken@3280
   170
    return nil;
slouken@3280
   171
}
slouken@3280
   172
slouken@3280
   173
- (NSInteger) conversationIdentifier
slouken@3280
   174
{
slouken@3280
   175
    return (NSInteger) self;
slouken@3280
   176
}
slouken@3280
   177
slouken@3280
   178
// This method returns the index for character that is 
slouken@3280
   179
// nearest to thePoint.  thPoint is in screen coordinate system.
slouken@3280
   180
- (NSUInteger) characterIndexForPoint:(NSPoint) thePoint
slouken@3280
   181
{
slouken@3280
   182
    DEBUG_IME(@"characterIndexForPoint: (%g, %g)", thePoint.x, thePoint.y);
slouken@3280
   183
    return 0;
slouken@3280
   184
}
slouken@3280
   185
slouken@3280
   186
// This method is the key to attribute extension. 
slouken@3280
   187
// We could add new attributes through this method.
slouken@3280
   188
// NSInputServer examines the return value of this
slouken@3280
   189
// method & constructs appropriate attributed string.
slouken@3280
   190
- (NSArray *) validAttributesForMarkedText
slouken@3280
   191
{
slouken@3280
   192
    return [NSArray array];
slouken@3280
   193
}
slouken@3280
   194
slouken@2289
   195
@end
slouken@2289
   196
slouken@1959
   197
/* This is the original behavior, before support was added for 
slouken@1959
   198
 * differentiating between left and right versions of the keys.
slouken@1959
   199
 */
slouken@1959
   200
static void
slouken@1959
   201
DoUnsidedModifiers(int keyboard, unsigned short scancode,
slouken@1959
   202
                   unsigned int oldMods, unsigned int newMods)
slouken@1959
   203
{
slouken@2303
   204
    const int mapping[] = {
slouken@2303
   205
        SDL_SCANCODE_CAPSLOCK,
slouken@2303
   206
        SDL_SCANCODE_LSHIFT,
slouken@2303
   207
        SDL_SCANCODE_LCTRL,
slouken@2303
   208
        SDL_SCANCODE_LALT,
slouken@2303
   209
        SDL_SCANCODE_LGUI
slouken@2303
   210
    };
slouken@1959
   211
    unsigned int i, bit;
slouken@1959
   212
slouken@1959
   213
    /* Iterate through the bits, testing each against the current modifiers */
slouken@1959
   214
    for (i = 0, bit = NSAlphaShiftKeyMask; bit <= NSCommandKeyMask; bit <<= 1, ++i) {
slouken@1959
   215
        unsigned int oldMask, newMask;
slouken@1959
   216
slouken@1959
   217
        oldMask = oldMods & bit;
slouken@1959
   218
        newMask = newMods & bit;
slouken@1959
   219
slouken@1959
   220
        if (oldMask && oldMask != newMask) {        /* modifier up event */
slouken@1959
   221
            /* If this was Caps Lock, we need some additional voodoo to make SDL happy */
slouken@1959
   222
            if (bit == NSAlphaShiftKeyMask) {
slouken@2303
   223
                SDL_SendKeyboardKey(keyboard, SDL_PRESSED, mapping[i]);
slouken@1959
   224
            }
slouken@2303
   225
            SDL_SendKeyboardKey(keyboard, SDL_RELEASED, mapping[i]);
slouken@1959
   226
        } else if (newMask && oldMask != newMask) { /* modifier down event */
slouken@2303
   227
            SDL_SendKeyboardKey(keyboard, SDL_PRESSED, mapping[i]);
slouken@1959
   228
            /* If this was Caps Lock, we need some additional voodoo to make SDL happy */
slouken@1959
   229
            if (bit == NSAlphaShiftKeyMask) {
slouken@2303
   230
                SDL_SendKeyboardKey(keyboard, SDL_RELEASED, mapping[i]);
slouken@1959
   231
            }
slouken@1959
   232
        }
slouken@1959
   233
    }
slouken@1959
   234
}
slouken@1959
   235
slouken@1959
   236
/* This is a helper function for HandleModifierSide. This 
slouken@1959
   237
 * function reverts back to behavior before the distinction between
slouken@1959
   238
 * sides was made.
slouken@1959
   239
 */
slouken@1959
   240
static void
slouken@2303
   241
HandleNonDeviceModifier(int keyboard,
slouken@1959
   242
                        unsigned int device_independent_mask,
slouken@1959
   243
                        unsigned int oldMods,
slouken@1959
   244
                        unsigned int newMods,
slouken@2303
   245
                        SDL_scancode scancode)
slouken@1959
   246
{
slouken@1959
   247
    unsigned int oldMask, newMask;
slouken@1959
   248
    
slouken@1959
   249
    /* Isolate just the bits we care about in the depedent bits so we can 
slouken@1959
   250
     * figure out what changed
slouken@1959
   251
     */ 
slouken@1959
   252
    oldMask = oldMods & device_independent_mask;
slouken@1959
   253
    newMask = newMods & device_independent_mask;
slouken@1959
   254
    
slouken@1959
   255
    if (oldMask && oldMask != newMask) {
slouken@2303
   256
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, scancode);
slouken@1959
   257
    } else if (newMask && oldMask != newMask) {
slouken@2303
   258
        SDL_SendKeyboardKey(keyboard, SDL_PRESSED, scancode);
slouken@1959
   259
    }
slouken@1959
   260
}
slouken@1959
   261
slouken@1959
   262
/* This is a helper function for HandleModifierSide. 
slouken@1959
   263
 * This function sets the actual SDL_PrivateKeyboard event.
slouken@1959
   264
 */
slouken@1959
   265
static void
slouken@2303
   266
HandleModifierOneSide(int keyboard,
slouken@1959
   267
                      unsigned int oldMods, unsigned int newMods,
slouken@2303
   268
                      SDL_scancode scancode, 
slouken@1959
   269
                      unsigned int sided_device_dependent_mask)
slouken@1959
   270
{
slouken@1959
   271
    unsigned int old_dep_mask, new_dep_mask;
slouken@1959
   272
slouken@1959
   273
    /* Isolate just the bits we care about in the depedent bits so we can 
slouken@1959
   274
     * figure out what changed
slouken@1959
   275
     */ 
slouken@1959
   276
    old_dep_mask = oldMods & sided_device_dependent_mask;
slouken@1959
   277
    new_dep_mask = newMods & sided_device_dependent_mask;
slouken@1959
   278
slouken@1959
   279
    /* We now know that this side bit flipped. But we don't know if
slouken@1959
   280
     * it went pressed to released or released to pressed, so we must 
slouken@1959
   281
     * find out which it is.
slouken@1959
   282
     */
slouken@1959
   283
    if (new_dep_mask && old_dep_mask != new_dep_mask) {
slouken@2303
   284
        SDL_SendKeyboardKey(keyboard, SDL_PRESSED, scancode);
slouken@1959
   285
    } else {
slouken@2303
   286
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, scancode);
slouken@1959
   287
    }
slouken@1959
   288
}
slouken@1959
   289
slouken@1959
   290
/* This is a helper function for DoSidedModifiers.
slouken@1959
   291
 * This function will figure out if the modifier key is the left or right side, 
slouken@1959
   292
 * e.g. left-shift vs right-shift. 
slouken@1959
   293
 */
slouken@1959
   294
static void
slouken@2303
   295
HandleModifierSide(int keyboard,
slouken@1959
   296
                   int device_independent_mask, 
slouken@1959
   297
                   unsigned int oldMods, unsigned int newMods, 
slouken@2303
   298
                   SDL_scancode left_scancode, 
slouken@2303
   299
                   SDL_scancode right_scancode,
slouken@1959
   300
                   unsigned int left_device_dependent_mask, 
slouken@1959
   301
                   unsigned int right_device_dependent_mask)
slouken@1959
   302
{
slouken@1959
   303
    unsigned int device_dependent_mask = (left_device_dependent_mask |
slouken@1959
   304
                                         right_device_dependent_mask);
slouken@1959
   305
    unsigned int diff_mod;
slouken@1959
   306
    
slouken@1959
   307
    /* On the basis that the device independent mask is set, but there are 
slouken@1959
   308
     * no device dependent flags set, we'll assume that we can't detect this 
slouken@1959
   309
     * keyboard and revert to the unsided behavior.
slouken@1959
   310
     */
slouken@1959
   311
    if ((device_dependent_mask & newMods) == 0) {
slouken@1959
   312
        /* Revert to the old behavior */
slouken@2303
   313
        HandleNonDeviceModifier(keyboard, device_independent_mask, oldMods, newMods, left_scancode);
slouken@1959
   314
        return;
slouken@1959
   315
    }
slouken@1959
   316
slouken@1959
   317
    /* XOR the previous state against the new state to see if there's a change */
slouken@1959
   318
    diff_mod = (device_dependent_mask & oldMods) ^
slouken@1959
   319
               (device_dependent_mask & newMods);
slouken@1959
   320
    if (diff_mod) {
slouken@1959
   321
        /* A change in state was found. Isolate the left and right bits 
slouken@1959
   322
         * to handle them separately just in case the values can simulataneously
slouken@1959
   323
         * change or if the bits don't both exist.
slouken@1959
   324
         */
slouken@1959
   325
        if (left_device_dependent_mask & diff_mod) {
slouken@2303
   326
            HandleModifierOneSide(keyboard, oldMods, newMods, left_scancode, left_device_dependent_mask);
slouken@1959
   327
        }
slouken@1959
   328
        if (right_device_dependent_mask & diff_mod) {
slouken@2303
   329
            HandleModifierOneSide(keyboard, oldMods, newMods, right_scancode, right_device_dependent_mask);
slouken@1959
   330
        }
slouken@1959
   331
    }
slouken@1959
   332
}
slouken@1959
   333
   
slouken@1959
   334
/* This is a helper function for DoSidedModifiers.
slouken@1959
   335
 * This function will release a key press in the case that 
slouken@1959
   336
 * it is clear that the modifier has been released (i.e. one side 
slouken@1959
   337
 * can't still be down).
slouken@1959
   338
 */
slouken@1959
   339
static void
slouken@2303
   340
ReleaseModifierSide(int keyboard,
slouken@1959
   341
                    unsigned int device_independent_mask, 
slouken@1959
   342
                    unsigned int oldMods, unsigned int newMods,
slouken@2303
   343
                    SDL_scancode left_scancode, 
slouken@2303
   344
                    SDL_scancode right_scancode,
slouken@1959
   345
                    unsigned int left_device_dependent_mask, 
slouken@1959
   346
                    unsigned int right_device_dependent_mask)
slouken@1959
   347
{
slouken@1959
   348
    unsigned int device_dependent_mask = (left_device_dependent_mask |
slouken@1959
   349
                                          right_device_dependent_mask);
slouken@1959
   350
slouken@1959
   351
    /* On the basis that the device independent mask is set, but there are 
slouken@1959
   352
     * no device dependent flags set, we'll assume that we can't detect this 
slouken@1959
   353
     * keyboard and revert to the unsided behavior.
slouken@1959
   354
     */
slouken@1959
   355
    if ((device_dependent_mask & oldMods) == 0) {
slouken@1959
   356
        /* In this case, we can't detect the keyboard, so use the left side 
slouken@1959
   357
         * to represent both, and release it. 
slouken@1959
   358
         */
slouken@2303
   359
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, left_scancode);
slouken@1959
   360
        return;
slouken@1959
   361
    }
slouken@1959
   362
slouken@1959
   363
    /* 
slouken@1959
   364
     * This could have been done in an if-else case because at this point,
slouken@1959
   365
     * we know that all keys have been released when calling this function. 
slouken@1959
   366
     * But I'm being paranoid so I want to handle each separately,
slouken@1959
   367
     * so I hope this doesn't cause other problems.
slouken@1959
   368
     */
slouken@1959
   369
    if ( left_device_dependent_mask & oldMods ) {
slouken@2303
   370
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, left_scancode);
slouken@1959
   371
    }
slouken@1959
   372
    if ( right_device_dependent_mask & oldMods ) {
slouken@2303
   373
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, right_scancode);
slouken@1959
   374
    }
slouken@1959
   375
}
slouken@1959
   376
slouken@1959
   377
/* This is a helper function for DoSidedModifiers.
slouken@1959
   378
 * This function handles the CapsLock case.
slouken@1959
   379
 */
slouken@1959
   380
static void
slouken@1959
   381
HandleCapsLock(int keyboard, unsigned short scancode,
slouken@1959
   382
               unsigned int oldMods, unsigned int newMods)
slouken@1959
   383
{
slouken@1959
   384
    unsigned int oldMask, newMask;
slouken@1959
   385
    
slouken@1959
   386
    oldMask = oldMods & NSAlphaShiftKeyMask;
slouken@1959
   387
    newMask = newMods & NSAlphaShiftKeyMask;
slouken@1959
   388
slouken@1959
   389
    if (oldMask != newMask) {
slouken@2303
   390
        SDL_SendKeyboardKey(keyboard, SDL_PRESSED, SDL_SCANCODE_CAPSLOCK);
slouken@2303
   391
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, SDL_SCANCODE_CAPSLOCK);
slouken@1959
   392
    }
slouken@1960
   393
slouken@1960
   394
    oldMask = oldMods & NSNumericPadKeyMask;
slouken@1960
   395
    newMask = newMods & NSNumericPadKeyMask;
slouken@1960
   396
slouken@1960
   397
    if (oldMask != newMask) {
slouken@2303
   398
        SDL_SendKeyboardKey(keyboard, SDL_PRESSED, SDL_SCANCODE_NUMLOCKCLEAR);
slouken@2303
   399
        SDL_SendKeyboardKey(keyboard, SDL_RELEASED, SDL_SCANCODE_NUMLOCKCLEAR);
slouken@1960
   400
    }
slouken@1959
   401
}
slouken@1959
   402
slouken@1959
   403
/* This function will handle the modifier keys and also determine the 
slouken@1959
   404
 * correct side of the key.
slouken@1959
   405
 */
slouken@1959
   406
static void
slouken@1959
   407
DoSidedModifiers(int keyboard, unsigned short scancode,
slouken@1959
   408
                 unsigned int oldMods, unsigned int newMods)
slouken@1959
   409
{
slouken@1959
   410
	/* Set up arrays for the key syms for the left and right side. */
slouken@2303
   411
    const SDL_scancode left_mapping[]  = {
slouken@2303
   412
        SDL_SCANCODE_LSHIFT,
slouken@2303
   413
        SDL_SCANCODE_LCTRL,
slouken@2303
   414
        SDL_SCANCODE_LALT,
slouken@2303
   415
        SDL_SCANCODE_LGUI
slouken@2303
   416
    };
slouken@2303
   417
    const SDL_scancode right_mapping[] = {
slouken@2303
   418
        SDL_SCANCODE_RSHIFT,
slouken@2303
   419
        SDL_SCANCODE_RCTRL,
slouken@2303
   420
        SDL_SCANCODE_RALT,
slouken@2303
   421
        SDL_SCANCODE_RGUI
slouken@2303
   422
    };
slouken@1959
   423
	/* Set up arrays for the device dependent masks with indices that 
slouken@1959
   424
     * correspond to the _mapping arrays 
slouken@1959
   425
     */
slouken@1959
   426
    const unsigned int left_device_mapping[]  = { NX_DEVICELSHIFTKEYMASK, NX_DEVICELCTLKEYMASK, NX_DEVICELALTKEYMASK, NX_DEVICELCMDKEYMASK };
slouken@1959
   427
    const unsigned int right_device_mapping[] = { NX_DEVICERSHIFTKEYMASK, NX_DEVICERCTLKEYMASK, NX_DEVICERALTKEYMASK, NX_DEVICERCMDKEYMASK };
slouken@1959
   428
slouken@1959
   429
    unsigned int i, bit;
slouken@1959
   430
slouken@1959
   431
    /* Handle CAPSLOCK separately because it doesn't have a left/right side */
slouken@1959
   432
    HandleCapsLock(keyboard, scancode, oldMods, newMods);
slouken@1959
   433
slouken@1959
   434
    /* Iterate through the bits, testing each against the old modifiers */
slouken@1959
   435
    for (i = 0, bit = NSShiftKeyMask; bit <= NSCommandKeyMask; bit <<= 1, ++i) {
slouken@1959
   436
        unsigned int oldMask, newMask;
slouken@1959
   437
		
slouken@1959
   438
        oldMask = oldMods & bit;
slouken@1959
   439
        newMask = newMods & bit;
slouken@1959
   440
		
slouken@1959
   441
        /* If the bit is set, we must always examine it because the left
slouken@1959
   442
         * and right side keys may alternate or both may be pressed.
slouken@1959
   443
         */
slouken@1959
   444
        if (newMask) {
slouken@2303
   445
            HandleModifierSide(keyboard, bit, oldMods, newMods,
slouken@1959
   446
                               left_mapping[i], right_mapping[i],
slouken@1959
   447
                               left_device_mapping[i], right_device_mapping[i]);
slouken@1959
   448
        }
slouken@1959
   449
        /* If the state changed from pressed to unpressed, we must examine
slouken@1959
   450
            * the device dependent bits to release the correct keys.
slouken@1959
   451
            */
slouken@1959
   452
        else if (oldMask && oldMask != newMask) {
slouken@2303
   453
            ReleaseModifierSide(keyboard, bit, oldMods, newMods,
slouken@1959
   454
                              left_mapping[i], right_mapping[i],
slouken@1959
   455
                              left_device_mapping[i], right_device_mapping[i]);
slouken@1959
   456
        }
slouken@1959
   457
    }
slouken@1959
   458
}
slouken@1959
   459
slouken@1959
   460
static void
slouken@1959
   461
HandleModifiers(_THIS, unsigned short scancode, unsigned int modifierFlags)
slouken@1959
   462
{
slouken@1959
   463
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@1959
   464
slouken@1959
   465
    if (modifierFlags == data->modifierFlags) {
slouken@1959
   466
    	return;
slouken@1959
   467
    }
slouken@1959
   468
slouken@1959
   469
    /* 
slouken@1959
   470
     * Starting with Panther (10.3.0), the ability to distinguish between 
slouken@1959
   471
     * left side and right side modifiers is available.
slouken@1959
   472
     */
slouken@1959
   473
    if (data->osversion >= 0x1030) {
slouken@1959
   474
        DoSidedModifiers(data->keyboard, scancode, data->modifierFlags, modifierFlags);
slouken@1959
   475
    } else {
slouken@1959
   476
        DoUnsidedModifiers(data->keyboard, scancode, data->modifierFlags, modifierFlags);
slouken@1959
   477
    }
slouken@1959
   478
    data->modifierFlags = modifierFlags;
slouken@1959
   479
}
slouken@1959
   480
slouken@2303
   481
static void
slouken@2303
   482
UpdateKeymap(SDL_VideoData *data)
slouken@2303
   483
{
slouken@3247
   484
#if MAC_OS_X_VERSION_MAX_ALLOWED >= 1050
slouken@3247
   485
    TISInputSourceRef key_layout;
slouken@3247
   486
#else
slouken@2303
   487
    KeyboardLayoutRef key_layout;
slouken@3247
   488
#endif
slouken@2303
   489
    const void *chr_data;
slouken@2303
   490
    int i;
slouken@2303
   491
    SDL_scancode scancode;
slouken@2303
   492
    SDLKey keymap[SDL_NUM_SCANCODES];
slouken@2303
   493
slouken@2303
   494
    /* See if the keymap needs to be updated */
slouken@3247
   495
#if MAC_OS_X_VERSION_MAX_ALLOWED >= 1050
slouken@3247
   496
    key_layout = TISCopyCurrentKeyboardLayoutInputSource();
slouken@3247
   497
#else
slouken@2303
   498
    KLGetCurrentKeyboardLayout(&key_layout);
slouken@3247
   499
#endif
slouken@2303
   500
    if (key_layout == data->key_layout) {
slouken@2303
   501
        return;
slouken@2303
   502
    }
slouken@2303
   503
    data->key_layout = key_layout;
slouken@2303
   504
slouken@2303
   505
    SDL_GetDefaultKeymap(keymap);
slouken@2303
   506
slouken@2303
   507
    /* Try Unicode data first (preferred as of Mac OS X 10.5) */
slouken@3247
   508
#if MAC_OS_X_VERSION_MAX_ALLOWED >= 1050
slouken@3247
   509
    CFDataRef uchrDataRef = TISGetInputSourceProperty(key_layout, kTISPropertyUnicodeKeyLayoutData);
slouken@3247
   510
    if (uchrDataRef)
slouken@3247
   511
        chr_data = CFDataGetBytePtr(uchrDataRef);
slouken@3247
   512
    else
slouken@3247
   513
        goto cleanup;
slouken@3247
   514
#else
slouken@2303
   515
    KLGetKeyboardLayoutProperty(key_layout, kKLuchrData, &chr_data);
slouken@3247
   516
#endif
slouken@2303
   517
    if (chr_data) {
slouken@2303
   518
        UInt32 keyboard_type = LMGetKbdType();
slouken@2303
   519
        OSStatus err;
slouken@2303
   520
slouken@2305
   521
        for (i = 0; i < SDL_arraysize(darwin_scancode_table); i++) {
slouken@2303
   522
            UniChar s[8];
slouken@2303
   523
            UniCharCount len;
slouken@2303
   524
            UInt32 dead_key_state;
slouken@2303
   525
slouken@2303
   526
            /* Make sure this scancode is a valid character scancode */
slouken@2305
   527
            scancode = darwin_scancode_table[i];
slouken@2303
   528
            if (scancode == SDL_SCANCODE_UNKNOWN ||
slouken@2303
   529
                (keymap[scancode] & SDLK_SCANCODE_MASK)) {
slouken@2303
   530
                continue;
slouken@2303
   531
            }
slouken@2303
   532
slouken@2303
   533
            dead_key_state = 0;
slouken@3247
   534
            err = UCKeyTranslate ((UCKeyboardLayout *) chr_data,
slouken@3247
   535
                                  i, kUCKeyActionDown,
slouken@2303
   536
                                  0, keyboard_type,
slouken@2303
   537
                                  kUCKeyTranslateNoDeadKeysMask,
slouken@2303
   538
                                  &dead_key_state, 8, &len, s);
slouken@2303
   539
            if (err != noErr)
slouken@2303
   540
                continue;
slouken@2303
   541
slouken@2303
   542
            if (len > 0 && s[0] != 0x10) {
slouken@2303
   543
                keymap[scancode] = s[0];
slouken@2303
   544
            }
slouken@2303
   545
        }
slouken@2303
   546
        SDL_SetKeymap(data->keyboard, 0, keymap, SDL_NUM_SCANCODES);
slouken@2303
   547
        return;
slouken@2303
   548
    }
slouken@2303
   549
slouken@3247
   550
#if MAC_OS_X_VERSION_MAX_ALLOWED >= 1050
slouken@3247
   551
cleanup:
slouken@3247
   552
    CFRelease(key_layout);
slouken@3247
   553
#else
slouken@2303
   554
    /* Fall back to older style key map data */
slouken@2303
   555
    KLGetKeyboardLayoutProperty(key_layout, kKLKCHRData, &chr_data);
slouken@2303
   556
    if (chr_data) {
slouken@2303
   557
        for (i = 0; i < 128; i++) {
slouken@2303
   558
            UInt32 c, state = 0;
slouken@2303
   559
slouken@2303
   560
            /* Make sure this scancode is a valid character scancode */
slouken@2305
   561
            scancode = darwin_scancode_table[i];
slouken@2303
   562
            if (scancode == SDL_SCANCODE_UNKNOWN ||
slouken@2303
   563
                (keymap[scancode] & SDLK_SCANCODE_MASK)) {
slouken@2303
   564
                continue;
slouken@2303
   565
            }
slouken@2303
   566
slouken@2304
   567
            c = KeyTranslate (chr_data, i, &state) & 255;
slouken@2303
   568
            if (state) {
slouken@2303
   569
                /* Dead key, process key up */
slouken@2304
   570
                c = KeyTranslate (chr_data, i | 128, &state) & 255;
slouken@2303
   571
            }
slouken@2303
   572
slouken@2304
   573
            if (c != 0 && c != 0x10) {
slouken@2303
   574
                /* MacRoman to Unicode table, taken from X.org sources */
slouken@2303
   575
                static const unsigned short macroman_table[128] = {
slouken@2303
   576
                    0xc4, 0xc5, 0xc7, 0xc9, 0xd1, 0xd6, 0xdc, 0xe1,
slouken@2303
   577
                    0xe0, 0xe2, 0xe4, 0xe3, 0xe5, 0xe7, 0xe9, 0xe8,
slouken@2303
   578
                    0xea, 0xeb, 0xed, 0xec, 0xee, 0xef, 0xf1, 0xf3,
slouken@2303
   579
                    0xf2, 0xf4, 0xf6, 0xf5, 0xfa, 0xf9, 0xfb, 0xfc,
slouken@2303
   580
                    0x2020, 0xb0, 0xa2, 0xa3, 0xa7, 0x2022, 0xb6, 0xdf,
slouken@2303
   581
                    0xae, 0xa9, 0x2122, 0xb4, 0xa8, 0x2260, 0xc6, 0xd8,
slouken@2303
   582
                    0x221e, 0xb1, 0x2264, 0x2265, 0xa5, 0xb5, 0x2202, 0x2211,
slouken@2303
   583
                    0x220f, 0x3c0, 0x222b, 0xaa, 0xba, 0x3a9, 0xe6, 0xf8,
slouken@2303
   584
                    0xbf, 0xa1, 0xac, 0x221a, 0x192, 0x2248, 0x2206, 0xab,
slouken@2303
   585
                    0xbb, 0x2026, 0xa0, 0xc0, 0xc3, 0xd5, 0x152, 0x153,
slouken@2303
   586
                    0x2013, 0x2014, 0x201c, 0x201d, 0x2018, 0x2019, 0xf7, 0x25ca,
slouken@2303
   587
                    0xff, 0x178, 0x2044, 0x20ac, 0x2039, 0x203a, 0xfb01, 0xfb02,
slouken@2303
   588
                    0x2021, 0xb7, 0x201a, 0x201e, 0x2030, 0xc2, 0xca, 0xc1,
slouken@2303
   589
                    0xcb, 0xc8, 0xcd, 0xce, 0xcf, 0xcc, 0xd3, 0xd4,
slouken@2303
   590
                    0xf8ff, 0xd2, 0xda, 0xdb, 0xd9, 0x131, 0x2c6, 0x2dc,
slouken@2303
   591
                    0xaf, 0x2d8, 0x2d9, 0x2da, 0xb8, 0x2dd, 0x2db, 0x2c7,
slouken@2303
   592
                };
slouken@2303
   593
slouken@2303
   594
                if (c >= 128) {
slouken@2303
   595
                    c = macroman_table[c - 128];
slouken@2303
   596
                }
slouken@2303
   597
                keymap[scancode] = c;
slouken@2303
   598
            }
slouken@2303
   599
        }
slouken@2303
   600
        SDL_SetKeymap(data->keyboard, 0, keymap, SDL_NUM_SCANCODES);
slouken@2303
   601
        return;
slouken@2303
   602
    }
slouken@3247
   603
#endif
slouken@2303
   604
}
slouken@2303
   605
slouken@1931
   606
void
slouken@1931
   607
Cocoa_InitKeyboard(_THIS)
slouken@1931
   608
{
slouken@1931
   609
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@1931
   610
    SDL_Keyboard keyboard;
slouken@1931
   611
slouken@1931
   612
    SDL_zero(keyboard);
slouken@1931
   613
    data->keyboard = SDL_AddKeyboard(&keyboard, -1);
slouken@2303
   614
    UpdateKeymap(data);
slouken@2268
   615
    
slouken@2268
   616
    /* Set our own names for the platform-dependent but layout-independent keys */
slouken@2303
   617
    /* This key is NumLock on the MacBook keyboard. :) */
slouken@2303
   618
    /*SDL_SetScancodeName(SDL_SCANCODE_NUMLOCKCLEAR, "Clear");*/
slouken@2303
   619
    SDL_SetScancodeName(SDL_SCANCODE_LALT, "Left Option");
slouken@2303
   620
    SDL_SetScancodeName(SDL_SCANCODE_LGUI, "Left Command");
slouken@2303
   621
    SDL_SetScancodeName(SDL_SCANCODE_RALT, "Right Option");
slouken@2303
   622
    SDL_SetScancodeName(SDL_SCANCODE_RGUI, "Right Command");
slouken@1931
   623
}
slouken@1931
   624
slouken@1931
   625
void
slouken@3280
   626
Cocoa_StartTextInput(_THIS)
slouken@3280
   627
{
slouken@3280
   628
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@3280
   629
    NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
slouken@3280
   630
    NSView *parentView = [[NSApp keyWindow] contentView];
slouken@3280
   631
slouken@3280
   632
    data->fieldEdit = [[SDLTranslatorResponder alloc] initWithFrame:NSMakeRect(0.0, 0.0, 0.0, 0.0)];
slouken@3280
   633
    [data->fieldEdit setKeyboard: data->keyboard];
slouken@3280
   634
slouken@3280
   635
    if (! [[data->fieldEdit superview] isEqual: parentView])
slouken@3280
   636
    {
slouken@3280
   637
        // DEBUG_IME(@"add fieldEdit to window contentView");
slouken@3280
   638
        [data->fieldEdit removeFromSuperview];
slouken@3280
   639
        [parentView addSubview: data->fieldEdit];
slouken@3280
   640
        [[NSApp keyWindow] makeFirstResponder: data->fieldEdit];
slouken@3280
   641
    }
slouken@3280
   642
slouken@3280
   643
    [pool release];
slouken@3280
   644
}
slouken@3280
   645
slouken@3280
   646
void
slouken@3280
   647
Cocoa_StopTextInput(_THIS)
slouken@3280
   648
{
slouken@3280
   649
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@3280
   650
slouken@3280
   651
    NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
slouken@3280
   652
    [data->fieldEdit removeFromSuperview];
slouken@3280
   653
    [data->fieldEdit release];
slouken@3280
   654
    data->fieldEdit = nil;
slouken@3280
   655
    [pool release];
slouken@3280
   656
}
slouken@3280
   657
slouken@3280
   658
void
slouken@3280
   659
Cocoa_SetTextInputRect(_THIS, SDL_Rect *rect)
slouken@3280
   660
{
slouken@3280
   661
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@3280
   662
slouken@3280
   663
    [data->fieldEdit setInputRect: rect];
slouken@3280
   664
}
slouken@3280
   665
slouken@3280
   666
void
slouken@1959
   667
Cocoa_HandleKeyEvent(_THIS, NSEvent *event)
slouken@1959
   668
{
slouken@1959
   669
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@1959
   670
    unsigned short scancode = [event keyCode];
slouken@2303
   671
    SDL_scancode code;
slouken@1959
   672
    const char *text;
slouken@1959
   673
slouken@2268
   674
    if ((scancode == 10 || scancode == 50) && KBGetLayoutType(LMGetKbdType()) == kKeyboardISO) {
slouken@2268
   675
        /* see comments in SDL_cocoakeys.h */
slouken@2268
   676
        scancode = 60 - scancode;
slouken@2268
   677
    }
slouken@2305
   678
    if (scancode < SDL_arraysize(darwin_scancode_table)) {
slouken@2305
   679
        code = darwin_scancode_table[scancode];
slouken@2268
   680
    }
slouken@2268
   681
    else {
slouken@1959
   682
        /* Hmm, does this ever happen?  If so, need to extend the keymap... */
slouken@2303
   683
        code = SDL_SCANCODE_UNKNOWN;
slouken@1959
   684
    }
slouken@1959
   685
slouken@1959
   686
    switch ([event type]) {
slouken@1959
   687
    case NSKeyDown:
slouken@2129
   688
        if (![event isARepeat]) {
slouken@2303
   689
            /* See if we need to rebuild the keyboard layout */
slouken@2303
   690
            UpdateKeymap(data);
slouken@2303
   691
slouken@2303
   692
            SDL_SendKeyboardKey(data->keyboard, SDL_PRESSED, code);
slouken@2268
   693
#if 1
slouken@2303
   694
            if (code == SDL_SCANCODE_UNKNOWN) {
slouken@2268
   695
                fprintf(stderr, "The key you just pressed is not recognized by SDL. To help get this fixed, report this to the SDL mailing list <sdl@libsdl.org> or to Christian Walther <cwalther@gmx.ch>. Mac virtual key code is %d.\n", scancode);
slouken@2268
   696
            }
slouken@2268
   697
#endif
slouken@1959
   698
        }
slouken@2129
   699
        if (SDL_EventState(SDL_TEXTINPUT, SDL_QUERY)) {
slouken@2268
   700
            /* FIXME CW 2007-08-16: only send those events to the field editor for which we actually want text events, not e.g. esc or function keys. Arrow keys in particular seem to produce crashes sometimes. */
slouken@2169
   701
            [data->fieldEdit interpretKeyEvents:[NSArray arrayWithObject:event]];
slouken@3280
   702
#if 0
slouken@2129
   703
            text = [[event characters] UTF8String];
slouken@2129
   704
            if(text && *text) {
slouken@2129
   705
                SDL_SendKeyboardText(data->keyboard, text);
slouken@2273
   706
                [data->fieldEdit setString:@""];
slouken@2129
   707
            }
slouken@3280
   708
#endif
slouken@1959
   709
        }
slouken@1959
   710
        break;
slouken@1959
   711
    case NSKeyUp:
slouken@2303
   712
        SDL_SendKeyboardKey(data->keyboard, SDL_RELEASED, code);
slouken@1959
   713
        break;
slouken@1959
   714
    case NSFlagsChanged:
slouken@2268
   715
        /* FIXME CW 2007-08-14: check if this whole mess that takes up half of this file is really necessary */
slouken@1959
   716
        HandleModifiers(_this, scancode, [event modifierFlags]);
slouken@1959
   717
        break;
slouken@2268
   718
    default: /* just to avoid compiler warnings */
slouken@2268
   719
        break;
slouken@2268
   720
    }
slouken@2268
   721
}
slouken@2268
   722
slouken@1959
   723
void
slouken@1931
   724
Cocoa_QuitKeyboard(_THIS)
slouken@1931
   725
{
slouken@1931
   726
    SDL_VideoData *data = (SDL_VideoData *) _this->driverdata;
slouken@2270
   727
    NSAutoreleasePool *pool;
slouken@1931
   728
slouken@1931
   729
    SDL_DelKeyboard(data->keyboard);
slouken@1931
   730
}
slouken@1931
   731
slouken@1931
   732
/* vi: set ts=4 sw=4 expandtab: */