1XkbUpdateMapFromCore(3)          XKB FUNCTIONS         XkbUpdateMapFromCore(3)
2
3
4

NAME

6       XkbUpdateMapFromCore  -  Update a local Xkb keyboard map to reflect the
7       mapping expressed by a core format mapping
8

SYNOPSIS

10       Bool  XkbUpdateMapFromCore  (XkbDescPtr  xkb,  KeyCode  first_key,  int
11              num_keys,  int  map_width,  KeySym  *core_keysyms, XkbChangesPtr
12              changes);
13

ARGUMENTS

15       - xkb  keyboard description to update
16
17       - first_key
18              keycode of first key description to update
19
20       - num_keys
21              number of key descriptions to update
22
23       - map_width
24              width of core protocol keymap
25
26       - core_keysyms
27              symbols in core protocol keymap
28
29       - changes
30              backfilled with changes made to Xkb
31

DESCRIPTION

33       Xkb provides several functions that make it easier to apply the compat‐
34       ibility  map  to  configure a client-side Xkb keyboard mapping, given a
35       core protocol representation of part or  all  of  a  keyboard  mapping.
36       Obtain  a  core  protocol  representation of a keyboard mapping from an
37       actual server (by using XGetKeyboardMapping, for example), a data file,
38       or some other source.
39
40       XkbUpdateMapFromCore interprets input argument information representing
41       a keyboard map in core format to update the  Xkb  keyboard  description
42       passed  in xkb.  Only a portion of the Xkb map is updated - the portion
43       corresponding to keys with keycodes  in  the  range  first_key  through
44       first_key  +  num_keys - 1.  If XkbUpdateMapFromCore is being called in
45       response to a MappingNotify event, first_key and num_keys are  reported
46       in  the  MappingNotify event.  core_keysyms contains the keysyms corre‐
47       sponding to the keycode range being updated, in core keyboard  descrip‐
48       tion   order.    map_width   is  the  number  of  keysyms  per  key  in
49       core_keysyms.  Thus, the first map_width entries  in  core_keysyms  are
50       for  the key with keycode first_key, the next map_width entries are for
51       key first_key + 1, and so on.
52
53       In addition to modifying  the  Xkb  keyboard  mapping  in  xkb,  XkbUp‐
54       dateMapFromCore backfills the changes structure whose address is passed
55       in changes to indicate the modifications that were made. You  may  then
56       use  changes  in  subsequent  calls such as XkbSetMap, to propagate the
57       local modifications to a server.
58

SEE ALSO

60       XkbSetMap(3)
61
62
63
64X Version 11                     libX11 1.3.4          XkbUpdateMapFromCore(3)
Impressum