WPrefs.app/xmodifier.c

   1 /* Grok X modifier mappings for shortcuts.
   2
   3 Most of this code was taken from src/event-Xt.c in XEmacs 20.3-b17.
   4 The copyright(s) from the original XEmacs code are included below.
   5
   6 Perpetrator: Sudish Joseph <sj@eng.mindspring.net>, Sept. 1997. */
   7
   8 /*
   9  * More changes for WPrefs by Alfredo Kojima, Aug 1998
  10  */
  11
  12 /* The event_stream interface for X11 with Xt, and/or tty frames.
  13  Copyright (C) 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
  14  Copyright (C) 1995 Sun Microsystems, Inc.
  15  Copyright (C) 1996 Ben Wing.
  16
  17  This file is part of XEmacs.
  18
  19  XEmacs is free software; you can redistribute it and/or modify it
  20  under the terms of the GNU General Public License as published by the
  21  Free Software Foundation; either version 2, or (at your option) any
  22  later version.
  23
  24  XEmacs is distributed in the hope that it will be useful, but WITHOUT
  25  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  26  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  27  for more details.
  28
  29  You should have received a copy of the GNU General Public License along
  30  with XEmacs; see the file COPYING. if not, write to the
  31  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  32  Boston, MA 02110-1301 USA. */
  33
  34 #include <string.h>
  35 #include <strings.h>
  36 #include <X11/Xlib.h>
  37 #include <X11/keysym.h>
  38 #include <X11/XKBlib.h>
  39
  40 #include <WINGs/WUtil.h>
  41
  42 #include "WPrefs.h"
  43
  44 /************************************************************************/
  45 /*                            keymap handling                           */
  46 /************************************************************************/
  47
  48 /* X bogusly doesn't define the interpretations of any bits besides
  49  ModControl, ModShift, and ModLock; so the Interclient Communication
  50  Conventions Manual says that we have to bend over backwards to figure
  51  out what the other modifier bits mean.  According to ICCCM:
  52
  53  - Any keycode which is assigned ModControl is a "control" key.
  54
  55  - Any modifier bit which is assigned to a keycode which generates Meta_L
  56  or Meta_R is the modifier bit meaning "meta".  Likewise for Super, Hyper,
  57  etc.
  58
  59  - Any keypress event which contains ModControl in its state should be
  60  interpreted as a "control" character.
  61
  62  - Any keypress event which contains a modifier bit in its state which is
  63  generated by a keycode whose corresponding keysym is Meta_L or Meta_R
  64  should be interpreted as a "meta" character.  Likewise for Super, Hyper,
  65  etc.
  66
  67  - It is illegal for a keysym to be associated with more than one modifier
  68  bit.
  69
  70  This means that the only thing that emacs can reasonably interpret as a
  71  "meta" key is a key whose keysym is Meta_L or Meta_R, and which generates
  72  one of the modifier bits Mod1-Mod5.
  73
  74  Unfortunately, many keyboards don't have Meta keys in their default
  75  configuration.  So, if there are no Meta keys, but there are "Alt" keys,
  76  emacs will interpret Alt as Meta.  If there are both Meta and Alt keys,
  77  then the Meta keys mean "Meta", and the Alt keys mean "Alt" (it used to
  78  mean "Symbol," but that just confused the hell out of way too many people).
  79
  80  This works with the default configurations of the 19 keyboard-types I've
  81  checked.
  82
  83  Emacs detects keyboard configurations which violate the above rules, and
  84  prints an error message on the standard-error-output.  (Perhaps it should
  85  use a pop-up-window instead.)
  86  */
  87
  88 static int MetaIndex, HyperIndex, SuperIndex, AltIndex, ModeIndex;
  89
  90 static const char *index_to_name(int indice)
  91 {
  92         switch (indice) {
  93         case ShiftMapIndex:
  94                 return "ModShift";
  95         case LockMapIndex:
  96                 return "ModLock";
  97         case ControlMapIndex:
  98                 return "ModControl";
  99         case Mod1MapIndex:
 100                 return "Mod1";
 101         case Mod2MapIndex:
 102                 return "Mod2";
 103         case Mod3MapIndex:
 104                 return "Mod3";
 105         case Mod4MapIndex:
 106                 return "Mod4";
 107         case Mod5MapIndex:
 108                 return "Mod5";
 109         default:
 110                 return "???";
 111         }
 112 }
 113
 114 static void x_reset_modifier_mapping(Display * display)
 115 {
 116         int modifier_index, modifier_key, column, mkpm;
 117         int meta_bit = 0;
 118         int hyper_bit = 0;
 119         int super_bit = 0;
 120         int alt_bit = 0;
 121         int mode_bit = 0;
 122         XModifierKeymap *x_modifier_keymap = XGetModifierMapping(display);
 123
 124 #define modwarn(name,old,other)                                                 \
 125     wwarning ("%s (0x%x) generates %s, which is generated by %s.",              \
 126     name, code, index_to_name (old), other)
 127
 128 #define modbarf(name,other)                                                     \
 129     wwarning ("%s (0x%x) generates %s, which is nonsensical.",                  \
 130     name, code, other)
 131
 132 #define check_modifier(name,mask)                                               \
 133     if ((1<<modifier_index) != mask)                                            \
 134     wwarning ("%s (0x%x) generates %s, which is nonsensical.",                  \
 135     name, code, index_to_name (modifier_index))
 136
 137 #define store_modifier(name,old)                                                \
 138     if (old && old != modifier_index)                                           \
 139     wwarning ("%s (0x%x) generates both %s and %s, which is nonsensical.",      \
 140     name, code, index_to_name (old),                                            \
 141     index_to_name (modifier_index));                                            \
 142     if (modifier_index == ShiftMapIndex) modbarf (name,"ModShift");             \
 143     else if (modifier_index == LockMapIndex) modbarf (name,"ModLock");          \
 144     else if (modifier_index == ControlMapIndex) modbarf (name,"ModControl");    \
 145     else if (sym == XK_Mode_switch)                                             \
 146     mode_bit = modifier_index; /* Mode_switch is special, see below... */       \
 147     else if (modifier_index == meta_bit && old != meta_bit)                     \
 148     modwarn (name, meta_bit, "Meta");                                           \
 149     else if (modifier_index == super_bit && old != super_bit)                   \
 150     modwarn (name, super_bit, "Super");                                         \
 151     else if (modifier_index == hyper_bit && old != hyper_bit)                   \
 152     modwarn (name, hyper_bit, "Hyper");                                         \
 153     else if (modifier_index == alt_bit && old != alt_bit)                       \
 154     modwarn (name, alt_bit, "Alt");                                             \
 155     else                                                                        \
 156     old = modifier_index;
 157
 158         mkpm = x_modifier_keymap->max_keypermod;
 159         for (modifier_index = 0; modifier_index < 8; modifier_index++)
 160                 for (modifier_key = 0; modifier_key < mkpm; modifier_key++) {
 161                         KeySym last_sym = 0;
 162                         for (column = 0; column < 4; column += 2) {
 163                                 KeyCode code = x_modifier_keymap->modifiermap[modifier_index * mkpm
 164                                                                               + modifier_key];
 165                                 KeySym sym;
 166
 167                                 if (code) {
 168                                         if (xext_xkb_supported)
 169                                                 sym = XkbKeycodeToKeysym(display, code, 0, column);
 170                                         else
 171                                                 sym = XKeycodeToKeysym(display, code, column);
 172                                 } else {
 173                                         sym = NoSymbol;
 174                                 }
 175
 176                                 if (sym == last_sym)
 177                                         continue;
 178                                 last_sym = sym;
 179                                 switch (sym) {
 180                                 case XK_Mode_switch:
 181                                         store_modifier("Mode_switch", mode_bit);
 182                                         break;
 183                                 case XK_Meta_L:
 184                                         store_modifier("Meta_L", meta_bit);
 185                                         break;
 186                                 case XK_Meta_R:
 187                                         store_modifier("Meta_R", meta_bit);
 188                                         break;
 189                                 case XK_Super_L:
 190                                         store_modifier("Super_L", super_bit);
 191                                         break;
 192                                 case XK_Super_R:
 193                                         store_modifier("Super_R", super_bit);
 194                                         break;
 195                                 case XK_Hyper_L:
 196                                         store_modifier("Hyper_L", hyper_bit);
 197                                         break;
 198                                 case XK_Hyper_R:
 199                                         store_modifier("Hyper_R", hyper_bit);
 200                                         break;
 201                                 case XK_Alt_L:
 202                                         store_modifier("Alt_L", alt_bit);
 203                                         break;
 204                                 case XK_Alt_R:
 205                                         store_modifier("Alt_R", alt_bit);
 206                                         break;
 207                                 case XK_Control_L:
 208                                         check_modifier("Control_L", ControlMask);
 209                                         break;
 210                                 case XK_Control_R:
 211                                         check_modifier("Control_R", ControlMask);
 212                                         break;
 213                                 case XK_Shift_L:
 214                                         check_modifier("Shift_L", ShiftMask);
 215                                         break;
 216                                 case XK_Shift_R:
 217                                         check_modifier("Shift_R", ShiftMask);
 218                                         break;
 219                                 case XK_Shift_Lock:
 220                                         check_modifier("Shift_Lock", LockMask);
 221                                         break;
 222                                 case XK_Caps_Lock:
 223                                         check_modifier("Caps_Lock", LockMask);
 224                                         break;
 225
 226                                         /* It probably doesn't make any sense for a modifier bit to be
 227                                            assigned to a key that is not one of the above, but OpenWindows
 228                                            assigns modifier bits to a couple of random function keys for
 229                                            no reason that I can discern, so printing a warning here would
 230                                            be annoying. */
 231                                 }
 232                         }
 233                 }
 234 #undef store_modifier
 235 #undef check_modifier
 236 #undef modwarn
 237 #undef modbarf
 238
 239         /* If there was no Meta key, then try using the Alt key instead.
 240            If there is both a Meta key and an Alt key, then the Alt key
 241            is not disturbed and remains an Alt key. */
 242         if (!meta_bit && alt_bit)
 243                 meta_bit = alt_bit, alt_bit = 0;
 244
 245         /* mode_bit overrides everything, since it's processed down inside of
 246            XLookupString() instead of by us.  If Meta and Mode_switch both
 247            generate the same modifier bit (which is an error), then we don't
 248            interpret that bit as Meta, because we can't make XLookupString()
 249            not interpret it as Mode_switch; and interpreting it as both would
 250            be totally wrong. */
 251         if (mode_bit) {
 252                 const char *warn = 0;
 253                 if (mode_bit == meta_bit)
 254                         warn = "Meta", meta_bit = 0;
 255                 else if (mode_bit == hyper_bit)
 256                         warn = "Hyper", hyper_bit = 0;
 257                 else if (mode_bit == super_bit)
 258                         warn = "Super", super_bit = 0;
 259                 else if (mode_bit == alt_bit)
 260                         warn = "Alt", alt_bit = 0;
 261                 if (warn) {
 262                         wwarning("%s is being used for both Mode_switch and %s.",
 263                              index_to_name(mode_bit), warn);
 264                 }
 265         }
 266
 267         MetaIndex = meta_bit;
 268         HyperIndex = hyper_bit;
 269         SuperIndex = super_bit;
 270         AltIndex = alt_bit;
 271         ModeIndex = mode_bit;
 272
 273         if (x_modifier_keymap != NULL)
 274                 XFreeModifiermap(x_modifier_keymap);
 275 }
 276
 277 int ModifierFromKey(Display * dpy, const char *key)
 278 {
 279         static int eqw = 0;
 280
 281         if (!eqw)
 282                 x_reset_modifier_mapping(dpy);
 283         eqw = 1;
 284
 285         if (strcasecmp(key, "SHIFT") == 0)
 286                 return ShiftMapIndex;
 287         else if (strcasecmp(key, "CONTROL") == 0)
 288                 return ControlMapIndex;
 289         else if (strcasecmp(key, "ALT") == 0)
 290                 return AltIndex;
 291         else if (strcasecmp(key, "META") == 0)
 292                 return MetaIndex;
 293         else if (strcasecmp(key, "SUPER") == 0)
 294                 return SuperIndex;
 295         else if (strcasecmp(key, "HYPER") == 0)
 296                 return HyperIndex;
 297         else if (strcasecmp(key, "MOD1") == 0)
 298                 return Mod1MapIndex;
 299         else if (strcasecmp(key, "MOD2") == 0)
 300                 return Mod2MapIndex;
 301         else if (strcasecmp(key, "MOD3") == 0)
 302                 return Mod3MapIndex;
 303         else if (strcasecmp(key, "MOD4") == 0)
 304                 return Mod4MapIndex;
 305         else if (strcasecmp(key, "MOD5") == 0)
 306                 return Mod5MapIndex;
 307         else
 308                 return -1;
 309 }