swipe-action: Clean up

Clean up the documentation, and use a type safe GFlags marshaller for
the ::swept signal's @direction argument - instead of a generic integer
marshaller.

http://bugzilla.clutter-project.org/show_bug.cgi?id=2585
This commit is contained in:
Emmanuele Bassi 2011-06-10 14:33:20 +01:00
parent 0058c78b79
commit 11d961b605
3 changed files with 37 additions and 60 deletions

View File

@ -13,9 +13,9 @@ VOID:INT,INT
VOID:FLOAT,FLOAT VOID:FLOAT,FLOAT
VOID:INT,INT,INT,INT VOID:INT,INT,INT,INT
VOID:OBJECT VOID:OBJECT
VOID:OBJECT,FLAGS
VOID:OBJECT,FLOAT,FLOAT VOID:OBJECT,FLOAT,FLOAT
VOID:OBJECT,FLOAT,FLOAT,FLAGS VOID:OBJECT,FLOAT,FLOAT,FLAGS
VOID:OBJECT,INT
VOID:OBJECT,PARAM VOID:OBJECT,PARAM
VOID:OBJECT,POINTER VOID:OBJECT,POINTER
VOID:OBJECT,UINT VOID:OBJECT,UINT

View File

@ -31,24 +31,8 @@
* @Title: ClutterSwipeAction * @Title: ClutterSwipeAction
* @Short_Description: Action for swipe gestures * @Short_Description: Action for swipe gestures
* *
* #ClutterSwipeAction is a sub-class of #ClutterAction that implements * #ClutterSwipeAction is a sub-class of #ClutterGestureAction that implements
* the logic for recognizing swipe gestures. It listens for low level events * the logic for recognizing swipe gestures.
* such as #ClutterButtonEvent and #ClutterMotionEvent on the stage to raise
* the signals #ClutterSwipeAction::swipe-begin, #ClutterSwipeAction::swipe-motion and
* #ClutterSwipeAction::swipe-end.
*
* To use #ClutterSwipeAction you just need to apply it to a #ClutterActor
* using clutter_actor_add_action() and connect to the signals:
*
* |[
* ClutterAction *action = clutter_swipe_action_new ();
*
* clutter_actor_add_action (actor, action);
*
* g_signal_connect (action, "swipe-begin", G_CALLBACK (on_swipe_begin), NULL);
* g_signal_connect (action, "swipe-motion", G_CALLBACK (on_swipe_motion), NULL);
* g_signal_connect (action, "swipe-end", G_CALLBACK (on_swipe_end), NULL);
* ]|
* *
* Since: 1.8 * Since: 1.8
*/ */
@ -68,8 +52,8 @@ struct _ClutterSwipeActionPrivate
{ {
ClutterSwipeDirection h_direction; ClutterSwipeDirection h_direction;
ClutterSwipeDirection v_direction; ClutterSwipeDirection v_direction;
gfloat last_motion_x;
gfloat last_motion_y; int threshold;
}; };
enum enum
@ -89,24 +73,26 @@ gesture_begin (ClutterGestureAction *action,
ClutterActor *actor) ClutterActor *actor)
{ {
ClutterSwipeActionPrivate *priv = CLUTTER_SWIPE_ACTION (action)->priv; ClutterSwipeActionPrivate *priv = CLUTTER_SWIPE_ACTION (action)->priv;
ClutterSettings *settings = clutter_settings_get_default ();
/* reset the state at the beginning of a new gesture */
priv->h_direction = 0; priv->h_direction = 0;
priv->v_direction = 0; priv->v_direction = 0;
g_object_get (settings, "dnd-drag-threshold", &priv->threshold, NULL);
return TRUE; return TRUE;
} }
static gboolean static gboolean
gesture_progress (ClutterGestureAction *action, gesture_progress (ClutterGestureAction *action,
ClutterActor *actor) ClutterActor *actor)
{ {
ClutterSwipeActionPrivate *priv = CLUTTER_SWIPE_ACTION (action)->priv; ClutterSwipeActionPrivate *priv = CLUTTER_SWIPE_ACTION (action)->priv;
gfloat press_x, press_y; gfloat press_x, press_y;
gfloat motion_x, motion_y; gfloat motion_x, motion_y;
gfloat delta_x, delta_y; gfloat delta_x, delta_y;
ClutterSwipeDirection h_direction = 0, v_direction = 0; ClutterSwipeDirection h_direction = 0, v_direction = 0;
ClutterSettings *settings = clutter_settings_get_default ();
gint drag_threshold;
clutter_gesture_action_get_press_coords (action, clutter_gesture_action_get_press_coords (action,
0, 0,
@ -121,22 +107,17 @@ gesture_progress (ClutterGestureAction *action,
delta_x = press_x - motion_x; delta_x = press_x - motion_x;
delta_y = press_y - motion_y; delta_y = press_y - motion_y;
g_object_get (settings, if (delta_x >= priv->threshold)
"dnd-drag-threshold", &drag_threshold,
NULL);
if (delta_x >= drag_threshold)
h_direction = CLUTTER_SWIPE_DIRECTION_RIGHT; h_direction = CLUTTER_SWIPE_DIRECTION_RIGHT;
else if (delta_x < -drag_threshold) else if (delta_x < -priv->threshold)
h_direction = CLUTTER_SWIPE_DIRECTION_LEFT; h_direction = CLUTTER_SWIPE_DIRECTION_LEFT;
if (delta_y >= drag_threshold) if (delta_y >= priv->threshold)
v_direction = CLUTTER_SWIPE_DIRECTION_DOWN; v_direction = CLUTTER_SWIPE_DIRECTION_DOWN;
else if (delta_y < -drag_threshold) else if (delta_y < -priv->threshold)
v_direction = CLUTTER_SWIPE_DIRECTION_UP; v_direction = CLUTTER_SWIPE_DIRECTION_UP;
/* cancel gesture on direction reversal */ /* cancel gesture on direction reversal */
if (priv->h_direction == 0) if (priv->h_direction == 0)
priv->h_direction = h_direction; priv->h_direction = h_direction;
@ -152,37 +133,31 @@ gesture_progress (ClutterGestureAction *action,
return TRUE; return TRUE;
} }
static void static void
gesture_end (ClutterGestureAction *action, gesture_end (ClutterGestureAction *action,
ClutterActor *actor) ClutterActor *actor)
{ {
ClutterSwipeActionPrivate *priv = CLUTTER_SWIPE_ACTION (action)->priv;
gfloat press_x, press_y; gfloat press_x, press_y;
gfloat release_x, release_y; gfloat release_x, release_y;
ClutterSwipeDirection direction = 0; ClutterSwipeDirection direction = 0;
ClutterSettings *settings = clutter_settings_get_default ();
gint drag_threshold;
clutter_gesture_action_get_press_coords (CLUTTER_GESTURE_ACTION (action), clutter_gesture_action_get_press_coords (action,
0, 0,
&press_x, &press_y); &press_x, &press_y);
clutter_gesture_action_get_release_coords (CLUTTER_GESTURE_ACTION (action), clutter_gesture_action_get_release_coords (action,
0, 0,
&release_x, &release_y); &release_x, &release_y);
g_object_get (settings, if (release_x - press_x > priv->threshold)
"dnd-drag-threshold", &drag_threshold,
NULL);
if (release_x - press_x > drag_threshold)
direction |= CLUTTER_SWIPE_DIRECTION_RIGHT; direction |= CLUTTER_SWIPE_DIRECTION_RIGHT;
else if (press_x - release_x > drag_threshold) else if (press_x - release_x > priv->threshold)
direction |= CLUTTER_SWIPE_DIRECTION_LEFT; direction |= CLUTTER_SWIPE_DIRECTION_LEFT;
if (release_y - press_y > drag_threshold) if (release_y - press_y > priv->threshold)
direction |= CLUTTER_SWIPE_DIRECTION_DOWN; direction |= CLUTTER_SWIPE_DIRECTION_DOWN;
else if (press_y - release_y > drag_threshold) else if (press_y - release_y > priv->threshold)
direction |= CLUTTER_SWIPE_DIRECTION_UP; direction |= CLUTTER_SWIPE_DIRECTION_UP;
g_signal_emit (action, swipe_signals[SWEPT], 0, actor, direction); g_signal_emit (action, swipe_signals[SWEPT], 0, actor, direction);
@ -217,10 +192,10 @@ clutter_swipe_action_class_init (ClutterSwipeActionClass *klass)
G_SIGNAL_RUN_LAST, G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (ClutterSwipeActionClass, swept), G_STRUCT_OFFSET (ClutterSwipeActionClass, swept),
NULL, NULL, NULL, NULL,
_clutter_marshal_VOID__OBJECT_INT, _clutter_marshal_VOID__OBJECT_FLAGS,
G_TYPE_NONE, 2, G_TYPE_NONE, 2,
CLUTTER_TYPE_ACTOR, CLUTTER_TYPE_ACTOR,
G_TYPE_INT); CLUTTER_TYPE_SWIPE_DIRECTION);
} }
static void static void
@ -229,8 +204,7 @@ clutter_swipe_action_init (ClutterSwipeAction *self)
self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, CLUTTER_TYPE_SWIPE_ACTION, self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, CLUTTER_TYPE_SWIPE_ACTION,
ClutterSwipeActionPrivate); ClutterSwipeActionPrivate);
clutter_gesture_action_set_required_devices (CLUTTER_GESTURE_ACTION (self), clutter_gesture_action_set_required_devices (CLUTTER_GESTURE_ACTION (self), 1);
1);
} }
/** /**

View File

@ -59,10 +59,10 @@ typedef struct _ClutterSwipeActionClass ClutterSwipeActionClass;
* *
* Since: 1.8 * Since: 1.8
*/ */
typedef enum { /*< prefix=CLUTTER_SWIPE >*/ typedef enum { /*< prefix=CLUTTER_SWIPE_DIRECTION >*/
CLUTTER_SWIPE_DIRECTION_UP = 1 << 0, CLUTTER_SWIPE_DIRECTION_UP = 1 << 0,
CLUTTER_SWIPE_DIRECTION_DOWN = 1 << 1, CLUTTER_SWIPE_DIRECTION_DOWN = 1 << 1,
CLUTTER_SWIPE_DIRECTION_LEFT = 1 << 2, CLUTTER_SWIPE_DIRECTION_LEFT = 1 << 2,
CLUTTER_SWIPE_DIRECTION_RIGHT = 1 << 3 CLUTTER_SWIPE_DIRECTION_RIGHT = 1 << 3
} ClutterSwipeDirection; } ClutterSwipeDirection;
@ -86,6 +86,9 @@ struct _ClutterSwipeAction
* ClutterSwipeActionClass: * ClutterSwipeActionClass:
* @swept: class handler for the #ClutterSwipeAction::swept signal * @swept: class handler for the #ClutterSwipeAction::swept signal
* *
* The <structname>ClutterSwipeActionClass</structname> structure contains
* only private data.
*
* Since: 1.8 * Since: 1.8
*/ */
struct _ClutterSwipeActionClass struct _ClutterSwipeActionClass
@ -95,8 +98,8 @@ struct _ClutterSwipeActionClass
/*< public >*/ /*< public >*/
void (* swept) (ClutterSwipeAction *action, void (* swept) (ClutterSwipeAction *action,
ClutterActor *actor, ClutterActor *actor,
ClutterSwipeDirection direction); ClutterSwipeDirection direction);
/*< private >*/ /*< private >*/
void (* _clutter_swipe_action1) (void); void (* _clutter_swipe_action1) (void);
@ -110,7 +113,7 @@ struct _ClutterSwipeActionClass
GType clutter_swipe_action_get_type (void) G_GNUC_CONST; GType clutter_swipe_action_get_type (void) G_GNUC_CONST;
ClutterAction *clutter_swipe_action_new (void); ClutterAction * clutter_swipe_action_new (void);
G_END_DECLS G_END_DECLS