добавление поддержки xinput

устройства ввода (например, графические планшеты), позволяющие рисовать удобнее и проще, чем мышью, последнее время стали намного дешевле . самый простой метод использования подобных устройств - замена мыши, но следует заметить, что также существуют другие преимущества :

• определение силы давления

• определение угла наклона

• меж точечное расположение

• множество методов ввода (например, стилус и ластик)

для детальной информации о дополнительных возможностях xinput, смотрите xinput howto.

анализируя, например, структуру gdkeventmotion мы видим, что она имеет поля для хранения информации об устройствах с дополнительными возможностями.

struct _gdkeventmotion
{
  gdkeventtype type;
  gdkwindow *window;
  guint32 time;
  gdouble x;
  gdouble y;
  gdouble pressure;
  gdouble xtilt;
  gdouble ytilt;
  guint state;
  gint16 is_hint;
  gdkinputsource source;
  guint32 deviceid;
};

pressure определяет давление, задаваемое числом между 0 и 1. xtilt и ytilt могут иметь значения между -1 и 1, соответствующие углу наклона в каждом из направлений. source и deviceid указывают на устройство, связанное с событием. source предоставляет простую информацию об устройстве. она может иметь такие значения:

gdk_source_mouse
gdk_source_pen
gdk_source_eraser
gdk_source_cursor

deviceid - уникальный id устройства. оно может быть использовано для выяснения дальнейшей информации об устройстве с помощью вызова  gdk_input_list_devices() (см. ниже). специальное значение gdk_core_pointer чаще всего указывает простую мышь.

расширение возможностей устройства

для того, чтобы дать gtk понять о нашем желании использовать дополнительную информацию устройства ввода, нужно всего-то добавить одну строку в программму:

gtk_widget_set_extension_events (drawing_area, gdk_extension_events_cursor);

используя значение gdk_extension_events_cursor мы указываем, что мы заинтересованы в дополнительных событиях устройства, но только если мы сами не должны рисовать свой собственный курсор. см. дальнейшие исследования для выяснения более подробной информации о рисовании курсора. также можно использовать gdk_extension_events_all при желании рисовать свои курсоры или gdk_extension_events_none для возврата к настройкам по умолчанию.

но это ещё не всё. по умолчанию дополнительные возможности устройств не включены: мы должны пользователям предоставить некий механизм для конфигурирования устройств. для автоматизации этого процесса gtk предоставляет виджет inputdialog. предоставленный код демонстрирует работу с inputdialog:

void
input_dialog_destroy (gtkwidget *w, gpointer data)
{
  *((gtkwidget **)data) = null;
}
void
create_input_dialog ()
{
  static gtkwidget *inputd = null;
  if (!inputd)
    {
      inputd = gtk_input_dialog_new();
      gtk_signal_connect (gtk_object(inputd), "destroy",
                          (gtksignalfunc)input_dialog_destroy, &inputd);
      gtk_signal_connect_object (gtk_object(gtk_input_dialog(inputd)->close_button),
                                 "clicked",
                                 (gtksignalfunc)gtk_widget_hide,
                                 gtk_object(inputd));
      gtk_widget_hide ( gtk_input_dialog(inputd)->save_button);
      gtk_widget_show (inputd);
    }
  else
    {
      if (!gtk_widget_mapped(inputd))
        gtk_widget_show(inputd);
      else
        gdk_window_raise(inputd->window);
    }
}

(следует заметить, что после уничтожения диалога, мы не храним указатель на него. это гарантирует отсутствие ошибки сегментации.)

inputdialog имеет две кнопки: "закрыть" и "сохранить", которые ничего в принципе не делают: "закрыть" прячет диалог, "сохранить" - спрятана.

использование информации устройства с расширенными возможностями

устройство включено - можно начинать пользоваться дополнительными возможностями. в принципе, использование этой информации - вполне безопасное действие, т.к. полученные данные будут вполне вменяемы, даже если устройство не было включено.

следует использовать gdk_input_window_get_pointer(), а не gdk_window_get_pointer, т.к. последний вызов не возвращает дополнительную информацию устройства.

void gdk_input_window_get_pointer( gdkwindow       *window,
                                   guint32         deviceid,
                                   gdouble         *x,
                                   gdouble         *y,
                                   gdouble         *pressure,
                                   gdouble         *xtilt,
                                   gdouble         *ytilt,
                                   gdkmodifiertype *mask)

при вызове функции следует указать id устройства и окно. обычно id берётся из поля deviceid структуры события. опять же, даже при наличии обычного устройства ввода (мышь) полученные данные будут корректными. просто event->deviceid будет иметь значение gdk_core_pointer.

обработчики событий нажатия кнопки или движения особо не меняются - лишь добавляется обработка дополнительной информации.

static gint
button_press_event (gtkwidget *widget, gdkeventbutton *event)
{
  print_button_press (event->deviceid);
  if (event->button == 1 && pixmap != null)
    draw_brush (widget, event->source, event->x, event->y, event->pressure);
  return true;
}
static gint
motion_notify_event (gtkwidget *widget, gdkeventmotion *event)
{
  gdouble x, y;
  gdouble pressure;
  gdkmodifiertype state;
  if (event->is_hint)
    gdk_input_window_get_pointer (event->window, event->deviceid,
                                  &x, &y, &pressure, null, null, &state);
  else
    {
      x = event->x;
      y = event->y;
      pressure = event->pressure;
      state = event->state;
    }
  if (state & gdk_button1_mask && pixmap != null)
    draw_brush (widget, event->source, x, y, pressure);
  return true;

так же следует как-нибудь использовать полученную информацию. скажем, функция draw_brush() рисует разными цветами в зависимости от event->source и меняет размер кисти в зависимости от давления.

/* draw a rectangle on the screen, size depending on pressure,
   and color on the type of device */
static void
draw_brush (gtkwidget *widget, gdkinputsource source,
            gdouble x, gdouble y, gdouble pressure)
{
  gdkgc *gc;
  gdkrectangle update_rect;
  switch (source)
    {
    case gdk_source_mouse:
      gc = widget->style->dark_gc[gtk_widget_state (widget)];
      break;
    case gdk_source_pen:
      gc = widget->style->black_gc;
      break;
    case gdk_source_eraser:
      gc = widget->style->white_gc;
      break;
    default:
      gc = widget->style->light_gc[gtk_widget_state (widget)];
    }
  update_rect.x = x - 10 * pressure;
  update_rect.y = y - 10 * pressure;
  update_rect.width = 20 * pressure;
  update_rect.height = 20 * pressure;
  gdk_draw_rectangle (pixmap, gc, true,
                      update_rect.x, update_rect.y,
                      update_rect.width, update_rect.height);
  gtk_widget_draw (widget, &update_rect);
}

выяснение дополнительной информации об устройстве

в качестве примера приведём код, который показывает имя устройства при нажатии на кнопку. для выяснения имени используется функция

glist *gdk_input_list_devices (void);

, которая возвращает список (glist из библиотеки glib) структур gdkdeviceinfo. gdkdeviceinfo определена как:

struct _gdkdeviceinfo
{
  guint32 deviceid;
  gchar *name;
  gdkinputsource source;
  gdkinputmode mode;
  gint has_cursor;
  gint num_axes;
  gdkaxisuse *axes;
  gint num_keys;
  gdkdevicekey *keys;
};

скорее всего большинство полей этой структуры будет вами проигнорировано до тех пор, пока вам не нужно сохранение конфигурации xinput. в данный момент нас интересует поле name, которое представляет из себя имя, присвоенное устройству x'ми. в свою очередь, если has_cursor равен false, нам следует рисовать курсор самим, но т.к. мы указали gdk_extension_events_cursor нам не следует об этом беспокоится.

функция print_button_press() просто итерирует по возвращённому списку до тех пор пока не найдёт совпадение.

static void
print_button_press (guint32 deviceid)
{
  glist *tmp_list;
  /* gdk_input_list_devices returns an internal list, so we shouldn't
     free it afterwards */
  tmp_list = gdk_input_list_devices();
  while (tmp_list)
    {
      gdkdeviceinfo *info = (gdkdeviceinfo *)tmp_list->data;
      if (info->deviceid == deviceid)
        {
          printf("button press on device '%s'\n", info->name);
          return;
        }
      tmp_list = tmp_list->next;
    }

описанное выше - последний шаг включения поддержки "xinput" в нашей программме.

дальнейшие исследования

не смотря на то, что наша программма достаточно не плохо поддерживает xinput, не хватает того, что мы бы желали видеть в полноценной программме. во первых, пользователь скорее всего не захочет конфигурировать устройство ввода при каждом запуске программмы - мы должны позволить сохранить конфигурацию. это достигается итерированием по результату gdk_input_list_devices() и записью результата в файл.

для восстановления состояния при загрузке программмы gdk предоставляет следующие функции:

gdk_input_set_extension_events()
gdk_input_set_source()
gdk_input_set_mode()
gdk_input_set_axes()
gdk_input_set_ke

(список, возвращённый gdk_input_list_devices() не должен изменяться на прямую.) пример подобной программмы - gsumi (доступна:http://www.msc.cornell.edu/~otaylor/gsumi/) конечно, было бы прекрасно иметь стандартный метод выполнения подобной процедуры, но, наверное, это задача библиотек более высокого уровня, скажем gnome.

другой не малый недостаток - отсутствие курсоров. платформы, отличные от xfree86, на данный момент не позволяют одновременное использование устройства ввода как простую мышь и специальное устройство, используемое напрямую из приложения. подробнее: xinput-howto. это означает, что если автор приложения желает сделать своё приложение более универсальным, нужно курсоры рисовать самому.

приложение, само желающее рисовать курсоры, должно сделать 2 вещи: определить требует ли устройство ввода прорисовки курсора и состояние устройства ввода (ведь приложение должно вести себя натурально: курсор пропадает, если стилус не дотрагивается до планшета, и появляется при контакте с планшетом). первое достигается поиском устройства в списке по имени. второе - используя событие "proximity_out". пример прорисовки собственных курсоров может быть найден в программме "testinput" из поставки gtk.