X11: XInput (1)

XInput 拡張機能は、マウス、キーボード、タッチスクリーン、ペンタブレットなどの入力デバイスを扱うための機能です。

XInput を使うと、入力デバイスの詳細な情報を取得することができるため、例えばペンタブレットの筆圧を取得したり、座標を double で取得することができます。

XInput には ver 1.x と ver 2.x があり、この二つのバージョンでは扱いが大きく異なります。
ここでは、XInput ver 2 (XI2) のみを扱います。

まずは、使用できる入力デバイスの情報が必要になります。

XI デバイスの一覧を表示するプログラムです。
各クラスの値については、次回で行います。

$ cc -o run e07-xi1.c -lXlib -lXi

<e07-xi1.c>

#include <stdio.h>
#include <X11/Xlib.h>
#include <X11/extensions/XInput2.h>

const char *g_use[] = {
 "MasterPointer", "MasterKeyboard", "SlavePointer", "SlaveKeyboard", "FloatingSlave"
};

int main(int argc,char **argv)
{
    Display *disp;
    XIDeviceInfo *info,*pi;
    int major,minor,dnum,i;
    
    disp = XOpenDisplay(NULL);
    if(!disp) return 1;

    //version

    major = 2, minor = 4;

    if(XIQueryVersion(disp, &major, &minor) != Success)
    {
        printf("unsupported XI2\n");
        XCloseDisplay(disp);
        return 1;
    }

    printf("ver %d.%d\n\n", major, minor);

    //デバイス情報

    info = XIQueryDevice(disp, XIAllDevices, &dnum);

    for(i = 0; i < dnum; i++)
    {
        pi = info + i;

        printf("-- [%s] --\ndeviceid(%d) use(%s) attachment(%d) enabled(%d) num_classes(%d)\n",
            pi->name, pi->deviceid, g_use[pi->use - 1], pi->attachment,
            pi->enabled, pi->num_classes);
    }

    XIFreeDeviceInfo(info);

    //

    XCloseDisplay(disp);

    return 0;
}

ver 2.4

-- [Virtual core pointer] --
deviceid(2) use(MasterPointer) attachment(3) enabled(1) num_classes(7)
-- [Virtual core keyboard] --
deviceid(3) use(MasterKeyboard) attachment(2) enabled(1) num_classes(1)
-- [Virtual core XTEST pointer] --
deviceid(4) use(SlavePointer) attachment(2) enabled(1) num_classes(3)
-- [Virtual core XTEST keyboard] --
deviceid(5) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Power Button] --
deviceid(6) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Video Bus] --
deviceid(7) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Power Button] --
deviceid(8) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Sleep Button] --
deviceid(9) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Wacom One by Wacom M Pen stylus] --
deviceid(10) use(SlavePointer) attachment(2) enabled(1) num_classes(12)
-- [ELECOM ELECOM BlueLED Mouse] --
deviceid(11) use(SlavePointer) attachment(2) enabled(1) num_classes(7)
-- [SEM USB Keyboard] --
deviceid(12) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [SEM USB Keyboard Consumer Control] --
deviceid(13) use(SlavePointer) attachment(2) enabled(1) num_classes(7)
-- [SEM USB Keyboard System Control] --
deviceid(14) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)
-- [Wacom One by Wacom M Pen eraser] --
deviceid(15) use(SlavePointer) attachment(2) enabled(1) num_classes(12)
-- [SEM USB Keyboard Consumer Control] --
deviceid(16) use(SlaveKeyboard) attachment(3) enabled(1) num_classes(1)

このパソコンには、キーボード、マウス、ペンタブレットがそれぞれ１つ接続されています。

"Virtual core pointer" がマスターポインタ、"Virtual core keyboard" がマスターキーボードで、他のスレーブデバイスは、そのどちらかに接続されています。

なお、"Virtual core XTEST *" は、XTEST 拡張機能に関するスレーブデバイスです。

スレーブキーボードには、実際のキーボードの他に、電源ボタンやスリープボタンもデバイスとして存在しています。

マウスとペンタブレットは、マスターポインタに接続されています。
そのため、どちらを操作しても、画面上のポインタは移動します。

なお、このペンタブレットの実際のペンには、消しゴム機能がありませんが、"eraser" の名前が付いて、ペンの消しゴム部分で操作した時用のデバイスが存在します。

このように、物理的に接続されているデバイスだけではなく、仮想的なデバイスがいくつかあります。
クライアントがデバイスを判断する際は、名前やクラスの情報を見て、何のデバイスかを判断するか、もしくは、対象のデバイスを直接ユーザーに選択してもらう必要があります。