[gtk+/wip/garnacho/touchpad-gestures: 69/71] gtkgesture: Add note to gtk_gesture_get_bounding_box()



commit 9e474f5f5452cb268a1a9e76e4a85e1e55e49f3a
Author: Carlos Garnacho <carlosg gnome org>
Date:   Fri Jul 24 12:59:59 2015 +0200

    gtkgesture: Add note to gtk_gesture_get_bounding_box()
    
    This is the only function that's will be semantically confusing
    with touchpad gesture events, explain what's to be expected there.

 gtk/gtkgesture.c |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkgesture.c b/gtk/gtkgesture.c
index 12226c4..65c7518 100644
--- a/gtk/gtkgesture.c
+++ b/gtk/gtkgesture.c
@@ -1328,6 +1328,12 @@ _gtk_gesture_get_last_update_time (GtkGesture       *gesture,
  * box containing all active touches. Otherwise, %FALSE will be
  * returned.
  *
+ * Note: This function will yield unexpected results on touchpad
+ * gestures. Since there is no correlation between physical and
+ * pixel distances, these will look as if constrained in an
+ * infinitely small area, @rect width and height will thus be 0
+ * regardless of the number of touchpoints.
+ *
  * Returns: %TRUE if there are active touches, %FALSE otherwise
  *
  * Since: 3.14


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