sungmg/mutter-performance-source
1
0
Fork 0
Code Activity

docs: Clean up ZoomAction signal and description

Browse source 
Remove the parts that were copied and pasted from DragAction.
This commit is contained in:
Emmanuele Bassi 2012-12-18 00:15:57 +00:00
parent 84b4f2f0a3
commit bd58c0bb24
1 changed files with 10 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
clutter/clutter-zoom-action.c
View file

@ -28,7 +28,8 @@
* @Short_Description: Action enabling zooming on actors * @Short_Description: Action enabling zooming on actors
* *
* #ClutterZoomAction is a sub-class of #ClutterGestureAction that * #ClutterZoomAction is a sub-class of #ClutterGestureAction that
* implements all the necessary logic for zooming actors. * implements all the necessary logic for zooming actors using a "pinch"
* gesture between two touch points.
* *
* The simplest usage of #ClutterZoomAction consists in adding it to * The simplest usage of #ClutterZoomAction consists in adding it to
* a #ClutterActor and setting it as reactive; for instance, the following * a #ClutterActor and setting it as reactive; for instance, the following
@ -40,7 +41,7 @@
* ]| * ]|
* *
* will automatically result in the actor to be scale according to the * will automatically result in the actor to be scale according to the
* distance between 2 touch points. * distance between two touch points.
* *
* Since: 1.12 * Since: 1.12
*/ */
@ -364,23 +365,17 @@ clutter_zoom_action_class_init (ClutterZoomActionClass *klass)
* ClutterZoomAction::zoom: * ClutterZoomAction::zoom:
* @action: the #ClutterZoomAction that emitted the signal * @action: the #ClutterZoomAction that emitted the signal
* @actor: the #ClutterActor attached to the action * @actor: the #ClutterActor attached to the action
* @distance: the initial distance between the 2 touch points * @focal_point: the focal point of the zoom
* @factor: the initial distance between the 2 touch points
* *
* The ::zoom signal is emitted for each touch event after the * The ::zoom signal is emitted for each series of touch events that
* #ClutterZoomAction::zoom-begin signal has been emitted. * change the distance and focal point between the touch points.
*
* The components of the distance between the touch begin event and
* the latest touch update event are computed in the actor's
* coordinate space, to take into account eventual transformations.
* If you want the stage coordinates of the latest motion event you
* can use clutter_zoom_action_get_motion_coords().
* *
* The default handler of the signal will call * The default handler of the signal will call
* clutter_actor_set_scale() on @actor using the ratio of the first * clutter_actor_set_scale() on @actor using the ratio of the first
* distance between the 2 touch points and the current distance. If * distance between the touch points and the current distance. To
* you want to override the default behaviour, you can connect to * override the default behaviour, connect to this signal and return
* this signal and call g_signal_stop_emission_by_name() from within * %FALSE.
* your callback.
* *
* Return value: %TRUE if the zoom should continue, and %FALSE if * Return value: %TRUE if the zoom should continue, and %FALSE if
* the zoom should be cancelled. * the zoom should be cancelled.