[gtk+/wip/wayland-tablet-v2: 50/66] gdk: Add a getter for the hardware id of a GdkDeviceTool



commit 984bfc39d5a3afbdbb4c2876660dcccecaec3068
Author: Carlos Garnacho <carlosg gnome org>
Date:   Thu Aug 4 18:49:13 2016 +0200

    gdk: Add a getter for the hardware id of a GdkDeviceTool
    
    Although scarcely used, this information may be useful to retrieve
    from the windowing systems that offer this information.

 gdk/gdkdevicetool.c |   39 +++++++++++++++++++++++++++++++++++++++
 gdk/gdkdevicetool.h |    3 +++
 2 files changed, 42 insertions(+), 0 deletions(-)
---
diff --git a/gdk/gdkdevicetool.c b/gdk/gdkdevicetool.c
index 3f07811..d632504 100644
--- a/gdk/gdkdevicetool.c
+++ b/gdk/gdkdevicetool.c
@@ -31,6 +31,7 @@ enum {
   TOOL_PROP_SERIAL,
   TOOL_PROP_TOOL_TYPE,
   TOOL_PROP_AXES,
+  TOOL_PROP_HARDWARE_ID,
   N_TOOL_PROPS
 };
 
@@ -55,6 +56,9 @@ gdk_device_tool_set_property (GObject      *object,
     case TOOL_PROP_AXES:
       tool->tool_axes = g_value_get_flags (value);
       break;
+    case TOOL_PROP_HARDWARE_ID:
+      tool->hw_id = g_value_get_uint64 (value);
+      break;
     default:
       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
       break;
@@ -80,6 +84,9 @@ gdk_device_tool_get_property (GObject    *object,
     case TOOL_PROP_AXES:
       g_value_set_flags (value, tool->tool_axes);
       break;
+    case TOOL_PROP_HARDWARE_ID:
+      g_value_set_uint64 (value, tool->hw_id);
+      break;
     default:
       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
       break;
@@ -113,6 +120,12 @@ gdk_device_tool_class_init (GdkDeviceToolClass *klass)
                                                    GDK_TYPE_AXIS_FLAGS, 0,
                                                    G_PARAM_READWRITE |
                                                    G_PARAM_CONSTRUCT_ONLY);
+  tool_props[TOOL_PROP_HARDWARE_ID] = g_param_spec_uint64 ("hardware-id",
+                                                           "Hardware ID",
+                                                           "Hardware ID",
+                                                           0, G_MAXUINT64, 0,
+                                                           G_PARAM_READWRITE |
+                                                           G_PARAM_CONSTRUCT_ONLY);
 
   g_object_class_install_properties (object_class, N_TOOL_PROPS, tool_props);
 }
@@ -154,6 +167,32 @@ gdk_device_tool_get_serial (GdkDeviceTool *tool)
 }
 
 /**
+ * gdk_device_tool_get_hardware_id:
+ * @tool: a #GdkDeviceTool
+ *
+ * Gets the hardware ID of this tool, or 0 if it's not known. When
+ * non-zero, the identificator is unique for the given tool model,
+ * meaning that two identical tools will share the same @hardware_id,
+ * but will have different serial numbers (see gdk_device_tool_get_serial()).
+ *
+ * This is a more concrete (and device specific) method to identify
+ * a #GdkDeviceTool than gdk_device_tool_get_tool_type(), as a tablet
+ * may support multiple devices with the same #GdkDeviceToolType,
+ * but having different hardware identificators.
+ *
+ * Returns: The hardware identificator of this tool.
+ *
+ * Since: 3.22
+ **/
+guint64
+gdk_device_tool_get_hardware_id (GdkDeviceTool *tool)
+{
+  g_return_val_if_fail (tool != NULL, 0);
+
+  return tool->hw_id;
+}
+
+/**
  * gdk_device_tool_get_tool_type:
  * @tool: a #GdkDeviceTool
  *
diff --git a/gdk/gdkdevicetool.h b/gdk/gdkdevicetool.h
index 5486e7e..34a3200 100644
--- a/gdk/gdkdevicetool.h
+++ b/gdk/gdkdevicetool.h
@@ -68,6 +68,9 @@ GDK_AVAILABLE_IN_3_22
 guint64 gdk_device_tool_get_serial (GdkDeviceTool *tool);
 
 GDK_AVAILABLE_IN_3_22
+guint64 gdk_device_tool_get_hardware_id (GdkDeviceTool *tool);
+
+GDK_AVAILABLE_IN_3_22
 GdkDeviceToolType gdk_device_tool_get_tool_type (GdkDeviceTool *tool);
 
 G_END_DECLS


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]