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 "gdkkeysprivate.h"
30 #include "gdkkeysyms.h"
31 #include "gdkprivate-x11.h"
32 #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 _GdkKeymapX11 GdkKeymapX11;
54 typedef struct _GdkKeymapClass GdkKeymapX11Class;
56 #define GDK_TYPE_KEYMAP_X11 (gdk_keymap_x11_get_type ())
57 #define GDK_KEYMAP_X11(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_KEYMAP_X11, GdkKeymapX11))
58 #define GDK_IS_KEYMAP_X11(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_KEYMAP_X11))
60 typedef struct _DirectionCacheEntry DirectionCacheEntry;
62 struct _DirectionCacheEntry
66 PangoDirection direction;
71 GdkKeymap parent_instance;
76 gint keysyms_per_keycode;
77 XModifierKeymap* mod_keymap;
79 GdkModifierType group_switch_mask;
80 GdkModifierType num_lock_mask;
81 GdkModifierType modmap[8];
82 PangoDirection current_direction;
84 guint have_direction : 1;
85 guint caps_lock_state : 1;
86 guint num_lock_state : 1;
91 /* We cache the directions */
92 Atom current_group_atom;
93 guint current_cache_serial;
94 /* A cache of size four should be more than enough, people usually
95 * have two groups around, and the xkb limit is four. It still
96 * works correct for more than four groups. It's just the
99 DirectionCacheEntry group_direction_cache[4];
103 #define KEYMAP_USE_XKB(keymap) GDK_DISPLAY_X11 ((keymap)->display)->use_xkb
104 #define KEYMAP_XDISPLAY(keymap) GDK_DISPLAY_XDISPLAY ((keymap)->display)
106 static GType gdk_keymap_x11_get_type (void);
107 static void gdk_keymap_x11_class_init (GdkKeymapX11Class *klass);
108 static void gdk_keymap_x11_init (GdkKeymapX11 *keymap);
109 static void gdk_keymap_x11_finalize (GObject *object);
111 static GdkKeymapClass *parent_class = NULL;
114 gdk_keymap_x11_get_type (void)
116 static GType object_type = 0;
120 const GTypeInfo object_info =
122 sizeof (GdkKeymapClass),
123 (GBaseInitFunc) NULL,
124 (GBaseFinalizeFunc) NULL,
125 (GClassInitFunc) gdk_keymap_x11_class_init,
126 NULL, /* class_finalize */
127 NULL, /* class_data */
128 sizeof (GdkKeymapX11),
130 (GInstanceInitFunc) gdk_keymap_x11_init,
133 object_type = g_type_register_static (GDK_TYPE_KEYMAP,
134 g_intern_static_string ("GdkKeymapX11"),
142 gdk_keymap_x11_init (GdkKeymapX11 *keymap)
144 keymap->min_keycode = 0;
145 keymap->max_keycode = 0;
147 keymap->keymap = NULL;
148 keymap->keysyms_per_keycode = 0;
149 keymap->mod_keymap = NULL;
151 keymap->num_lock_mask = 0;
152 keymap->sun_keypad = FALSE;
153 keymap->group_switch_mask = 0;
154 keymap->lock_keysym = GDK_KEY_Caps_Lock;
155 keymap->have_direction = FALSE;
156 keymap->current_serial = 0;
159 keymap->xkb_desc = NULL;
160 keymap->current_group_atom = 0;
161 keymap->current_cache_serial = 0;
167 gdk_keymap_x11_finalize (GObject *object)
169 GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (object);
171 if (keymap_x11->keymap)
172 XFree (keymap_x11->keymap);
174 if (keymap_x11->mod_keymap)
175 XFreeModifiermap (keymap_x11->mod_keymap);
178 if (keymap_x11->xkb_desc)
179 XkbFreeKeyboard (keymap_x11->xkb_desc, XkbAllComponentsMask, True);
182 G_OBJECT_CLASS (parent_class)->finalize (object);
186 update_keyrange (GdkKeymapX11 *keymap_x11)
188 if (keymap_x11->max_keycode == 0)
189 XDisplayKeycodes (KEYMAP_XDISPLAY (GDK_KEYMAP (keymap_x11)),
190 &keymap_x11->min_keycode, &keymap_x11->max_keycode);
196 update_modmap (Display *display,
197 GdkKeymapX11 *keymap_x11)
202 GdkModifierType mask;
204 { "Meta", 0, GDK_META_MASK },
205 { "Super", 0, GDK_SUPER_MASK },
206 { "Hyper", 0, GDK_HYPER_MASK },
213 for (i = 0; vmods[i].name; i++)
214 vmods[i].atom = XInternAtom (display, vmods[i].name, FALSE);
216 for (i = 0; i < 8; i++)
217 keymap_x11->modmap[i] = 1 << i;
219 for (i = 0; i < XkbNumVirtualMods; i++)
221 for (j = 0; vmods[j].atom; j++)
223 if (keymap_x11->xkb_desc->names->vmods[i] == vmods[j].atom)
225 for (k = 0; k < 8; k++)
227 if (keymap_x11->xkb_desc->server->vmods[i] & (1 << k))
228 keymap_x11->modmap[k] |= vmods[j].mask;
236 get_xkb (GdkKeymapX11 *keymap_x11)
238 GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (GDK_KEYMAP (keymap_x11)->display);
239 Display *xdisplay = display_x11->xdisplay;
241 update_keyrange (keymap_x11);
243 if (keymap_x11->xkb_desc == NULL)
245 keymap_x11->xkb_desc = XkbGetMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask | XkbModifierMapMask | XkbVirtualModsMask, XkbUseCoreKbd);
246 if (keymap_x11->xkb_desc == NULL)
248 g_error ("Failed to get keymap");
252 XkbGetNames (xdisplay, XkbGroupNamesMask | XkbVirtualModNamesMask, keymap_x11->xkb_desc);
254 update_modmap (xdisplay, keymap_x11);
256 else if (keymap_x11->current_serial != display_x11->keymap_serial)
258 XkbGetUpdatedMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask | XkbModifierMapMask | XkbVirtualModsMask,
259 keymap_x11->xkb_desc);
260 XkbGetNames (xdisplay, XkbGroupNamesMask | XkbVirtualModNamesMask, keymap_x11->xkb_desc);
262 update_modmap (xdisplay, keymap_x11);
265 keymap_x11->current_serial = display_x11->keymap_serial;
267 if (keymap_x11->num_lock_mask == 0)
268 keymap_x11->num_lock_mask = XkbKeysymToModifiers (KEYMAP_XDISPLAY (GDK_KEYMAP (keymap_x11)), XK_Num_Lock);
270 return keymap_x11->xkb_desc;
272 #endif /* HAVE_XKB */
274 /* Whether we were able to turn on detectable-autorepeat using
275 * XkbSetDetectableAutorepeat. If FALSE, we'll fall back
276 * to checking the next event with XPending().
280 * gdk_keymap_get_for_display:
281 * @display: the #GdkDisplay.
283 * Returns the #GdkKeymap attached to @display.
285 * Return value: (transfer none): the #GdkKeymap attached to @display.
290 gdk_keymap_get_for_display (GdkDisplay *display)
292 GdkDisplayX11 *display_x11;
293 g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
294 display_x11 = GDK_DISPLAY_X11 (display);
296 if (!display_x11->keymap)
297 display_x11->keymap = g_object_new (gdk_keymap_x11_get_type (), NULL);
299 display_x11->keymap->display = display;
301 return display_x11->keymap;
304 /* Find the index of the group/level pair within the keysyms for a key.
305 * We round up the number of keysyms per keycode to the next even number,
306 * otherwise we lose a whole group of keys
308 #define KEYSYM_INDEX(keymap_impl, group, level) \
309 (2 * ((group) % (gint)((keymap_impl->keysyms_per_keycode + 1) / 2)) + (level))
310 #define KEYSYM_IS_KEYPAD(s) (((s) >= 0xff80 && (s) <= 0xffbd) || \
311 ((s) >= 0x11000000 && (s) <= 0x1100ffff))
314 get_symbol (const KeySym *syms,
315 GdkKeymapX11 *keymap_x11,
321 index = KEYSYM_INDEX(keymap_x11, group, level);
322 if (index >= keymap_x11->keysyms_per_keycode)
329 set_symbol (KeySym *syms,
330 GdkKeymapX11 *keymap_x11,
337 index = KEYSYM_INDEX(keymap_x11, group, level);
338 if (index >= keymap_x11->keysyms_per_keycode)
345 update_keymaps (GdkKeymapX11 *keymap_x11)
347 GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (GDK_KEYMAP (keymap_x11)->display);
348 Display *xdisplay = display_x11->xdisplay;
351 g_assert (!KEYMAP_USE_XKB (GDK_KEYMAP (keymap_x11)));
354 if (keymap_x11->keymap == NULL ||
355 keymap_x11->current_serial != display_x11->keymap_serial)
361 keymap_x11->current_serial = display_x11->keymap_serial;
363 update_keyrange (keymap_x11);
365 if (keymap_x11->keymap)
366 XFree (keymap_x11->keymap);
368 if (keymap_x11->mod_keymap)
369 XFreeModifiermap (keymap_x11->mod_keymap);
371 keymap_x11->keymap = XGetKeyboardMapping (xdisplay, keymap_x11->min_keycode,
372 keymap_x11->max_keycode - keymap_x11->min_keycode + 1,
373 &keymap_x11->keysyms_per_keycode);
376 /* GDK_KEY_ISO_Left_Tab, as usually configured through XKB, really messes
377 * up the whole idea of "consumed modifiers" because shift is consumed.
378 * However, <shift>Tab is not usually GDK_KEY_ISO_Left_Tab without XKB,
379 * we we fudge the map here.
381 keycode = keymap_x11->min_keycode;
382 while (keycode <= keymap_x11->max_keycode)
384 KeySym *syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
385 /* Check both groups */
386 for (i = 0 ; i < 2 ; i++)
388 if (get_symbol (syms, keymap_x11, i, 0) == GDK_KEY_Tab)
389 set_symbol (syms, keymap_x11, i, 1, GDK_KEY_ISO_Left_Tab);
393 * If there is one keysym and the key symbol has upper and lower
394 * case variants fudge the keymap
396 if (get_symbol (syms, keymap_x11, 0, 1) == 0)
401 gdk_keyval_convert_case (get_symbol (syms, keymap_x11, 0, 0), &lower, &upper);
404 set_symbol (syms, keymap_x11, 0, 0, lower);
405 set_symbol (syms, keymap_x11, 0, 1, upper);
413 keymap_x11->mod_keymap = XGetModifierMapping (xdisplay);
415 keymap_x11->lock_keysym = GDK_KEY_VoidSymbol;
416 keymap_x11->group_switch_mask = 0;
417 keymap_x11->num_lock_mask = 0;
419 for (i = 0; i < 8; i++)
420 keymap_x11->modmap[i] = 1 << i;
422 /* There are 8 sets of modifiers, with each set containing
423 * max_keypermod keycodes.
425 map_size = 8 * keymap_x11->mod_keymap->max_keypermod;
426 for (i = 0; i < map_size; i++)
428 /* Get the key code at this point in the map. */
429 gint keycode = keymap_x11->mod_keymap->modifiermap[i];
434 /* Ignore invalid keycodes. */
435 if (keycode < keymap_x11->min_keycode ||
436 keycode > keymap_x11->max_keycode)
439 syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
442 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
444 if (syms[j] == GDK_KEY_Meta_L ||
445 syms[j] == GDK_KEY_Meta_R)
446 mask |= GDK_META_MASK;
447 else if (syms[j] == GDK_KEY_Hyper_L ||
448 syms[j] == GDK_KEY_Hyper_R)
449 mask |= GDK_HYPER_MASK;
450 else if (syms[j] == GDK_KEY_Super_L ||
451 syms[j] == GDK_KEY_Super_R)
452 mask |= GDK_SUPER_MASK;
455 keymap_x11->modmap[i/keymap_x11->mod_keymap->max_keypermod] |= mask;
457 /* The fourth modifier, GDK_MOD1_MASK is 1 << 3.
458 * Each group of max_keypermod entries refers to the same modifier.
460 mask = 1 << (i / keymap_x11->mod_keymap->max_keypermod);
465 /* Get the Lock keysym. If any keysym bound to the Lock modifier
466 * is Caps_Lock, we will interpret the modifier as Caps_Lock;
467 * otherwise, if any is bound to Shift_Lock, we will interpret
468 * the modifier as Shift_Lock. Otherwise, the lock modifier
471 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
473 if (syms[j] == GDK_KEY_Caps_Lock)
474 keymap_x11->lock_keysym = GDK_KEY_Caps_Lock;
475 else if (syms[j] == GDK_KEY_Shift_Lock &&
476 keymap_x11->lock_keysym == GDK_KEY_VoidSymbol)
477 keymap_x11->lock_keysym = GDK_KEY_Shift_Lock;
481 case GDK_CONTROL_MASK:
484 /* Some keyboard maps are known to map Mode_Switch as an
485 * extra Mod1 key. In circumstances like that, it won't be
486 * used to switch groups.
491 /* Find the Mode_Switch and Num_Lock modifiers. */
492 for (j = 0; j < keymap_x11->keysyms_per_keycode; j++)
494 if (syms[j] == GDK_KEY_Mode_switch)
496 /* This modifier swaps groups */
497 keymap_x11->group_switch_mask |= mask;
499 else if (syms[j] == GDK_KEY_Num_Lock)
501 /* This modifier is used for Num_Lock */
502 keymap_x11->num_lock_mask |= mask;
509 /* Hack: The Sun X server puts the keysym to use when the Num Lock
510 * modifier is on in the third element of the keysym array, instead
513 if ((strcmp (ServerVendor (xdisplay), "Sun Microsystems, Inc.") == 0) &&
514 (keymap_x11->keysyms_per_keycode > 2))
515 keymap_x11->sun_keypad = TRUE;
517 keymap_x11->sun_keypad = FALSE;
522 get_keymap (GdkKeymapX11 *keymap_x11)
524 update_keymaps (keymap_x11);
526 return keymap_x11->keymap;
529 #define GET_EFFECTIVE_KEYMAP(keymap) get_effective_keymap ((keymap), G_STRFUNC)
532 get_effective_keymap (GdkKeymap *keymap,
533 const char *function)
538 g_message ("reverting to default display keymap in %s",
540 return gdk_keymap_get_default ();
547 static PangoDirection
548 get_direction (XkbDescRec *xkb,
553 gint rtl_minus_ltr = 0; /* total number of RTL keysyms minus LTR ones */
555 for (code = xkb->min_key_code; code <= xkb->max_key_code; code++)
558 KeySym sym = XkbKeySymEntry (xkb, code, level, group);
559 PangoDirection dir = pango_unichar_direction (gdk_keyval_to_unicode (sym));
563 case PANGO_DIRECTION_RTL:
566 case PANGO_DIRECTION_LTR:
574 if (rtl_minus_ltr > 0)
575 return PANGO_DIRECTION_RTL;
577 return PANGO_DIRECTION_LTR;
580 static PangoDirection
581 get_direction_from_cache (GdkKeymapX11 *keymap_x11,
585 Atom group_atom = xkb->names->groups[group];
587 gboolean cache_hit = FALSE;
588 DirectionCacheEntry *cache = keymap_x11->group_direction_cache;
590 PangoDirection direction = PANGO_DIRECTION_NEUTRAL;
593 if (keymap_x11->have_direction)
595 /* lookup in cache */
596 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
598 if (cache[i].group_atom == group_atom)
601 cache[i].serial = keymap_x11->current_cache_serial++; /* freshen */
602 direction = cache[i].direction;
603 group_atom = cache[i].group_atom;
610 /* initialize cache */
611 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
613 cache[i].group_atom = 0;
614 cache[i].serial = keymap_x11->current_cache_serial;
616 keymap_x11->current_cache_serial++;
619 /* insert in cache */
624 direction = get_direction (xkb, group);
626 /* remove the oldest entry */
627 for (i = 0; i < G_N_ELEMENTS (keymap_x11->group_direction_cache); i++)
629 if (cache[i].serial < cache[oldest].serial)
633 cache[oldest].group_atom = group_atom;
634 cache[oldest].direction = direction;
635 cache[oldest].serial = keymap_x11->current_cache_serial++;
642 get_num_groups (GdkKeymap *keymap,
645 Display *display = KEYMAP_XDISPLAY (keymap);
646 XkbGetControls(display, XkbSlowKeysMask, xkb);
647 XkbGetUpdatedMap (display, XkbKeySymsMask | XkbKeyTypesMask |
648 XkbModifierMapMask | XkbVirtualModsMask, xkb);
649 return xkb->ctrls->num_groups;
653 update_direction (GdkKeymapX11 *keymap_x11,
656 XkbDescPtr xkb = get_xkb (keymap_x11);
658 gboolean had_direction;
659 PangoDirection old_direction;
661 had_direction = keymap_x11->have_direction;
662 old_direction = keymap_x11->current_direction;
664 group_atom = xkb->names->groups[group];
666 /* a group change? */
667 if (!keymap_x11->have_direction || keymap_x11->current_group_atom != group_atom)
669 keymap_x11->current_direction = get_direction_from_cache (keymap_x11, xkb, group);
670 keymap_x11->current_group_atom = group_atom;
671 keymap_x11->have_direction = TRUE;
674 return !had_direction || old_direction != keymap_x11->current_direction;
678 update_lock_state (GdkKeymapX11 *keymap_x11,
681 gboolean caps_lock_state;
682 gboolean num_lock_state;
684 caps_lock_state = keymap_x11->caps_lock_state;
685 num_lock_state = keymap_x11->num_lock_state;
687 keymap_x11->caps_lock_state = (locked_mods & GDK_LOCK_MASK) != 0;
688 keymap_x11->num_lock_state = (locked_mods & keymap_x11->num_lock_mask) != 0;
690 return (caps_lock_state != keymap_x11->caps_lock_state)
691 || (num_lock_state != keymap_x11->num_lock_state);
694 /* keep this in sync with the XkbSelectEventDetails() call
695 * in gdk_display_open()
698 _gdk_keymap_state_changed (GdkDisplay *display,
701 GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
702 XkbEvent *xkb_event = (XkbEvent *)xevent;
704 if (display_x11->keymap)
706 GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (display_x11->keymap);
708 if (update_direction (keymap_x11, XkbStateGroup (&xkb_event->state)))
709 g_signal_emit_by_name (keymap_x11, "direction-changed");
711 if (update_lock_state (keymap_x11, xkb_event->state.locked_mods))
712 g_signal_emit_by_name (keymap_x11, "state-changed");
716 #endif /* HAVE_XKB */
719 _gdk_keymap_keys_changed (GdkDisplay *display)
721 GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
723 ++display_x11->keymap_serial;
725 if (display_x11->keymap)
726 g_signal_emit_by_name (display_x11->keymap, "keys_changed", 0);
729 static PangoDirection
730 gdk_x11_keymap_get_direction (GdkKeymap *keymap)
732 keymap = GET_EFFECTIVE_KEYMAP (keymap);
735 if (KEYMAP_USE_XKB (keymap))
737 GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (keymap);
739 if (!keymap_x11->have_direction)
741 GdkDisplay *display = GDK_KEYMAP (keymap_x11)->display;
742 XkbStateRec state_rec;
744 XkbGetState (GDK_DISPLAY_XDISPLAY (display), XkbUseCoreKbd,
746 update_direction (keymap_x11, XkbStateGroup (&state_rec));
749 return keymap_x11->current_direction;
752 #endif /* HAVE_XKB */
753 return PANGO_DIRECTION_NEUTRAL;
757 gdk_x11_keymap_have_bidi_layouts (GdkKeymap *keymap)
759 keymap = GET_EFFECTIVE_KEYMAP (keymap);
762 if (KEYMAP_USE_XKB (keymap))
764 GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (keymap);
765 XkbDescPtr xkb = get_xkb (keymap_x11);
766 int num_groups = get_num_groups (keymap, xkb);
769 gboolean have_ltr_keyboard = FALSE;
770 gboolean have_rtl_keyboard = FALSE;
772 for (i = 0; i < num_groups; i++)
774 if (get_direction_from_cache (keymap_x11, xkb, i) == PANGO_DIRECTION_RTL)
775 have_rtl_keyboard = TRUE;
777 have_ltr_keyboard = TRUE;
780 return have_ltr_keyboard && have_rtl_keyboard;
783 #endif /* HAVE_XKB */
788 gdk_x11_keymap_get_caps_lock_state (GdkKeymap *keymap)
790 GdkKeymapX11 *keymap_x11;
792 keymap = GET_EFFECTIVE_KEYMAP (keymap);
794 keymap_x11 = GDK_KEYMAP_X11 (keymap);
796 return keymap_x11->caps_lock_state;
800 gdk_x11_keymap_get_num_lock_state (GdkKeymap *keymap)
802 GdkKeymapX11 *keymap_x11;
804 keymap = GET_EFFECTIVE_KEYMAP (keymap);
806 keymap_x11 = GDK_KEYMAP_X11 (keymap);
808 return keymap_x11->num_lock_state;
812 gdk_x11_keymap_get_entries_for_keyval (GdkKeymap *keymap,
818 GdkKeymapX11 *keymap_x11;
820 g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
821 g_return_val_if_fail (keys != NULL, FALSE);
822 g_return_val_if_fail (n_keys != NULL, FALSE);
823 g_return_val_if_fail (keyval != 0, FALSE);
825 keymap = GET_EFFECTIVE_KEYMAP (keymap);
826 keymap_x11 = GDK_KEYMAP_X11 (keymap);
828 retval = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
831 if (KEYMAP_USE_XKB (keymap))
833 /* See sec 15.3.4 in XKB docs */
835 XkbDescRec *xkb = get_xkb (keymap_x11);
838 keycode = keymap_x11->min_keycode;
840 while (keycode <= keymap_x11->max_keycode)
842 gint max_shift_levels = XkbKeyGroupsWidth (xkb, keycode); /* "key width" */
845 gint total_syms = XkbKeyNumSyms (xkb, keycode);
849 /* entry is an array with all syms for group 0, all
850 * syms for group 1, etc. and for each group the
851 * shift level syms are in order
853 entry = XkbKeySymsPtr (xkb, keycode);
855 while (i < total_syms)
857 /* check out our cool loop invariant */
858 g_assert (i == (group * max_shift_levels + level));
860 if (entry[i] == keyval)
865 key.keycode = keycode;
869 g_array_append_val (retval, key);
871 g_assert (XkbKeySymEntry (xkb, keycode, level, group) ==
877 if (level == max_shift_levels)
892 const KeySym *map = get_keymap (keymap_x11);
895 keycode = keymap_x11->min_keycode;
896 while (keycode <= keymap_x11->max_keycode)
898 const KeySym *syms = map + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
901 while (i < keymap_x11->keysyms_per_keycode)
903 if (syms[i] == keyval)
908 key.keycode = keycode;
910 /* The "classic" non-XKB keymap has 2 levels per group */
914 g_array_append_val (retval, key);
926 *keys = (GdkKeymapKey*) retval->data;
927 *n_keys = retval->len;
935 g_array_free (retval, retval->len > 0 ? FALSE : TRUE);
941 gdk_x11_keymap_get_entries_for_keycode (GdkKeymap *keymap,
942 guint hardware_keycode,
947 GdkKeymapX11 *keymap_x11;
950 GArray *keyval_array;
952 g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
953 g_return_val_if_fail (n_entries != NULL, FALSE);
955 keymap = GET_EFFECTIVE_KEYMAP (keymap);
956 keymap_x11 = GDK_KEYMAP_X11 (keymap);
958 update_keyrange (keymap_x11);
960 if (hardware_keycode < keymap_x11->min_keycode ||
961 hardware_keycode > keymap_x11->max_keycode)
973 key_array = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
978 keyval_array = g_array_new (FALSE, FALSE, sizeof (guint));
983 if (KEYMAP_USE_XKB (keymap))
985 /* See sec 15.3.4 in XKB docs */
987 XkbDescRec *xkb = get_xkb (keymap_x11);
988 gint max_shift_levels;
995 max_shift_levels = XkbKeyGroupsWidth (xkb, hardware_keycode); /* "key width" */
996 total_syms = XkbKeyNumSyms (xkb, hardware_keycode);
998 /* entry is an array with all syms for group 0, all
999 * syms for group 1, etc. and for each group the
1000 * shift level syms are in order
1002 entry = XkbKeySymsPtr (xkb, hardware_keycode);
1004 while (i < total_syms)
1006 /* check out our cool loop invariant */
1007 g_assert (i == (group * max_shift_levels + level));
1013 key.keycode = hardware_keycode;
1017 g_array_append_val (key_array, key);
1021 g_array_append_val (keyval_array, entry[i]);
1025 if (level == max_shift_levels)
1037 const KeySym *map = get_keymap (keymap_x11);
1041 syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
1043 while (i < keymap_x11->keysyms_per_keycode)
1049 key.keycode = hardware_keycode;
1051 /* The "classic" non-XKB keymap has 2 levels per group */
1055 g_array_append_val (key_array, key);
1059 g_array_append_val (keyval_array, syms[i]);
1069 *n_entries = key_array->len;
1070 *keys = (GdkKeymapKey*) g_array_free (key_array, FALSE);
1075 *n_entries = keyval_array->len;
1076 *keyvals = (guint*) g_array_free (keyval_array, FALSE);
1079 return *n_entries > 0;
1083 gdk_x11_keymap_lookup_key (GdkKeymap *keymap,
1084 const GdkKeymapKey *key)
1086 GdkKeymapX11 *keymap_x11;
1088 g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), 0);
1089 g_return_val_if_fail (key != NULL, 0);
1090 g_return_val_if_fail (key->group < 4, 0);
1092 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1093 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1096 if (KEYMAP_USE_XKB (keymap))
1098 XkbDescRec *xkb = get_xkb (keymap_x11);
1100 return XkbKeySymEntry (xkb, key->keycode, key->level, key->group);
1105 const KeySym *map = get_keymap (keymap_x11);
1106 const KeySym *syms = map + (key->keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
1107 return get_symbol (syms, keymap_x11, key->group, key->level);
1112 /* This is copied straight from XFree86 Xlib, to:
1113 * - add the group and level return.
1114 * - change the interpretation of mods_rtrn as described
1115 * in the docs for gdk_keymap_translate_keyboard_state()
1116 * It's unchanged for ease of diff against the Xlib sources; don't
1120 MyEnhancedXkbTranslateKeyCode(register XkbDescPtr xkb,
1122 register unsigned int mods,
1123 unsigned int * mods_rtrn,
1124 KeySym * keysym_rtrn,
1128 XkbKeyTypeRec *type;
1130 unsigned preserve,effectiveGroup;
1133 if (mods_rtrn!=NULL)
1136 nKeyGroups= XkbKeyNumGroups(xkb,key);
1137 if ((!XkbKeycodeInRange(xkb,key))||(nKeyGroups==0)) {
1138 if (keysym_rtrn!=NULL)
1139 *keysym_rtrn = NoSymbol;
1143 syms = XkbKeySymsPtr(xkb,key);
1145 /* find the offset of the effective group */
1147 effectiveGroup= XkbGroupForCoreState(mods);
1148 if ( effectiveGroup>=nKeyGroups ) {
1149 unsigned groupInfo= XkbKeyGroupInfo(xkb,key);
1150 switch (XkbOutOfRangeGroupAction(groupInfo)) {
1152 effectiveGroup %= nKeyGroups;
1154 case XkbClampIntoRange:
1155 effectiveGroup = nKeyGroups-1;
1157 case XkbRedirectIntoRange:
1158 effectiveGroup = XkbOutOfRangeGroupNumber(groupInfo);
1159 if (effectiveGroup>=nKeyGroups)
1164 col= effectiveGroup*XkbKeyGroupsWidth(xkb,key);
1165 type = XkbKeyKeyType(xkb,key,effectiveGroup);
1168 if (type->map) { /* find the column (shift level) within the group */
1170 register XkbKTMapEntryPtr entry;
1171 /* ---- Begin section modified for GDK ---- */
1174 for (i=0,entry=type->map;i<type->map_count;i++,entry++) {
1177 unsigned long tmp = entry->mods.mask;
1183 /* We always add one-modifiers levels to mods_rtrn since
1184 * they can't wipe out bits in the state unless the
1185 * level would be triggered. But return other modifiers
1188 if (bits == 1 || (mods&type->mods.mask)==entry->mods.mask)
1189 *mods_rtrn |= entry->mods.mask;
1192 if (!found&&entry->active&&((mods&type->mods.mask)==entry->mods.mask)) {
1195 preserve= type->preserve[i].mask;
1198 *level_rtrn = entry->level;
1203 /* ---- End section modified for GDK ---- */
1206 if (keysym_rtrn!=NULL)
1207 *keysym_rtrn= syms[col];
1209 /* ---- Begin section modified for GDK ---- */
1210 *mods_rtrn &= ~preserve;
1211 /* ---- End section modified for GDK ---- */
1213 /* ---- Begin stuff GDK comments out of the original Xlib version ---- */
1214 /* This is commented out because xkb_info is a private struct */
1217 /* The Motif VTS doesn't get the help callback called if help
1218 * is bound to Shift+<whatever>, and it appears as though it
1219 * is XkbTranslateKeyCode that is causing the problem. The
1220 * core X version of XTranslateKey always OR's in ShiftMask
1221 * and LockMask for mods_rtrn, so this "fix" keeps this behavior
1222 * and solves the VTS problem.
1224 if ((xkb->dpy)&&(xkb->dpy->xkb_info)&&
1225 (xkb->dpy->xkb_info->xlib_ctrls&XkbLC_AlwaysConsumeShiftAndLock)) { *mods_rtrn|= (ShiftMask|LockMask);
1229 /* ---- End stuff GDK comments out of the original Xlib version ---- */
1232 /* ---- Begin stuff GDK adds to the original Xlib version ---- */
1235 *group_rtrn = effectiveGroup;
1237 /* ---- End stuff GDK adds to the original Xlib version ---- */
1239 return (syms[col] != NoSymbol);
1241 #endif /* HAVE_XKB */
1243 /* Translates from keycode/state to keysymbol using the traditional interpretation
1244 * of the keyboard map. See section 12.7 of the Xlib reference manual
1247 translate_keysym (GdkKeymapX11 *keymap_x11,
1248 guint hardware_keycode,
1250 GdkModifierType state,
1251 gint *effective_group,
1252 gint *effective_level)
1254 const KeySym *map = get_keymap (keymap_x11);
1255 const KeySym *syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
1257 #define SYM(k,g,l) get_symbol (syms, k,g,l)
1259 GdkModifierType shift_modifiers;
1262 gint num_lock_index;
1264 shift_modifiers = GDK_SHIFT_MASK;
1265 if (keymap_x11->lock_keysym == GDK_KEY_Shift_Lock)
1266 shift_modifiers |= GDK_LOCK_MASK;
1268 /* Fall back to the first group if the passed in group is empty
1270 if (!(SYM (keymap_x11, group, 0) || SYM (keymap_x11, group, 1)) &&
1271 (SYM (keymap_x11, 0, 0) || SYM (keymap_x11, 0, 1)))
1274 /* Hack: On Sun, the Num Lock modifier uses the third element in the
1275 * keysym array, and Mode_Switch does not apply for a keypad key.
1277 if (keymap_x11->sun_keypad)
1285 for (i = 0; i < keymap_x11->keysyms_per_keycode; i++)
1286 if (KEYSYM_IS_KEYPAD (SYM (keymap_x11, 0, i)))
1293 if ((state & keymap_x11->num_lock_mask) &&
1294 KEYSYM_IS_KEYPAD (SYM (keymap_x11, group, num_lock_index)))
1296 /* Shift, Shift_Lock cancel Num_Lock
1298 shift_level = (state & shift_modifiers) ? 0 : num_lock_index;
1299 if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, group, 0))
1302 tmp_keyval = SYM (keymap_x11, group, shift_level);
1306 /* Fall back to the first level if no symbol for the level
1309 shift_level = (state & shift_modifiers) ? 1 : 0;
1310 if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, group, 0))
1313 tmp_keyval = SYM (keymap_x11, group, shift_level);
1315 if (keymap_x11->lock_keysym == GDK_KEY_Caps_Lock && (state & GDK_LOCK_MASK) != 0)
1317 guint upper = gdk_keyval_to_upper (tmp_keyval);
1318 if (upper != tmp_keyval)
1323 if (effective_group)
1324 *effective_group = group;
1326 if (effective_level)
1327 *effective_level = shift_level;
1335 gdk_x11_keymap_translate_keyboard_state (GdkKeymap *keymap,
1336 guint hardware_keycode,
1337 GdkModifierType state,
1340 gint *effective_group,
1342 GdkModifierType *consumed_modifiers)
1344 GdkKeymapX11 *keymap_x11;
1345 KeySym tmp_keyval = NoSymbol;
1346 guint tmp_modifiers;
1348 g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
1349 g_return_val_if_fail (group < 4, FALSE);
1351 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1352 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1356 if (effective_group)
1357 *effective_group = 0;
1360 if (consumed_modifiers)
1361 *consumed_modifiers = 0;
1363 update_keyrange (keymap_x11);
1365 if (hardware_keycode < keymap_x11->min_keycode ||
1366 hardware_keycode > keymap_x11->max_keycode)
1370 if (KEYMAP_USE_XKB (keymap))
1372 XkbDescRec *xkb = get_xkb (keymap_x11);
1374 /* replace bits 13 and 14 with the provided group */
1375 state &= ~(1 << 13 | 1 << 14);
1376 state |= group << 13;
1378 MyEnhancedXkbTranslateKeyCode (xkb,
1386 if (state & ~tmp_modifiers & LockMask)
1387 tmp_keyval = gdk_keyval_to_upper (tmp_keyval);
1389 /* We need to augment the consumed modifiers with LockMask, since
1390 * we handle that ourselves, and also with the group bits
1392 tmp_modifiers |= LockMask | 1 << 13 | 1 << 14;
1397 GdkModifierType bit;
1401 /* We see what modifiers matter by trying the translation with
1402 * and without each possible modifier
1404 for (bit = GDK_SHIFT_MASK; bit < GDK_BUTTON1_MASK; bit <<= 1)
1406 /* Handling of the group here is a bit funky; a traditional
1407 * X keyboard map can have more than two groups, but no way
1408 * of accessing the extra groups is defined. We allow a
1409 * caller to pass in any group to this function, but we
1410 * only can represent switching between group 0 and 1 in
1411 * consumed modifiers.
1413 if (translate_keysym (keymap_x11, hardware_keycode,
1414 (bit == keymap_x11->group_switch_mask) ? 0 : group,
1417 translate_keysym (keymap_x11, hardware_keycode,
1418 (bit == keymap_x11->group_switch_mask) ? 1 : group,
1421 tmp_modifiers |= bit;
1424 tmp_keyval = translate_keysym (keymap_x11, hardware_keycode,
1426 level, effective_group);
1429 if (consumed_modifiers)
1430 *consumed_modifiers = tmp_modifiers;
1433 *keyval = tmp_keyval;
1435 return tmp_keyval != NoSymbol;
1439 /* Key handling not part of the keymap */
1442 * @keyval: a key value.
1444 * Converts a key value into a symbolic name.
1445 * The names are the same as those in the
1446 * <filename><gdk/gdkkeysyms.h></filename> header file
1447 * but without the leading "GDK_KEY_".
1449 * Return value: (transfer none): a string containing the name of the key, or
1450 * %NULL if @keyval is not a valid key. The string should not be modified.
1453 gdk_keyval_name (guint keyval)
1457 case GDK_KEY_Page_Up:
1459 case GDK_KEY_Page_Down:
1461 case GDK_KEY_KP_Page_Up:
1462 return "KP_Page_Up";
1463 case GDK_KEY_KP_Page_Down:
1464 return "KP_Page_Down";
1467 return XKeysymToString (keyval);
1471 gdk_keyval_from_name (const gchar *keyval_name)
1473 g_return_val_if_fail (keyval_name != NULL, 0);
1475 return XStringToKeysym (keyval_name);
1478 #ifdef HAVE_XCONVERTCASE
1480 gdk_keyval_convert_case (guint symbol,
1487 /* Check for directly encoded 24-bit UCS characters: */
1488 if ((symbol & 0xff000000) == 0x01000000)
1491 *lower = gdk_unicode_to_keyval (g_unichar_tolower (symbol & 0x00ffffff));
1493 *upper = gdk_unicode_to_keyval (g_unichar_toupper (symbol & 0x00ffffff));
1498 XConvertCase (symbol, &xlower, &xupper);
1505 #endif /* HAVE_XCONVERTCASE */
1508 _gdk_x11_get_group_for_state (GdkDisplay *display,
1509 GdkModifierType state)
1511 GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
1514 if (display_x11->use_xkb)
1516 return XkbGroupForCoreState (state);
1521 GdkKeymapX11 *keymap_impl = GDK_KEYMAP_X11 (gdk_keymap_get_for_display (display));
1522 update_keymaps (keymap_impl);
1523 return (state & keymap_impl->group_switch_mask) ? 1 : 0;
1528 _gdk_keymap_add_virtual_modifiers_compat (GdkKeymap *keymap,
1529 GdkModifierType *modifiers)
1531 GdkKeymapX11 *keymap_x11;
1534 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1535 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1537 for (i = 3; i < 8; i++)
1539 if ((1 << i) & *modifiers)
1541 if (keymap_x11->modmap[i] & GDK_MOD1_MASK)
1542 *modifiers |= GDK_MOD1_MASK;
1543 else if (keymap_x11->modmap[i] & GDK_SUPER_MASK)
1544 *modifiers |= GDK_SUPER_MASK;
1545 else if (keymap_x11->modmap[i] & GDK_HYPER_MASK)
1546 *modifiers |= GDK_HYPER_MASK;
1547 else if (keymap_x11->modmap[i] & GDK_META_MASK)
1548 *modifiers |= GDK_META_MASK;
1554 gdk_x11_keymap_add_virtual_modifiers (GdkKeymap *keymap,
1555 GdkModifierType *state)
1557 GdkKeymapX11 *keymap_x11;
1560 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1561 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1563 for (i = 3; i < 8; i++)
1565 if ((1 << i) & *state)
1567 if (keymap_x11->modmap[i] & GDK_MOD1_MASK)
1568 *state |= GDK_MOD1_MASK;
1569 if (keymap_x11->modmap[i] & GDK_SUPER_MASK)
1570 *state |= GDK_SUPER_MASK;
1571 if (keymap_x11->modmap[i] & GDK_HYPER_MASK)
1572 *state |= GDK_HYPER_MASK;
1573 if (keymap_x11->modmap[i] & GDK_META_MASK)
1574 *state |= GDK_META_MASK;
1580 _gdk_keymap_key_is_modifier (GdkKeymap *keymap,
1583 GdkKeymapX11 *keymap_x11;
1586 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1587 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1589 if (keycode < keymap_x11->min_keycode ||
1590 keycode > keymap_x11->max_keycode)
1594 if (KEYMAP_USE_XKB (keymap))
1596 XkbDescRec *xkb = get_xkb (keymap_x11);
1598 if (xkb->map->modmap && xkb->map->modmap[keycode] != 0)
1604 for (i = 0; i < 8 * keymap_x11->mod_keymap->max_keypermod; i++)
1606 if (keycode == keymap_x11->mod_keymap->modifiermap[i])
1615 gdk_x11_keymap_map_virtual_modifiers (GdkKeymap *keymap,
1616 GdkModifierType *state)
1618 GdkKeymapX11 *keymap_x11;
1619 const guint vmods[] = {
1620 GDK_SUPER_MASK, GDK_HYPER_MASK, GDK_META_MASK
1625 keymap = GET_EFFECTIVE_KEYMAP (keymap);
1626 keymap_x11 = GDK_KEYMAP_X11 (keymap);
1628 if (KEYMAP_USE_XKB (keymap))
1629 get_xkb (keymap_x11);
1633 for (j = 0; j < 3; j++)
1635 if (*state & vmods[j])
1637 for (i = 3; i < 8; i++)
1639 if (keymap_x11->modmap[i] & vmods[j])
1641 if (*state & (1 << i))
1654 gdk_keymap_x11_class_init (GdkKeymapX11Class *klass)
1656 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1657 GdkKeymapClass *keymap_class = GDK_KEYMAP_CLASS (klass);
1659 parent_class = g_type_class_peek_parent (klass);
1661 object_class->finalize = gdk_keymap_x11_finalize;
1663 keymap_class->get_direction = gdk_x11_keymap_get_direction;
1664 keymap_class->have_bidi_layouts = gdk_x11_keymap_have_bidi_layouts;
1665 keymap_class->get_caps_lock_state = gdk_x11_keymap_get_caps_lock_state;
1666 keymap_class->get_num_lock_state = gdk_x11_keymap_get_num_lock_state;
1667 keymap_class->get_entries_for_keyval = gdk_x11_keymap_get_entries_for_keyval;
1668 keymap_class->get_entries_for_keycode = gdk_x11_keymap_get_entries_for_keycode;
1669 keymap_class->lookup_key = gdk_x11_keymap_lookup_key;
1670 keymap_class->translate_keyboard_state = gdk_x11_keymap_translate_keyboard_state;
1671 keymap_class->add_virtual_modifiers = gdk_x11_keymap_add_virtual_modifiers;
1672 keymap_class->map_virtual_modifiers = gdk_x11_keymap_map_virtual_modifiers;