forked from AuroraMiddleware/gtk
425b9886c9
Thu Apr 25 16:51:40 2002 Owen Taylor <otaylor@redhat.com> Start of integration of Erwann Chenede's multihead work from the gtk-multihead branch. * gdk/gdkdisplay.[ch] gdk/gdkscreen.[ch] gdk/x11/gdkdisplay-x11.[ch] gdk/x11/gdkscreen-x11.[ch] New classes representing a set of screens with attached input devices and a single contiguous area, respectively. * gdk/gdk.[ch] gdk/gdkinternals.h gdk/x11/gdkmain-x11.c: gdk/x11/gdkprivate-x11.h: Make the initialization interface simple _gdk_windowing_init() and do the rest in gdk_open_display() calls. * gdk/gdk.[ch]: Add gdk_parse_args() which can be used to do the display-independent part of initialization instead of gdk_init_[check]. * gdk/gdkcursor.h gdk/gdkfont.h gdk/gdkkeys.h gdk/gdkpixmap.h gdk/gdkproperty.h gdk/gdkselection.h gdk/gdkwindow.h: Add multihead variants (_for_display(), for_screen()) of functions getting information specific to a particular screen screen or display. * gdk/gdkscreen.[ch]: Add gdk_screen__* variants of functions like gdk_rgb_get_colormap() that used to get/list global objects. * gdk/x11/gdkx.h: Add functions for converting GdkScreen and GdkDisplay into the X equivalents. * gdk/x11/gdkwindow-x11.c: Removed gdk_window_xid_at_coords() not in the headers and unused. * configure.in gdk/x11/{gxid.c,gxid_lib.[ch],gdkinput-gxi.c}: Remove gxid support ... has not been tested for a long time... "xfree" support is more portable to non XFree86. * gdk/**.h: Add a GDK_MULTIHEAD_SAFE define that can be used to turn off functions that are inherently non-multihead safe. * gdk/**.c: add GDK_NOTE(multihead, ...) calls when functions are used in non-multihead-safe ways. * gdk/*.c gdk/x11/*.c: Changes to make the internals of GDK multihead safe.
1142 lines
32 KiB
C
1142 lines
32 KiB
C
/* GDK - The GIMP Drawing Kit
|
|
* Copyright (C) 2000 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
|
* file for a list of people on the GTK+ Team. See the ChangeLog
|
|
* files for a list of changes. These files are distributed with
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <unistd.h>
|
|
#include <limits.h>
|
|
#include <errno.h>
|
|
|
|
#include "gdk.h"
|
|
#include "gdkx.h"
|
|
|
|
#include "gdkprivate-x11.h"
|
|
#include "gdkinternals.h"
|
|
#include "gdkdisplay-x11.h"
|
|
#include "gdkkeysyms.h"
|
|
|
|
#include "config.h"
|
|
|
|
#ifdef HAVE_XKB
|
|
#include <X11/XKBlib.h>
|
|
#endif
|
|
|
|
typedef struct _GdkKeymapX11 GdkKeymapX11;
|
|
|
|
#define GDK_TYPE_KEYMAP_X11 (gdk_keymap_x11_get_type ())
|
|
#define GDK_KEYMAP_X11(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_KEYMAP_X11, GdkKeymapX11))
|
|
#define GDK_IS_KEYMAP_X11(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_KEYMAP_X11))
|
|
|
|
struct _GdkKeymapX11
|
|
{
|
|
GdkKeymap parent_instance;
|
|
|
|
gint min_keycode;
|
|
gint max_keycode;
|
|
KeySym* keymap;
|
|
gint keysyms_per_keycode;
|
|
XModifierKeymap* mod_keymap;
|
|
GdkModifierType group_switch_mask;
|
|
PangoDirection current_direction;
|
|
gboolean have_direction;
|
|
guint current_serial;
|
|
|
|
#ifdef HAVE_XKB
|
|
XkbDescPtr xkb_desc;
|
|
#endif
|
|
};
|
|
|
|
#define KEYMAP_USE_XKB(keymap) GDK_DISPLAY_X11 ((keymap)->display)->use_xkb
|
|
#define KEYMAP_XDISPLAY(keymap) GDK_DISPLAY_XDISPLAY ((keymap)->display)
|
|
|
|
static GType gdk_keymap_x11_get_type (void);
|
|
static void gdk_keymap_x11_init (GdkKeymapX11 *keymap);
|
|
|
|
static GType
|
|
gdk_keymap_x11_get_type (void)
|
|
{
|
|
static GType object_type = 0;
|
|
|
|
if (!object_type)
|
|
{
|
|
static const GTypeInfo object_info =
|
|
{
|
|
sizeof (GdkKeymapClass),
|
|
(GBaseInitFunc) NULL,
|
|
(GBaseFinalizeFunc) NULL,
|
|
(GClassInitFunc) NULL,
|
|
NULL, /* class_finalize */
|
|
NULL, /* class_data */
|
|
sizeof (GdkKeymapX11),
|
|
0, /* n_preallocs */
|
|
(GInstanceInitFunc) gdk_keymap_x11_init,
|
|
};
|
|
|
|
object_type = g_type_register_static (GDK_TYPE_KEYMAP,
|
|
"GdkKeymapX11",
|
|
&object_info, 0);
|
|
}
|
|
|
|
return object_type;
|
|
}
|
|
|
|
static void
|
|
gdk_keymap_x11_init (GdkKeymapX11 *keymap)
|
|
{
|
|
keymap->min_keycode = 0;
|
|
keymap->max_keycode = 0;
|
|
|
|
keymap->keymap = NULL;
|
|
keymap->keysyms_per_keycode = 0;
|
|
keymap->mod_keymap = NULL;
|
|
|
|
keymap->group_switch_mask = 0;
|
|
keymap->have_direction = FALSE;
|
|
keymap->xkb_desc = NULL;
|
|
|
|
keymap->current_serial = 0;
|
|
}
|
|
|
|
static inline void
|
|
update_keyrange (GdkKeymapX11 *keymap_x11)
|
|
{
|
|
if (keymap_x11->max_keycode == 0)
|
|
XDisplayKeycodes (KEYMAP_XDISPLAY (GDK_KEYMAP (keymap_x11)),
|
|
&keymap_x11->min_keycode, &keymap_x11->max_keycode);
|
|
}
|
|
|
|
#ifdef HAVE_XKB
|
|
|
|
static XkbDescPtr
|
|
get_xkb (GdkKeymapX11 *keymap_x11)
|
|
{
|
|
GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (GDK_KEYMAP (keymap_x11)->display);
|
|
Display *xdisplay = display_x11->xdisplay;
|
|
|
|
update_keyrange (keymap_x11);
|
|
|
|
if (keymap_x11->xkb_desc == NULL)
|
|
{
|
|
keymap_x11->xkb_desc = XkbGetMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask, XkbUseCoreKbd);
|
|
if (keymap_x11->xkb_desc == NULL)
|
|
g_error ("Failed to get keymap");
|
|
|
|
XkbGetNames (xdisplay, XkbGroupNamesMask, keymap_x11->xkb_desc);
|
|
}
|
|
else if (keymap_x11->current_serial != display_x11->keymap_serial)
|
|
{
|
|
XkbGetUpdatedMap (xdisplay, XkbKeySymsMask | XkbKeyTypesMask,
|
|
keymap_x11->xkb_desc);
|
|
XkbGetNames (xdisplay, XkbGroupNamesMask, keymap_x11->xkb_desc);
|
|
}
|
|
|
|
keymap_x11->current_serial = display_x11->keymap_serial;
|
|
|
|
return keymap_x11->xkb_desc;
|
|
}
|
|
#endif /* HAVE_XKB */
|
|
|
|
/* Whether we were able to turn on detectable-autorepeat using
|
|
* XkbSetDetectableAutorepeat. If FALSE, we'll fall back
|
|
* to checking the next event with XPending().
|
|
*/
|
|
|
|
/**
|
|
* gdk_keymap_get_for_display :
|
|
* @display : the #GdkDisplay.
|
|
*
|
|
* Returns the GdkKeymap attached to @display.
|
|
*
|
|
* Returns : the GdkKeymap attached to @display.
|
|
**/
|
|
GdkKeymap*
|
|
gdk_keymap_get_for_display (GdkDisplay *display)
|
|
{
|
|
GdkDisplayX11 *display_x11;
|
|
g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
|
|
display_x11 = GDK_DISPLAY_X11 (display);
|
|
|
|
if (!display_x11->keymap)
|
|
display_x11->keymap = g_object_new (gdk_keymap_x11_get_type (), NULL);
|
|
|
|
display_x11->keymap->display = display;
|
|
|
|
return display_x11->keymap;
|
|
}
|
|
|
|
GdkKeymap*
|
|
gdk_keymap_get_default (void)
|
|
{
|
|
return gdk_keymap_get_for_display (gdk_get_default_display ());
|
|
}
|
|
|
|
/* Find the index of the group/level pair within the keysyms for a key.
|
|
*/
|
|
#define KEYSYM_INDEX(keymap_impl, group, level) \
|
|
(2 * ((group) % (keymap_impl->keysyms_per_keycode / 2)) + (level))
|
|
|
|
static void
|
|
update_keymaps (GdkKeymapX11 *keymap_x11)
|
|
{
|
|
GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (GDK_KEYMAP (keymap_x11)->display);
|
|
Display *xdisplay = display_x11->xdisplay;
|
|
|
|
#ifdef HAVE_XKB
|
|
g_assert (!KEYMAP_USE_XKB (GDK_KEYMAP (keymap_x11)));
|
|
#endif
|
|
|
|
if (keymap_x11->keymap == NULL ||
|
|
keymap_x11->current_serial != display_x11->keymap_serial)
|
|
{
|
|
gint i;
|
|
gint map_size;
|
|
gint keycode;
|
|
|
|
keymap_x11->current_serial = display_x11->keymap_serial;
|
|
|
|
update_keyrange (keymap_x11);
|
|
|
|
if (keymap_x11->keymap)
|
|
XFree (keymap_x11->keymap);
|
|
|
|
if (keymap_x11->mod_keymap)
|
|
XFreeModifiermap (keymap_x11->mod_keymap);
|
|
|
|
keymap_x11->keymap = XGetKeyboardMapping (xdisplay, keymap_x11->min_keycode,
|
|
keymap_x11->max_keycode - keymap_x11->min_keycode,
|
|
&keymap_x11->keysyms_per_keycode);
|
|
|
|
|
|
/* GDK_ISO_Left_Tab, as usually configured through XKB, really messes
|
|
* up the whole idea of "consumed modifiers" because shift is consumed.
|
|
* However, <shift>Tab is not usually GDK_ISO_Left_Tab without XKB,
|
|
* we we fudge the map here.
|
|
*/
|
|
keycode = keymap_x11->min_keycode;
|
|
while (keycode < keymap_x11->max_keycode)
|
|
{
|
|
KeySym *syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
/* Check both groups */
|
|
for (i = 0 ; i < 2 ; i++)
|
|
{
|
|
if (syms[KEYSYM_INDEX (keymap_x11, i, 0)] == GDK_Tab)
|
|
syms[KEYSYM_INDEX (keymap_x11, i, 1)] = GDK_ISO_Left_Tab;
|
|
}
|
|
|
|
/*
|
|
* If there is one keysym and the key symbol has upper and lower
|
|
* case variants fudge the keymap
|
|
*/
|
|
if (syms[KEYSYM_INDEX (keymap_x11, 0, 1)] == 0)
|
|
{
|
|
guint lower;
|
|
guint upper;
|
|
|
|
gdk_keyval_convert_case (syms[KEYSYM_INDEX (keymap_x11, 0, 0)], &lower, &upper);
|
|
if (lower != upper)
|
|
{
|
|
syms[KEYSYM_INDEX (keymap_x11, 0, 0)] = lower;
|
|
syms[KEYSYM_INDEX (keymap_x11, 0, 1)] = upper;
|
|
}
|
|
}
|
|
|
|
|
|
++keycode;
|
|
}
|
|
|
|
keymap_x11->mod_keymap = XGetModifierMapping (xdisplay);
|
|
|
|
|
|
keymap_x11->group_switch_mask = 0;
|
|
|
|
/* there are 8 modifiers, and the first 3 are shift, shift lock,
|
|
* and control
|
|
*/
|
|
map_size = 8 * keymap_x11->mod_keymap->max_keypermod;
|
|
i = 3 * keymap_x11->mod_keymap->max_keypermod;
|
|
while (i < map_size)
|
|
{
|
|
/* get the key code at this point in the map,
|
|
* see if its keysym is GDK_Mode_switch, if so
|
|
* we have the mode key
|
|
*/
|
|
gint keycode = keymap_x11->mod_keymap->modifiermap[i];
|
|
|
|
if (keycode >= keymap_x11->min_keycode &&
|
|
keycode <= keymap_x11->max_keycode)
|
|
{
|
|
gint j = 0;
|
|
KeySym *syms = keymap_x11->keymap + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
|
|
while (j < keymap_x11->keysyms_per_keycode)
|
|
{
|
|
if (syms[j] == GDK_Mode_switch)
|
|
{
|
|
/* This modifier swaps groups */
|
|
|
|
/* GDK_MOD1_MASK is 1 << 3 for example, i.e. the
|
|
* fourth modifier, i / keyspermod is the modifier
|
|
* index
|
|
*/
|
|
|
|
keymap_x11->group_switch_mask |= (1 << ( i / keymap_x11->mod_keymap->max_keypermod));
|
|
break;
|
|
}
|
|
|
|
++j;
|
|
}
|
|
}
|
|
|
|
++i;
|
|
}
|
|
}
|
|
}
|
|
|
|
static const KeySym*
|
|
get_keymap (GdkKeymapX11 *keymap_x11)
|
|
{
|
|
update_keymaps (keymap_x11);
|
|
|
|
return keymap_x11->keymap;
|
|
}
|
|
|
|
#if HAVE_XKB
|
|
static PangoDirection
|
|
get_direction (GdkKeymapX11 *keymap_x11)
|
|
{
|
|
XkbDescRec *xkb = get_xkb (keymap_x11);
|
|
const char *name;
|
|
XkbStateRec state_rec;
|
|
PangoDirection result;
|
|
|
|
GdkDisplay *display = GDK_KEYMAP (keymap_x11)->display;
|
|
|
|
XkbGetState (GDK_DISPLAY_XDISPLAY (display), XkbUseCoreKbd, &state_rec);
|
|
|
|
if (xkb->names->groups[state_rec.locked_group] == None)
|
|
result = PANGO_DIRECTION_LTR;
|
|
else
|
|
{
|
|
name = gdk_x11_get_xatom_name_for_display (display, xkb->names->groups[state_rec.locked_group]);
|
|
|
|
if (g_strcasecmp (name, "arabic") == 0 ||
|
|
g_strcasecmp (name, "hebrew") == 0 ||
|
|
g_strcasecmp (name, "israelian") == 0)
|
|
result = PANGO_DIRECTION_RTL;
|
|
else
|
|
result = PANGO_DIRECTION_LTR;
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
void
|
|
_gdk_keymap_state_changed (GdkDisplay *display)
|
|
{
|
|
GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
|
|
|
|
if (display_x11->keymap)
|
|
{
|
|
GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (display_x11->keymap);
|
|
|
|
PangoDirection new_direction = get_direction (keymap_x11);
|
|
|
|
if (!keymap_x11->have_direction || new_direction != keymap_x11->current_direction)
|
|
{
|
|
keymap_x11->have_direction = TRUE;
|
|
keymap_x11->current_direction = new_direction;
|
|
g_signal_emit_by_name (G_OBJECT (keymap_x11), "direction_changed");
|
|
}
|
|
}
|
|
}
|
|
#endif /* HAVE_XKB */
|
|
|
|
PangoDirection
|
|
gdk_keymap_get_direction (GdkKeymap *keymap)
|
|
{
|
|
if (!keymap)
|
|
{
|
|
keymap = gdk_keymap_get_for_display (gdk_get_default_display ());
|
|
GDK_NOTE (MULTIHEAD,
|
|
g_message ("_multihead : reverting to default display keymap "
|
|
"in gdk_keymap_get_direction"));
|
|
}
|
|
|
|
#if HAVE_XKB
|
|
if (KEYMAP_USE_XKB (keymap))
|
|
{
|
|
GdkKeymapX11 *keymap_x11 = GDK_KEYMAP_X11 (keymap);
|
|
|
|
if (!keymap_x11->have_direction)
|
|
{
|
|
keymap_x11->current_direction = get_direction (keymap_x11);
|
|
keymap_x11->have_direction = TRUE;
|
|
}
|
|
|
|
return keymap_x11->current_direction;
|
|
}
|
|
else
|
|
#endif /* HAVE_XKB */
|
|
return PANGO_DIRECTION_LTR;
|
|
}
|
|
|
|
/**
|
|
* gdk_keymap_get_entries_for_keyval:
|
|
* @keymap: a #GdkKeymap, or %NULL to use the default keymap
|
|
* @keyval: a keyval, such as %GDK_a, %GDK_Up, %GDK_Return, etc.
|
|
* @keys: return location for an array of #GdkKeymapKey
|
|
* @n_keys: return location for number of elements in returned array
|
|
*
|
|
* Obtains a list of keycode/group/level combinations that will
|
|
* generate @keyval. Groups and levels are two kinds of keyboard mode;
|
|
* in general, the level determines whether the top or bottom symbol
|
|
* on a key is used, and the group determines whether the left or
|
|
* right symbol is used. On US keyboards, the shift key changes the
|
|
* keyboard level, and there are no groups. A group switch key might
|
|
* convert a keyboard between Hebrew to English modes, for example.
|
|
* #GdkEventKey contains a %group field that indicates the active
|
|
* keyboard group. The level is computed from the modifier mask.
|
|
* The returned array should be freed
|
|
* with g_free().
|
|
*
|
|
* Return value: %TRUE if keys were found and returned
|
|
**/
|
|
gboolean
|
|
gdk_keymap_get_entries_for_keyval (GdkKeymap *keymap,
|
|
guint keyval,
|
|
GdkKeymapKey **keys,
|
|
gint *n_keys)
|
|
{
|
|
GArray *retval;
|
|
GdkKeymapX11 *keymap_x11;
|
|
|
|
g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
|
|
g_return_val_if_fail (keys != NULL, FALSE);
|
|
g_return_val_if_fail (n_keys != NULL, FALSE);
|
|
g_return_val_if_fail (keyval != 0, FALSE);
|
|
|
|
if (!keymap)
|
|
{
|
|
keymap = gdk_keymap_get_for_display (gdk_get_default_display ());
|
|
GDK_NOTE (MULTIHEAD,
|
|
g_message ("_multihead : reverting to default display keymap "
|
|
"in gdk_keymap_get_entries_for_keyval\n"));
|
|
}
|
|
|
|
keymap_x11 = GDK_KEYMAP_X11 (keymap);
|
|
|
|
retval = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
|
|
|
|
#ifdef HAVE_XKB
|
|
if (KEYMAP_USE_XKB (keymap))
|
|
{
|
|
/* See sec 15.3.4 in XKB docs */
|
|
|
|
XkbDescRec *xkb = get_xkb (keymap_x11);
|
|
gint keycode;
|
|
|
|
keycode = keymap_x11->min_keycode;
|
|
|
|
while (keycode <= keymap_x11->max_keycode)
|
|
{
|
|
gint max_shift_levels = XkbKeyGroupsWidth (xkb, keycode); /* "key width" */
|
|
gint group = 0;
|
|
gint level = 0;
|
|
gint total_syms = XkbKeyNumSyms (xkb, keycode);
|
|
gint i = 0;
|
|
KeySym *entry;
|
|
|
|
/* entry is an array with all syms for group 0, all
|
|
* syms for group 1, etc. and for each group the
|
|
* shift level syms are in order
|
|
*/
|
|
entry = XkbKeySymsPtr (xkb, keycode);
|
|
|
|
while (i < total_syms)
|
|
{
|
|
/* check out our cool loop invariant */
|
|
g_assert (i == (group * max_shift_levels + level));
|
|
|
|
if (entry[i] == keyval)
|
|
{
|
|
/* Found a match */
|
|
GdkKeymapKey key;
|
|
|
|
key.keycode = keycode;
|
|
key.group = group;
|
|
key.level = level;
|
|
|
|
g_array_append_val (retval, key);
|
|
|
|
g_assert (XkbKeySymEntry (xkb, keycode, level, group) ==
|
|
keyval);
|
|
}
|
|
|
|
++level;
|
|
|
|
if (level == max_shift_levels)
|
|
{
|
|
level = 0;
|
|
++group;
|
|
}
|
|
|
|
++i;
|
|
}
|
|
|
|
++keycode;
|
|
}
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
const KeySym *map = get_keymap (keymap_x11);
|
|
gint keycode;
|
|
|
|
keycode = keymap_x11->min_keycode;
|
|
while (keycode < keymap_x11->max_keycode)
|
|
{
|
|
const KeySym *syms = map + (keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
gint i = 0;
|
|
|
|
while (i < keymap_x11->keysyms_per_keycode)
|
|
{
|
|
if (syms[i] == keyval)
|
|
{
|
|
/* found a match */
|
|
GdkKeymapKey key;
|
|
|
|
key.keycode = keycode;
|
|
|
|
/* The "classic" non-XKB keymap has 2 levels per group */
|
|
key.group = i / 2;
|
|
key.level = i % 2;
|
|
|
|
g_array_append_val (retval, key);
|
|
}
|
|
|
|
++i;
|
|
}
|
|
|
|
++keycode;
|
|
}
|
|
}
|
|
|
|
if (retval->len > 0)
|
|
{
|
|
*keys = (GdkKeymapKey*) retval->data;
|
|
*n_keys = retval->len;
|
|
}
|
|
else
|
|
{
|
|
*keys = NULL;
|
|
*n_keys = 0;
|
|
}
|
|
|
|
g_array_free (retval, retval->len > 0 ? FALSE : TRUE);
|
|
|
|
return *n_keys > 0;
|
|
}
|
|
|
|
/**
|
|
* gdk_keymap_get_entries_for_keycode:
|
|
* @keymap: a #GdkKeymap or %NULL to use the default keymap
|
|
* @hardware_keycode: a keycode
|
|
* @keys: return location for array of #GdkKeymapKey, or NULL
|
|
* @keyvals: return location for array of keyvals, or NULL
|
|
* @n_entries: length of @keys and @keyvals
|
|
*
|
|
* Returns the keyvals bound to @hardware_keycode.
|
|
* The Nth #GdkKeymapKey in @keys is bound to the Nth
|
|
* keyval in @keyvals. Free the returned arrays with g_free().
|
|
* When a keycode is pressed by the user, the keyval from
|
|
* this list of entries is selected by considering the effective
|
|
* keyboard group and level. See gdk_keymap_translate_keyboard_state().
|
|
*
|
|
* Returns: %TRUE if there were any entries
|
|
**/
|
|
gboolean
|
|
gdk_keymap_get_entries_for_keycode (GdkKeymap *keymap,
|
|
guint hardware_keycode,
|
|
GdkKeymapKey **keys,
|
|
guint **keyvals,
|
|
gint *n_entries)
|
|
{
|
|
GdkKeymapX11 *keymap_x11;
|
|
|
|
GArray *key_array;
|
|
GArray *keyval_array;
|
|
|
|
g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
|
|
g_return_val_if_fail (n_entries != NULL, FALSE);
|
|
|
|
if (!keymap)
|
|
{
|
|
keymap = gdk_keymap_get_for_display (gdk_get_default_display ());
|
|
GDK_NOTE (MULTIHEAD,
|
|
g_message ("_multihead : reverting to default display keymap "
|
|
"in gdk_keymap_get_entries_for_keycode\n"));
|
|
}
|
|
|
|
keymap_x11 = GDK_KEYMAP_X11 (keymap);
|
|
|
|
update_keyrange (keymap_x11);
|
|
|
|
if (hardware_keycode < keymap_x11->min_keycode ||
|
|
hardware_keycode > keymap_x11->max_keycode)
|
|
{
|
|
if (keys)
|
|
*keys = NULL;
|
|
if (keyvals)
|
|
*keyvals = NULL;
|
|
|
|
*n_entries = 0;
|
|
return FALSE;
|
|
}
|
|
|
|
if (keys)
|
|
key_array = g_array_new (FALSE, FALSE, sizeof (GdkKeymapKey));
|
|
else
|
|
key_array = NULL;
|
|
|
|
if (keyvals)
|
|
keyval_array = g_array_new (FALSE, FALSE, sizeof (guint));
|
|
else
|
|
keyval_array = NULL;
|
|
|
|
#ifdef HAVE_XKB
|
|
if (KEYMAP_USE_XKB (keymap))
|
|
{
|
|
/* See sec 15.3.4 in XKB docs */
|
|
|
|
XkbDescRec *xkb = get_xkb (keymap_x11);
|
|
gint max_shift_levels;
|
|
gint group = 0;
|
|
gint level = 0;
|
|
gint total_syms;
|
|
gint i = 0;
|
|
KeySym *entry;
|
|
|
|
max_shift_levels = XkbKeyGroupsWidth (xkb, hardware_keycode); /* "key width" */
|
|
total_syms = XkbKeyNumSyms (xkb, hardware_keycode);
|
|
|
|
/* entry is an array with all syms for group 0, all
|
|
* syms for group 1, etc. and for each group the
|
|
* shift level syms are in order
|
|
*/
|
|
entry = XkbKeySymsPtr (xkb, hardware_keycode);
|
|
|
|
while (i < total_syms)
|
|
{
|
|
/* check out our cool loop invariant */
|
|
g_assert (i == (group * max_shift_levels + level));
|
|
|
|
if (key_array)
|
|
{
|
|
GdkKeymapKey key;
|
|
|
|
key.keycode = hardware_keycode;
|
|
key.group = group;
|
|
key.level = level;
|
|
|
|
g_array_append_val (key_array, key);
|
|
}
|
|
|
|
if (keyval_array)
|
|
g_array_append_val (keyval_array, entry[i]);
|
|
|
|
++level;
|
|
|
|
if (level == max_shift_levels)
|
|
{
|
|
level = 0;
|
|
++group;
|
|
}
|
|
|
|
++i;
|
|
}
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
const KeySym *map = get_keymap (keymap_x11);
|
|
const KeySym *syms;
|
|
gint i = 0;
|
|
|
|
syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
|
|
while (i < keymap_x11->keysyms_per_keycode)
|
|
{
|
|
if (key_array)
|
|
{
|
|
GdkKeymapKey key;
|
|
|
|
key.keycode = hardware_keycode;
|
|
|
|
/* The "classic" non-XKB keymap has 2 levels per group */
|
|
key.group = i / 2;
|
|
key.level = i % 2;
|
|
|
|
g_array_append_val (key_array, key);
|
|
}
|
|
|
|
if (keyval_array)
|
|
g_array_append_val (keyval_array, syms[i]);
|
|
|
|
++i;
|
|
}
|
|
}
|
|
|
|
if ((key_array && key_array->len > 0) ||
|
|
(keyval_array && keyval_array->len > 0))
|
|
{
|
|
if (keys)
|
|
*keys = (GdkKeymapKey*) key_array->data;
|
|
|
|
if (keyvals)
|
|
*keyvals = (guint*) keyval_array->data;
|
|
|
|
if (key_array)
|
|
*n_entries = key_array->len;
|
|
else
|
|
*n_entries = keyval_array->len;
|
|
}
|
|
else
|
|
{
|
|
if (keys)
|
|
*keys = NULL;
|
|
|
|
if (keyvals)
|
|
*keyvals = NULL;
|
|
|
|
*n_entries = 0;
|
|
}
|
|
|
|
if (key_array)
|
|
g_array_free (key_array, key_array->len > 0 ? FALSE : TRUE);
|
|
if (keyval_array)
|
|
g_array_free (keyval_array, keyval_array->len > 0 ? FALSE : TRUE);
|
|
|
|
return *n_entries > 0;
|
|
}
|
|
|
|
|
|
/**
|
|
* gdk_keymap_lookup_key:
|
|
* @keymap: a #GdkKeymap or %NULL to use the default keymap
|
|
* @key: a #GdkKeymapKey with keycode, group, and level initialized
|
|
*
|
|
* Looks up the keyval mapped to a keycode/group/level triplet.
|
|
* If no keyval is bound to @key, returns 0. For normal user input,
|
|
* you want to use gdk_keymap_translate_keyboard_state() instead of
|
|
* this function, since the effective group/level may not be
|
|
* the same as the current keyboard state.
|
|
*
|
|
* Return value: a keyval, or 0 if none was mapped to the given @key
|
|
**/
|
|
guint
|
|
gdk_keymap_lookup_key (GdkKeymap *keymap,
|
|
const GdkKeymapKey *key)
|
|
{
|
|
GdkKeymapX11 *keymap_x11;
|
|
|
|
g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), 0);
|
|
g_return_val_if_fail (key != NULL, 0);
|
|
g_return_val_if_fail (key->group < 4, 0);
|
|
|
|
if (!keymap)
|
|
{
|
|
keymap = gdk_keymap_get_for_display (gdk_get_default_display ());
|
|
GDK_NOTE (MULTIHEAD,
|
|
g_message ("_multihead : reverting to default display keymap "
|
|
"in gdk_keymap_lookup_key\n"));
|
|
}
|
|
|
|
keymap_x11 = GDK_KEYMAP_X11 (keymap);
|
|
|
|
#ifdef HAVE_XKB
|
|
if (KEYMAP_USE_XKB (keymap))
|
|
{
|
|
XkbDescRec *xkb = get_xkb (keymap_x11);
|
|
|
|
return XkbKeySymEntry (xkb, key->keycode, key->level, key->group);
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
const KeySym *map = get_keymap (keymap_x11);
|
|
const KeySym *syms = map + (key->keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
return syms [KEYSYM_INDEX (keymap_x11, key->group, key->level)];
|
|
}
|
|
}
|
|
|
|
#ifdef HAVE_XKB
|
|
/* This is copied straight from XFree86 Xlib, because I needed to
|
|
* add the group and level return. It's unchanged for ease of
|
|
* diff against the Xlib sources; don't reformat it.
|
|
*/
|
|
static Bool
|
|
MyEnhancedXkbTranslateKeyCode(register XkbDescPtr xkb,
|
|
KeyCode key,
|
|
register unsigned int mods,
|
|
unsigned int * mods_rtrn,
|
|
KeySym * keysym_rtrn,
|
|
unsigned int * group_rtrn,
|
|
unsigned int * level_rtrn)
|
|
{
|
|
XkbKeyTypeRec *type;
|
|
int col,nKeyGroups;
|
|
unsigned preserve,effectiveGroup;
|
|
KeySym *syms;
|
|
|
|
if (mods_rtrn!=NULL)
|
|
*mods_rtrn = 0;
|
|
|
|
nKeyGroups= XkbKeyNumGroups(xkb,key);
|
|
if ((!XkbKeycodeInRange(xkb,key))||(nKeyGroups==0)) {
|
|
if (keysym_rtrn!=NULL)
|
|
*keysym_rtrn = NoSymbol;
|
|
return False;
|
|
}
|
|
|
|
syms = XkbKeySymsPtr(xkb,key);
|
|
|
|
/* find the offset of the effective group */
|
|
col = 0;
|
|
effectiveGroup= XkbGroupForCoreState(mods);
|
|
if ( effectiveGroup>=nKeyGroups ) {
|
|
unsigned groupInfo= XkbKeyGroupInfo(xkb,key);
|
|
switch (XkbOutOfRangeGroupAction(groupInfo)) {
|
|
default:
|
|
effectiveGroup %= nKeyGroups;
|
|
break;
|
|
case XkbClampIntoRange:
|
|
effectiveGroup = nKeyGroups-1;
|
|
break;
|
|
case XkbRedirectIntoRange:
|
|
effectiveGroup = XkbOutOfRangeGroupNumber(groupInfo);
|
|
if (effectiveGroup>=nKeyGroups)
|
|
effectiveGroup= 0;
|
|
break;
|
|
}
|
|
}
|
|
col= effectiveGroup*XkbKeyGroupsWidth(xkb,key);
|
|
type = XkbKeyKeyType(xkb,key,effectiveGroup);
|
|
|
|
preserve= 0;
|
|
if (type->map) { /* find the column (shift level) within the group */
|
|
register int i;
|
|
register XkbKTMapEntryPtr entry;
|
|
for (i=0,entry=type->map;i<type->map_count;i++,entry++) {
|
|
if ((entry->active)&&((mods&type->mods.mask)==entry->mods.mask)) {
|
|
col+= entry->level;
|
|
if (type->preserve)
|
|
preserve= type->preserve[i].mask;
|
|
|
|
/* ---- Begin stuff GDK adds to the original Xlib version ---- */
|
|
|
|
if (level_rtrn)
|
|
*level_rtrn = entry->level;
|
|
|
|
/* ---- End stuff GDK adds to the original Xlib version ---- */
|
|
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (keysym_rtrn!=NULL)
|
|
*keysym_rtrn= syms[col];
|
|
if (mods_rtrn) {
|
|
*mods_rtrn= type->mods.mask&(~preserve);
|
|
|
|
/* ---- Begin stuff GDK comments out of the original Xlib version ---- */
|
|
/* This is commented out because xkb_info is a private struct */
|
|
|
|
#if 0
|
|
/* The Motif VTS doesn't get the help callback called if help
|
|
* is bound to Shift+<whatever>, and it appears as though it
|
|
* is XkbTranslateKeyCode that is causing the problem. The
|
|
* core X version of XTranslateKey always OR's in ShiftMask
|
|
* and LockMask for mods_rtrn, so this "fix" keeps this behavior
|
|
* and solves the VTS problem.
|
|
*/
|
|
if ((xkb->dpy)&&(xkb->dpy->xkb_info)&&
|
|
(xkb->dpy->xkb_info->xlib_ctrls&XkbLC_AlwaysConsumeShiftAndLock)) { *mods_rtrn|= (ShiftMask|LockMask);
|
|
}
|
|
#endif
|
|
|
|
/* ---- End stuff GDK comments out of the original Xlib version ---- */
|
|
}
|
|
|
|
/* ---- Begin stuff GDK adds to the original Xlib version ---- */
|
|
|
|
if (group_rtrn)
|
|
*group_rtrn = effectiveGroup;
|
|
|
|
/* ---- End stuff GDK adds to the original Xlib version ---- */
|
|
|
|
return (syms[col]!=NoSymbol);
|
|
}
|
|
#endif /* HAVE_XKB */
|
|
|
|
/**
|
|
* gdk_keymap_translate_keyboard_state:
|
|
* @keymap: a #GdkKeymap, or %NULL to use the default
|
|
* @hardware_keycode: a keycode
|
|
* @state: a modifier state
|
|
* @group: active keyboard group
|
|
* @keyval: return location for keyval
|
|
* @effective_group: return location for effective group
|
|
* @level: return location for level
|
|
* @consumed_modifiers: return location for modifiers that were used to determine the group or level
|
|
*
|
|
*
|
|
* Translates the contents of a #GdkEventKey into a keyval, effective
|
|
* group, and level. Modifiers that affected the translation and
|
|
* are thus unavailable for application use are returned in
|
|
* @consumed_modifiers. See gdk_keyval_get_keys() for an explanation of
|
|
* groups and levels. The @effective_group is the group that was
|
|
* actually used for the translation; some keys such as Enter are not
|
|
* affected by the active keyboard group. The @level is derived from
|
|
* @state. For convenience, #GdkEventKey already contains the translated
|
|
* keyval, so this function isn't as useful as you might think.
|
|
*
|
|
* Return value: %TRUE if there was a keyval bound to the keycode/state/group
|
|
**/
|
|
gboolean
|
|
gdk_keymap_translate_keyboard_state (GdkKeymap *keymap,
|
|
guint hardware_keycode,
|
|
GdkModifierType state,
|
|
gint group,
|
|
guint *keyval,
|
|
gint *effective_group,
|
|
gint *level,
|
|
GdkModifierType *consumed_modifiers)
|
|
{
|
|
GdkKeymapX11 *keymap_x11;
|
|
KeySym tmp_keyval = NoSymbol;
|
|
guint tmp_modifiers;
|
|
|
|
g_return_val_if_fail (keymap == NULL || GDK_IS_KEYMAP (keymap), FALSE);
|
|
g_return_val_if_fail (group < 4, FALSE);
|
|
|
|
keymap_x11 = GDK_KEYMAP_X11 (keymap);
|
|
|
|
if (keyval)
|
|
*keyval = NoSymbol;
|
|
if (effective_group)
|
|
*effective_group = 0;
|
|
if (level)
|
|
*level = 0;
|
|
if (consumed_modifiers)
|
|
*consumed_modifiers = 0;
|
|
|
|
update_keyrange (keymap_x11);
|
|
|
|
if (hardware_keycode < keymap_x11->min_keycode ||
|
|
hardware_keycode > keymap_x11->max_keycode)
|
|
return FALSE;
|
|
|
|
#ifdef HAVE_XKB
|
|
if (KEYMAP_USE_XKB (keymap))
|
|
{
|
|
XkbDescRec *xkb = get_xkb (keymap_x11);
|
|
|
|
/* replace bits 13 and 14 with the provided group */
|
|
state &= ~(1 << 13 | 1 << 14);
|
|
state |= group << 13;
|
|
|
|
MyEnhancedXkbTranslateKeyCode (xkb,
|
|
hardware_keycode,
|
|
state,
|
|
&tmp_modifiers,
|
|
&tmp_keyval,
|
|
effective_group,
|
|
level);
|
|
|
|
if (state & ~tmp_modifiers & LockMask)
|
|
tmp_keyval = gdk_keyval_to_upper (tmp_keyval);
|
|
|
|
/* We need to augment the consumed modifiers with LockMask, since
|
|
* we handle that ourselves, and also with the group bits
|
|
*/
|
|
tmp_modifiers |= LockMask | 1 << 13 | 1 << 14;
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
const KeySym *map = get_keymap (keymap_x11);
|
|
const KeySym *syms;
|
|
gint shift_level;
|
|
gboolean ignore_shift = FALSE;
|
|
gboolean ignore_group = FALSE;
|
|
|
|
if ((state & GDK_SHIFT_MASK) &&
|
|
(state & GDK_LOCK_MASK))
|
|
shift_level = 0; /* shift disables shift lock */
|
|
else if ((state & GDK_SHIFT_MASK) ||
|
|
(state & GDK_LOCK_MASK))
|
|
shift_level = 1;
|
|
else
|
|
shift_level = 0;
|
|
|
|
syms = map + (hardware_keycode - keymap_x11->min_keycode) * keymap_x11->keysyms_per_keycode;
|
|
|
|
#define SYM(k,g,l) syms[KEYSYM_INDEX (k,g,l)]
|
|
|
|
/* Drop group and shift if there are no keysymbols on
|
|
* the specified key.
|
|
*/
|
|
if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, group, 0))
|
|
{
|
|
shift_level = 0;
|
|
ignore_shift = TRUE;
|
|
}
|
|
if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, 0, shift_level))
|
|
{
|
|
group = 0;
|
|
ignore_group = TRUE;
|
|
}
|
|
if (!SYM (keymap_x11, group, shift_level) && SYM (keymap_x11, 0, 0))
|
|
{
|
|
shift_level = 0;
|
|
group = 0;
|
|
ignore_group = TRUE;
|
|
ignore_shift = TRUE;
|
|
}
|
|
|
|
/* See whether the group and shift level actually mattered
|
|
* to know what to put in consumed_modifiers
|
|
*/
|
|
if (!SYM (keymap_x11, group, 1) ||
|
|
SYM (keymap_x11, group, 0) == SYM (keymap_x11, group, 1))
|
|
ignore_shift = TRUE;
|
|
|
|
if (!SYM (keymap_x11, 1, shift_level) ||
|
|
SYM (keymap_x11, 0, shift_level) == SYM (keymap_x11, 1, shift_level))
|
|
ignore_group = TRUE;
|
|
|
|
tmp_keyval = SYM (keymap_x11, group, shift_level);
|
|
|
|
tmp_modifiers = ignore_group ? 0 : keymap_x11->group_switch_mask;
|
|
tmp_modifiers |= ignore_shift ? 0 : (GDK_SHIFT_MASK | GDK_LOCK_MASK);
|
|
|
|
if (effective_group)
|
|
*effective_group = group;
|
|
|
|
if (level)
|
|
*level = shift_level;
|
|
#undef SYM
|
|
}
|
|
|
|
if (consumed_modifiers)
|
|
*consumed_modifiers = tmp_modifiers;
|
|
|
|
if (keyval)
|
|
*keyval = tmp_keyval;
|
|
|
|
return tmp_keyval != NoSymbol;
|
|
}
|
|
|
|
|
|
/* Key handling not part of the keymap */
|
|
|
|
gchar*
|
|
gdk_keyval_name (guint keyval)
|
|
{
|
|
switch (keyval)
|
|
{
|
|
case GDK_Page_Up:
|
|
return "Page_Up";
|
|
case GDK_Page_Down:
|
|
return "Page_Down";
|
|
case GDK_KP_Page_Up:
|
|
return "KP_Page_Up";
|
|
case GDK_KP_Page_Down:
|
|
return "KP_Page_Down";
|
|
}
|
|
|
|
return XKeysymToString (keyval);
|
|
}
|
|
|
|
guint
|
|
gdk_keyval_from_name (const gchar *keyval_name)
|
|
{
|
|
g_return_val_if_fail (keyval_name != NULL, 0);
|
|
|
|
return XStringToKeysym (keyval_name);
|
|
}
|
|
|
|
#ifdef HAVE_XCONVERTCASE
|
|
void
|
|
gdk_keyval_convert_case (guint symbol,
|
|
guint *lower,
|
|
guint *upper)
|
|
{
|
|
KeySym xlower = 0;
|
|
KeySym xupper = 0;
|
|
|
|
/* Check for directly encoded 24-bit UCS characters: */
|
|
if ((symbol & 0xff000000) == 0x01000000)
|
|
{
|
|
if (lower)
|
|
*lower = gdk_unicode_to_keyval (g_unichar_tolower (symbol & 0x00ffffff));
|
|
if (upper)
|
|
*upper = gdk_unicode_to_keyval (g_unichar_toupper (symbol & 0x00ffffff));
|
|
return;
|
|
}
|
|
|
|
if (symbol)
|
|
XConvertCase (symbol, &xlower, &xupper);
|
|
|
|
if (lower)
|
|
*lower = xlower;
|
|
if (upper)
|
|
*upper = xupper;
|
|
}
|
|
#endif /* HAVE_XCONVERTCASE */
|
|
|
|
gint
|
|
_gdk_x11_get_group_for_state (GdkDisplay *display,
|
|
GdkModifierType state)
|
|
{
|
|
GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
|
|
|
|
#ifdef HAVE_XKB
|
|
if (display_x11->use_xkb)
|
|
{
|
|
return XkbGroupForCoreState (state);
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
GdkKeymapX11 *keymap_impl = GDK_KEYMAP_X11 (gdk_keymap_get_for_display (display));
|
|
update_keymaps (keymap_impl);
|
|
return (state & keymap_impl->group_switch_mask) ? 1 : 0;
|
|
}
|
|
}
|