mike-jumper commented on a change in pull request #331:
URL: https://github.com/apache/guacamole-server/pull/331#discussion_r574979782
##########
File path: src/libguac/guacamole/user-fntypes.h
##########
@@ -95,6 +95,51 @@ typedef void* guac_user_callback(guac_user* user, void*
data);
typedef int guac_user_mouse_handler(guac_user* user, int x, int y,
int button_mask);
+/**
+ * Handler for Guacamole touch events, invoked when a "touch" instruction has
+ * been received from a user.
+ *
+ * @param user
+ * The user that sent the touch event.
+ *
+ * @param id
+ * An arbitrary integer ID which uniquely identifies this contact relative
+ * to other active contacts.
+ *
+ * @param x
+ * The X coordinate of the center of the touch contact within the display
+ * when the event occurred, in pixels. This value is not guaranteed to be
+ * within the bounds of the display area.
+ *
+ * @param y
+ * The Y coordinate of the center of the touch contact within the display
+ * when the event occurred, in pixels. This value is not guaranteed to be
+ * within the bounds of the display area.
+ *
+ * @param x_radius
+ * The X radius of the ellipse covering the general area of the touch
+ * contact, in pixels.
+ *
+ * @param y_radius
+ * The Y radius of the ellipse covering the general area of the touch
+ * contact, in pixels.
+ *
+ * @param angle
+ * The rough angle of clockwise rotation of the general area of the touch
+ * contact, in degrees.
+ *
+ * @param force
+ * The relative force exerted by the touch contact, where 0 is no force
+ * (the touch has been lifted) and 1 is maximum force (the maximum amount
+ * of force representable by the device).
+ *
+ * @return
+ * Zero if the mouse event was handled successfully, or non-zero if an
Review comment:
Whoops. Corrected via rebase.
🐭 🧀
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
