cluttermm: Clutter::Animation Class Reference

Inheritance diagram for Clutter::Animation:
Collaboration diagram for Clutter::Animation:

Public Member Functions

virtual ~Animation ()
 
ClutterAnimation* gobj ()
 Provides access to the underlying C GObject. More...

 
const ClutterAnimation* gobj () const
 Provides access to the underlying C GObject. More...

 
ClutterAnimation* gobj_copy ()
 Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

 
void set_object (const Glib::RefPtr< Glib::Object >& object)
 Attaches animation to object. More...

 
Glib::RefPtr< const Glib::Objectget_object () const
 Retrieves the Object attached to animation. More...

 
void set_mode (gulong mode)
 Sets the animation mode of animation. More...

 
gulong get_mode () const
 Retrieves the animation mode of animation, as set by set_mode(). More...

 
void set_duration (guint msecs)
 Sets the duration of animation in milliseconds. More...

 
guint get_duration () const
 Retrieves the duration of animation, in milliseconds. More...

 
void set_loop (bool loop=true)
 Sets whether animation should loop over itself once finished. More...

 
bool get_loop () const
 Retrieves whether animation is looping. More...

 
void set_timeline (const Glib::RefPtr< Timeline >& timeline)
 Sets the Clutter::Timeline used by animation. More...

 
Glib::RefPtr< Timelineget_timeline () const
 Retrieves the Clutter::Timeline used by animation. More...

 
void set_alpha (const Glib::RefPtr< Alpha >& alpha)
 Sets alpha as the Clutter::Alpha used by animation. More...

 
Glib::RefPtr< Alphaget_alpha () const
 Retrieves the Clutter::Alpha used by animation. More...

 
void completed ()
 Emits the signal_completed() signal on animation. More...

 
Glib::RefPtr< Animationbind (const std::string& property_name, const Glib::ValueBase& final)
 Adds a single property with name property_name to the animation animation. More...

 
void bind_interval (const std::string& property_name, const Glib::RefPtr< Interval >& interval)
 Binds interval to the property_name of the Object attached to animation. More...

 
void update_interval (const std::string& property_name, const Glib::RefPtr< Interval >& interval)
 Changes the interval for property_name. More...

 
bool has_property (const std::string& property_name) const
 Checks whether animation is controlling property_name. More...

 
Glib::RefPtr< Animationupdate (const std::string& property_name, const Glib::ValueBase& final)
 Updates the final value of the interval for property_name. More...

 
void unbind_property (const std::string& property_name)
 Removes property_name from the list of animated properties. More...

 
Glib::RefPtr< Intervalget_interval (const std::string& property_name) const
 Retrieves the Clutter::Interval associated to property_name inside animation. More...

 
Glib::SignalProxy0< void > signal_started ()
 
Glib::SignalProxy0< void > signal_completed ()
 
Glib::PropertyProxy

< Glib::RefPtr< Glib::Object > > 
property_object ()
 Object to which the animation applies. More...

 
Glib::PropertyProxy_ReadOnly

< Glib::RefPtr< Glib::Object > > 
property_object () const
 Object to which the animation applies. More...

 
Glib::PropertyProxy< gulong > property_mode ()
 The mode of the animation. More...

 
Glib::PropertyProxy_ReadOnly

< gulong > 
property_mode () const
 The mode of the animation. More...

 
Glib::PropertyProxy< guint > property_duration ()
 Duration of the animation, in milliseconds. More...

 
Glib::PropertyProxy_ReadOnly

< guint > 
property_duration () const
 Duration of the animation, in milliseconds. More...

 
Glib::PropertyProxy< bool > property_loop ()
 Whether the animation should loop. More...

 
Glib::PropertyProxy_ReadOnly

< bool > 
property_loop () const
 Whether the animation should loop. More...

 
Glib::PropertyProxy

< Glib::RefPtr< Timeline > > 
property_timeline ()
 The timeline used by the animation. More...

 
Glib::PropertyProxy_ReadOnly

< Glib::RefPtr< Timeline > > 
property_timeline () const
 The timeline used by the animation. More...

 
Glib::PropertyProxy

< Glib::RefPtr< Alpha > > 
property_alpha ()
 The alpha used by the animation. More...

 
Glib::PropertyProxy_ReadOnly

< Glib::RefPtr< Alpha > > 
property_alpha () const
 The alpha used by the animation. More...

 

Static Public Member Functions

static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...

 
static Glib::RefPtr< Animationcreate ()
 

Protected Member Functions

 Animation ()
 
virtual void on_started ()
 This is a default handler for the signal signal_started(). More...

 
virtual void on_completed ()
 This is a default handler for the signal signal_completed(). More...

 

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Clutter::Animationwrap (ClutterAnimation* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...

 

Detailed Description

Constructor & Destructor Documentation

virtual Clutter::Animation::~Animation ( )
virtual
Clutter::Animation::Animation ( )
protected

Member Function Documentation

Glib::RefPtr<Animation> Clutter::Animation::bind ( const std::string property_name,
const Glib::ValueBase final 
)

Adds a single property with name property_name to the animation animation.

For more information about animations, see Clutter::Actor::animate().

This method returns the animation primarily to make chained calls convenient in language bindings.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameThe property to control.
finalThe final value of the property.
Returns
The animation itself.
void Clutter::Animation::bind_interval ( const std::string property_name,
const Glib::RefPtr< Interval >&  interval 
)

Binds interval to the property_name of the Object attached to animation.

The Clutter::Animation will take ownership of the passed Clutter::Interval. For more information about animations, see Clutter::Actor::animate().

If you need to update the interval instance use update_interval() instead.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameThe property to control.
intervalA Clutter::Interval.
Returns
The animation itself.
void Clutter::Animation::completed ( )

Emits the signal_completed() signal on animation.

When using this function with a Clutter::Animation created by the Clutter::Actor::animate() family of functions, animation will be unreferenced and it will not be valid anymore, unless Glib::object_ref() was called before calling this function or unless a reference was taken inside a handler for the Clutter::Animation::signal_completed() signal

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
static Glib::RefPtr<Animation> Clutter::Animation::create ( )
static
Glib::RefPtr<Alpha> Clutter::Animation::get_alpha ( ) const

Retrieves the Clutter::Alpha used by animation.

Since cluttermm 1.0:

Deprecated: 1.10: Use get_timeline() and Clutter::Timeline::get_progress_mode() instead.

Deprecated:
Use get_timeline() and set_progress_mode() instead.
Returns
The alpha object used by the animation.
guint Clutter::Animation::get_duration ( ) const

Retrieves the duration of animation, in milliseconds.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Returns
The duration of the animation.
Glib::RefPtr<Interval> Clutter::Animation::get_interval ( const std::string property_name) const

Retrieves the Clutter::Interval associated to property_name inside animation.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameName of the property.
Returns
A Clutter::Interval or 0 if no property with the same name was found. The returned interval is owned by the Clutter::Animation and should not be unreferenced.
bool Clutter::Animation::get_loop ( ) const

Retrieves whether animation is looping.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Returns
true if the animation is looping.
gulong Clutter::Animation::get_mode ( ) const

Retrieves the animation mode of animation, as set by set_mode().

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Returns
The mode for the animation.
Glib::RefPtr<const Glib::Object> Clutter::Animation::get_object ( ) const

Retrieves the Object attached to animation.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Returns
A Object.
Glib::RefPtr<Timeline> Clutter::Animation::get_timeline ( ) const

Retrieves the Clutter::Timeline used by animation.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Returns
The timeline used by the animation.
static GType Clutter::Animation::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

ClutterAnimation* Clutter::Animation::gobj ( )
inline

Provides access to the underlying C GObject.

const ClutterAnimation* Clutter::Animation::gobj ( ) const
inline

Provides access to the underlying C GObject.

ClutterAnimation* Clutter::Animation::gobj_copy ( )

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

bool Clutter::Animation::has_property ( const std::string property_name) const

Checks whether animation is controlling property_name.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameName of the property.
Returns
true if the property is animated by the Clutter::Animation, false otherwise.
virtual void Clutter::Animation::on_completed ( )
protectedvirtual

This is a default handler for the signal signal_completed().

virtual void Clutter::Animation::on_started ( )
protectedvirtual

This is a default handler for the signal signal_started().

Glib::PropertyProxy< Glib::RefPtr<Alpha> > Clutter::Animation::property_alpha ( )

The alpha used by the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Alpha> > Clutter::Animation::property_alpha ( ) const

The alpha used by the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< guint > Clutter::Animation::property_duration ( )

Duration of the animation, in milliseconds.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< guint > Clutter::Animation::property_duration ( ) const

Duration of the animation, in milliseconds.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Clutter::Animation::property_loop ( )

Whether the animation should loop.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Clutter::Animation::property_loop ( ) const

Whether the animation should loop.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< gulong > Clutter::Animation::property_mode ( )

The mode of the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< gulong > Clutter::Animation::property_mode ( ) const

The mode of the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Glib::Object> > Clutter::Animation::property_object ( )

Object to which the animation applies.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Glib::Object> > Clutter::Animation::property_object ( ) const

Object to which the animation applies.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Timeline> > Clutter::Animation::property_timeline ( )

The timeline used by the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Timeline> > Clutter::Animation::property_timeline ( ) const

The timeline used by the animation.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
void Clutter::Animation::set_alpha ( const Glib::RefPtr< Alpha >&  alpha)

Sets alpha as the Clutter::Alpha used by animation.

If alpha is not 0, the Clutter::Animation will take ownership of the Clutter::Alpha instance.

Since cluttermm 1.0:

Deprecated: 1.10: Use get_timeline() and Clutter::Timeline::set_progress_mode() instead.

Deprecated:
Use get_timeline() and set_progress_mode() instead.
Parameters
alphaA Clutter::Alpha, or 0 to unset the current Clutter::Alpha.
void Clutter::Animation::set_duration ( guint  msecs)

Sets the duration of animation in milliseconds.

This function will set Clutter::Animation::property_alpha() and Clutter::Animation::property_timeline() if needed.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
msecsThe duration in milliseconds.
void Clutter::Animation::set_loop ( bool  loop = true)

Sets whether animation should loop over itself once finished.

A looping Clutter::Animation will not emit the Clutter::Animation::signal_completed() signal when finished.

This function will set Clutter::Animation::property_alpha() and Clutter::Animation::property_timeline() if needed.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
looptrue if the animation should loop.
void Clutter::Animation::set_mode ( gulong  mode)

Sets the animation mode of animation.

The animation mode is a logical id, either coming from the Clutter::AnimationMode enumeration or the return value of Clutter::Alpha::register_func().

This function will also set Clutter::Animation::property_alpha() if needed.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
modeAn animation mode logical id.
void Clutter::Animation::set_object ( const Glib::RefPtr< Glib::Object > &  object)

Attaches animation to object.

The Clutter::Animation will take a reference on object.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
objectA Object.
void Clutter::Animation::set_timeline ( const Glib::RefPtr< Timeline >&  timeline)

Sets the Clutter::Timeline used by animation.

This function will take a reference on the passed timeline.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
timelineA Clutter::Timeline, or 0 to unset the current Clutter::Timeline.
Glib::SignalProxy0< void > Clutter::Animation::signal_completed ( )
Slot Prototype:
void on_my_completed()

The signal_completed() signal is emitted once the animation has been completed.

The animation instance is guaranteed to be valid for the entire duration of the signal emission chain.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Glib::SignalProxy0< void > Clutter::Animation::signal_started ( )
Slot Prototype:
void on_my_started()

The signal_started() signal is emitted once the animation has been started

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
void Clutter::Animation::unbind_property ( const std::string property_name)

Removes property_name from the list of animated properties.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameName of the property.
Glib::RefPtr<Animation> Clutter::Animation::update ( const std::string property_name,
const Glib::ValueBase final 
)

Updates the final value of the interval for property_name.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameName of the property.
finalThe final value of the property.
Returns
The animation itself.
void Clutter::Animation::update_interval ( const std::string property_name,
const Glib::RefPtr< Interval >&  interval 
)

Changes the interval for property_name.

The Clutter::Animation will take ownership of the passed Clutter::Interval.

Since cluttermm 1.0:
Deprecated: 1.12: Use Clutter::PropertyTransition instead
Deprecated:
Use PropertyTransition instead.
Parameters
property_nameName of the property.
intervalA Clutter::Interval.

Friends And Related Function Documentation

Glib::RefPtr< Clutter::Animation > wrap ( ClutterAnimation *  object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file:
  • cluttermm/animation.h