1 /* GDK - The GIMP Drawing Kit
2 * Copyright (C) 2000 Red Hat, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
29 #include "gdkx11keys.h"
30 #include "gdkkeysprivate.h"
31 #include "gdkkeysyms.h"
32 #include "gdkprivate-x11.h"
33 #include "gdkdisplay-x11.h"
43 #include <X11/XKBlib.h>
45 /* OSF-4.0 is apparently missing this macro
47 # ifndef XkbKeySymEntry
48 # define XkbKeySymEntry(d,k,sl,g) \
49 (XkbKeySym(d,k,((XkbKeyGroupsWidth(d,k)*(g))+(sl))))
53 typedef struct _DirectionCacheEntry DirectionCacheEntry;
55 struct _DirectionCacheEntry
59 PangoDirection direction;
64 GdkKeymap parent_instance;
69 gint keysyms_per_keycode;
70 XModifierKeymap* mod_keymap;
72 GdkModifierType group_switch_mask;
73 GdkModifierType num_lock_mask;
74 GdkModifierType modmap[8];
75 PangoDirection current_direction;
77 guint have_direction : 1;
78 guint have_lock_state : 1;
79 guint caps_lock_state : 1;
80 guint num_lock_state : 1;
86 /* We cache the directions */
87 Atom current_group_atom;
88 guint current_cache_serial;
89 /* A cache of size four should be more than enough, people usually
90 * have two groups around, and the xkb limit is four. It still
91 * works correct for more than four groups. It's just the
94 DirectionCacheEntry group_direction_cache[4];
98 struct _GdkX11KeymapClass
100 GdkKeymapClass parent_class;
103 #define KEYMAP_USE_XKB(keymap) GDK_X11_DISPLAY ((keymap)->display)->use_xkb
104 #define KEYMAP_XDISPLAY(keymap) GDK_DISPLAY_XDISPLAY ((keymap)->display)
106 G_DEFINE_TYPE (GdkX11Keymap, gdk_x11_keymap, GDK_TYPE_KEYMAP)
109 gdk_x11_keymap_init (GdkX11Keymap *keymap)
111 keymap->min_keycode = 0;
112 keymap->max_keycode = 0;
114 keymap->keymap = NULL;
115 keymap->keysyms_per_keycode = 0;
116 keymap->mod_keymap = NULL;
118 keymap->num_lock_mask = 0;
119 keymap->sun_keypad = FALSE;
120 keymap->group_switch_mask = 0;
121 keymap->lock_keysym = GDK_KEY_Caps_Lock;
122 keymap->have_direction = FALSE;
123 keymap->have_lock_state = FALSE;
124 keymap->current_serial = 0;
127 keymap->xkb_desc = NULL;
128 keymap->current_group_atom = 0;
129 keymap->current_cache_serial = 0;
135 gdk_x11_keymap_finalize (GObject *object)
137 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (object);
139 if (keymap_x11->keymap)
140 XFree (keymap_x11->keymap);
142 if (keymap_x11->mod_keymap)
143 XFreeModifiermap (keymap_x11->mod_keymap);
146 if (keymap_x11->xkb_desc)
147 XkbFreeKeyboard (keymap_x11->xkb_desc, XkbAllComponentsMask, True);
150 G_OBJECT_CLASS (gdk_x11_keymap_parent_class)->finalize (object);
154 update_keyrange (GdkX11Keymap *keymap_x11)
156 if (keymap_x11->max_keycode == 0)
157 XDisplayKeycodes (KEYMAP_XDISPLAY (GDK_KEYMAP (keymap_x11)),
158 &keymap_x11->min_keycode, &keymap_x11->max_keycode);
164 update_modmap (Display *display,
165 GdkX11Keymap *keymap_x11)
170 GdkModifierType mask;
172 { "Meta", 0, GDK_META_MASK },
173 { "Super", 0, GDK_SUPER_MASK },
174 { "Hyper", 0, GDK_HYPER_MASK },
181 for (i = 0; vmods[i].name; i++)
182 vmods[i].atom = XInternAtom (display, vmods[i].name, FALSE);
184 for (i = 0; i < 8; i++)
185 keymap_x11->modmap[i] = 1 << i;
187 for (i = 0; i < XkbNumVirtualMods; i++)
189 for (j = 0; vmods[j].atom; j++)
191 if (keymap_x11->xkb_desc->names->vmods[i] == vmods[j].atom)
193 for (k = 0; k < 8; k++)
195 if (keymap_x11->xkb_desc->server->vmods[i] & (1 << k))
196 keymap_x11->modmap[k] |= vmods[j].mask;
204 get_xkb (GdkX11Keymap *keymap_x11)
206 GdkX11Display *display_x11 = GDK_X11_DISPLAY (GDK_KEYMAP (keymap_x11)->display);
207 Display *xdisplay = display_x11->xdisplay;
209 update_keyrange (keymap_x11);
211 if (keymap_x11->xkb_desc == NULL)
213 keymap_x11->xkb_desc = XkbGetMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask | XkbModifierMapMask | XkbVirtualModsMask, XkbUseCoreKbd);
214 if (keymap_x11->xkb_desc == NULL)
216 g_error ("Failed to get keymap");
220 XkbGetNames (xdisplay, XkbGroupNamesMask | XkbVirtualModNamesMask, keymap_x11->xkb_desc);
222 update_modmap (xdisplay, keymap_x11);
224 else if (keymap_x11->current_serial != display_x11->keymap_serial)
226 XkbGetUpdatedMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask | XkbModifierMapMask | XkbVirtualModsMask,
227 keymap_x11->xkb_desc);
228 XkbGetNames (xdisplay, XkbGroupNamesMask | XkbVirtualModNamesMask, keymap_x11->xkb_desc);
230 update_modmap (xdisplay, keymap_x11);
233 keymap_x11->current_serial = display_x11->keymap_serial;
235 if (keymap_x11->num_lock_mask == 0)
236 keymap_x11->num_lock_mask = XkbKeysymToModifiers (KEYMAP_XDISPLAY (GDK_KEYMAP (keymap_x11)), GDK_KEY_Num_Lock);
238 return keymap_x11->xkb_desc;
240 #endif /* HAVE_XKB */
242 /* Whether we were able to turn on detectable-autorepeat using
243 * XkbSetDetectableAutorepeat. If FALSE, we'll fall back
244 * to checking the next event with XPending().
247 /* Find the index of the group/level pair within the keysyms for a key.
248 * We round up the number of keysyms per keycode to the next even number,
249 * otherwise we lose a whole group of keys
251 #define KEYSYM_INDEX(keymap_impl, group, level) \
252 (2 * ((group) % (gint)((keymap_impl->keysyms_per_keycode + 1) / 2)) + (level))
253 #define KEYSYM_IS_KEYPAD(s) (((s) >= 0xff80 && (s) <= 0xffbd) || \
254 ((s) >= 0x11000000 && (s) <= 0x1100ffff))
257 get_symbol (const KeySym *syms,
258 GdkX11Keymap *keymap_x11,
264 index = KEYSYM_INDEX(keymap_x11, group, level);
265 if (index >= keymap_x11->keysyms_per_keycode)
272 set_symbol (KeySym *syms,
273 GdkX11Keymap *keymap_x11,
280 index = KEYSYM_INDEX(keymap_x11, group, level);
281 if (index >= keymap_x11->keysyms_per_keycode)
288 update_keymaps (GdkX11Keymap *keymap_x11)
290 GdkX11Display *display_x11 = GDK_X11_DISPLAY (GDK_KEYMAP (keymap_x11)->display);
291 Display *xdisplay = display_x11->xdisplay;
294 g_assert (!KEYMAP_USE_XKB (GDK_KEYMAP (keymap_x11)));
297 if (keymap_x11->keymap == NULL ||
298 keymap_x11->current_serial != display_x11->keymap_serial)
304 keymap_x11->current_serial = display_x11->keymap_serial;
306 update_keyrange (keymap_x11);
308 if (keymap_x11->keymap)
309 XFree (keymap_x11->keymap);
311 if (keymap_x11->mod_keymap)
312 XFreeModifiermap (keymap_x11->mod_keymap);
314 keymap_x11->keymap = XGetKeyboardMapping (xdisplay, keymap_x11->min_keycode,
315 keymap_x11->max_keycode - keymap_x11->min_keycode + 1,
316 &keymap_x11->keysyms_per_keycode);
319 /* GDK_KEY_ISO_Left_Tab, as usually configured through XKB, really messes
320 * up the whole idea of "consumed modifiers" because shift is consumed.
321 * However, <shift>Tab is not usually GDK_KEY_ISO_Left_Tab without XKB,
322 * we we fudge the map here.
324 keycode = keymap_x11->min_keycode;
325 while (keycode <= keymap_x11->max_keycode)
327 KeySym *syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
328 /* Check both groups */
329 for (i = 0 ; i < 2 ; i++)
331 if (get_symbol (syms, keymap_x11, i, 0) == GDK_KEY_Tab)
332 set_symbol (syms, keymap_x11, i, 1, GDK_KEY_ISO_Left_Tab);
336 * If there is one keysym and the key symbol has upper and lower
337 * case variants fudge the keymap
339 if (get_symbol (syms, keymap_x11, 0, 1) == 0)
344 gdk_keyval_convert_case (get_symbol (syms, keymap_x11, 0, 0), &lower, &upper);
347 set_symbol (syms, keymap_x11, 0, 0, lower);
348 set_symbol (syms, keymap_x11, 0, 1, upper);
355 keymap_x11->mod_keymap = XGetModifierMapping (xdisplay);
357 keymap_x11->lock_keysym = GDK_KEY_VoidSymbol;
358 keymap_x11->group_switch_mask = 0;
359 keymap_x11->num_lock_mask = 0;
361 for (i = 0; i < 8; i++)
362 keymap_x11->modmap[i] = 1 << i;
364 /* There are 8 sets of modifiers, with each set containing
365 * max_keypermod keycodes.
367 map_size = 8 * keymap_x11->mod_keymap->max_keypermod;
368 for (i = 0; i < map_size; i++)
370 /* Get the key code at this point in the map. */
371 gint keycode = keymap_x11->mod_keymap->modifiermap[i];
376 /* Ignore invalid keycodes. */
377 if (keycode < keymap_x11->min_keycode ||
378 keycode > keymap_x11->max_keycode)
381 syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
384 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
386 if (syms[j] == GDK_KEY_Meta_L ||
387 syms[j] == GDK_KEY_Meta_R)
388 mask |= GDK_META_MASK;
389 else if (syms[j] == GDK_KEY_Hyper_L ||
390 syms[j] == GDK_KEY_Hyper_R)
391 mask |= GDK_HYPER_MASK;
392 else if (syms[j] == GDK_KEY_Super_L ||
393 syms[j] == GDK_KEY_Super_R)
394 mask |= GDK_SUPER_MASK;
397 keymap_x11->modmap[i/keymap_x11->mod_keymap->max_keypermod] |= mask;
399 /* The fourth modifier, GDK_MOD1_MASK is 1 << 3.
400 * Each group of max_keypermod entries refers to the same modifier.
402 mask = 1 << (i / keymap_x11->mod_keymap->max_keypermod);
407 /* Get the Lock keysym. If any keysym bound to the Lock modifier
408 * is Caps_Lock, we will interpret the modifier as Caps_Lock;
409 * otherwise, if any is bound to Shift_Lock, we will interpret
410 * the modifier as Shift_Lock. Otherwise, the lock modifier
413 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
415 if (syms[j] == GDK_KEY_Caps_Lock)
416 keymap_x11->lock_keysym = GDK_KEY_Caps_Lock;
417 else if (syms[j] == GDK_KEY_Shift_Lock &&
418 keymap_x11->lock_keysym == GDK_KEY_VoidSymbol)
419 keymap_x11->lock_keysym = GDK_KEY_Shift_Lock;
423 case GDK_CONTROL_MASK:
426 /* Some keyboard maps are known to map Mode_Switch as an
427 * extra Mod1 key. In circumstances like that, it won't be
428 * used to switch groups.
433 /* Find the Mode_Switch and Num_Lock modifiers. */
434 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
436 if (syms[j] == GDK_KEY_Mode_switch)
438 /* This modifier swaps groups */
439 keymap_x11->group_switch_mask |= mask;
441 else if (syms[j] == GDK_KEY_Num_Lock)
443 /* This modifier is used for Num_Lock */
444 keymap_x11->num_lock_mask |= mask;
451 /* Hack: The Sun X server puts the keysym to use when the Num Lock
452 * modifier is on in the third element of the keysym array, instead
455 if ((strcmp (ServerVendor (xdisplay), "Sun Microsystems, Inc.") == 0) &&
456 (keymap_x11->keysyms_per_keycode > 2))
457 keymap_x11->sun_keypad = TRUE;
459 keymap_x11->sun_keypad = FALSE;
464 get_keymap (GdkX11Keymap *keymap_x11)
466 update_keymaps (keymap_x11);
468 return keymap_x11->keymap;
472 static PangoDirection
473 get_direction (XkbDescRec *xkb,
478 gint rtl_minus_ltr = 0; /* total number of RTL keysyms minus LTR ones */
480 for (code = xkb->min_key_code; code <= xkb->max_key_code; code++)
483 KeySym sym = XkbKeySymEntry (xkb, code, level, group);
484 PangoDirection dir = pango_unichar_direction (gdk_keyval_to_unicode (sym));
488 case PANGO_DIRECTION_RTL:
491 case PANGO_DIRECTION_LTR:
499 if (rtl_minus_ltr > 0)
500 return PANGO_DIRECTION_RTL;
502 return PANGO_DIRECTION_LTR;
505 static PangoDirection
506 get_direction_from_cache (GdkX11Keymap *keymap_x11,
510 Atom group_atom = xkb->names->groups[group];
512 gboolean cache_hit = FALSE;
513 DirectionCacheEntry *cache = keymap_x11->group_direction_cache;
515 PangoDirection direction = PANGO_DIRECTION_NEUTRAL;
518 if (keymap_x11->have_direction)
520 /* lookup in cache */
521 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
523 if (cache[i].group_atom == group_atom)
526 cache[i].serial = keymap_x11->current_cache_serial++; /* freshen */
527 direction = cache[i].direction;
528 group_atom = cache[i].group_atom;
535 /* initialize cache */
536 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
538 cache[i].group_atom = 0;
539 cache[i].serial = keymap_x11->current_cache_serial;
541 keymap_x11->current_cache_serial++;
544 /* insert in cache */
549 direction = get_direction (xkb, group);
551 /* remove the oldest entry */
552 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
554 if (cache[i].serial < cache[oldest].serial)
558 cache[oldest].group_atom = group_atom;
559 cache[oldest].direction = direction;
560 cache[oldest].serial = keymap_x11->current_cache_serial++;
567 get_num_groups (GdkKeymap *keymap,
570 Display *display = KEYMAP_XDISPLAY (keymap);
571 XkbGetControls(display, XkbSlowKeysMask, xkb);
572 XkbGetUpdatedMap (display, XkbKeySymsMask | XkbKeyTypesMask |
573 XkbModifierMapMask | XkbVirtualModsMask, xkb);
574 return xkb->ctrls->num_groups;
578 update_direction (GdkX11Keymap *keymap_x11,
581 XkbDescPtr xkb = get_xkb (keymap_x11);
583 gboolean had_direction;
584 PangoDirection old_direction;
586 had_direction = keymap_x11->have_direction;
587 old_direction = keymap_x11->current_direction;
589 group_atom = xkb->names->groups[group];
591 /* a group change? */
592 if (!keymap_x11->have_direction || keymap_x11->current_group_atom != group_atom)
594 keymap_x11->current_direction = get_direction_from_cache (keymap_x11, xkb, group);
595 keymap_x11->current_group_atom = group_atom;
596 keymap_x11->have_direction = TRUE;
599 return !had_direction || old_direction != keymap_x11->current_direction;
603 update_lock_state (GdkX11Keymap *keymap_x11,
607 XkbDescPtr xkb G_GNUC_UNUSED;
608 gboolean have_lock_state;
609 gboolean caps_lock_state;
610 gboolean num_lock_state;
611 guint modifier_state;
613 /* ensure keymap_x11->num_lock_mask is initialized */
614 xkb = get_xkb (keymap_x11);
616 have_lock_state = keymap_x11->have_lock_state;
617 caps_lock_state = keymap_x11->caps_lock_state;
618 num_lock_state = keymap_x11->num_lock_state;
619 modifier_state = keymap_x11->modifier_state;
621 keymap_x11->have_lock_state = TRUE;
622 keymap_x11->caps_lock_state = (locked_mods & GDK_LOCK_MASK) != 0;
623 keymap_x11->num_lock_state = (locked_mods & keymap_x11->num_lock_mask) != 0;
624 /* FIXME: sanitize this */
625 keymap_x11->modifier_state = (guint)effective_mods;
627 return !have_lock_state
628 || (caps_lock_state != keymap_x11->caps_lock_state)
629 || (num_lock_state != keymap_x11->num_lock_state)
630 || (modifier_state != keymap_x11->modifier_state);
633 /* keep this in sync with the XkbSelectEventDetails()
634 * call in gdk_display_open()
637 _gdk_x11_keymap_state_changed (GdkDisplay *display,
640 GdkX11Display *display_x11 = GDK_X11_DISPLAY (display);
641 XkbEvent *xkb_event = (XkbEvent *)xevent;
643 if (display_x11->keymap)
645 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (display_x11->keymap);
647 if (update_direction (keymap_x11, XkbStateGroup (&xkb_event->state)))
648 g_signal_emit_by_name (keymap_x11, "direction-changed");
650 if (update_lock_state (keymap_x11,
651 xkb_event->state.locked_mods,
652 xkb_event->state.mods))
653 g_signal_emit_by_name (keymap_x11, "state-changed");
657 #endif /* HAVE_XKB */
660 ensure_lock_state (GdkKeymap *keymap)
663 if (KEYMAP_USE_XKB (keymap))
665 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
667 if (!keymap_x11->have_lock_state)
669 GdkDisplay *display = keymap->display;
670 XkbStateRec state_rec;
672 XkbGetState (GDK_DISPLAY_XDISPLAY (display), XkbUseCoreKbd, &state_rec);
673 update_lock_state (keymap_x11, state_rec.locked_mods, state_rec.mods);
676 #endif /* HAVE_XKB */
680 _gdk_x11_keymap_keys_changed (GdkDisplay *display)
682 GdkX11Display *display_x11 = GDK_X11_DISPLAY (display);
684 ++display_x11->keymap_serial;
686 if (display_x11->keymap)
687 g_signal_emit_by_name (display_x11->keymap, "keys_changed", 0);
690 static PangoDirection
691 gdk_x11_keymap_get_direction (GdkKeymap *keymap)
694 if (KEYMAP_USE_XKB (keymap))
696 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
698 if (!keymap_x11->have_direction)
700 GdkDisplay *display = keymap->display;
701 XkbStateRec state_rec;
703 XkbGetState (GDK_DISPLAY_XDISPLAY (display), XkbUseCoreKbd,
705 update_direction (keymap_x11, XkbStateGroup (&state_rec));
708 return keymap_x11->current_direction;
711 #endif /* HAVE_XKB */
712 return PANGO_DIRECTION_NEUTRAL;
716 gdk_x11_keymap_have_bidi_layouts (GdkKeymap *keymap)
719 if (KEYMAP_USE_XKB (keymap))
721 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
722 XkbDescPtr xkb = get_xkb (keymap_x11);
723 int num_groups = get_num_groups (keymap, xkb);
726 gboolean have_ltr_keyboard = FALSE;
727 gboolean have_rtl_keyboard = FALSE;
729 for (i = 0; i < num_groups; i++)
731 if (get_direction_from_cache (keymap_x11, xkb, i) == PANGO_DIRECTION_RTL)
732 have_rtl_keyboard = TRUE;
734 have_ltr_keyboard = TRUE;
737 return have_ltr_keyboard && have_rtl_keyboard;
740 #endif /* HAVE_XKB */
745 gdk_x11_keymap_get_caps_lock_state (GdkKeymap *keymap)
747 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
749 ensure_lock_state (keymap);
751 return keymap_x11->caps_lock_state;
755 gdk_x11_keymap_get_num_lock_state (GdkKeymap *keymap)
757 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
759 ensure_lock_state (keymap);
761 return keymap_x11->num_lock_state;
765 gdk_x11_keymap_get_modifier_state (GdkKeymap *keymap)
767 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
769 ensure_lock_state (keymap);
771 return keymap_x11->modifier_state;
775 gdk_x11_keymap_get_entries_for_keyval (GdkKeymap *keymap,
780 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
783 retval = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
786 if (KEYMAP_USE_XKB (keymap))
788 /* See sec 15.3.4 in XKB docs */
790 XkbDescRec *xkb = get_xkb (keymap_x11);
793 keycode = keymap_x11->min_keycode;
795 while (keycode <= keymap_x11->max_keycode)
797 gint max_shift_levels = XkbKeyGroupsWidth (xkb, keycode); /* "key width" */
800 gint total_syms = XkbKeyNumSyms (xkb, keycode);
804 /* entry is an array with all syms for group 0, all
805 * syms for group 1, etc. and for each group the
806 * shift level syms are in order
808 entry = XkbKeySymsPtr (xkb, keycode);
810 while (i < total_syms)
812 /* check out our cool loop invariant */
813 g_assert (i == (group * max_shift_levels + level));
815 if (entry[i] == keyval)
820 key.keycode = keycode;
824 g_array_append_val (retval, key);
826 g_assert (XkbKeySymEntry (xkb, keycode, level, group) ==
832 if (level == max_shift_levels)
847 const KeySym *map = get_keymap (keymap_x11);
850 keycode = keymap_x11->min_keycode;
851 while (keycode <= keymap_x11->max_keycode)
853 const KeySym *syms = map + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
856 while (i < keymap_x11->keysyms_per_keycode)
858 if (syms[i] == keyval)
863 key.keycode = keycode;
865 /* The "classic" non-XKB keymap has 2 levels per group */
869 g_array_append_val (retval, key);
881 *keys = (GdkKeymapKey*) retval->data;
882 *n_keys = retval->len;
890 g_array_free (retval, retval->len > 0 ? FALSE : TRUE);
896 gdk_x11_keymap_get_entries_for_keycode (GdkKeymap *keymap,
897 guint hardware_keycode,
902 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
904 GArray *keyval_array;
906 update_keyrange (keymap_x11);
908 if (hardware_keycode < keymap_x11->min_keycode ||
909 hardware_keycode > keymap_x11->max_keycode)
921 key_array = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
926 keyval_array = g_array_new (FALSE, FALSE, sizeof (guint));
931 if (KEYMAP_USE_XKB (keymap))
933 /* See sec 15.3.4 in XKB docs */
935 XkbDescRec *xkb = get_xkb (keymap_x11);
936 gint max_shift_levels;
943 max_shift_levels = XkbKeyGroupsWidth (xkb, hardware_keycode); /* "key width" */
944 total_syms = XkbKeyNumSyms (xkb, hardware_keycode);
946 /* entry is an array with all syms for group 0, all
947 * syms for group 1, etc. and for each group the
948 * shift level syms are in order
950 entry = XkbKeySymsPtr (xkb, hardware_keycode);
952 while (i < total_syms)
954 /* check out our cool loop invariant */
955 g_assert (i == (group * max_shift_levels + level));
961 key.keycode = hardware_keycode;
965 g_array_append_val (key_array, key);
969 g_array_append_val (keyval_array, entry[i]);
973 if (level == max_shift_levels)
985 const KeySym *map = get_keymap (keymap_x11);
989 syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
991 while (i < keymap_x11->keysyms_per_keycode)
997 key.keycode = hardware_keycode;
999 /* The "classic" non-XKB keymap has 2 levels per group */
1003 g_array_append_val (key_array, key);
1007 g_array_append_val (keyval_array, syms[i]);
1017 *n_entries = key_array->len;
1018 *keys = (GdkKeymapKey*) g_array_free (key_array, FALSE);
1023 *n_entries = keyval_array->len;
1024 *keyvals = (guint*) g_array_free (keyval_array, FALSE);
1027 return *n_entries > 0;
1031 gdk_x11_keymap_lookup_key (GdkKeymap *keymap,
1032 const GdkKeymapKey *key)
1034 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1036 g_return_val_if_fail (key->group < 4, 0);
1039 if (KEYMAP_USE_XKB (keymap))
1041 XkbDescRec *xkb = get_xkb (keymap_x11);
1043 return XkbKeySymEntry (xkb, key->keycode, key->level, key->group);
1048 const KeySym *map = get_keymap (keymap_x11);
1049 const KeySym *syms = map + (key->keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
1050 return get_symbol (syms, keymap_x11, key->group, key->level);
1055 /* This is copied straight from XFree86 Xlib, to:
1056 * - add the group and level return.
1057 * - change the interpretation of mods_rtrn as described
1058 * in the docs for gdk_keymap_translate_keyboard_state()
1059 * It's unchanged for ease of diff against the Xlib sources; don't
1063 MyEnhancedXkbTranslateKeyCode(register XkbDescPtr xkb,
1065 register unsigned int mods,
1066 unsigned int * mods_rtrn,
1067 KeySym * keysym_rtrn,
1071 XkbKeyTypeRec *type;
1073 unsigned preserve,effectiveGroup;
1076 if (mods_rtrn!=NULL)
1079 nKeyGroups= XkbKeyNumGroups(xkb,key);
1080 if ((!XkbKeycodeInRange(xkb,key))||(nKeyGroups==0)) {
1081 if (keysym_rtrn!=NULL)
1082 *keysym_rtrn = NoSymbol;
1086 syms = XkbKeySymsPtr(xkb,key);
1088 /* find the offset of the effective group */
1090 effectiveGroup= XkbGroupForCoreState(mods);
1091 if ( effectiveGroup>=nKeyGroups ) {
1092 unsigned groupInfo= XkbKeyGroupInfo(xkb,key);
1093 switch (XkbOutOfRangeGroupAction(groupInfo)) {
1095 effectiveGroup %= nKeyGroups;
1097 case XkbClampIntoRange:
1098 effectiveGroup = nKeyGroups-1;
1100 case XkbRedirectIntoRange:
1101 effectiveGroup = XkbOutOfRangeGroupNumber(groupInfo);
1102 if (effectiveGroup>=nKeyGroups)
1107 col= effectiveGroup*XkbKeyGroupsWidth(xkb,key);
1108 type = XkbKeyKeyType(xkb,key,effectiveGroup);
1111 if (type->map) { /* find the column (shift level) within the group */
1113 register XkbKTMapEntryPtr entry;
1114 /* ---- Begin section modified for GDK ---- */
1117 for (i=0,entry=type->map;i<type->map_count;i++,entry++) {
1120 unsigned long tmp = entry->mods.mask;
1126 /* We always add one-modifiers levels to mods_rtrn since
1127 * they can't wipe out bits in the state unless the
1128 * level would be triggered. But return other modifiers
1131 if (bits == 1 || (mods&type->mods.mask)==entry->mods.mask)
1132 *mods_rtrn |= entry->mods.mask;
1135 if (!found&&entry->active&&((mods&type->mods.mask)==entry->mods.mask)) {
1138 preserve= type->preserve[i].mask;
1141 *level_rtrn = entry->level;
1146 /* ---- End section modified for GDK ---- */
1149 if (keysym_rtrn!=NULL)
1150 *keysym_rtrn= syms[col];
1152 /* ---- Begin section modified for GDK ---- */
1153 *mods_rtrn &= ~preserve;
1154 /* ---- End section modified for GDK ---- */
1156 /* ---- Begin stuff GDK comments out of the original Xlib version ---- */
1157 /* This is commented out because xkb_info is a private struct */
1160 /* The Motif VTS doesn't get the help callback called if help
1161 * is bound to Shift+<whatever>, and it appears as though it
1162 * is XkbTranslateKeyCode that is causing the problem. The
1163 * core X version of XTranslateKey always OR's in ShiftMask
1164 * and LockMask for mods_rtrn, so this "fix" keeps this behavior
1165 * and solves the VTS problem.
1167 if ((xkb->dpy)&&(xkb->dpy->xkb_info)&&
1168 (xkb->dpy->xkb_info->xlib_ctrls&XkbLC_AlwaysConsumeShiftAndLock)) { *mods_rtrn|= (ShiftMask|LockMask);
1172 /* ---- End stuff GDK comments out of the original Xlib version ---- */
1175 /* ---- Begin stuff GDK adds to the original Xlib version ---- */
1178 *group_rtrn = effectiveGroup;
1180 /* ---- End stuff GDK adds to the original Xlib version ---- */
1182 return (syms[col] != NoSymbol);
1184 #endif /* HAVE_XKB */
1186 /* Translates from keycode/state to keysymbol using the traditional interpretation
1187 * of the keyboard map. See section 12.7 of the Xlib reference manual
1190 translate_keysym (GdkX11Keymap *keymap_x11,
1191 guint hardware_keycode,
1193 GdkModifierType state,
1194 gint *effective_group,
1195 gint *effective_level)
1197 const KeySym *map = get_keymap (keymap_x11);
1198 const KeySym *syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
1200 #define SYM(k,g,l) get_symbol (syms, k,g,l)
1202 GdkModifierType shift_modifiers;
1205 gint num_lock_index;
1207 shift_modifiers = GDK_SHIFT_MASK;
1208 if (keymap_x11->lock_keysym == GDK_KEY_Shift_Lock)
1209 shift_modifiers |= GDK_LOCK_MASK;
1211 /* Fall back to the first group if the passed in group is empty
1213 if (!(SYM (keymap_x11, group, 0) || SYM (keymap_x11, group, 1)) &&
1214 (SYM (keymap_x11, 0, 0) || SYM (keymap_x11, 0, 1)))
1217 /* Hack: On Sun, the Num Lock modifier uses the third element in the
1218 * keysym array, and Mode_Switch does not apply for a keypad key.
1220 if (keymap_x11->sun_keypad)
1228 for (i = 0; i < keymap_x11->keysyms_per_keycode; i++)
1229 if (KEYSYM_IS_KEYPAD (SYM (keymap_x11, 0, i)))
1236 if ((state & keymap_x11->num_lock_mask) &&
1237 KEYSYM_IS_KEYPAD (SYM (keymap_x11, group, num_lock_index)))
1239 /* Shift, Shift_Lock cancel Num_Lock
1241 shift_level = (state & shift_modifiers) ? 0 : num_lock_index;
1242 if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, group, 0))
1245 tmp_keyval = SYM (keymap_x11, group, shift_level);
1249 /* Fall back to the first level if no symbol for the level
1252 shift_level = (state & shift_modifiers) ? 1 : 0;
1253 if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, group, 0))
1256 tmp_keyval = SYM (keymap_x11, group, shift_level);
1258 if (keymap_x11->lock_keysym == GDK_KEY_Caps_Lock && (state & GDK_LOCK_MASK) != 0)
1260 guint upper = gdk_keyval_to_upper (tmp_keyval);
1261 if (upper != tmp_keyval)
1266 if (effective_group)
1267 *effective_group = group;
1269 if (effective_level)
1270 *effective_level = shift_level;
1278 gdk_x11_keymap_translate_keyboard_state (GdkKeymap *keymap,
1279 guint hardware_keycode,
1280 GdkModifierType state,
1283 gint *effective_group,
1285 GdkModifierType *consumed_modifiers)
1287 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1288 KeySym tmp_keyval = NoSymbol;
1289 guint tmp_modifiers;
1291 g_return_val_if_fail (group < 4, FALSE);
1295 if (effective_group)
1296 *effective_group = 0;
1299 if (consumed_modifiers)
1300 *consumed_modifiers = 0;
1302 update_keyrange (keymap_x11);
1304 if (hardware_keycode < keymap_x11->min_keycode ||
1305 hardware_keycode > keymap_x11->max_keycode)
1309 if (KEYMAP_USE_XKB (keymap))
1311 XkbDescRec *xkb = get_xkb (keymap_x11);
1313 /* replace bits 13 and 14 with the provided group */
1314 state &= ~(1 << 13 | 1 << 14);
1315 state |= group << 13;
1317 MyEnhancedXkbTranslateKeyCode (xkb,
1325 if (state & ~tmp_modifiers & LockMask)
1326 tmp_keyval = gdk_keyval_to_upper (tmp_keyval);
1328 /* We need to augment the consumed modifiers with LockMask, since
1329 * we handle that ourselves, and also with the group bits
1331 tmp_modifiers |= LockMask | 1 << 13 | 1 << 14;
1336 GdkModifierType bit;
1340 /* We see what modifiers matter by trying the translation with
1341 * and without each possible modifier
1343 for (bit = GDK_SHIFT_MASK; bit < GDK_BUTTON1_MASK; bit <<= 1)
1345 /* Handling of the group here is a bit funky; a traditional
1346 * X keyboard map can have more than two groups, but no way
1347 * of accessing the extra groups is defined. We allow a
1348 * caller to pass in any group to this function, but we
1349 * only can represent switching between group 0 and 1 in
1350 * consumed modifiers.
1352 if (translate_keysym (keymap_x11, hardware_keycode,
1353 (bit == keymap_x11->group_switch_mask) ? 0 : group,
1356 translate_keysym (keymap_x11, hardware_keycode,
1357 (bit == keymap_x11->group_switch_mask) ? 1 : group,
1360 tmp_modifiers |= bit;
1363 tmp_keyval = translate_keysym (keymap_x11, hardware_keycode,
1365 level, effective_group);
1368 if (consumed_modifiers)
1369 *consumed_modifiers = tmp_modifiers;
1372 *keyval = tmp_keyval;
1374 return tmp_keyval != NoSymbol;
1377 /* Key handling not part of the keymap */
1379 _gdk_x11_display_manager_get_keyval_name (GdkDisplayManager *manager,
1384 case GDK_KEY_Page_Up:
1386 case GDK_KEY_Page_Down:
1388 case GDK_KEY_KP_Page_Up:
1389 return "KP_Page_Up";
1390 case GDK_KEY_KP_Page_Down:
1391 return "KP_Page_Down";
1394 return XKeysymToString (keyval);
1398 _gdk_x11_display_manager_lookup_keyval (GdkDisplayManager *manager,
1399 const gchar *keyval_name)
1401 g_return_val_if_fail (keyval_name != NULL, 0);
1403 return XStringToKeysym (keyval_name);
1406 #ifdef HAVE_XCONVERTCASE
1408 _gdk_x11_display_manager_keyval_convert_case (GdkDisplayManager *manager,
1416 /* Check for directly encoded 24-bit UCS characters: */
1417 if ((symbol & 0xff000000) == 0x01000000)
1420 *lower = gdk_unicode_to_keyval (g_unichar_tolower (symbol & 0x00ffffff));
1422 *upper = gdk_unicode_to_keyval (g_unichar_toupper (symbol & 0x00ffffff));
1427 XConvertCase (symbol, &xlower, &xupper);
1434 #endif /* HAVE_XCONVERTCASE */
1437 _gdk_x11_get_group_for_state (GdkDisplay *display,
1438 GdkModifierType state)
1440 GdkX11Display *display_x11 = GDK_X11_DISPLAY (display);
1443 if (display_x11->use_xkb)
1445 return XkbGroupForCoreState (state);
1450 GdkX11Keymap *keymap_impl = GDK_X11_KEYMAP (gdk_keymap_get_for_display (display));
1451 update_keymaps (keymap_impl);
1452 return (state & keymap_impl->group_switch_mask) ? 1 : 0;
1457 _gdk_x11_keymap_add_virt_mods (GdkKeymap *keymap,
1458 GdkModifierType *modifiers)
1460 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1463 /* See comment in add_virtual_modifiers() */
1464 for (i = 4; i < 8; i++)
1466 if ((1 << i) & *modifiers)
1468 if (keymap_x11->modmap[i] & GDK_SUPER_MASK)
1469 *modifiers |= GDK_SUPER_MASK;
1470 else if (keymap_x11->modmap[i] & GDK_HYPER_MASK)
1471 *modifiers |= GDK_HYPER_MASK;
1472 else if (keymap_x11->modmap[i] & GDK_META_MASK)
1473 *modifiers |= GDK_META_MASK;
1479 gdk_x11_keymap_add_virtual_modifiers (GdkKeymap *keymap,
1480 GdkModifierType *state)
1482 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1485 /* This loop used to start at 3, which included MOD1 in the
1486 * virtual mapping. However, all of GTK+ treats MOD1 as a
1487 * synonym for Alt, and does not expect it to be mapped around,
1488 * therefore it's more sane to simply treat MOD1 like SHIFT and
1489 * CONTROL, which are not mappable either.
1491 for (i = 4; i < 8; i++)
1493 if ((1 << i) & *state)
1495 if (keymap_x11->modmap[i] & GDK_SUPER_MASK)
1496 *state |= GDK_SUPER_MASK;
1497 if (keymap_x11->modmap[i] & GDK_HYPER_MASK)
1498 *state |= GDK_HYPER_MASK;
1499 if (keymap_x11->modmap[i] & GDK_META_MASK)
1500 *state |= GDK_META_MASK;
1506 _gdk_x11_keymap_key_is_modifier (GdkKeymap *keymap,
1509 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1512 update_keyrange (keymap_x11);
1513 if (keycode < keymap_x11->min_keycode ||
1514 keycode > keymap_x11->max_keycode)
1518 if (KEYMAP_USE_XKB (keymap))
1520 XkbDescRec *xkb = get_xkb (keymap_x11);
1522 if (xkb->map->modmap && xkb->map->modmap[keycode] != 0)
1528 for (i = 0; i < 8 * keymap_x11->mod_keymap->max_keypermod; i++)
1530 if (keycode == keymap_x11->mod_keymap->modifiermap[i])
1539 gdk_x11_keymap_map_virtual_modifiers (GdkKeymap *keymap,
1540 GdkModifierType *state)
1542 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1543 const guint vmods[] = { GDK_SUPER_MASK, GDK_HYPER_MASK, GDK_META_MASK };
1547 if (KEYMAP_USE_XKB (keymap))
1548 get_xkb (keymap_x11);
1552 for (j = 0; j < 3; j++)
1554 if (*state & vmods[j])
1556 /* See comment in add_virtual_modifiers() */
1557 for (i = 4; i < 8; i++)
1559 if (keymap_x11->modmap[i] & vmods[j])
1561 if (*state & (1 << i))
1573 static GdkModifierType
1574 gdk_x11_keymap_get_modifier_mask (GdkKeymap *keymap,
1575 GdkModifierIntent intent)
1577 GdkX11Keymap *keymap_x11 = GDK_X11_KEYMAP (keymap);
1581 case GDK_MODIFIER_INTENT_SHIFT_GROUP:
1582 return keymap_x11->group_switch_mask;
1585 return GDK_KEYMAP_CLASS (gdk_x11_keymap_parent_class)->get_modifier_mask (keymap,
1591 gdk_x11_keymap_class_init (GdkX11KeymapClass *klass)
1593 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1594 GdkKeymapClass *keymap_class = GDK_KEYMAP_CLASS (klass);
1596 object_class->finalize = gdk_x11_keymap_finalize;
1598 keymap_class->get_direction = gdk_x11_keymap_get_direction;
1599 keymap_class->have_bidi_layouts = gdk_x11_keymap_have_bidi_layouts;
1600 keymap_class->get_caps_lock_state = gdk_x11_keymap_get_caps_lock_state;
1601 keymap_class->get_num_lock_state = gdk_x11_keymap_get_num_lock_state;
1602 keymap_class->get_modifier_state = gdk_x11_keymap_get_modifier_state;
1603 keymap_class->get_entries_for_keyval = gdk_x11_keymap_get_entries_for_keyval;
1604 keymap_class->get_entries_for_keycode = gdk_x11_keymap_get_entries_for_keycode;
1605 keymap_class->lookup_key = gdk_x11_keymap_lookup_key;
1606 keymap_class->translate_keyboard_state = gdk_x11_keymap_translate_keyboard_state;
1607 keymap_class->add_virtual_modifiers = gdk_x11_keymap_add_virtual_modifiers;
1608 keymap_class->map_virtual_modifiers = gdk_x11_keymap_map_virtual_modifiers;
1609 keymap_class->get_modifier_mask = gdk_x11_keymap_get_modifier_mask;