Top |
GObject ╰── GInitiallyUnowned ╰── ClutterActorMeta ╰── ClutterConstraint ╰── ClutterPathConstraint
ClutterPathConstraint is a simple constraint that modifies the allocation of the ClutterActor to which it has been applied using a ClutterPath.
By setting the “offset” property it is possible to control how far along the path the ClutterActor should be.
ClutterPathConstraint is available since Clutter 1.6.
ClutterConstraint * clutter_path_constraint_new (ClutterPath *path
,gfloat offset
);
Creates a new ClutterPathConstraint with the given path
and offset
Since 1.6
void clutter_path_constraint_set_path (ClutterPathConstraint *constraint
,ClutterPath *path
);
Sets the path
to be followed by the ClutterPathConstraint.
The constraint
will take ownership of the ClutterPath passed to this
function.
Since 1.6
ClutterPath *
clutter_path_constraint_get_path (ClutterPathConstraint *constraint
);
Retrieves a pointer to the ClutterPath used by constraint
.
the ClutterPath used by the
ClutterPathConstraint, or NULL
. The returned ClutterPath is owned
by the constraint and it should not be unreferenced.
[transfer none]
Since 1.6
void clutter_path_constraint_set_offset (ClutterPathConstraint *constraint
,gfloat offset
);
Sets the offset along the ClutterPath used by constraint
.
Since 1.6
gfloat
clutter_path_constraint_get_offset (ClutterPathConstraint *constraint
);
Retrieves the offset along the ClutterPath used by constraint
.
Since 1.6
typedef struct _ClutterPathConstraint ClutterPathConstraint;
ClutterPathConstraint is an opaque structure whose members cannot be directly accessed
Since 1.6
“offset”
property “offset” gfloat
The offset along the “path”, between -1.0 and 2.0.
Flags: Read / Write
Allowed values: [-1,2]
Default value: 0
Since 1.6
“path”
property“path” ClutterPath *
The ClutterPath used to constrain the position of an actor.
Flags: Read / Write
Since 1.6
“node-reached”
signalvoid user_function (ClutterPathConstraint *constraint, ClutterActor *actor, guint index, gpointer user_data)
The ::node-reached signal is emitted each time a “offset” value results in the actor passing a ClutterPathNode
constraint |
the ClutterPathConstraint that emitted the signal |
|
actor |
the ClutterActor using the |
|
index |
the index of the node that has been reached |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since 1.6