ClutterBehaviourBspline

typedef struct _ClutterBehaviourBspline ClutterBehaviourBspline;

ClutterBehaviourBspline contains only private data and should be accessed using the functions below.

Since 0.2

ClutterBehaviourBsplineClass

typedef struct {
  void (*knot_reached) (ClutterBehaviourBspline *bsplineb,
                        const ClutterKnot       *knot);
} ClutterBehaviourBsplineClass;

ClutterBehaviourBsplineClass contains only private data and should be accessed using the functions below.

Since 0.2

clutter_behaviour_bspline_new ()

ClutterBehaviour*   clutter_behaviour_bspline_new       (ClutterAlpha *alpha,
                                                         const ClutterKnot *knots,
                                                         guint n_knots);

Creates a new bezier spline behaviour. You can use this behaviour to drive actors along the bezier spline, described by the knots control points.

Bspline is defined by 3n + 1 points, n >=1; any trailing points passed into this function are stored internally and used during any subsequent clutter_behaviour_bspline_append_* operations.

Since 0.4

clutter_behaviour_bspline_append_knot ()

void                clutter_behaviour_bspline_append_knot
                                                        (ClutterBehaviourBspline *bs,
                                                         const ClutterKnot *knot);

Appends a ClutterKnot control point to the bezier spline bs. Note, that since a bezier is defined by 4 control points, the point gets stored in a temporary chache, and only when there are enough control points to create a new bezier curve will the bspline extended.

Since 0.4

clutter_behaviour_bspline_append_knots ()

void                clutter_behaviour_bspline_append_knots
                                                        (ClutterBehaviourBspline *bs,
                                                         const ClutterKnot *first_knot,
                                                         ...);

Appends a bezier spline defined by the last control point of bezier spline bs and the array of ClutterKnot control points to the orginal bezier spline bs.

Since 0.6

clutter_behaviour_bspline_truncate ()

void                clutter_behaviour_bspline_truncate  (ClutterBehaviourBspline *bs,
                                                         guint offset);

Truncates the bezier spline at the control point; if the control point at offset is not one of the on-curve points, the bspline will be truncated at the nearest preceeding on-curve point.

Since 0.4

clutter_behaviour_bspline_join ()

void                clutter_behaviour_bspline_join      (ClutterBehaviourBspline *bs1,
                                                         ClutterBehaviourBspline *bs2);

Joins a copy of bezier spline bs2 onto the end of bezier spline bs1; bs2 is not modified.

Since 0.4

clutter_behaviour_bspline_split ()

ClutterBehaviour*   clutter_behaviour_bspline_split     (ClutterBehaviourBspline *bs,
                                                         guint offset);

Splits a bezier spline into two at the control point at offset; if the control point at offset is not one of the on-curve bezier points, the bspline will be split at the nearest on-curve point before the offset. The original bspline is shortened appropriately.

Since 0.4

clutter_behaviour_bspline_clear ()

void                clutter_behaviour_bspline_clear     (ClutterBehaviourBspline *bs);

Empties a bspline.

Since 0.4

clutter_behaviour_bspline_adjust ()

void                clutter_behaviour_bspline_adjust    (ClutterBehaviourBspline *bs,
                                                         guint offset,
                                                         ClutterKnot *knot);

Change the coordinaces of control point at index to those represented by the knot.

Since 0.4

clutter_behaviour_bspline_set_origin ()

void                clutter_behaviour_bspline_set_origin
                                                        (ClutterBehaviourBspline *bs,
                                                         ClutterKnot *knot);

Sets the origin of the bezier to the point represented by knot. (Initially the origin of a bspline is given by the position of the first control point of the first bezier curve.)

Since 0.4

clutter_behaviour_bspline_get_origin ()

void                clutter_behaviour_bspline_get_origin
                                                        (ClutterBehaviourBspline *bs,
                                                         ClutterKnot *knot);

Gets the origin of the bezier.

Since 0.4

The "knot-reached" signal

void                user_function                      (ClutterBehaviourBspline *pathb,
                                                        ClutterKnot             *knot,
                                                        gpointer                 user_data)      : Run Last

This signal is emitted at the end of each frame.

Since 0.2