Clutter.RotateAction
Description: Reference for Clutter.RotateAction

### Class

# ClutterRotateAction

since: 13

#### Description [src]

    class Clutter.RotateAction : Clutter.GestureAction
    {
      /* No available fields */
    }

Action to rotate an actor

`ClutterRotateAction` is a sub-class of `ClutterGestureAction` that implements the logic for recognizing rotate gestures using two touch points.

Available since: 13

#### Ancestors

- ClutterGestureAction
- ClutterAction
- ClutterActorMeta
- GInitiallyUnowned
- GObject

#### Constructors

###### clutter_rotate_action_new

Creates a new `ClutterRotateAction` instance.

since: 13

#### Instance methods

##### Methods inherited from ClutterGestureAction (17)

###### clutter_gesture_action_cancel

Cancel a `ClutterGestureAction` before it begins.

since: 13

###### clutter_gesture_action_get_device

Retrieves the `ClutterInputDevice` of a touch point.

since: 13

###### clutter_gesture_action_get_last_event

Retrieves a reference to the last `ClutterEvent` for a touch point. Call `clutter_event_copy()` if you need to store the reference somewhere.

since: 13

###### clutter_gesture_action_get_motion_coords

Retrieves the coordinates, in stage space, of the latest motion event during the dragging.

since: 13

###### clutter_gesture_action_get_motion_delta

Retrieves the incremental delta since the last motion event during the dragging.

since: 13

###### clutter_gesture_action_get_n_current_points

Retrieves the number of points currently active.

since: 13

###### clutter_gesture_action_get_n_touch_points

Retrieves the number of requested points to trigger the gesture.

since: 13

###### clutter_gesture_action_get_press_coords

Retrieves the coordinates, in stage space, of the press event that started the dragging for a specific touch point.

since: 13

###### clutter_gesture_action_get_release_coords

Retrieves the coordinates, in stage space, where the touch point was last released.

since: 13

###### clutter_gesture_action_get_sequence

Retrieves the `ClutterEventSequence` of a touch point.

since: 13

###### clutter_gesture_action_get_threshold_trigger_distance

Retrieves the threshold trigger distance of the gesture `action`, as set using `clutter_gesture_action_set_threshold_trigger_distance()`.

since: 13

###### clutter_gesture_action_get_threshold_trigger_edge

Retrieves the edge trigger of the gesture `action`, as set using `clutter_gesture_action_set_threshold_trigger_edge()`.

since: 13

###### clutter_gesture_action_get_threshold_trigger_egde

Retrieves the edge trigger of the gesture `action`, as set using `clutter_gesture_action_set_threshold_trigger_edge()`.

deprecated: 1.20 since: 13

###### clutter_gesture_action_get_velocity

Retrieves the velocity, in stage pixels per millisecond, of the latest motion event during the dragging.

since: 13

###### clutter_gesture_action_set_n_touch_points

Sets the number of points needed to trigger the gesture.

since: 13

###### clutter_gesture_action_set_threshold_trigger_distance

Sets the threshold trigger distance for the gesture drag threshold, if any.

since: 13

###### clutter_gesture_action_set_threshold_trigger_edge

Sets the edge trigger for the gesture drag threshold, if any.

since: 13

##### Methods inherited from ClutterAction (1)

###### clutter_action_get_phase

No description available.

since: 13

##### Methods inherited from ClutterActorMeta (5)

###### clutter_actor_meta_get_actor

Retrieves a pointer to the `ClutterActor` that owns `meta`.

since: 13

###### clutter_actor_meta_get_enabled

Retrieves whether `meta` is enabled.

since: 13

###### clutter_actor_meta_get_name

Retrieves the name set using `clutter_actor_meta_set_name()`

since: 13

###### clutter_actor_meta_set_enabled

Sets whether `meta` should be enabled or not.

since: 13

###### clutter_actor_meta_set_name

Sets the name of `meta`.

since: 13

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

##### Properties inherited from ClutterGestureAction (4)

###### Clutter.GestureAction:n-touch-points

Number of touch points to trigger a gesture action.

since: 13

###### Clutter.GestureAction:threshold-trigger-distance-x

The horizontal trigger distance to be used by the action to either emit the `ClutterGestureAction::gesture-begin` signal or to emit the `ClutterGestureAction::gesture-cancel` signal.

since: 13

###### Clutter.GestureAction:threshold-trigger-distance-y

The vertical trigger distance to be used by the action to either emit the `ClutterGestureAction::gesture-begin` signal or to emit the `ClutterGestureAction::gesture-cancel` signal.

since: 13

###### Clutter.GestureAction:threshold-trigger-edge

The trigger edge to be used by the action to either emit the `ClutterGestureAction::gesture-begin` signal or to emit the `ClutterGestureAction::gesture-cancel` signal.

since: 13

##### Properties inherited from ClutterActorMeta (3)

###### Clutter.ActorMeta:actor

The `ClutterActor` attached to the `ClutterActorMeta` instance.

since: 13

###### Clutter.ActorMeta:enabled

Whether or not the `ClutterActorMeta` is enabled.

since: 13

###### Clutter.ActorMeta:name

The unique name to access the `ClutterActorMeta`.

since: 13

#### Signals

###### Clutter.RotateAction::rotate

The signal is emitted when a rotate gesture is recognized on the attached actor and when the gesture is cancelled (in this case with an angle value of 0).

since: 13

##### Signals inherited from ClutterGestureAction (4)

###### ClutterGestureAction::gesture-begin

The signal is emitted when the `ClutterActor` to which a `ClutterGestureAction` has been applied starts receiving a gesture.

since: 13

###### ClutterGestureAction::gesture-cancel

The signal is emitted when the ongoing gesture gets cancelled from the `ClutterGestureAction::gesture-progress` signal handler.

since: 13

###### ClutterGestureAction::gesture-end

The signal is emitted at the end of the gesture gesture, when the pointer’s button is released.

since: 13

###### ClutterGestureAction::gesture-progress

The signal is emitted for each motion event after the `ClutterGestureAction::gesture-begin` signal has been emitted.

since: 13

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0

#### Class structure

    struct ClutterRotateActionClass {
      /* no available fields */
    }

The `ClutterRotateActionClass` structure contains only private data.