ClutterBehaviourRotate

ClutterBehaviourRotate — A behaviour class to rotate actors

Synopsis




enum                ClutterRotateAxis;
enum                ClutterRotateDirection;
                    ClutterBehaviourRotate;
                    ClutterBehaviourRotateClass;
ClutterBehaviour*   clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
                                                         ClutterRotateAxis axis,
                                                         ClutterRotateDirection direction,
                                                         gdouble angle_begin,
                                                         gdouble angle_end);
ClutterBehaviour*   clutter_behaviour_rotate_newx       (ClutterAlpha *alpha,
                                                         ClutterRotateAxis axis,
                                                         ClutterRotateDirection direction,
                                                         ClutterFixed angle_begin,
                                                         ClutterFixed angle_end);
void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
                                                         ClutterRotateAxis axis);
ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);
void                clutter_behaviour_rotate_set_direction
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterRotateDirection direction);
ClutterRotateDirection clutter_behaviour_rotate_get_direction
                                                        (ClutterBehaviourRotate *rotate);
void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
                                                         gdouble angle_begin,
                                                         gdouble angle_end);
void                clutter_behaviour_rotate_set_boundsx
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterFixed angle_begin,
                                                         ClutterFixed angle_end);
void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
                                                         gdouble *angle_begin,
                                                         gdouble *angle_end);
void                clutter_behaviour_rotate_get_boundsx
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterFixed *angle_begin,
                                                         ClutterFixed *angle_end);


Object Hierarchy


  GObject
   +----ClutterBehaviour
         +----ClutterBehaviourRotate

Properties


  "angle-begin"              gdouble               : Read / Write
  "angle-end"                gdouble               : Read / Write
  "axis"                     ClutterRotateAxis     : Read / Write
  "direction"                ClutterRotateDirection  : Read / Write

Description

A ClutterBehaviourRotate rotate actors between a starting and ending angle on a given axis.

The ClutterBehaviourRotate is available since version 0.4.

Details

enum ClutterRotateAxis

typedef enum { /*< prefix=CLUTTER >*/
  CLUTTER_X_AXIS,
  CLUTTER_Y_AXIS,
  CLUTTER_Z_AXIS
} ClutterRotateAxis;


enum ClutterRotateDirection

typedef enum { /*< prefix=CLUTTER_ROTATE >*/
  CLUTTER_ROTATE_CW,
  CLUTTER_ROTATE_CCW
} ClutterRotateDirection;


ClutterBehaviourRotate

typedef struct _ClutterBehaviourRotate ClutterBehaviourRotate;


ClutterBehaviourRotateClass

typedef struct {
  ClutterBehaviourClass parent_class;
} ClutterBehaviourRotateClass;


clutter_behaviour_rotate_new ()

ClutterBehaviour*   clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
                                                         ClutterRotateAxis axis,
                                                         ClutterRotateDirection direction,
                                                         gdouble angle_begin,
                                                         gdouble angle_end);

Creates a new ClutterBehaviourRotate. This behaviour will rotate actors bound to it on axis, following direction, between angle_begin and angle_end.

alpha : a ClutterAlpha, or NULL
axis : the rotation axis
direction : the rotation direction
angle_begin : the starting angle
angle_end : the final angle
Returns : the newly created ClutterBehaviourRotate.

Since 0.4


clutter_behaviour_rotate_newx ()

ClutterBehaviour*   clutter_behaviour_rotate_newx       (ClutterAlpha *alpha,
                                                         ClutterRotateAxis axis,
                                                         ClutterRotateDirection direction,
                                                         ClutterFixed angle_begin,
                                                         ClutterFixed angle_end);

Creates a new ClutterBehaviourRotate. This is the fixed point version of clutter_behaviour_rotate_new().

alpha : a ClutterAlpha or NULL
axis : the rotation axis
direction : the rotation direction
angle_begin : the starting angle, in fixed point notation
angle_end : the final angle, in fixed point notation
Returns : the newly created ClutterBehaviourRotate.

Since 0.4


clutter_behaviour_rotate_set_axis ()

void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
                                                         ClutterRotateAxis axis);

Sets the axis used by the rotate behaviour.

Since 0.4


clutter_behaviour_rotate_get_axis ()

ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);

Retrieves the ClutterRotateAxis used by the rotate behaviour.

rotate : a ClutterBehaviourRotate
Returns : the rotation axis

Since 0.4


clutter_behaviour_rotate_set_direction ()

void                clutter_behaviour_rotate_set_direction
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterRotateDirection direction);

Sets the rotation direction used by the rotate behaviour.

rotate : a ClutterBehaviourRotate
direction : the rotation direction

Since 0.4


clutter_behaviour_rotate_get_direction ()

ClutterRotateDirection clutter_behaviour_rotate_get_direction
                                                        (ClutterBehaviourRotate *rotate);

Retrieves the ClutterRotateDirection used by the rotate behaviour.

rotate : a ClutterBehaviourRotate
Returns : the rotation direction

Since 0.4


clutter_behaviour_rotate_set_bounds ()

void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
                                                         gdouble angle_begin,
                                                         gdouble angle_end);

rotate :
angle_begin :
angle_end :

clutter_behaviour_rotate_set_boundsx ()

void                clutter_behaviour_rotate_set_boundsx
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterFixed angle_begin,
                                                         ClutterFixed angle_end);

rotate :
angle_begin :
angle_end :

clutter_behaviour_rotate_get_bounds ()

void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
                                                         gdouble *angle_begin,
                                                         gdouble *angle_end);

Retrieves the rotation boundaries of the rotate behaviour. This is the fixed point notation version of clutter_behaviour_rotate_get_bounds().

rotate : a ClutterBehaviourRotate
angle_begin : return value for the initial angle
angle_end : return value for the final angle

Since 0.4


clutter_behaviour_rotate_get_boundsx ()

void                clutter_behaviour_rotate_get_boundsx
                                                        (ClutterBehaviourRotate *rotate,
                                                         ClutterFixed *angle_begin,
                                                         ClutterFixed *angle_end);

rotate :
angle_begin :
angle_end :

Property Details

The "angle-begin" property

  "angle-begin"              gdouble               : Read / Write

The initial angle from whence the rotation should begin.

Allowed values: [0,359]

Default value: 0

Since 0.4


The "angle-end" property

  "angle-end"                gdouble               : Read / Write

The final angle to where the rotation should end.

Allowed values: [0,359]

Default value: 359

Since 0.4


The "axis" property

  "axis"                     ClutterRotateAxis     : Read / Write

The axis of rotation.

Default value: CLUTTER_Z_AXIS

Since 0.4


The "direction" property

  "direction"                ClutterRotateDirection  : Read / Write

The direction of the rotation.

Default value: CLUTTER_ROTATE_CW

Since 0.4