Top | ![]() |
![]() |
![]() |
![]() |
ClutterAnimatable * | animatable | Read / Write |
ClutterInterval * | interval | Read / Write |
gboolean | remove-on-complete | Read / Write |
GObject ╰── ClutterTimeline ╰── ClutterTransition ├── ClutterPropertyTransition ╰── ClutterTransitionGroup
ClutterTransition is an abstract subclass of ClutterTimeline that computes the interpolation between two values, stored by a ClutterInterval.
void clutter_transition_set_from (ClutterTransition *transition
,GType value_type
,...
);
Sets the initial value of the transition.
This is a convenience function that will either create the
ClutterInterval used by transition
, or will update it if
the “interval” is already set.
If transition
already has a “interval” set,
then value
must hold the same type, or a transformable type,
as the interval's “value-type” property.
This is a convenience function for the C API; language bindings
should use clutter_transition_set_from_value()
instead.
Since 1.12
void clutter_transition_set_from_value (ClutterTransition *transition
,const GValue *value
);
Sets the initial value of the transition.
This is a convenience function that will either create the
ClutterInterval used by transition
, or will update it if
the “interval” is already set.
This function will copy the contents of value
, so it is
safe to call g_value_unset()
after it returns.
If transition
already has a “interval” set,
then value
must hold the same type, or a transformable type,
as the interval's “value-type” property.
This function is meant to be used by language bindings.
Rename to: clutter_transition_set_from
Since 1.12
void clutter_transition_set_to (ClutterTransition *transition
,GType value_type
,...
);
Sets the final value of the transition.
This is a convenience function that will either create the
ClutterInterval used by transition
, or will update it if
the “interval” is already set.
If transition
already has a “interval” set,
then value
must hold the same type, or a transformable type,
as the interval's “value-type” property.
This is a convenience function for the C API; language bindings
should use clutter_transition_set_to_value()
instead.
Since 1.12
void clutter_transition_set_to_value (ClutterTransition *transition
,const GValue *value
);
Sets the final value of the transition.
This is a convenience function that will either create the
ClutterInterval used by transition
, or will update it if
the “interval” is already set.
This function will copy the contents of value
, so it is
safe to call g_value_unset()
after it returns.
If transition
already has a “interval” set,
then value
must hold the same type, or a transformable type,
as the interval's “value-type” property.
This function is meant to be used by language bindings.
Rename to: clutter_transition_set_to
Since 1.12
void clutter_transition_set_interval (ClutterTransition *transition
,ClutterInterval *interval
);
Sets the “interval” property using interval
.
The transition
will acquire a reference on the interval
, sinking
the floating flag on it if necessary.
Since 1.10
ClutterInterval *
clutter_transition_get_interval (ClutterTransition *transition
);
Retrieves the interval set using clutter_transition_set_interval()
a ClutterInterval, or NULL
; the returned
interval is owned by the ClutterTransition and it should not be freed
directly.
[transfer none]
Since 1.10
void clutter_transition_set_animatable (ClutterTransition *transition
,ClutterAnimatable *animatable
);
Sets the “animatable” property.
The transition
will acquire a reference to the animatable
instance,
and will call the ClutterTransitionClass.attached()
virtual function.
If an existing ClutterAnimatable is attached to transition
, the
reference will be released, and the ClutterTransitionClass.detached()
virtual function will be called.
Since 1.10
ClutterAnimatable *
clutter_transition_get_animatable (ClutterTransition *transition
);
Retrieves the ClutterAnimatable set using clutter_transition_set_animatable()
.
a ClutterAnimatable, or NULL
; the returned
animatable is owned by the ClutterTransition, and it should not be freed
directly.
[transfer none]
Since 1.10
void clutter_transition_set_remove_on_complete (ClutterTransition *transition
,gboolean remove_complete
);
Sets whether transition
should be detached from the ClutterAnimatable
set using clutter_transition_set_animatable()
when the
“completed” signal is emitted.
Since 1.10
gboolean
clutter_transition_get_remove_on_complete
(ClutterTransition *transition
);
Retrieves the value of the “remove-on-complete” property.
Since 1.10
typedef struct _ClutterTransition ClutterTransition;
The ClutterTransition structure contains private data and should only be accessed using the provided API.
Since 1.10
struct ClutterTransitionClass { void (* attached) (ClutterTransition *transition, ClutterAnimatable *animatable); void (* detached) (ClutterTransition *transition, ClutterAnimatable *animatable); void (* compute_value) (ClutterTransition *transition, ClutterAnimatable *animatable, ClutterInterval *interval, gdouble progress); };
The ClutterTransitionClass structure contains private data.
virtual function; called when a transition is attached to a ClutterAnimatable instance |
||
virtual function; called when a transition is detached from a ClutterAnimatable instance |
||
virtual function; called each frame to compute and apply the interpolation of the interval |
Since 1.10
“animatable”
property“animatable” ClutterAnimatable *
The ClutterAnimatable instance currently being animated.
Flags: Read / Write
Since 1.10
“interval”
property“interval” ClutterInterval *
The ClutterInterval used to describe the initial and final states of the transition.
Flags: Read / Write
Since 1.10
“remove-on-complete”
property “remove-on-complete” gboolean
Whether the ClutterTransition should be automatically detached from the “animatable” instance whenever the “stopped” signal is emitted.
The “remove-on-complete” property takes into account the value of the “repeat-count” property, and it only detaches the transition if the transition is not repeating.
Flags: Read / Write
Default value: FALSE
Since 1.10