![]() |
![]() |
![]() |
Clutter Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
ClutterBehaviourEllipseClutterBehaviourEllipse — A behaviour interpolating position along an ellipse |
struct ClutterBehaviourEllipse; struct ClutterBehaviourEllipseClass; ClutterBehaviour * clutter_behaviour_ellipse_new (ClutterAlpha *alpha
,gint x
,gint y
,gint width
,gint height
,ClutterRotateDirection direction
,gdouble start
,gdouble end
); void clutter_behaviour_ellipse_set_center (ClutterBehaviourEllipse *self
,gint x
,gint y
); void clutter_behaviour_ellipse_get_center (ClutterBehaviourEllipse *self
,gint *x
,gint *y
); void clutter_behaviour_ellipse_set_angle_start (ClutterBehaviourEllipse *self
,gdouble angle_start
); gdouble clutter_behaviour_ellipse_get_angle_start (ClutterBehaviourEllipse *self
); void clutter_behaviour_ellipse_set_angle_end (ClutterBehaviourEllipse *self
,gdouble angle_end
); gdouble clutter_behaviour_ellipse_get_angle_end (ClutterBehaviourEllipse *self
); void clutter_behaviour_ellipse_set_angle_tilt (ClutterBehaviourEllipse *self
,ClutterRotateAxis axis
,gdouble angle_tilt
); gdouble clutter_behaviour_ellipse_get_angle_tilt (ClutterBehaviourEllipse *self
,ClutterRotateAxis axis
); void clutter_behaviour_ellipse_set_height (ClutterBehaviourEllipse *self
,gint height
); gint clutter_behaviour_ellipse_get_height (ClutterBehaviourEllipse *self
); void clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self
,gint width
); gint clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self
); void clutter_behaviour_ellipse_set_tilt (ClutterBehaviourEllipse *self
,gdouble angle_tilt_x
,gdouble angle_tilt_y
,gdouble angle_tilt_z
); void clutter_behaviour_ellipse_get_tilt (ClutterBehaviourEllipse *self
,gdouble *angle_tilt_x
,gdouble *angle_tilt_y
,gdouble *angle_tilt_z
); void clutter_behaviour_ellipse_set_direction (ClutterBehaviourEllipse *self
,ClutterRotateDirection direction
); ClutterRotateDirection clutter_behaviour_ellipse_get_direction (ClutterBehaviourEllipse *self
);
"angle-end" gdouble : Read / Write "angle-start" gdouble : Read / Write "angle-tilt-x" gdouble : Read / Write "angle-tilt-y" gdouble : Read / Write "angle-tilt-z" gdouble : Read / Write "center" ClutterKnot* : Read / Write "direction" ClutterRotateDirection : Read / Write "height" gint : Read / Write "width" gint : Read / Write
ClutterBehaviourEllipse interpolates actors along a path defined by an ellipse.
When applying an ellipse behaviour to an actor, the behaviour will update the actor's position and depth and set them to what is dictated by the ellipses initial position.
struct ClutterBehaviourEllipse;
ClutterBehaviourEllipse
is deprecated and should not be used in newly-written code. 1.6
The ClutterBehaviourEllipse struct contains only private data and should be accessed using the provided API
Since 0.4
struct ClutterBehaviourEllipseClass { };
ClutterBehaviourEllipseClass
is deprecated and should not be used in newly-written code. 1.6
The ClutterBehaviourEllipseClass struct contains only private data
Since 0.4
ClutterBehaviour * clutter_behaviour_ellipse_new (ClutterAlpha *alpha
,gint x
,gint y
,gint width
,gint height
,ClutterRotateDirection direction
,gdouble start
,gdouble end
);
Creates a behaviour that drives actors along an elliptical path with
given center, width and height; the movement starts at start
degrees (with 0 corresponding to 12 o'clock) and ends at end
degrees. Angles greated than 360 degrees get clamped to the canonical
interval <0, 360); if start
is equal to end
, the behaviour will
rotate by exacly 360 degrees.
If alpha
is not NULL
, the ClutterBehaviour will take ownership
of the ClutterAlpha instance. In the case when alpha
is NULL
,
it can be set later with clutter_behaviour_set_alpha()
.
|
a ClutterAlpha instance, or NULL . [allow-none]
|
|
x coordinace of the center |
|
y coordiance of the center |
|
width of the ellipse |
|
height of the ellipse |
|
ClutterRotateDirection of rotation |
|
angle in degrees at which movement starts, between 0 and 360 |
|
angle in degrees at which movement ends, between 0 and 360 |
Returns : |
the newly created ClutterBehaviourEllipse |
Since 0.4
void clutter_behaviour_ellipse_set_center (ClutterBehaviourEllipse *self
,gint x
,gint y
);
Sets the center of the elliptical path to the point represented by knot.
|
a ClutterBehaviourEllipse |
|
x coordinace of centre |
|
y coordinace of centre |
Since 0.4
void clutter_behaviour_ellipse_get_center (ClutterBehaviourEllipse *self
,gint *x
,gint *y
);
Gets the center of the elliptical path path.
|
a ClutterBehaviourEllipse |
|
return location for the X coordinate of the center, or NULL . [out]
|
|
return location for the Y coordinate of the center, or NULL . [out]
|
Since 0.4
void clutter_behaviour_ellipse_set_angle_start (ClutterBehaviourEllipse *self
,gdouble angle_start
);
Sets the angle at which movement starts; angles >= 360 degress get clamped to the canonical interval <0, 360).
|
a ClutterBehaviourEllipse |
|
angle at which movement starts in degrees, between 0 and 360. |
Since 0.6
gdouble clutter_behaviour_ellipse_get_angle_start
(ClutterBehaviourEllipse *self
);
Gets the angle at which movements starts.
|
a ClutterBehaviourEllipse |
Returns : |
angle in degrees |
Since 0.6
void clutter_behaviour_ellipse_set_angle_end (ClutterBehaviourEllipse *self
,gdouble angle_end
);
Sets the angle at which movement ends; angles >= 360 degress get clamped to the canonical interval <0, 360).
|
a ClutterBehaviourEllipse |
|
angle at which movement ends in degrees, between 0 and 360. |
Since 0.4
gdouble clutter_behaviour_ellipse_get_angle_end
(ClutterBehaviourEllipse *self
);
Gets the at which movements ends.
|
a ClutterBehaviourEllipse |
Returns : |
angle in degrees |
Since 0.4
void clutter_behaviour_ellipse_set_angle_tilt (ClutterBehaviourEllipse *self
,ClutterRotateAxis axis
,gdouble angle_tilt
);
Sets the angle at which the ellipse should be tilted around it's center.
|
a ClutterBehaviourEllipse |
|
a ClutterRotateAxis |
|
tilt of the elipse around the center in the given axis in degrees. |
Since 0.4
gdouble clutter_behaviour_ellipse_get_angle_tilt (ClutterBehaviourEllipse *self
,ClutterRotateAxis axis
);
Gets the tilt of the ellipse around the center in the given axis.
|
a ClutterBehaviourEllipse |
|
a ClutterRotateAxis |
Returns : |
angle in degrees. |
Since 0.4
void clutter_behaviour_ellipse_set_height (ClutterBehaviourEllipse *self
,gint height
);
Sets the height of the elliptical path.
|
a ClutterBehaviourEllipse |
|
height of the ellipse |
Since 0.4
gint clutter_behaviour_ellipse_get_height
(ClutterBehaviourEllipse *self
);
Gets the height of the elliptical path.
|
a ClutterBehaviourEllipse |
Returns : |
the height of the path |
Since 0.4
void clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self
,gint width
);
Sets the width of the elliptical path.
|
a ClutterBehaviourEllipse |
|
width of the ellipse |
Since 0.4
gint clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self
);
Gets the width of the elliptical path.
|
a ClutterBehaviourEllipse |
Returns : |
the width of the path |
Since 0.4
void clutter_behaviour_ellipse_set_tilt (ClutterBehaviourEllipse *self
,gdouble angle_tilt_x
,gdouble angle_tilt_y
,gdouble angle_tilt_z
);
Sets the angles at which the ellipse should be tilted around it's center.
|
a ClutterBehaviourEllipse |
|
tilt of the elipse around the center in X axis in degrees. |
|
tilt of the elipse around the center in Y axis in degrees. |
|
tilt of the elipse around the center in Z axis in degrees. |
Since 0.4
void clutter_behaviour_ellipse_get_tilt (ClutterBehaviourEllipse *self
,gdouble *angle_tilt_x
,gdouble *angle_tilt_y
,gdouble *angle_tilt_z
);
Gets the tilt of the ellipse around the center in Y axis.
|
a ClutterBehaviourEllipse |
|
return location for tilt angle on the X axis, or NULL . [out]
|
|
return location for tilt angle on the Y axis, or NULL . [out]
|
|
return location for tilt angle on the Z axis, or NULL . [out]
|
Since 0.4
void clutter_behaviour_ellipse_set_direction (ClutterBehaviourEllipse *self
,ClutterRotateDirection direction
);
Sets the rotation direction used by the ellipse behaviour.
|
a ClutterBehaviourEllipse |
|
the rotation direction |
Since 0.4
ClutterRotateDirection clutter_behaviour_ellipse_get_direction
(ClutterBehaviourEllipse *self
);
Retrieves the ClutterRotateDirection used by the ellipse behaviour.
|
a ClutterBehaviourEllipse |
Returns : |
the rotation direction |
Since 0.4
"angle-end"
property "angle-end" gdouble : Read / Write
The final angle to where the rotation should end.
Allowed values: [0,360]
Default value: 0
Since 0.4
"angle-start"
property "angle-start" gdouble : Read / Write
The initial angle from where the rotation should start.
Allowed values: [0,360]
Default value: 0
Since 0.4
"angle-tilt-x"
property "angle-tilt-x" gdouble : Read / Write
The tilt angle for the rotation around center in X axis
Allowed values: [0,360]
Default value: 360
Since 0.4
"angle-tilt-y"
property "angle-tilt-y" gdouble : Read / Write
The tilt angle for the rotation around center in Y axis
Allowed values: [0,360]
Default value: 360
Since 0.4
"angle-tilt-z"
property "angle-tilt-z" gdouble : Read / Write
The tilt angle for the rotation on the Z axis
Allowed values: [0,360]
Default value: 360
Since 0.4
"direction"
property"direction" ClutterRotateDirection : Read / Write
The direction of the rotation.
Default value: CLUTTER_ROTATE_CW
Since 0.4
"height"
property "height" gint : Read / Write
Height of the ellipse, in pixels
Allowed values: >= 0
Default value: 50
Since 0.4