X11: XKB (4) - クライアントマップ

typedef struct {
    //キータイプ
    unsigned char   size_types;
    unsigned char   num_types;
    XkbKeyTypePtr   types;
    //キーシンボル
    unsigned short  size_syms;
    unsigned short  num_syms;
    KeySym *        syms;
    //シンボルマップ
    XkbSymMapPtr    key_sym_map;
    //修飾子
    unsigned char * modmap;
} XkbClientMapRec, *XkbClientMapPtr;

<group1>{ [shift0] [shift1] } <group2>{ [shift0] [shift1] }

#define XkbNumKbdGroups  4
#define XkbMaxKbdGroup   (XkbNumKbdGroups-1)

typedef struct {
    unsigned char   kt_index[XkbNumKbdGroups];
    unsigned char   group_info;
    unsigned char   width;
    unsigned short  offset;
} XkbSymMapRec, *XkbSymMapPtr;

$ cc -o run e14-xkb4.c util.c -lXlib

#include <stdio.h>
#include <X11/Xlib.h>
#include <X11/XKBlib.h>
#include "util.h"

static void _put_types(XkbClientMapPtr p)
{
    int i,j;
    XkbKeyTypePtr pt;
    XkbKTMapEntryPtr pm;
    XkbModsPtr ppr;

    printf("size_types: %d\n"
        "num_types: %d\n",
        p->size_types, p->num_types);

    pt = p->types;

    for(i = 0; i < p->num_types; i++, pt++)
    {
        printf("\n--- [%d] ---\n", i);
        put_atom_name_line("name: ", pt->name);
        
        printf("mods: mask(0x%x) real(0x%x) vmods(0x%x)\n"
        "num_levels: %d\n",
        pt->mods.mask, pt->mods.real_mods, pt->mods.vmods, pt->num_levels);

        for(j = 0; j < pt->num_levels; j++)
        {
            printf("level[%d]: ", j);
            put_atom_name_line(NULL, pt->level_names[j]);
        }

        //map

        pm = pt->map;

        for(j = 0; j < pt->map_count; j++, pm++)
        {
            printf("<map[%d]> active(%d) level(%d) mods[mask(0x%x):real(0x%x):vmods(0x%x)]\n",
                j, pm->active, pm->level,
                pm->mods.mask, pm->mods.real_mods, pm->mods.vmods);
        }

        //preserve

        if(pt->preserve)
        {
            ppr = pt->preserve;
            
            for(j = 0; j < pt->map_count; j++, ppr++)
            {
                if(ppr->mask)
                {
                    printf("<preserve[%d]> mask(0x%x):real(0x%x):vmods(0x%x)\n",
                        j, ppr->mask, ppr->real_mods, ppr->vmods);
                }
            }
        }
    }
}

static void _put_symmap(XkbDescPtr p,int min,int max)
{
    int i,j,group_num;
    XkbSymMapPtr pm;
    KeySym *sym;
    char *name;

    printf("\n==== key_sym_map ====\n\n");

    pm = p->map->key_sym_map + min;

    for(i = min; i <= max; i++, pm++)
    {
        printf("[%d]<%.4s> kt_index(%d,%d,%d,%d)"
        " group_info(0x%x) width(%d) offset(%d)\n",
            i, p->names->keys[i].name,
            pm->kt_index[0], pm->kt_index[1],
            pm->kt_index[2], pm->kt_index[3],
            pm->group_info, pm->width, pm->offset);

        sym = p->map->syms + pm->offset;
        group_num = pm->group_info & 0x0f;

        for(j = group_num * pm->width; j; j--)
        {
            name = XKeysymToString(*(sym++));
            if(name)
                printf(" %s", name);
            else
                printf(" <null>");
        }

        printf("\n");
    }
}

int main(int argc,char **argv)
{
    Display *disp;
    XkbDescPtr desc;
    
    disp = XOpenDisplay(NULL);
    if(!disp) return 1;

    set_display(disp);

    //XKB 初期化

    if(init_xkb(disp, NULL))
        return 1;

    //データ取得

    desc = XkbGetKeyboard(disp, XkbAllComponentsMask, XkbUseCoreKbd);

    _put_types(desc->map);

    _put_symmap(desc, desc->min_key_code, desc->max_key_code);

    XkbFreeKeyboard(desc, 0, True);

    XCloseDisplay(disp);

    return 0;
}

//キーコードとグループインデックス、シフトレベルから KeySym を取得

KeySym XkbKeycodeToKeysym(Display *dpy, KeyCode kc, unsigned int group, unsigned int level);

//KeySym に関連付けられている実修飾子を取得

unsigned int XkbKeysymToModifiers(Display *dpy, KeySym ks);

//キーコードと修飾子(キーイベント時の state)から KeySym を取得
// mods_rtrn : 消費された修飾子が返る

Bool XkbLookupKeySym(Display *dpy, KeyCode key, unsigned int state, unsigned int *mods_rtrn, KeySym *sym_rtrn);

//XLookupString と同等。KeySym から文字列を取得

int XkbLookupKeyBinding(Display *dpy, KeySym sym, unsigned int state, char *buf, int nbytes, int *extra_rtrn);

//KeySym に修飾子を適用したものを返し、文字列があればそれも返す

int XkbTranslateKeySym(Display *dpy, KeySym *sym_inout, unsigned int mods,
    char *buf, int nbytes, int *extra_rtrn);

//XkbDescRec 構造体を元に、キーコードと修飾子から KeySym を取得

Bool XkbTranslateKeyCode(XkbDescPtr xkb, KeyCode key, unsigned int mods,
    unsigned int *mods_rtrn, KeySym *keysym_rtrn);