gnomemm r2135 - in cluttermm/trunk: . clutter clutter/src tests tools/extra_defs_gen tools/m4
- From: siavashs svn gnome org
- To: svn-commits-list gnome org
- Subject: gnomemm r2135 - in cluttermm/trunk: . clutter clutter/src tests tools/extra_defs_gen tools/m4
- Date: Sat, 28 Mar 2009 15:18:02 +0000 (UTC)
Author: siavashs
Date: Sat Mar 28 15:18:02 2009
New Revision: 2135
URL: http://svn.gnome.org/viewvc/gnomemm?rev=2135&view=rev
Log:
Added Clutter::Animation and Clutter::Interval, Regenerated .defs
* clutter/src/animation.ccg:
* clutter/src/animation.hg: Added Clutter::Animation
* clutter/src/interval.ccg:
* clutter/src/interval.hg: Added Clutter::Interval
* clutter/cluttermm.h:
* clutter/src/Makefile_list_of_hg.am_fragment:
* clutter/src/clutter_docs.xml: Regenerated
* clutter/src/clutter_enums.defs: Regenerated
* clutter/src/clutter_methods.defs: Regenerated
* clutter/src/clutter_signals.defs: Regenerated and modified by hand to
Support all Events
* tests/Makefile.am:
* tests/test-interval-creation.cc: Test Clutter::Interval creation
* tools/extra_defs_gen/generate_defs_clutter.cc:
* tools/m4/convert_cluttermm.m4:
Added:
cluttermm/trunk/clutter/src/animation.ccg
cluttermm/trunk/clutter/src/animation.hg
cluttermm/trunk/clutter/src/interval.ccg
cluttermm/trunk/clutter/src/interval.hg
cluttermm/trunk/tests/test-interval-creation.cc
Modified:
cluttermm/trunk/ChangeLog
cluttermm/trunk/clutter/cluttermm.h
cluttermm/trunk/clutter/src/Makefile_list_of_hg.am_fragment
cluttermm/trunk/clutter/src/clutter_docs.xml
cluttermm/trunk/clutter/src/clutter_enums.defs
cluttermm/trunk/clutter/src/clutter_methods.defs
cluttermm/trunk/clutter/src/clutter_signals.defs
cluttermm/trunk/tests/Makefile.am
cluttermm/trunk/tools/extra_defs_gen/generate_defs_clutter.cc
cluttermm/trunk/tools/m4/convert_cluttermm.m4
Modified: cluttermm/trunk/clutter/cluttermm.h
==============================================================================
--- cluttermm/trunk/clutter/cluttermm.h (original)
+++ cluttermm/trunk/clutter/cluttermm.h Sat Mar 28 15:18:02 2009
@@ -29,6 +29,7 @@
#include <cluttermm/actor.h>
#include <cluttermm/alpha.h>
+#include <cluttermm/animation.h>
#include <cluttermm/behaviour.h>
#include <cluttermm/behaviour-depth.h>
#include <cluttermm/behaviour-ellipse.h>
@@ -42,6 +43,7 @@
#include <cluttermm/frame-source.h>
#include <cluttermm/group.h>
#include <cluttermm/init.h>
+#include <cluttermm/interval.h>
#include <cluttermm/main.h>
#include <cluttermm/media.h>
#include <cluttermm/path.h>
Modified: cluttermm/trunk/clutter/src/Makefile_list_of_hg.am_fragment
==============================================================================
--- cluttermm/trunk/clutter/src/Makefile_list_of_hg.am_fragment (original)
+++ cluttermm/trunk/clutter/src/Makefile_list_of_hg.am_fragment Sat Mar 28 15:18:02 2009
@@ -5,6 +5,7 @@
files_hg = \
actor.hg \
alpha.hg \
+animation.hg \
behaviour.hg \
behaviour-depth.hg \
behaviour-ellipse.hg \
@@ -17,6 +18,7 @@
color.hg \
container.hg \
group.hg \
+interval.hg \
media.hg \
path.hg \
rectangle.hg \
Added: cluttermm/trunk/clutter/src/animation.ccg
==============================================================================
--- (empty file)
+++ cluttermm/trunk/clutter/src/animation.ccg Sat Mar 28 15:18:02 2009
@@ -0,0 +1,24 @@
+/* Copyright (C) 2007 The cluttermm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free
+ * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include <clutter/clutter.h>
+
+namespace Clutter
+{
+
+} //namespace Clutter
+
Added: cluttermm/trunk/clutter/src/animation.hg
==============================================================================
--- (empty file)
+++ cluttermm/trunk/clutter/src/animation.hg Sat Mar 28 15:18:02 2009
@@ -0,0 +1,67 @@
+/* Copyright (C) 2009 The cluttermm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free
+ * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include <glibmm/object.h>
+#include <cluttermm/alpha.h>
+#include <cluttermm/actor.h>
+#include <cluttermm/interval.h>
+#include <cluttermm/timeline.h>
+#include <clutter/clutter.h>
+
+_DEFS(cluttermm,clutter)
+_PINCLUDE(glibmm/private/object_p.h)
+
+namespace Clutter
+{
+
+class Animation : public Glib::Object
+{
+
+ _CLASS_GOBJECT(Animation, ClutterAnimation, CLUTTER_ANIMATION, Glib::Object, GObject)
+ _DERIVES_INITIALLY_UNOWNED()
+
+protected:
+ _CTOR_DEFAULT()
+
+public:
+ _WRAP_CREATE()
+
+ _WRAP_METHOD(void set_object(const Glib::RefPtr<Glib::Object>& object), clutter_animation_set_object)
+ _WRAP_METHOD(Glib::RefPtr<Glib::Object> get_object(), clutter_animation_get_object)
+ _WRAP_METHOD(Glib::RefPtr<const Glib::Object> get_object() const, clutter_animation_get_object)
+ _WRAP_METHOD(void set_mode(gulong mode), clutter_animation_set_mode)
+ _WRAP_METHOD(gulong get_mode() const, clutter_animation_get_mode)
+ _WRAP_METHOD(void set_duration(int msecs), clutter_animation_set_duration)
+ _WRAP_METHOD(guint get_duration() const, clutter_animation_get_duration)
+ _WRAP_METHOD(void set_loop(bool loop=true), clutter_animation_set_loop)
+ _WRAP_METHOD(bool get_loop() const, clutter_animation_get_loop)
+ _WRAP_METHOD(void set_timeline(const Glib::RefPtr<Timeline>& timeline), clutter_animation_set_timeline)
+ _WRAP_METHOD(Glib::RefPtr<Timeline> get_timeline() const, clutter_animation_get_timeline)
+ _WRAP_METHOD(void set_alpha(const Glib::RefPtr<Alpha>& alpha), clutter_animation_set_alpha)
+ _WRAP_METHOD(Glib::RefPtr<Alpha> get_alpha() const, clutter_animation_get_alpha)
+ _WRAP_METHOD(void completed(), clutter_animation_completed)
+ _WRAP_METHOD(Glib::RefPtr<Animation> bind(const std::string& property_name, const Glib::ValueBase& final), clutter_animation_bind)
+ _WRAP_METHOD(void bind_interval(const std::string& property_name, const Glib::RefPtr<Interval>& interval), clutter_animation_bind_interval)
+ _WRAP_METHOD(void update_interval(const std::string& property_name, const Glib::RefPtr<Interval>& interval), clutter_animation_update_interval)
+ _WRAP_METHOD(bool has_property(const std::string& property_name) const, clutter_animation_has_property)
+ _WRAP_METHOD(void unbind_property(const std::string& property_name), clutter_animation_unbind_property)
+ _WRAP_METHOD(Glib::RefPtr<Interval> get_interval(const std::string& property_name) const, clutter_animation_get_interval)
+
+ _WRAP_SIGNAL(void completed(), "completed")
+};
+
+} // namespace Clutter
Modified: cluttermm/trunk/clutter/src/clutter_docs.xml
==============================================================================
--- cluttermm/trunk/clutter/src/clutter_docs.xml (original)
+++ cluttermm/trunk/clutter/src/clutter_docs.xml Sat Mar 28 15:18:02 2009
@@ -1,4 +1,20 @@
<root>
+<function name="clutter_do_event">
+<description>
+Processes an event. This function should never be called by applications.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_value_get_unit">
<description>
Gets the #ClutterUnit&lt;!-- --&gt;s contained in @value.
@@ -33,55 +49,104 @@
<return></return>
</function>
-<function name="clutter_event_get">
+<function name="cogl_pango_font_map_create_context">
<description>
-Pops an event off the event queue. Applications should not need to call
-this.
+Creates a new #PangoContext from the passed font map.
</description>
<parameters>
+<parameter name="fm">
+<parameter_description> a #CoglPangoFontMap
+</parameter_description>
+</parameter>
</parameters>
-<return> A #ClutterEvent or NULL if queue empty
+<return> the newly created #PangoContext
-Since: 0.4
+Since: 1.0
</return>
</function>
-<function name="clutter_score_append">
+<function name="clutter_actor_animate_with_timeline">
<description>
-Appends a timeline to another one existing in the score; the newly
-appended timeline will be started when @parent is complete.
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite duration given by @timeline and a speed given by the @mode.
-If @parent is %NULL, the new #ClutterTimeline will be started when
-clutter_score_start() is called.
+See clutter_actor_animate() for further details.
-#ClutterScore will take a reference on @timeline.
+This function is useful if you want to use an existing timeline
+to animate @actor.
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="parent">
-<parameter_description> a #ClutterTimeline in the score, or %NULL
+<parameter name="mode">
+<parameter_description> an animation mode logical id
</parameter_description>
</parameter>
<parameter name="timeline">
<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of a property
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> a %NULL terminated list of property names and
+property values
+</parameter_description>
+</parameter>
</parameters>
-<return> the id of the #ClutterTimeline inside the score, or
-0 on failure. The returned id can be used with clutter_score_remove()
-or clutter_score_get_timeline().
+<return> (transfer none): a #ClutterAnimation object. The object is
+owned by the #ClutterActor and should not be unreferenced with
+g_object_unref()
-Since: 0.6
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_event_get">
+<description>
+Pops an event off the event queue. Applications should not need to call
+this.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #ClutterEvent or NULL if queue empty
+
+Since: 0.4
</return>
</function>
+<function name="clutter_interval_set_initial_value">
+<description>
+Sets the initial value of @interval to @value. The value is copied
+inside the #ClutterInterval.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="ClutterModelIter">
<description>
The row number to which this iter points to.
@@ -94,128 +159,224 @@
<return></return>
</function>
-<function name="clutter_actor_get_shader">
+<function name="clutter_timeline_start">
<description>
-Queries the currently set #ClutterShader on @self.
+Starts the #ClutterTimeline playing.
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_group_get_children">
+<description>
+Get a list containing all actors contained in the group.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter_description> A #ClutterGroup
</parameter_description>
</parameter>
</parameters>
-<return> The currently set #ClutterShader or %NULL if no
-shader is set.
+<return> A list of #ClutterActors. You should free the returned
+list using g_list_free() when finished using it.
-Since: 0.6
+ Deprecated: 0.4: This function is obsolete, use
+clutter_container_get_children() instead.
</return>
</function>
-<function name="json_array_get_element">
+<function name="clutter_media_set_audio_volume">
<description>
-Retrieves the #JsonNode containing the value of the element at @index_
-inside a #JsonArray.
+Sets the playback volume of @media to @volume.
+Since: 1.0
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="volume">
+<parameter_description> the volume as a double between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the #JsonNode at the requested index
-</return>
+<return></return>
</function>
-<function name="clutter_label_get_alignment">
+<function name="clutter_path_to_cairo_path">
<description>
-Return value: The label's #PangoAlignment
+Add the nodes of the ClutterPath to the path in the Cairo context.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="cr">
+<parameter_description> a Cairo context
</parameter_description>
</parameter>
</parameters>
-<return> The label's #PangoAlignment
+<return></return>
+</function>
-Since 0.2
-</return>
+<function name="clutter_value_set_shader_matrix">
+<description>
+Sets @matrix as the contents of @value. The passed #GValue
+must have been initialized using %CLUTTER_TYPE_SHADER_MATRIX.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> number of floating point values in @floats
+</parameter_description>
+</parameter>
+<parameter name="matrix">
+<parameter_description> a matrix of floating point values
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="clutter_actor_raise">
+<function name="clutter_timeout_pool_remove">
<description>
-Puts @self above @below.
+Removes a timeout function with @id from the timeout pool. The id
+is the same returned when adding a function to the timeout pool with
+clutter_timeout_pool_add().
-Both actors must have the same parent.
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="pool">
+<parameter_description> a #ClutterTimeoutPool
</parameter_description>
</parameter>
-<parameter name="below">
-<parameter_description> A #ClutterActor to raise above.
+<parameter name="id">
+<parameter_description> the id of the timeout to remove
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_timeline_remove_marker">
+<function name="clutter_text_set_max_length">
<description>
-Removes @marker_name, if found, from @timeline.
+Sets the maximum allowed length of the contents of the actor. If the
+current contents are longer than the given length, then they will be
+truncated to fit.
-Since: 0.8
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="marker_name">
-<parameter_description> the name of the marker to remove
+<parameter name="max">
+<parameter_description> the maximum number of characters allowed in the text actor; 0
+to disable or -1 to set the length of the current string
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="CLUTTER_ALPHA_RAMP">
+<function name="clutter_media_set_uri">
<description>
-Convenience symbol for clutter_ramp_func().
+Sets the URI of @media to @uri.
Since: 0.2
</description>
<parameters>
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> the URI of the media stream
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_timeline_get_current_frame">
+<function name="clutter_glx_texture_pixmap_new_with_window">
<description>
-Request the current frame number of the timeline.
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> the X window to which this texture should be bound
+</parameter_description>
+</parameter>
+</parameters>
+<return> A new #ClutterGLXTexturePixmap bound to the given X window
+
+Since: 0.8
+</return>
+</function>
+
+<function name="cogl_pango_font_map_clear_glyph_cache">
+<description>
+Clears the glyph cache for @fm.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="fm">
+<parameter_description> a #CoglPangoFontMap
</parameter_description>
</parameter>
</parameters>
-<return> current frame number
+<return></return>
+</function>
+
+<function name="clutter_stage_get_actor_at_pos">
+<description>
+Checks the scene at the coordinates @x and @y and returns a pointer
+to the #ClutterActor at those coordinates.
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate to check
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the actor at the specified coordinates, if any
</return>
</function>
@@ -250,24 +411,23 @@
</return>
</function>
-<function name="clutter_clone_texture_set_parent_texture">
+<function name="clutter_text_get_line_alignment">
<description>
-Sets the parent texture cloned by the #ClutterCloneTexture.
+Retrieves the alignment of a #ClutterText, as set by
+clutter_text_set_line_alignment().
-Since: 0.2
</description>
<parameters>
-<parameter name="clone">
-<parameter_description> a #ClutterCloneTexture
-</parameter_description>
-</parameter>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture or %NULL
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #PangoAlignment
+
+Since 1.0
+</return>
</function>
<function name="clutter_stage_get_use_fog">
@@ -288,27 +448,6 @@
</return>
</function>
-<function name="clutter_stage_get_fogx">
-<description>
-Retrieves the current depth cueing settings from the stage. This is the
-fixed point version of clutter_stage_get_fog().
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="fog">
-<parameter_description> return location for a #ClutterFog structure
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_ellipse_get_direction">
<description>
Retrieves the #ClutterRotateDirection used by the ellipse behaviour.
@@ -327,82 +466,81 @@
</return>
</function>
-<function name="clutter_alpha_set_timeline">
+<function name="clutter_timeline_get_speed">
<description>
-Binds @alpha to @timeline.
+Gets the frames per second played by @timeline
-Since: 0.2
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
-</parameter_description>
-</parameter>
<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the number of frames per second.
+</return>
</function>
-<function name="clutter_label_set_justify">
+<function name="clutter_value_set_fixed">
<description>
-Sets whether the text of the @label actor should be justified
-on both margins. This setting is ignored if Clutter is compiled
-against Pango &lt; 1.18.
+Sets @value to @fixed_.
-Since: 0.6
+Since: 0.8
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="value">
+<parameter_description> a #GValue initialized to %COGL_TYPE_FIXED
</parameter_description>
</parameter>
-<parameter name="justify">
-<parameter_description> whether the text should be justified
+<parameter name="fixed_">
+<parameter_description> the fixed point value to set
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_value_set_fixed">
+<function name="clutter_path_replace_node">
<description>
-Sets @value to @fixed_.
+Replaces the node at offset @index_ with @node.
-Since: 0.8
+Since: 1.0
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to #CLUTTER_TYPE_FIXED
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="fixed_">
-<parameter_description> the fixed point value to set
+<parameter name="index_">
+<parameter_description> index to the existing node
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> the replacement node
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_get_visibility">
+<function name="clutter_clone_new">
<description>
-Return value: %TRUE if the contents of the entry are displayed as plaintext.
+Creates a new #ClutterActor which clones @source/
+
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="source">
+<parameter_description> a #ClutterActor, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the contents of the entry are displayed as plaintext.
+<return> the newly created #ClutterClone
-Since: 0.4
+Since: 1.0
</return>
</function>
@@ -476,26 +614,60 @@
<return></return>
</function>
-<function name="clutter_stage_set_key_focus">
+<function name="clutter_path_new">
<description>
-Sets the key focus on @actor. An actor with key focus will receive
-all the key events. If @actor is %NULL, the stage will receive
-focus.
+Creates a new #ClutterPath instance with no nodes.
+
+The object has a floating reference so if you add it to a
+#ClutterBehaviourPath then you do not need to unref it.
-Since: 0.6
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
+</parameters>
+<return> the newly created #ClutterPath
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_actor_animate_with_alpha">
+<description>
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite behaviour given by the passed @alpha.
+
+See clutter_actor_animate() for further details.
+
+This function is useful if you want to use an existing #ClutterAlpha
+to animate @actor.
+
+
+</description>
+<parameters>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> the actor to set key focus to, or %NULL
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of a property
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> a %NULL terminated list of property names and
+property values
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #ClutterAnimation object. The object is owned by the
+#ClutterActor and should not be unreferenced with g_object_unref()
+
+Since: 1.0
+</return>
</function>
<function name="clutter_get_keyboard_grab">
@@ -506,7 +678,7 @@
</description>
<parameters>
</parameters>
-<return> the actor currently holding the keyboard grab, or NULL if there is no grab.
+<return> (transfer none): the actor currently holding the keyboard grab, or NULL if there is no grab.
Since: 0.6
</return>
@@ -525,6 +697,9 @@
Inside Clutter, every #ClutterTimeline share the same timeout pool, unless
the CLUTTER_TIMELINE=no-pool environment variable is set.
+#ClutterTimeoutPool is part of the #ClutterTimeline implementation
+and should not be used by application developers.
+
</description>
<parameters>
@@ -534,72 +709,111 @@
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterTimeoutPool
+<return> the newly created #ClutterTimeoutPool. The created pool
+is owned by the GLib default context and will be automatically
+destroyed when the context is destroyed. It is possible to force
+the destruction of the timeout pool using g_source_destroy()
Since: 0.4
</return>
</function>
-<function name="clutter_texture_set_filter_quality">
+<function name="clutter_actor_animate_with_timelinev">
<description>
-Sets the filter quality when scaling a texture. The quality is an
-enumeration currently the following values are supported:
-CLUTTER_TEXTURE_QUALITY_LOW which is fast but only uses nearest neighbour
-interpolation. CLUTTER_TEXTURE_QUALITY_MEDIUM which is computationally a bit
-more expensive (bilinear interpolation), and CLUTTER_TEXTURE_QUALITY_HIGH
-which uses extra texture memory resources to improve scaled down rendering
-as well (it uses mipmaps). The default value is
-CLUTTER_TEXTURE_QUALITY_MEDIUM.
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite duration given by @timeline and a speed given by the @mode.
+
+See clutter_actor_animate() for further details.
+
+This function is useful if you want to use an existing timeline
+to animate @actor.
+
+This is the vector-based variant of clutter_actor_animate_with_timeline(),
+useful for language bindings.
-Since: 0.8
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="filter_quality">
-<parameter_description> New filter quality value
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="n_properties">
+<parameter_description> number of property names and values
+</parameter_description>
+</parameter>
+<parameter name="properties">
+<parameter_description> (array length=n_properties): a vector containing the
+property names to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> (array length=n_properies): a vector containing the
+property values to set
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #ClutterAnimation object. The object is
+owned by the #ClutterActor and should not be unreferenced with
+g_object_unref()
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_exp_dec_func">
+<function name="clutter_animation_set_timeline">
<description>
-Convenience alpha function for a decreasing 2^x curve. You can use this
-function as the alpha function for clutter_alpha_set_func().
+Sets the #ClutterTimeline used by @animation.
+
+The #ClutterAnimation:duration and #ClutterAnimation:loop properties
+will be set using the corresponding #ClutterTimeline properties as a
+side effect.
+
+If @timeline is %NULL a new #ClutterTimeline will be constructed
+using the current values of the #ClutterAnimation:duration and
+#ClutterAnimation:loop properties.
+Since: 1.0
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="CLUTTER_ALPHA_SINE_HALF">
+<function name="clutter_behaviour_ellipse_get_height">
<description>
-Convenience symbol for clutter_sine_half_func().
+Gets the height of the elliptical path.
-Since: 0.4
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the height of the path
+
+Since: 0.4
+</return>
</function>
<function name="clutter_alpha_new">
@@ -622,52 +836,50 @@
</return>
</function>
-<function name="clutter_effect_template_new_full">
+<function name="cogl_pango_font_map_set_use_mipmapping">
<description>
-Creates a new #ClutterEffectTemplate, to be used with the effects API.
-
-A #ClutterEffectTemplate binds a timeline and an alpha function and can
-be used as a template for multiple calls of clutter_effect_fade(),
-clutter_effect_move() and clutter_effect_scale().
-
-This API is intended for simple animations involving a single actor;
-for more complex animations, you should see #ClutterBehaviour and the
-derived classes.
-
-This function is intended for language bindings only: if @notify is
-not %NULL it will be called to dispose of @user_data.
+Sets whether the renderer for the passed font map should use
+mipmapping when rendering a #PangoLayout.
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="alpha_func">
-<parameter_description> an alpha function to use for the template
+<parameter name="fm">
+<parameter_description> a #CoglPangoFontMap
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data to be passed to the alpha function, or %NULL
+<parameter name="value">
+<parameter_description> %TRUE to enable the use of mipmapping
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> function to be called when disposing the alpha function's use
-data, or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_get_alpha">
+<description>
+Retrieves the #ClutterAlpha used by @animation.
+
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterEffectTemplate object
+<return> (transfer none): the alpha object used by the animation
-Since: 0.4
+Since: 1.0
</return>
</function>
<function name="clutter_actor_set_scale">
<description>
-Scales an actor with the given factors. The scaling is always
-relative to the anchor point.
+Scales an actor with the given factors. The scaling is relative to
+the scale center and the anchor point. The scale center is
+unchanged by this function and defaults to 0,0.
Since: 0.2
@@ -689,20 +901,36 @@
<return></return>
</function>
-<function name="clutter_x11_add_filter">
+<function name="json_node_free">
<description>
-Adds an event filter function.
+Frees the resources allocated by @node.
-Since: 0.6
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_parent">
+<description>
+Sets the parent of @self to @parent. The opposite function is
+clutter_actor_unparent().
+
+This function should not be used by applications, but by custom
+container actor subclasses.
</description>
<parameters>
-<parameter name="func">
-<parameter_description> a filter function
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> user data to be passed to the filter function, or %NULL
+<parameter name="parent">
+<parameter_description> A new #ClutterActor parent
</parameter_description>
</parameter>
</parameters>
@@ -727,42 +955,150 @@
<return></return>
</function>
-<function name="clutter_group_get_children">
+<function name="json_array_get_element">
<description>
-Get a list containing all actors contained in the group.
+Retrieves the #JsonNode containing the value of the element at @index_
+inside a #JsonArray.
+
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): a pointer to the #JsonNode at the requested index
+</return>
+</function>
+
+<function name="clutter_interval_get_final_value">
+<description>
+Retrieves the final value of @interval and copies
+it into @value.
+
+The passed #GValue must be initialized to the value held by
+the #ClutterInterval.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_get_selection_bound">
+<description>
+Retrieves the other end of the selection of a #ClutterText actor,
+in characters from the current cursor position.
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterGroup
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> A list of #ClutterActors. You should free the returned
-list using g_list_free() when finished using it.
+<return> the position of the other end of the selection
- Deprecated: 0.4: This function is obsolete, use
-clutter_container_get_children() instead.
+Since: 1.0
+</return>
+</function>
+
+<function name="json_array_get_elements">
+<description>
+Gets the elements of a #JsonArray as a list of #JsonNode&lt;!-- --&gt;s.
+
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer container) (element-type JsonNode): a #GList containing
+the elements of the array. The contents of the list are owned by the array and
+should never be modified or freed. Use g_list_free() on the returned list when
+done using it
+</return>
+</function>
+
+<function name="clutter_get_motion_events_frequency">
+<description>
+Retrieves the number of motion events per second that are delivered
+to the stage.
+
+See clutter_set_motion_events_frequency().
+
+
+</description>
+<parameters>
+</parameters>
+<return> the number of motion events per second
+
+Since: 0.6
</return>
</function>
-<function name="clutter_scriptable_get_id">
+<function name="clutter_actor_animatev">
<description>
-Retrieves the id of @scriptable set using clutter_scriptable_set_id().
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite duration and a speed given by the @mode.
+
+This is the vector-based variant of clutter_actor_animate(), useful
+for language bindings.
</description>
<parameters>
-<parameter name="scriptable">
-<parameter_description> a #ClutterScriptable
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> duration of the animation, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="n_properties">
+<parameter_description> number of property names and values
+</parameter_description>
+</parameter>
+<parameter name="properties">
+<parameter_description> (array length=n_properties): a vector containing the
+property names to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> (array length=n_properies): a vector containing the
+property values to set
</parameter_description>
</parameter>
</parameters>
-<return> the id of the object. The returned string is owned by
-the scriptable object and should never be modified of freed
+<return> (transfer none): a #ClutterAnimation object. The object is
+owned by the #ClutterActor and should not be unreferenced with
+g_object_unref()
-Since: 0.6
+Since: 1.0
</return>
</function>
@@ -782,27 +1118,23 @@
<return></return>
</function>
-<function name="clutter_color_from_hlsx">
+<function name="clutter_set_font_flags">
<description>
-Converts a color expressed in HLS (hue, luminance and saturation)
-values into a #ClutterColor.
+Sets the font quality options for subsequent text rendering
+operations.
+
+Using mipmapped textures will improve the quality for scaled down
+text but will use more texture memory.
+
+Enabling hinting improves text quality for static text but may
+introduce some artifacts if the text is animated.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="dest">
-<parameter_description> return location for a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="hue">
-<parameter_description> hue value (0 .. 360)
-</parameter_description>
-</parameter>
-<parameter name="luminance">
-<parameter_description> luminance value (0 .. 1)
-</parameter_description>
-</parameter>
-<parameter name="saturation">
-<parameter_description> saturation value (0 .. 1)
+<parameter name="flags">
+<parameter_description> The new flags
</parameter_description>
</parameter>
</parameters>
@@ -811,12 +1143,12 @@
<function name="clutter_event_peek">
<description>
-Return value: A #ClutterEvent or NULL if queue empty.
+Return value: (transfer none): A #ClutterEvent or NULL if queue empty.
</description>
<parameters>
</parameters>
-<return> A #ClutterEvent or NULL if queue empty.
+<return> (transfer none): A #ClutterEvent or NULL if queue empty.
Since: 0.4
</return>
@@ -869,10 +1201,10 @@
actor in the plane of @ancestor. The returned vertices relate to
the #ClutterActorBox coordinates as follows:
&lt;itemizedlist&gt;
-&lt;listitem&gt;&lt;para&gt;v[0] contains (x1, y1)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[1] contains (x2, y1)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[2] contains (x1, y2)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[3] contains (x2, y2)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;@verts[0] contains (x1, y1)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;@verts[1] contains (x2, y1)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;@verts[2] contains (x1, y2)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;@verts[3] contains (x2, y2)&lt;/para&gt;&lt;/listitem&gt;
&lt;/itemizedlist&gt;
If @ancestor is %NULL the ancestor will be the #ClutterStage. In
@@ -894,7 +1226,7 @@
</parameter_description>
</parameter>
<parameter name="verts">
-<parameter_description> return location for an array of 4 #ClutterVertex in which
+<parameter_description> (out) (array): return location for an array of 4 #ClutterVertex in which
to store the result.
</parameter_description>
</parameter>
@@ -902,6 +1234,49 @@
<return></return>
</function>
+<function name="clutter_timeline_get_duration">
+<description>
+Retrieves the duration of a #ClutterTimeline in milliseconds.
+See clutter_timeline_set_duration().
+
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return> the duration of the timeline, in milliseconds.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_text_set_editable">
+<description>
+Sets whether the #ClutterText actor should be editable.
+
+An editable #ClutterText with key focus set using
+clutter_actor_grab_key_focus() or clutter_stage_take_key_focus()
+will receive key events and will update its contents accordingly.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="editable">
+<parameter_description> whether the #ClutterText should be editable
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_set_motion_events_enabled">
<description>
Sets whether per-actor motion events should be enabled or not (the
@@ -927,19 +1302,6 @@
<return></return>
</function>
-<function name="ClutterLabel">
-<description>
-Whether the contents of the label should be justified on both
-margins.
-
-Since: 0.6
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_model_get_column_type">
<description>
Retrieves the type of the @column.
@@ -983,6 +1345,29 @@
<return></return>
</function>
+<function name="clutter_path_node_equal">
+<description>
+Compares two nodes and checks if they are the same type with the
+same coordinates.
+
+
+</description>
+<parameters>
+<parameter name="node_a">
+<parameter_description> First node
+</parameter_description>
+</parameter>
+<parameter name="node_b">
+<parameter_description> Second node
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the nodes are the same.
+
+Since: 1.0
+</return>
+</function>
+
<function name="json_parser_get_current_pos">
<description>
Retrieves the current position inside the current line, starting
@@ -1002,9 +1387,10 @@
<function name="clutter_actor_set_heightu">
<description>
-Forces a height request on an actor, causing the actor's
-normal width and height (if any) to be ignored. This function
-sets both the minimum and natural size request of the actor.
+Forces a height on an actor, causing the actor's preferred width
+and height (if any) to be ignored.
+
+This function sets both the minimum and natural size of the actor.
since: 0.6
@@ -1022,31 +1408,13 @@
<return></return>
</function>
-<function name="clutter_effect_template_set_timeline_clone">
-<description>
-Sets if effects using this template should make a copy of the
-templates timeline (default) or reference the effects timeline.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="setting">
-<parameter_description> A boolean indicating if effects should clone the timeline.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_path_new">
<description>
Creates a new path behaviour. You can use this behaviour to drive
-actors along the nodes of a path, described by the @knots.
+actors along the nodes of a path, described by @path.
+
+This will claim the floating reference on the #ClutterPath so you
+do not need to unref if it.
</description>
@@ -1055,12 +1423,8 @@
<parameter_description> a #ClutterAlpha, or %NULL
</parameter_description>
</parameter>
-<parameter name="knots">
-<parameter_description> a list of #ClutterKnots, or %NULL for an empty path
-</parameter_description>
-</parameter>
-<parameter name="n_knots">
-<parameter_description> the number of nodes in the path
+<parameter name="path">
+<parameter_description> a #ClutterPath or %NULL for an empty path
</parameter_description>
</parameter>
</parameters>
@@ -1070,19 +1434,32 @@
</return>
</function>
-<function name="json_node_set_int">
+<function name="clutter_actor_get_clip">
<description>
-Sets @value as the integer content of the @node, replacing any existing
-content.
+Gets the clip area for @self, in pixels.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> an integer value
+<parameter name="xoff">
+<parameter_description> (out): return location for the X offset of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="yoff">
+<parameter_description> (out): return location for the Y offset of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> (out): return location for the width of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> (out): return location for the height of the clip rectangle, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -1113,22 +1490,28 @@
<return></return>
</function>
-<function name="clutter_entry_get_max_length">
+<function name="clutter_alpha_register_func">
<description>
-Gets the maximum length of text that can be set into @entry.
-See clutter_entry_set_max_length().
+Registers a global alpha function and returns its logical id
+to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
+
+The logical id is always greater than %CLUTTER_ANIMATION_LAST.
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="func">
+<parameter_description> a #ClutterAlphaFunc
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to pass to @func, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the maximum number of characters.
+<return> the logical id of the alpha function
-Since: 0.4
+Since: 1.0
</return>
</function>
@@ -1258,6 +1641,8 @@
<function name="clutter_actor_unparent">
<description>
+Removes the parent of @self.
+
This function should not be used in applications. It should be called by
implementations of container actors, to dissociate a child from the
container.
@@ -1274,45 +1659,20 @@
<return></return>
</function>
-<function name="clutter_color_to_hlsx">
+<function name="clutter_timeline_remove_marker">
<description>
-Converts @src to the HLS format. Returned hue is in degrees (0 .. 360),
-luminance and saturation from interval &lt;0 .. 1&gt;.
-
-</description>
-<parameters>
-<parameter name="src">
-<parameter_description> a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="hue">
-<parameter_description> return location for the hue value or %NULL
-</parameter_description>
-</parameter>
-<parameter name="luminance">
-<parameter_description> return location for the luminance value or %NULL
-</parameter_description>
-</parameter>
-<parameter name="saturation">
-<parameter_description> return location for the saturation value or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Removes @marker_name, if found, from @timeline.
-<function name="clutter_media_set_uri">
-<description>
-Sets the URI of @media to @uri.
+Since: 0.8
</description>
<parameters>
-<parameter name="media">
-<parameter_description> #ClutterMedia object
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="uri">
-<parameter_description> URI
+<parameter name="marker_name">
+<parameter_description> the name of the marker to remove
</parameter_description>
</parameter>
</parameters>
@@ -1367,24 +1727,6 @@
</return>
</function>
-<function name="clutter_media_set_position">
-<description>
-Sets the playback position of @media to @position.
-
-</description>
-<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
-</parameter_description>
-</parameter>
-<parameter name="position">
-<parameter_description> The desired position.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_list_model_new">
<description>
Creates a new default model with @n_columns columns with the types
@@ -1418,25 +1760,105 @@
</parameter_description>
</parameter>
</parameters>
-<return> a new #ClutterListModel
+<return> a new #ClutterListModel
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_text_set_line_wrap_mode">
+<description>
+If line wrapping is enabled (see clutter_text_set_line_wrap()) this
+function controls how the line wrapping is performed. The default is
+%PANGO_WRAP_WORD which means wrap on word boundaries.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="wrap_mode">
+<parameter_description> the line wrapping mode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_bind_property">
+<description>
+Binds @interval to the @property_name of the #GObject
+attached to @animation. The #ClutterAnimation will take
+ownership of the passed #ClutterInterval.
+
+If you need to update the interval instance use
+clutter_animation_update_property() instead.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the property to control
+</parameter_description>
+</parameter>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_script_lookup_filename">
+<description>
+Looks up @filename inside the search paths of @script. If @filename
+is found, its full path will be returned .
+
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> the name of the file to lookup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the full path of @filename or %NULL if no path was
+found.
-Since: 0.6
+Since: 0.8
</return>
</function>
-<function name="json_array_remove_element">
+<function name="clutter_actor_get_anchor_pointu">
<description>
-Removes the #JsonNode inside @array at @index_ freeing its allocated
-resources.
+Gets the current anchor point of the @actor in #ClutterUnit&lt;!-- --&gt;s.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the position of the element to be removed
+<parameter name="anchor_x">
+<parameter_description> (out): return location for the X coordinate of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> (out): return location for the Y coordinate of the anchor point
</parameter_description>
</parameter>
</parameters>
@@ -1483,12 +1905,12 @@
<function name="clutter_stage_get_default">
<description>
-Return value: the main #ClutterStage. You should never
+Return value: (transfer none): the main #ClutterStage. You should never
</description>
<parameters>
</parameters>
-<return> the main #ClutterStage. You should never
+<return> (transfer none): the main #ClutterStage. You should never
destroy or unref the returned actor.
</return>
</function>
@@ -1517,47 +1939,89 @@
<return></return>
</function>
-<function name="clutter_list_model_newv">
+<function name="clutter_actor_animate_with_alphav">
<description>
-Non-vararg version of clutter_list_model_new(). This function is
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite behaviour given by the passed @alpha.
+
+See clutter_actor_animate() for further details.
+
+This function is useful if you want to use an existing #ClutterAlpha
+to animate @actor.
+
+This is the vector-based variant of clutter_actor_animate_with_alpha(),
useful for language bindings.
</description>
<parameters>
-<parameter name="n_columns">
-<parameter_description> number of columns in the model
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="types">
-<parameter_description> an array of #GType types for the columns, from first to last
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="names">
-<parameter_description> an array of names for the columns, from first to last
+<parameter name="n_properties">
+<parameter_description> number of property names and values
+</parameter_description>
+</parameter>
+<parameter name="properties">
+<parameter_description> (array length=n_properties): a vector containing the
+property names to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> (array length=n_properies): a vector containing the
+property values to set
</parameter_description>
</parameter>
</parameters>
-<return> a new default #ClutterModel
+<return> (transfer none): a #ClutterAnimation object. The object is owned by the
+#ClutterActor and should not be unreferenced with g_object_unref()
-Since: 0.6
+Since: 1.0
</return>
</function>
-<function name="clutter_score_pause">
+<function name="clutter_timeline_get_delay">
<description>
-Pauses a playing score @score.
+Retrieves the delay set using clutter_timeline_set_delay().
-Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the delay in milliseconds.
+
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_text_get_max_length">
+<description>
+Gets the maximum length of text that can be set into a text actor.
+
+See clutter_text_set_max_length().
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> the maximum number of characters.
+
+Since: 1.0
+</return>
</function>
<function name="clutter_actor_set_shader_param">
@@ -1565,7 +2029,7 @@
Sets the value for a named parameter of the shader applied
to @actor.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
@@ -1610,11 +2074,11 @@
</parameter_description>
</parameter>
<parameter name="min_height_p">
-<parameter_description> return location for min height, or %NULL
+<parameter_description> (out): return location for minimum height, or %NULL
</parameter_description>
</parameter>
<parameter name="natural_height_p">
-<parameter_description> return location for natural height, or %NULL
+<parameter_description> (out): return location for natural height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -1633,41 +2097,28 @@
<return></return>
</function>
-<function name="clutter_effect_fade">
+<function name="clutter_container_add_valist">
<description>
-Simple effect for fading a single #ClutterActor.
+Alternative va_list version of clutter_container_add().
+Since: 0.4
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="opacity_end">
-<parameter_description> Final opacity value to apply to actor
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
+<parameter name="first_actor">
+<parameter_description> the first #ClutterActor to add
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or %NULL
+<parameter name="var_args">
+<parameter_description> list of actors to add, followed by %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unrefed by
-the effect when completed.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="CLUTTER_ACTOR_IS_REACTIVE">
@@ -1708,113 +2159,74 @@
</parameter_description>
</parameter>
<parameter name="columns">
-<parameter_description> a vector containing the columns to set
+<parameter_description> (array length=n_columns): a vector containing the columns to set
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> a vector containing the values for the cells
+<parameter_description> (array length=n_columns): a vector containing the values for the cells
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_label_set_ellipsize">
+<function name="clutter_cairo_texture_set_surface_size">
<description>
-Sets the mode used to ellipsize (add an ellipsis: "...") to the text
-if there is not enough space to render the entire string.
+Resizes the Cairo surface used by @self to @width and @height.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-<parameter name="mode">
-<parameter_description> a #PangoEllipsizeMode
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_x11_set_stage_foreign">
-<description>
-Target the #ClutterStage to use an existing external X Window
-
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="width">
+<parameter_description> the new width of the surface
</parameter_description>
</parameter>
-<parameter name="xwindow">
-<parameter_description> an existing X Window id
+<parameter name="height">
+<parameter_description> the new height of the surface
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if foreign window is valid
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_label_new_with_text">
+<function name="clutter_shader_release">
<description>
-Creates a new #ClutterLabel displaying @text using @font_name.
+Frees up any GL context resources held by the shader.
+Since: 0.6
</description>
<parameters>
-<parameter name="font_name">
-<parameter_description> the name (and size) of the font to be used
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterLabel
-</return>
+<return></return>
</function>
-<function name="clutter_label_set_font_name">
+<function name="clutter_x11_set_stage_foreign">
<description>
-Sets @font_name as the font used by @label.
+Target the #ClutterStage to use an existing external X Window
- font_name must be a string containing the font name and its
-size, similarly to what you would feed to the
-pango_font_description_from_string() function.
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
-<parameter name="font_name">
-<parameter_description> a font name and size, or %NULL for the default font
+<parameter name="xwindow">
+<parameter_description> an existing X Window id
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_get_default_backend">
-<description>
-FIXME
-
-
-</description>
-<parameters>
-</parameters>
-<return> the default backend. You should not ref or
-unref the returned object. Applications should not rarely need
-to use this.
+<return> %TRUE if foreign window is valid
Since: 0.4
</return>
@@ -1836,8 +2248,9 @@
</parameter_description>
</parameter>
</parameters>
-<return> the requested timeline, or %NULL. This function does
-not increase the reference count on the returned #ClutterTimeline
+<return> (transfer none): the requested timeline, or %NULL. This
+function does not increase the reference count on the returned
+#ClutterTimeline
Since: 0.6
</return>
@@ -1885,7 +2298,9 @@
silhouette. Containers should always recursively call pick for
each child.
-Since 0.4
+This function will emit the #ClutterActor::pick signal.
+
+Since: 0.4
</description>
<parameters>
@@ -1901,23 +2316,80 @@
<return></return>
</function>
-<function name="clutter_entry_set_max_length">
+<function name="clutter_color_hash">
<description>
-Sets the maximum allowed length of the contents of the actor. If the
-current contents are longer than the given length, then they will be
-truncated to fit.
+Converts a #ClutterColor to a hash value.
-Since: 0.4
+This function can be passed to g_hash_table_new() as the @hash_func
+parameter, when using #ClutterColor&lt;!-- --&gt;s as keys in a #GHashTable.
+
+
+</description>
+<parameters>
+<parameter name="v">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hash value corresponding to the color
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_stage_set_fog">
+<description>
+Sets the fog (also known as "depth cueing") settings for the @stage.
+
+A #ClutterStage will only use a linear fog progression, which
+depends solely on the distance from the viewer. The cogl_set_fog()
+function in COGL exposes more of the underlying implementation,
+and allows changing the for progression function. It can be directly
+used by disabling the #ClutterStage:use-fog property and connecting
+a signal handler to the #ClutterActor::paint signal on the @stage,
+like:
+
+|[
+clutter_stage_set_use_fog (stage, FALSE);
+g_signal_connect (stage, "paint", G_CALLBACK (on_stage_paint), NULL);
+]|
+
+The paint signal handler will call cogl_set_fog() with the
+desired settings:
+
+|[
+static void
+on_stage_paint (ClutterActor *actor)
+{
+ClutterColor stage_color = { 0, };
+CoglColor fog_color = { 0, };
+
+/&ast; set the fog color to the stage background color &ast;/
+clutter_stage_get_color (CLUTTER_STAGE (actor), &amp;stage_color);
+cogl_color_set_from_4ub (&amp;fog_color,
+stage_color.red,
+stage_color.green,
+stage_color.blue,
+stage_color.alpha);
+
+/&ast; enable fog &ast;/
+cogl_set_fog (&amp;fog_color,
+COGL_FOG_MODE_EXPONENTIAL, /&ast; mode &ast;/
+0.5, /&ast; density &ast;/
+5.0, 30.0); /&ast; z_near and z_far &ast;/
+}
+]|
+
+Since: 0.6
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="stage">
+<parameter_description> the #ClutterStage
</parameter_description>
</parameter>
-<parameter name="max">
-<parameter_description> the maximum number of characters allowed in the entry; 0
-to disable or -1 to set the length of the current string
+<parameter name="fog">
+<parameter_description> a #ClutterFog structure
</parameter_description>
</parameter>
</parameters>
@@ -1947,33 +2419,14 @@
</description>
<parameters>
<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return> The length of the media stream.
-</return>
-</function>
-
-<function name="clutter_entry_set_text">
-<description>
-Sets @text as the text to be displayed by @entry. The
-ClutterEntry::text-changed signal is emitted.
+<return> the duration of the media stream, in seconds
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
+Since: 0.2
+</return>
</function>
<function name="clutter_actor_set_sizeu">
@@ -2023,52 +2476,154 @@
</return>
</function>
-<function name="clutter_container_class_find_child_property">
+<function name="clutter_container_class_find_child_property">
+<description>
+Looks up the #GParamSpec for a child property of @klass.
+
+
+</description>
+<parameters>
+<parameter name="klass">
+<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> a property name.
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): The #GParamSpec for the property or %NULL
+if no such property exist.
+
+Since: 0.8
+</return>
+</function>
+
+<function name="clutter_interval_peek_initial_value">
+<description>
+Gets the pointer to the initial value of @interval
+
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the initial value of the interval.
+The value is owned by the #ClutterInterval and it should not be
+modified or freed
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_path_add_move_to">
+<description>
+Adds a #CLUTTER_PATH_MOVE_TO type node to the path. This is usually
+used as the first node in a path. It can also be used in the middle
+of the path to cause the actor to jump to the new coordinate.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x coordinate
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y coordinate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_score_append">
<description>
-Looks up the #GParamSpec for a child property of @klass.
+Appends a timeline to another one existing in the score; the newly
+appended timeline will be started when @parent is complete.
+
+If @parent is %NULL, the new #ClutterTimeline will be started when
+clutter_score_start() is called.
+
+#ClutterScore will take a reference on @timeline.
</description>
<parameters>
-<parameter name="klass">
-<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> a property name.
+<parameter name="parent">
+<parameter_description> a #ClutterTimeline in the score, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> The #GParamSpec for the property or %NULL if no such
-property exist.
+<return> the id of the #ClutterTimeline inside the score, or
+0 on failure. The returned id can be used with clutter_score_remove()
+or clutter_score_get_timeline().
-Since: 0.8
+Since: 0.6
</return>
</function>
-<function name="clutter_qmulx">
+<function name="clutter_animatable_animate_property">
<description>
-Multiplies two fixed values using 64bit arithmetic; this provides
-significantly better precission than the #CLUTTER_FIXED_MUL macro,
-but at performance cost (about 2.7 times slowdown on ARMv5e, and 2 times
-on x86).
+Calls the animate_property() virtual function for @animatable.
+
+The @initial_value and @final_value #GValue&lt;!-- --&gt;s must contain
+the same type; @value must have been initialized to the same
+type of @initial_value and @final_value.
+All implementation of the #ClutterAnimatable interface must
+implement this function.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="op1">
-<parameter_description> #ClutterFixed
+<parameter name="animatable">
+<parameter_description> a #ClutterAnimatable
+</parameter_description>
+</parameter>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the name of the animated property
+</parameter_description>
+</parameter>
+<parameter name="initial_value">
+<parameter_description> the initial value of the animation interval
+</parameter_description>
+</parameter>
+<parameter name="final_value">
+<parameter_description> the final value of the animation interval
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> the progress factor
</parameter_description>
</parameter>
-<parameter name="op2">
-<parameter_description> #ClutterFixed
+<parameter name="value">
+<parameter_description> return location for the animation value
</parameter_description>
</parameter>
</parameters>
-<return> the result of the operation
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_shader_set_vertex_source">
@@ -2096,20 +2651,48 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_height">
+<function name="clutter_units_em">
<description>
-Sets the height of the elliptical path.
+Converts a value in em to #ClutterUnit&lt;!-- --&gt;s at the
+current DPI
-Since: 0.4
+
+</description>
+<parameters>
+<parameter name="em">
+<parameter_description> em to convert
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value in units
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_actor_get_scale_centeru">
+<description>
+ClutterUnit&lt;!-- --&gt;s version of clutter_actor_get_scale_center().
+
+Retrieves the scale center coordinate in units relative to the top
+left corner of the actor. If the scale center was specified using a
+#ClutterGravity this will calculate the unit offset using the
+current size of the actor.
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> height of the ellipse
+<parameter name="center_x">
+<parameter_description> (out): Location to store the X position of the scale center, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="center_y">
+<parameter_description> (out): Location to store the Y position of the scale center, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -2132,26 +2715,31 @@
</return>
</function>
-<function name="clutter_ramp_inc_func">
+<function name="clutter_path_get_position">
<description>
-Convenience alpha function for a monotonic increasing ramp. You
-can use this function as the alpha function for clutter_alpha_set_func().
+The value in @progress represents a position along the path where
+0.0 is the beginning and 1.0 is the end of the path. An
+interpolated position is then stored in @position.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> a position along the path as a fraction of its length
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="position">
+<parameter_description> location to store the position
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return> index of the node used to calculate the position.
-Since: 0.2
+Since: 1.0
</return>
</function>
@@ -2174,76 +2762,68 @@
</return>
</function>
-<function name="json_array_unref">
+<function name="clutter_text_get_password_char">
<description>
-Decreases by one the reference count of a #JsonArray. If the
-reference count reaches zero, the array is destroyed and all
-its allocated resources are freed.
+Retrieves the character to use in place of the actual text
+as set by clutter_text_set_password_char().
+
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a Unicode character or 0 if the password
+character is not set
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_behaviour_scale_set_boundsx">
+<function name="clutter_animation_get_interval">
<description>
-Fixed point version of clutter_behaviour_scale_set_bounds().
+Retrieves the #ClutterInterval associated to @property_name
+inside @animation.
-Sets the bounds used by scale behaviour.
-
-Since: 0.6
</description>
<parameters>
-<parameter name="scale">
-<parameter_description> a #ClutterBehaviourScale
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> initial scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> initial scale factor on the Y axis
-</parameter_description>
-</parameter>
-<parameter name="x_scale_end">
-<parameter_description> final scale factor on the X axis
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="y_scale_end">
-<parameter_description> final scale factor on the Y axis
+<parameter name="property_name">
+<parameter_description> name of the property
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #ClutterInterval or %NULL if no
+property with the same name was found. The returned interval is
+owned by the #ClutterAnimation and should not be unreferenced
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_exp_inc_func">
+<function name="clutter_text_get_font_name">
<description>
-Convenience alpha function for a 2^x curve. You can use this function as the
-alpha function for clutter_alpha_set_func().
+Retrieves the font name as set by clutter_text_set_font_name().
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return> a string containing the font name. The returned
+string is owned by the #ClutterText actor and should not be
+modified or freed
-Since: 0.4
+Since: 1.0
</return>
</function>
@@ -2305,11 +2885,11 @@
</description>
<parameters>
<parameter name="argc">
-<parameter_description> a pointer to the number of command line arguments
+<parameter_description> (inout): a pointer to the number of command line arguments
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> a pointer to the array of comman line arguments
+<parameter_description> (array length=argc) (inout): a pointer to the array of command line arguments
</parameter_description>
</parameter>
<parameter name="parameter_string">
@@ -2342,55 +2922,35 @@
</return>
</function>
-<function name="clutter_color_parse">
+<function name="clutter_text_set_single_line_mode">
<description>
-Parses a string definition of a color, filling the
-&lt;structfield&gt;red&lt;/structfield&gt;, &lt;structfield&gt;green&lt;/structfield&gt;,
-&lt;structfield&gt;blue&lt;/structfield&gt; and &lt;structfield&gt;alpha&lt;/structfield&gt;
-channels of @dest. If alpha is not specified it will be set full opaque.
-The color in @dest is not allocated.
+Sets whether a #ClutterText actor should be in single line mode
+or not.
-The color may be defined by any of the formats understood by
-&lt;function&gt;pango_color_parse&lt;/function&gt;; these include literal color
-names, like &lt;literal&gt;Red&lt;/literal&gt; or &lt;literal&gt;DarkSlateGray&lt;/literal&gt;,
-or hexadecimal specifications like &lt;literal&gt;&num;3050b2&lt;/literal&gt; or
-&lt;literal&gt;&num;333&lt;/literal&gt;.
+A text actor in single line mode will not wrap text and will clip
+the the visible area to the predefined size. The contents of the
+text actor will scroll to display the end of the text if its length
+is bigger than the allocated width.
+When setting the single line mode the #ClutterText:activatable
+property is also set as a side effect. Instead of entering a new
+line character, the text actor will emit the #ClutterText::activate
+signal.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="color">
-<parameter_description> a string specifiying a color (named color or #RRGGBBAA)
-</parameter_description>
-</parameter>
-<parameter name="dest">
-<parameter_description> return location for a #ClutterColor
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if parsing succeeded.
-
-Since: 0.2
-</return>
-</function>
-
-<function name="clutter_stage_manager_list_stage">
-<description>
-Lists all currently used stages.
-
-
-</description>
-<parameters>
-<parameter name="stage_manager">
-<parameter_description> a #ClutterStageManager
+<parameter name="single_line">
+<parameter_description> whether to enable single line mode
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated list of #ClutterStage objects. Use
-g_slist_free() to deallocate it when done.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_remove">
@@ -2426,38 +2986,93 @@
<return></return>
</function>
-<function name="clutter_behaviour_path_get_knots">
+<function name="clutter_actor_unrealize">
<description>
-Return value: a #GSList of the paths knots.
+Frees up any underlying graphics resources needed by the actor to be
+displayed.
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList of the paths knots.
-
-Since: 0.2
-</return>
+<return></return>
</function>
-<function name="clutter_actor_unrealize">
+<function name="clutter_interval_register_progress_func">
<description>
-Frees up any underlying graphics resources needed by the actor to be
-displayed.
+Sets the progress function for a given @value_type, like:
+
+|[
+clutter_interval_register_progress_func (MY_TYPE_FOO,
+my_foo_progress);
+]|
+
+Whenever a #ClutterInterval instance using the default
+#ClutterInterval::compute_value implementation is set as an
+interval between two #GValue of type @value_type, it will call
+ func to establish the value depending on the given progress,
+for instance:
+
+|[
+static gboolean
+my_int_progress (const GValue *a,
+const GValue *b,
+gdouble progress,
+GValue *retval)
+{
+gint ia = g_value_get_int (a);
+gint ib = g_value_get_int (b);
+gint res = factor * (ib - ia) + ia;
+
+g_value_set_int (retval, res);
+
+return TRUE;
+}
+
+clutter_interval_register_progress_func (G_TYPE_INT, my_int_progress);
+]|
+
+To unset a previously set progress function of a #GType, pass %NULL
+for @func.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="value_type">
+<parameter_description> a #GType
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterProgressFunc, or %NULL to unset a previously
+set progress function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_units_to_pixels">
+<description>
+Converts a value in #ClutterUnit&lt;!-- --&gt;s to pixels
+
+
+</description>
+<parameters>
+<parameter name="units">
+<parameter_description> units to convert
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value in pixels
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_set_rotation">
<description>
Sets the rotation angle of @self around the given axis.
@@ -2505,6 +3120,38 @@
<return></return>
</function>
+<function name="clutter_text_new_full">
+<description>
+Creates a new #ClutterText actor, using @font_name as the font
+description; @text will be used to set the contents of the actor;
+and @color will be used as the color to render @text.
+
+This function is equivalent to calling clutter_text_new(),
+clutter_text_set_font_name(), clutter_text_set_text() and
+clutter_text_set_color().
+
+
+</description>
+<parameters>
+<parameter name="font_name">
+<parameter_description> a string with a font description
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> the contents of the actor
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> the color to be used to render @text
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterText actor
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_behaviour_apply">
<description>
Applies @behave to @actor. This function adds a reference on
@@ -2565,21 +3212,29 @@
</return>
</function>
-<function name="clutter_sinx">
+<function name="clutter_text_new_with_text">
<description>
-Fixed point implementation of sine function
+Creates a new #ClutterText actor, using @font_name as the font
+description; @text will be used to set the contents of the actor.
+
+This function is equivalent to calling clutter_text_new(),
+clutter_text_set_font_name(), and clutter_text_set_text().
</description>
<parameters>
-<parameter name="angle">
-<parameter_description> a #ClutterFixed angle in radians
+<parameter name="font_name">
+<parameter_description> a string with a font description
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> the contents of the actor
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterFixed sine value.
+<return> the newly created #ClutterText actor
-Since: 0.2
+Since: 1.0
</return>
</function>
@@ -2604,6 +3259,54 @@
<return></return>
</function>
+<function name="clutter_interval_get_initial_value">
+<description>
+Retrieves the initial value of @interval and copies
+it into @value.
+
+The passed #GValue must be initialized to the value held by
+the #ClutterInterval.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_anchor_point">
+<description>
+Gets the current anchor point of the @actor in pixels.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="anchor_x">
+<parameter_description> (out): return location for the X coordinate of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> (out): return location for the Y coordinate of the anchor point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_timeline_get_delta">
<description>
Retrieves the number of frames and the amount of time elapsed since
@@ -2632,48 +3335,26 @@
</return>
</function>
-<function name="clutter_script_get_object">
+<function name="clutter_animation_has_property">
<description>
-Retrieves the object bound to @name. This function does not increment
-the reference count of the returned object.
+Checks whether @animation is controlling @property_name.
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the object to retrieve
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-</parameters>
-<return> the named object, or %NULL if no object with the
-given name was available
-
-Since: 0.6
-</return>
-</function>
-
-<function name="clutter_sini">
-<description>
-Very fast fixed point implementation of sine function.
-
-ClutterAngle is an integer such that 1024 represents
-full circle.
-
-
-</description>
-<parameters>
-<parameter name="angle">
-<parameter_description> a #ClutterAngle
+<parameter name="property_name">
+<parameter_description> name of the property
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterFixed sine value.
+<return> %TRUE if the property is animated by the
+#ClutterAnimation, %FALSE otherwise
-Since: 0.2
+Since: 1.0
</return>
</function>
@@ -2710,11 +3391,11 @@
</parameter_description>
</parameter>
<parameter name="start">
-<parameter_description> #ClutterFixed angle in degrees at which movement starts
+<parameter_description> #CoglFixed angle in degrees at which movement starts
</parameter_description>
</parameter>
<parameter name="end">
-<parameter_description> #ClutterFixed angle in degrees at which movement ends
+<parameter_description> #CoglFixed angle in degrees at which movement ends
</parameter_description>
</parameter>
</parameters>
@@ -2724,18 +3405,23 @@
</return>
</function>
-<function name="clutter_timeline_start">
+<function name="clutter_actor_get_shader">
<description>
-Starts the #ClutterTimeline playing.
+Queries the currently set #ClutterShader on @self.
+
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): The currently set #ClutterShader or %NULL if no
+shader is set.
+
+Since: 0.6
+</return>
</function>
<function name="clutter_behaviour_rotate_get_boundsx">
@@ -2763,28 +3449,19 @@
<return></return>
</function>
-<function name="clutter_stage_get_actor_at_pos">
+<function name="clutter_timeline_get_current_frame">
<description>
-Checks the scene at the coordinates @x and @y and returns a pointer
-to the #ClutterActor at those coordinates.
+Request the current frame number of the timeline.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X coordinate to check
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate to check
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> the actor at the specified coordinates, if any
+<return> current frame number
</return>
</function>
@@ -2809,6 +3486,28 @@
<return></return>
</function>
+<function name="clutter_text_set_ellipsize">
+<description>
+Sets the mode used to ellipsize (add an ellipsis: "...") to the
+text if there is not enough space to render the entire contents
+of a #ClutterText actor
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> a #PangoEllipsizeMode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="ClutterBehaviourDepth">
<description>
End depth level to apply to the actors.
@@ -2821,30 +3520,22 @@
<return></return>
</function>
-<function name="clutter_actor_get_paint_area">
+<function name="clutter_stage_set_key_focus">
<description>
-Gets where an actor will be painted, which is generally the union
-of the paint boxes of the actor's children, plus anything the actor
-draws itself, transformed by the scale factor and anchor point. The
-result is a "paint area", i.e. where the actor will actually be
-painted.
-
-The returned #ClutterActorBox is in the coordinates of the actor's
-parent, just as an allocation is.
-
-&lt;note&gt;This function is only valid if the allocation is valid,
-which means for the most part only inside a paint() method.&lt;/note&gt;
+Sets the key focus on @actor. An actor with key focus will receive
+all the key events. If @actor is %NULL, the stage will receive
+focus.
-Since: 0.8
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="stage">
+<parameter_description> the #ClutterStage
</parameter_description>
</parameter>
-<parameter name="box">
-<parameter_description> the function fills this in with the actor's paint area
+<parameter name="actor">
+<parameter_description> the actor to set key focus to, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -2854,10 +3545,11 @@
<function name="clutter_behaviour_ellipse_new">
<description>
Creates a behaviour that drives actors along an elliptical path with
-given center, width and height; the movement starts at @angle_start
-degrees (with 0 corresponding to 12 o'clock) and ends at @angle_end
-degrees. Angles &gt;= 360 degrees get clamped to the canonical interval
-&lt;0, 360), if start == end, the behaviour will rotate by exacly 360 degrees.
+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 &lt;0, 360); if @start is equal to @end, the behaviour will
+rotate by exacly 360 degrees.
</description>
@@ -2925,68 +3617,83 @@
<return></return>
</function>
-<function name="json_array_get_elements">
+<function name="clutter_event_get_state">
<description>
-Gets the elements of a #JsonArray as a list of #JsonNode&lt;!-- --&gt;s.
+Retrieves the modifier state of the event.
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> a #GList containing the elements of the array. The
-contents of the list are owned by the array and should never be
-modified or freed. Use g_list_free() on the returned list when
-done using it
+<return> the modifier state parameter, or 0
+
+Since: 0.4
</return>
</function>
-<function name="clutter_entry_set_visible_cursor">
+<function name="clutter_units_pixels">
<description>
-Sets the visibility of the input cursor.
+Converts a value in pixels to #ClutterUnit&lt;!-- --&gt;s
-Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="visible">
-<parameter_description> whether the input cursor should be visible
+<parameter name="px">
+<parameter_description> pixels to convert
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the value in units
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_shader_set_uniform_1f">
+<function name="clutter_alpha_set_timeline">
<description>
-Sets a user configurable variable in the shader programs attached
-to a #ClutterShader.
+Binds @alpha to @timeline.
-Since: 0.6
+Since: 0.2
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> name of uniform in vertex or fragment program to set.
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the new value of the uniform.
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_path_new_with_description">
+<description>
+Creates a new #ClutterPath instance with the nodes described in
+ desc See clutter_path_add_string() for details of the format of
+the string.
+
+The object has a floating reference so if you add it to a
+#ClutterBehaviourPath then you do not need to unref it.
+
+
+</description>
+<parameters>
+<parameter name="desc">
+<parameter_description> a string describing the path
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterPath
+
+Since: 1.0
+</return>
</function>
<function name="clutter_behaviour_ellipse_set_tilt">
@@ -3017,28 +3724,25 @@
<return></return>
</function>
-<function name="clutter_sine_inc_func">
+<function name="clutter_media_set_progress">
<description>
-Convenience alpha function for a sine wave over interval [0, pi / 2].
-You can use this function as the alpha function for
-clutter_alpha_set_func().
+Sets the playback progress of @media. The @progress is
+a normalized value between 0.0 (begin) and 1.0 (end).
+Since: 1.0
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="progress">
+<parameter_description> the progress of the playback, between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
-
-Since: 0.2
-</return>
+<return></return>
</function>
<function name="clutter_group_get_n_children">
@@ -3102,6 +3806,59 @@
<return></return>
</function>
+<function name="clutter_text_set_activatable">
+<description>
+Sets whether a #ClutterText actor should be activatable.
+
+An activatable #ClutterText actor will emit the #ClutterText::activate
+signal whenever the 'Enter' (or 'Return') key is pressed; if it is not
+activatable, a new line will be appended to the current content.
+
+An activatable #ClutterText must also be set as editable using
+clutter_text_set_editable().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="activatable">
+<parameter_description> whether the #ClutterText actor should be activatable
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_frame_source_add">
+<description>
+Simple wrapper around clutter_frame_source_add_full().
+
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> the time between calls to the function, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+</parameters>
+<return> the ID (greater than 0) of the event source.
+
+Since: 0.8
+</return>
+</function>
+
<function name="json_node_set_double">
<description>
Sets @value as the double content of the @node, replacing any existing
@@ -3124,6 +3881,7 @@
<function name="clutter_actor_set_yu">
<description>
Sets the actor's Y coordinate, relative to its parent.
+
Overrides any layout manager and forces a fixed position for
the actor.
@@ -3166,6 +3924,49 @@
<return></return>
</function>
+<function name="json_object_get_size">
+<description>
+Retrieves the number of members of a #JsonObject.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #JsonObject
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of members
+</return>
+</function>
+
+<function name="clutter_value_get_shader_float">
+<description>
+Retrieves the list of floating point values stored inside
+the passed #GValue. @value must have been initialized with
+%CLUTTER_TYPE_SHADER_FLOAT.
+
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> return location for the number of returned floating
+point values, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the pointer to a list of floating point values.
+The returned value is owned by the #GValue and should never
+be modified or freed.
+
+Since: 0.8
+</return>
+</function>
+
<function name="clutter_actor_set_fixed_position_set">
<description>
Sets whether an actor has a fixed position set (and will thus be
@@ -3206,11 +4007,11 @@
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return location for the X coordinate, or %NULL
+<parameter_description> (out): return location for the X coordinate, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return location for the Y coordinate, or %NULL
+<parameter_description> (out): return location for the Y coordinate, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -3282,68 +4083,94 @@
</return>
</function>
-<function name="clutter_sine_func">
+<function name="clutter_behaviour_ellipse_set_angle_endx">
+<description>
+Sets the angle at which movement ends; angles &gt;= 360 degress get clamped
+to the canonical interval &lt;0, 360).
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="angle_end">
+<parameter_description> angle, as #CoglFixed, at which movement ends, in degrees,
+between 0 and 360.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_rotation">
<description>
-Convenience alpha function for a sine wave. You can use this
-function as the alpha function for clutter_alpha_set_func().
+Retrieves the angle and center of rotation on the given axis,
+set using clutter_actor_set_angle().
+
+The coordinates of the center returned by this function depend on
+the axis passed.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> (out): return value for the X coordinate of the center of rotation
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="y">
+<parameter_description> (out): return value for the Y coordinate of the center of rotation
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> (out): return value for the Z coordinate of the center of rotation
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return> the angle of rotation.
-Since: 0.2
+Since: 0.6
</return>
</function>
-<function name="clutter_behaviour_ellipse_set_angle_endx">
+<function name="clutter_actor_set_scale_full">
<description>
-Sets the angle at which movement ends; angles &gt;= 360 degress get clamped
-to the canonical interval &lt;0, 360).
+Scales an actor with the given factors around the given center
+point. The center point is specified in pixels relative to the
+anchor point (usually the top left corner of the actor).
-Since: 0.4
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="angle_end">
-<parameter_description> angle, as #ClutterFixed, at which movement ends, in degrees,
-between 0 and 360.
+<parameter name="scale_x">
+<parameter_description> double factor to scale actor by horizontally.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="json_object_add_member">
-<description>
-Adds a member named @member_name and containing @node into a #JsonObject.
-The object will take ownership of the #JsonNode.
-
-</description>
-<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="scale_y">
+<parameter_description> double factor to scale actor by vertically.
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="center_x">
+<parameter_description> X coordinate of the center of the scale.
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the value of the member
+<parameter name="center_y">
+<parameter_description> Y coordinate of the center of the scale
</parameter_description>
</parameter>
</parameters>
@@ -3366,65 +4193,41 @@
</return>
</function>
-<function name="clutter_stage_set_fogx">
+<function name="clutter_redraw">
<description>
-Sets the depth cueing settings for the @stage. This is the fixed point
-version of clutter_stage_set_fog().
-
-Since: 0.6
+Forces a redraw of the entire stage. Applications should never use this
+function, but queue a redraw using clutter_actor_queue_redraw().
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="fog">
-<parameter_description> a #ClutterFog structure
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_model_set_types">
+<function name="ClutterBehaviourScale">
<description>
-Sets the types of the columns inside a #ClutterModel.
-
-This function is meant primarily for #GObjects that inherit from
-#ClutterModel, and should only be used when contructing a #ClutterModel.
-It will not work after the initial creation of the #ClutterModel.
+The final scaling factor on the Y axis for the actors.
Since: 0.6
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="n_columns">
-<parameter_description> number of columns for the model
-</parameter_description>
-</parameter>
-<parameter name="types">
-<parameter_description> an array of #GType types
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
-<function name="ClutterBehaviourScale">
+<function name="clutter_get_option_group_without_init">
<description>
-The final scaling factor on the Y axis for the actors.
-
-Since: 0.6
+Return value: (transfer full): a #GOptionGroup for the commandline arguments
</description>
<parameters>
</parameters>
-<return></return>
+<return> (transfer full): a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+Since: 0.8.2
+</return>
</function>
<function name="clutter_texture_set_cogl_texture">
@@ -3453,6 +4256,8 @@
<description>
Raises @self to the top.
+This function calls clutter_actor_raise() internally.
+
</description>
<parameters>
<parameter name="self">
@@ -3482,6 +4287,26 @@
</return>
</function>
+<function name="clutter_path_remove_node">
+<description>
+Removes the node at the given offset from the path.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> index of the node to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_move_byu">
<description>
Moves an actor by the specified distance relative to its current
@@ -3510,6 +4335,31 @@
<return></return>
</function>
+<function name="clutter_path_add_line_to">
+<description>
+Adds a #CLUTTER_PATH_LINE_TO type node to the path. This causes the
+actor to move to the new coordinates in a straight line.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x coordinate
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y coordinate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_score_stop">
<description>
Stops and rewinds a playing #ClutterScore instance.
@@ -3545,70 +4395,62 @@
</return>
</function>
-<function name="clutter_timeline_is_playing">
+<function name="clutter_score_rewind">
<description>
-Query state of a #ClutterTimeline instance.
+Rewinds a #ClutterScore to its initial state.
+Since: 0.6
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="score">
+<parameter_description> A #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> TRUE if timeline is currently playing, FALSE if not.
-</return>
+<return></return>
</function>
<function name="clutter_color_darken">
<description>
-Darkens @src by a fixed amount, and saves the changed color
-in @dest.
+Darkens @color by a fixed amount, and saves the changed color
+in @result.
</description>
<parameters>
-<parameter name="src">
+<parameter name="color">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the darker color
+<parameter name="result">
+<parameter_description> (out): return location for the darker color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_redraw">
-<description>
-Forces a redraw of the entire stage. Applications should never use this
-function, but queue a redraw using clutter_actor_queue_redraw().
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_behaviour_bspline_get_origin">
+<function name="clutter_interval_validate">
<description>
-Gets the origin of the bezier.
+Validates the initial and final values of @interval against
+a #GParamSpec.
-Since: 0.4
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot where to store the origin of the bezier
+<parameter name="pspec">
+<parameter_description> a #GParamSpec
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the #ClutterInterval is valid, %FALSE otherwise
+
+Since: 1.0
+</return>
</function>
<function name="clutter_set_motion_events_frequency">
@@ -3653,30 +4495,26 @@
<return></return>
</function>
-<function name="clutter_actor_move_anchor_point">
+<function name="json_generator_to_data">
<description>
-Sets an anchor point for the @actor, and adjusts the actor postion so
-that the relative position of the actor toward its parent remains the
-same.
+Generates a JSON data stream from @generator and returns it as a
+buffer.
-Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="anchor_x">
-<parameter_description> X coordinate of the anchor point
+<parameter name="generator">
+<parameter_description> a #JsonGenerator
</parameter_description>
</parameter>
-<parameter name="anchor_y">
-<parameter_description> Y coordinate of the anchor point
+<parameter name="length">
+<parameter_description> return location for the length of the returned buffer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a newly allocated buffer holding a JSON data stream. Use
+g_free() to free the allocated resources.
+</return>
</function>
<function name="clutter_model_iter_next">
@@ -3693,37 +4531,53 @@
</parameter_description>
</parameter>
</parameters>
-<return> The passed iterator, updated to point at the next
+<return> (transfer none): The passed iterator, updated to point at the next
row in the model.
Since: 0.6
</return>
</function>
-<function name="clutter_model_filter_row">
+<function name="clutter_stage_get_perspective">
<description>
-Checks whether @row should be filtered or not using the
-filtering function set on @model.
+Retrieves the stage perspective.
-This function should be used only by subclasses of #ClutterModel.
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> A #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="perspective">
+<parameter_description> return location for a #ClutterPerspective
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_path_get_node">
+<description>
+Retrieves the node of the path indexed by @index.
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="row">
-<parameter_description> the row to filter
+<parameter name="index_">
+<parameter_description> the node number to retrieve
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> a location to store a copy of the node
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the row should be displayed,
-%FALSE otherwise
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_x11_texture_pixmap_new">
@@ -3738,19 +4592,34 @@
</return>
</function>
-<function name="clutter_value_get_fixed">
+<function name="clutter_text_new">
<description>
-Gets the fixed point value stored inside @value.
+Creates a new #ClutterText actor. This actor can be used to
+display and edit text.
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to #CLUTTER_TYPE_FIXED
+</parameters>
+<return> the newly created #ClutterText actor
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_x11_get_input_device_type">
+<description>
+Retrieves the type of @device.
+
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #ClutterX11XInputDevice
</parameter_description>
</parameter>
</parameters>
-<return> the value inside the passed #GValue
+<return> the type of the device
Since: 0.8
</return>
@@ -3776,42 +4645,27 @@
</return>
</function>
-<function name="clutter_actor_get_rotation">
+<function name="json_object_add_member">
<description>
-Retrieves the angle and center of rotation on the given axis,
-set using clutter_actor_set_angle().
-
-The coordinates of the center returned by this function depend on
-the axis passed.
-
+Adds a member named @member_name and containing @node into a #JsonObject.
+The object will take ownership of the #JsonNode.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> return value for the X coordinate of the center of rotation
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> return value for the Y coordinate of the center of rotation
+<parameter name="member_name">
+<parameter_description> the name of the member
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> return value for the Z coordinate of the center of rotation
+<parameter name="node">
+<parameter_description> the value of the member
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_model_set_filter">
@@ -3839,7 +4693,26 @@
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return></return>
+</function>
+
+<function name="clutter_text_get_justify">
+<description>
+Retrieves whether the #ClutterText actor should justify its contents
+on both margins.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the text should be justified
+
+Since: 0.6
+</return>
</function>
<function name="clutter_actor_queue_relayout">
@@ -3920,6 +4793,23 @@
</return>
</function>
+<function name="clutter_path_get_nodes">
+<description>
+Return value: (transfer container) (element-type ClutterPathNode): a list of nodes in the path.
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer container) (element-type ClutterPathNode): a list of nodes in the path.
+
+Since: 1.0
+</return>
+</function>
+
<function name="ClutterScript">
<description>
The path of the currently parsed file. If ClutterScript:filename-set
@@ -3933,18 +4823,40 @@
<return></return>
</function>
-<function name="clutter_label_get_color">
+<function name="clutter_actor_get_paint_visibility">
+<description>
+Retrieves the 'paint' visibility of an actor recursively checking for non
+visible parents.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> TRUE if the actor is visibile and will be painted.
+
+Since: 0.8.4
+</return>
+</function>
+
+<function name="clutter_cairo_set_source_color">
<description>
-Retrieves the color of @label.
+Utility function for setting the source color of @cr using
+a #ClutterColor.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="cr">
+<parameter_description> a Cairo context
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> return location for a #ClutterColor
+<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
</parameters>
@@ -3971,7 +4883,7 @@
</parameter_description>
</parameter>
<parameter name="geom">
-<parameter_description> allocation geometry in pixels
+<parameter_description> (out): allocation geometry in pixels
</parameter_description>
</parameter>
</parameters>
@@ -4038,34 +4950,113 @@
</return>
</function>
-<function name="clutter_entry_get_layout">
+<function name="clutter_path_add_cairo_path">
<description>
-Gets the #PangoLayout used to display the entry.
-The layout is useful to e.g. convert text positions to
-pixel positions.
-The returned layout is owned by the entry so need not be
-freed by the caller.
+Add the nodes of the Cairo path to the end of @path.
+Since: 1.0
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="cpath">
+<parameter_description> a Cairo path
</parameter_description>
</parameter>
</parameters>
-<return> the #PangoLayout for this entry
+<return></return>
+</function>
-Since: 0.4
-</return>
+<function name="clutter_text_delete_chars">
+<description>
+Deletes @n_chars inside a #ClutterText actor, starting from the
+current cursor position.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="n_chars">
+<parameter_description> the number of characters to delete
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="clutter_main_quit">
+<function name="clutter_model_prependv">
<description>
-Terminates the Clutter mainloop.
+Creates and prepends a new row to the #ClutterModel, setting the row
+values for the given @columns upon creation.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> the number of columns and values to set
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> (array length=n_columns): a vector containing the columns to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> (array length=n_columns): a vector containing the values for the cells
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_path_add_rel_curve_to">
+<description>
+Same as clutter_path_add_curve_to() except the coordinates are
+relative to the previous node.
+
+Since: 1.0
</description>
<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="x_1">
+<parameter_description> the x coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="y_1">
+<parameter_description> the y coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="x_2">
+<parameter_description> the x coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="y_2">
+<parameter_description> the y coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="x_3">
+<parameter_description> the x coordinate of the third control point
+</parameter_description>
+</parameter>
+<parameter name="y_3">
+<parameter_description> the y coordinate of the third control point
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -4131,20 +5122,20 @@
</description>
<parameters>
-<parameter name="dest">
-<parameter_description> return location for a #ClutterColor
+<parameter name="color">
+<parameter_description> (out): return location for a #ClutterColor
</parameter_description>
</parameter>
<parameter name="hue">
-<parameter_description> hue value (0 .. 255)
+<parameter_description> hue value, in the 0 .. 360 range
</parameter_description>
</parameter>
<parameter name="luminance">
-<parameter_description> luminance value (0 .. 255)
+<parameter_description> luminance value, in the 0 .. 1 range
</parameter_description>
</parameter>
<parameter name="saturation">
-<parameter_description> saturation value (0 .. 255)
+<parameter_description> saturation value, in the 0 .. 1 range
</parameter_description>
</parameter>
</parameters>
@@ -4170,29 +5161,27 @@
<return></return>
</function>
-<function name="clutter_scriptable_set_custom_property">
+<function name="clutter_texture_set_filter_quality">
<description>
-Overrides the common properties setting. The underlying virtual
-function should be used when implementing custom properties.
+Sets the filter quality when scaling a texture. The quality is an
+enumeration currently the following values are supported:
+%CLUTTER_TEXTURE_QUALITY_LOW which is fast but only uses nearest neighbour
+interpolation. %CLUTTER_TEXTURE_QUALITY_MEDIUM which is computationally a
+bit more expensive (bilinear interpolation), and
+%CLUTTER_TEXTURE_QUALITY_HIGH which uses extra texture memory resources to
+improve scaled down rendering as well (by using mipmaps). The default value
+is %CLUTTER_TEXTURE_QUALITY_MEDIUM.
-Since: 0.6
+Since: 0.8
</description>
<parameters>
-<parameter name="scriptable">
-<parameter_description> a #ClutterScriptable
-</parameter_description>
-</parameter>
-<parameter name="script">
-<parameter_description> the #ClutterScript creating the scriptable instance
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the property
+<parameter name="texture">
+<parameter_description> a #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value of the property
+<parameter name="filter_quality">
+<parameter_description> new filter quality value
</parameter_description>
</parameter>
</parameters>
@@ -4212,11 +5201,11 @@
</parameter_description>
</parameter>
<parameter name="scale_x">
-<parameter_description> Location to store horizonal float scale factor, or %NULL.
+<parameter_description> (out): Location to store horizonal float scale factor, or %NULL.
</parameter_description>
</parameter>
<parameter name="scale_y">
-<parameter_description> Location to store vertical float scale factor, or %NULL.
+<parameter_description> (out): Location to store vertical float scale factor, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -4236,52 +5225,12 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterStage
+<return> (transfer none): a #ClutterStage
Since: 0.8
</return>
</function>
-<function name="clutter_behaviour_bspline_truncate">
-<description>
-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
-
-</description>
-<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
-</parameter_description>
-</parameter>
-<parameter name="offset">
-<parameter_description> offset of control where the bspline should be truncated
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_label_set_text">
-<description>
-Sets @text as the text to be displayed by @label.
-
-</description>
-<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_actor_get_depthu">
<description>
Retrieves the depth of @self.
@@ -4325,43 +5274,6 @@
</return>
</function>
-<function name="clutter_effect_depth">
-<description>
-Simple effect for changing the depth of a single #ClutterActor.
-
-
-</description>
-<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="depth_end">
-<parameter_description> Final depth value to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #ClutterTimeline for the effect. Will be unrefed by
-the effect when completed.
-
-Since: 0.6
-</return>
-</function>
-
<function name="clutter_model_set_sort">
<description>
Sorts @model using the given sorting function.
@@ -4394,107 +5306,139 @@
<return></return>
</function>
-<function name="clutter_effect_template_construct">
+<function name="clutter_value_get_shader_matrix">
<description>
-Constructs a #ClutterEffectTemplate, to be used with the effects API.
-
-This function can only be called once after the creation of @template_
-and is only useful for language bindings.
+Retrieves a matrix of floating point values stored inside
+the passed #GValue. @value must have been initialized with
+%CLUTTER_TYPE_SHADER_MATRIX.
-Since: 0.6
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> a #ClutterEffectTemplate
+<parameter name="value">
+<parameter_description> a #GValue
</parameter_description>
</parameter>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="length">
+<parameter_description> (out): return location for the number of returned floating
+point values, or %NULL
</parameter_description>
</parameter>
-<parameter name="alpha_func">
-<parameter_description> an alpha function to use for the template
+</parameters>
+<return> (array length=length) (transfer none): the pointer to a matrix
+of floating point values. The returned value is owned by the #GValue and
+should never be modified or freed.
+
+Since: 0.8
+</return>
+</function>
+
+<function name="clutter_behaviour_rotate_set_bounds">
+<description>
+Sets the initial and final angles of a rotation behaviour; angles &gt;= 360
+degrees get clamped to the canonical interval &lt;0, 360).
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data to be passed to the alpha function, or %NULL
+<parameter name="angle_start">
+<parameter_description> initial angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> function to be called when disposing the alpha function's use
-data, or %NULL
+<parameter name="angle_end">
+<parameter_description> final angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_texture_set_max_tile_waste">
+<function name="clutter_timeline_clone">
<description>
-Sets the maximum number of pixels in either axis that can be wasted
-for an individual texture slice. If -1 is specified then the
-texture is forced not to be sliced and the texture creation will
-fail if the hardware can't create a texture large enough.
+Create a new #ClutterTimeline instance which has property values
+matching that of supplied timeline. The cloned timeline will not
+be started and will not be positioned to the current position of
+ timeline: you will have to start it with clutter_timeline_start().
-The value is only used when first creating a texture so changing it
-after the texture data has been set has no effect.
-Since: 0.8
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> #ClutterTimeline to duplicate.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #ClutterTimeline, cloned from @timeline
+
+Since: 0.4
+</return>
+</function>
+
+<function name="ClutterMedia">
+<description>
+The ::error signal is emitted each time an error occurred.
+
+Since: 0.2
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="media">
+<parameter_description> the #ClutterMedia instance that received the signal
</parameter_description>
</parameter>
-<parameter name="max_tile_waste">
-<parameter_description> Maximum amount of waste in pixels or -1
+<parameter name="error">
+<parameter_description> the #GError
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_tani">
+<function name="clutter_script_get_objects">
<description>
-Very fast fixed point implementation of tan function.
+Retrieves a list of objects for the given names. After @script, object
+names/return location pairs should be listed, with a %NULL pointer
+ending the list, like:
+
+&lt;informalexample&gt;&lt;programlisting&gt;
+GObject *my_label, *a_button, *main_timeline;
+
+clutter_script_get_objects (script,
+"my-label", &amp;my_label,
+"a-button", &amp;a_button,
+"main-timeline", &amp;main_timeline,
+NULL);
+&lt;/programlisting&gt;&lt;/informalexample&gt;
-ClutterAngle is an integer such that 1024 represents
-full circle.
+Note: This function does not increment the reference count of the
+returned objects.
</description>
<parameters>
-<parameter name="angle">
-<parameter_description> a #ClutterAngle
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-</parameters>
-<return> #ClutterFixed sine value.
-
-Since: 0.3
-</return>
-</function>
-
-<function name="ClutterMedia">
-<description>
-The ::error signal is emitted each time an error occurred.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="media">
-<parameter_description> the #ClutterMedia instance that received the signal
+<parameter name="first_name">
+<parameter_description> the name of the first object to retrieve
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> the #GError
+<parameter name="Varargs">
+<parameter_description> return location for a #GObject, then additional names, ending
+with %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the number of objects returned.
+
+Since: 0.6
+</return>
</function>
<function name="json_node_get_int">
@@ -4513,106 +5457,122 @@
</return>
</function>
-<function name="clutter_entry_set_color">
+<function name="ClutterCairoTexture">
<description>
-Sets the color of @entry.
+The height of the Cairo surface used by the #ClutterCairoTexture
+actor, in pixels.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> a #ClutterColor
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_center">
+<function name="clutter_actor_get_scale_gravity">
<description>
-Sets the center of the elliptical path to the point represented by knot.
+Retrieves the scale center as a compass direction. If the scale
+center was specified in pixels or units this will return
+%CLUTTER_GRAVITY_NONE.
-Since: 0.4
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> x coordinace of centre
+</parameters>
+<return> the scale gravity
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_model_appendv">
+<description>
+Creates and appends a new row to the #ClutterModel, setting the row
+values for the given @columns upon creation.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> y coordinace of centre
+<parameter name="n_columns">
+<parameter_description> the number of columns and values
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> (array length=n_columns): a vector with the columns to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> (array length=n_columns): a vector with the values
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_powx">
+<function name="clutter_model_iter_get_value">
<description>
-Calculates x to y power. (Note, if x is a constant it will be faster to
-calculate the power as clutter_pow2x (CLUTTER_FIXED_MUL(y, log2 (x)))
+Sets an initializes @value to that at @column. When done with @value,
+g_value_unset() needs to be called to free any allocated memory.
+Since: 0.6
</description>
<parameters>
-<parameter name="x">
-<parameter_description> base
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> #ClutterFixed exponent
+<parameter name="column">
+<parameter_description> column number to retrieve the value from
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> an empty #GValue to set
</parameter_description>
</parameter>
</parameters>
-<return> x in y power.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_x11_get_stage_window">
+<function name="clutter_get_font_flags">
<description>
-Gets the stages X Window.
+Gets the current font flags for rendering text. See
+clutter_set_font_flags().
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
-</parameter_description>
-</parameter>
</parameters>
-<return> An XID for the stage window.
+<return> The font flags
-Since: 0.4
+Since: 1.0
</return>
</function>
-<function name="clutter_entry_get_alignment">
+<function name="clutter_ungrab_pointer_for_device">
<description>
-Return value: The entry's #PangoAlignment
+Removes an existing grab of the pointer events for device @id.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="id">
+<parameter_description> a device id
</parameter_description>
</parameter>
</parameters>
-<return> The entry's #PangoAlignment
-
-Since 0.4
-</return>
+<return></return>
</function>
<function name="clutter_stage_queue_redraw">
@@ -4634,21 +5594,33 @@
<return></return>
</function>
-<function name="CLUTTER_ALPHA_SINE_DEC">
+<function name="clutter_animation_set_alpha">
<description>
-Convenience symbol for clutter_sine_dec_func().
+Sets @alpha as the #ClutterAlpha used by @animation.
-Since: 0.2
+If @alpha is %NULL, a new #ClutterAlpha will be constructed from
+the current values of the #ClutterAnimation:mode and
+#ClutterAnimation:timeline properties.
+
+Since: 1.0
</description>
<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha, or %NULL
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
<function name="clutter_param_spec_fixed">
<description>
-Creates a #GParamSpec for properties using #ClutterFixed values
+Creates a #GParamSpec for properties using #CoglFixed values
</description>
@@ -4688,6 +5660,24 @@
</return>
</function>
+<function name="clutter_text_get_activatable">
+<description>
+Retrieves whether a #ClutterText is activatable or not.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the actor is activatable
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_group_lower">
<description>
Lowers @actor to @sibling level in the depth ordering.
@@ -4780,15 +5770,18 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt_x">
-<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in X axis
+<parameter_description> tilt of the elipse in degrees, as #CoglFixed, around
+the center in X axis
</parameter_description>
</parameter>
<parameter name="angle_tilt_y">
-<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in Y axis
+<parameter_description> tilt of the elipse in degrees, as #CoglFixed, around
+the center in Y axis
</parameter_description>
</parameter>
<parameter name="angle_tilt_z">
-<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in Z axis
+<parameter_description> tilt of the elipse in degrees, as #CoglFixed, around
+the center in Z axis
</parameter_description>
</parameter>
</parameters>
@@ -4834,21 +5827,22 @@
</return>
</function>
-<function name="clutter_label_get_line_wrap_mode">
+<function name="clutter_timeline_set_n_frames">
<description>
-Return value: %TRUE if the lines of the label are automatically wrapped.
+Sets the total number of frames for @timeline
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="n_frames">
+<parameter_description> the number of frames
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the lines of the label are automatically wrapped.
-
-Since: 0.2
-</return>
+<return></return>
</function>
<function name="clutter_container_remove">
@@ -4879,47 +5873,35 @@
<return></return>
</function>
-<function name="clutter_set_use_mipmapped_text">
+<function name="clutter_behaviour_path_new_with_knots">
<description>
-Sets whether subsequent text rendering operations will use
-mipmapped textures or not. Using mipmapped textures will improve
-the quality for scaled down text but will use more texture memory.
+Creates a new path behaviour that will make the actors visit all of
+the given knots in order with straight lines in between.
+
+A path will be created where the first knot is used in a
+%CLUTTER_PATH_MOVE_TO and the subsequent knots are used in
+%CLUTTER_PATH_LINE_TO&lt;!-- --&gt;s.
-Since: 0.8
</description>
<parameters>
-<parameter name="value">
-<parameter_description> %TRUE to enable mipmapping or %FALSE to disable.
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_entry_set_visibility">
-<description>
-Sets whether the contents of the entry are visible or not. When visibility
-is set to %FALSE, characters are displayed as the invisible char, and will
-also appear that way when the text in the entry widget is copied elsewhere.
-
-The default invisible char is the asterisk '*', but it can be changed with
-clutter_entry_set_invisible_char().
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="knots">
+<parameter_description> an array of #ClutterKnot&lt;!-- --&gt;s
</parameter_description>
</parameter>
-<parameter name="visible">
-<parameter_description> %TRUE if the contents of the entry are displayed as plaintext.
+<parameter name="n_knots">
+<parameter_description> number of entries in @knots
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterBehaviour
+
+Since: 1.0
+</return>
</function>
<function name="clutter_script_ensure_objects">
@@ -4957,67 +5939,6 @@
<return></return>
</function>
-<function name="clutter_actor_get_clip">
-<description>
-Gets the clip area for @self, in pixels.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="xoff">
-<parameter_description> return location for the X offset of the clip rectangle, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="yoff">
-<parameter_description> return location for the Y offset of the clip rectangle, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> return location for the width of the clip rectangle, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> return location for the height of the clip rectangle, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_behaviour_rotate_set_center">
-<description>
-Sets the center of rotation. The coordinates are relative to the plane
-normal to the rotation axis set with clutter_behaviour_rotate_set_axis().
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X axis center of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y axis center of rotation
-</parameter_description>
-</parameter>
-<parameter name="z">
-<parameter_description> Z axis center of rotation
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_rotate_new">
<description>
Creates a new #ClutterBehaviourRotate. This behaviour will rotate actors
@@ -5056,80 +5977,42 @@
</return>
</function>
-<function name="clutter_behaviour_path_append_knot">
-<description>
-Appends a #ClutterKnot to the path
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
-</parameter_description>
-</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot to append.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_label_get_layout">
-<description>
-Gets the #PangoLayout used to display the label.
-The layout is useful to e.g. convert text positions to
-pixel positions.
-The returned layout is owned by the label so need not be
-freed by the caller.
-
-
-</description>
-<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-</parameters>
-<return> the #PangoLayout for this label
-
-Since: 0.2
-</return>
-</function>
-
-<function name="clutter_actor_set_parent">
+<function name="clutter_x11_add_filter">
<description>
-Sets the parent of @self to @parent. The opposite function is
-clutter_actor_unparent().
+Adds an event filter function.
-This function should not be used by applications, but by custom
-'composite' actor subclasses.
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="func">
+<parameter_description> a filter function
</parameter_description>
</parameter>
-<parameter name="parent">
-<parameter_description> A new #ClutterActor parent
+<parameter name="data">
+<parameter_description> user data to be passed to the filter function, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="CLUTTER_ALPHA_SMOOTHSTEP_DEC">
+<function name="clutter_alpha_get_mode">
<description>
-Convenience symbol for clutter_smoothstep_dec_func().
+Retrieves the #ClutterAnimatioMode used by @alpha.
-Since: 0.4
</description>
<parameters>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the animation mode
+
+Since: 1.0
+</return>
</function>
<function name="clutter_win32_get_stage_window">
@@ -5172,22 +6055,22 @@
</return>
</function>
-<function name="clutter_label_get_attributes">
+<function name="clutter_text_get_layout">
<description>
-Gets the attribute list that was set on the label using
-clutter_label_set_attributes(), if any.
+Retrieves the current #PangoLayout used by a #ClutterText actor.
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the attribute list, or %NULL if none was set.
+<return> (transfer none): a #PangoLayout. The returned object is owned by
+the #ClutterText actor and should not be modified or freed
-Since: 0.2
+Since: 1.0
</return>
</function>
@@ -5290,102 +6173,63 @@
</return>
</function>
-<function name="clutter_label_set_alignment">
+<function name="clutter_path_add_node">
<description>
-Sets text alignment of the label.
+Adds @node to the end of the path.
-</description>
-<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-<parameter name="alignment">
-<parameter_description> A #PangoAlignment
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_behaviour_path_insert_knot">
-<description>
-Inserts a #ClutterKnot in the path at specified position. Values greater
-than total number of knots will append the knot at the end of path.
-
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> position in path to insert knot.
-</parameter_description>
-</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot to append.
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_bspline_append_knot">
+<function name="clutter_x11_get_stage_from_window">
<description>
-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.
+Gets the stage for a particular X window.
-Since: 0.4
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
-</parameter_description>
-</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot control point to append.
+<parameter name="win">
+<parameter_description> an X Window ID
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The stage or NULL if a stage does not exist for the window.
+
+Since: 0.8
+</return>
</function>
-<function name="clutter_behaviour_scale_get_bounds">
+<function name="clutter_path_insert_node">
<description>
-Retrieves the bounds used by scale behaviour.
+Inserts @node into the path before the node at the given offset. If
+ index_ is negative it will append the node to the end of the path.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="scale">
-<parameter_description> a #ClutterBehaviourScale
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> return location for the initial scale factor on the X
-axis, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> return location for the initial scale factor on the Y
-axis, or %NULL
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="x_scale_end">
-<parameter_description> return location for the final scale factor on the X axis,
-or %NULL
+<parameter name="index_">
+<parameter_description> offset of where to insert the node
</parameter_description>
</parameter>
-<parameter name="y_scale_end">
-<parameter_description> return location for the final scale factor on the Y axis,
-or %NULL
+<parameter name="node">
+<parameter_description> the node to insert
</parameter_description>
</parameter>
</parameters>
@@ -5406,7 +6250,7 @@
</parameter_description>
</parameter>
<parameter name="box">
-<parameter_description> return location for a #ClutterActorBox
+<parameter_description> (out): return location for a #ClutterActorBox
</parameter_description>
</parameter>
</parameters>
@@ -5425,7 +6269,27 @@
</parameter_description>
</parameter>
</parameters>
-<return> Number of frames for this #ClutterTimeline.
+<return> the number of frames
+</return>
+</function>
+
+<function name="clutter_backend_get_font_name">
+<description>
+Retrieves the default font name as set by
+clutter_backend_set_font_name().
+
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the font name for the backend. The returned string is
+owned by the #ClutterBackend and should never be modified or freed
+
+Since: 1.0
</return>
</function>
@@ -5438,7 +6302,7 @@
</description>
<parameters>
<parameter name="keyval">
-<parameter_description> a clutter key symbol
+<parameter_description> a key symbol
</parameter_description>
</parameter>
</parameters>
@@ -5459,226 +6323,335 @@
<return></return>
</function>
-<function name="clutter_threads_add_idle_full">
+<function name="json_generator_set_root">
<description>
-Adds a function to be called whenever there are no higher priority
-events pending. If the function returns %FALSE it is automatically
-removed from the list of event sources and will not be called again.
+Sets @node as the root of the JSON data stream to be serialized by
+the #JsonGenerator.
-This variant of g_idle_add_full() calls @function with the Clutter lock
-held. It can be thought of a MT-safe version for Clutter actors for the
-following use case, where you have to worry about idle_callback()
-running in thread A and accessing @self after it has been finalized
-in thread B:
+</description>
+<parameters>
+<parameter name="generator">
+<parameter_description> a #JsonGenerator
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-&lt;informalexample&gt;&lt;programlisting&gt;
-static gboolean
-idle_callback (gpointer data)
-{
-// clutter_threads_enter(); would be needed for g_idle_add()
+<function name="clutter_container_get_children">
+<description>
+Retrieves all the children of @container.
-SomeActor *self = data;
-/&lt;!-- --&gt;* do stuff with self *&lt;!-- --&gt;/
-self-&gt;idle_id = 0;
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+</parameters>
+<return> (element-type Actor) (transfer container): a list
+of #ClutterActor&lt;!-- --&gt;s. Use g_list_free() on the returned
+list when done.
-// clutter_threads_leave(); would be needed for g_idle_add()
-return FALSE;
-}
-static void
-some_actor_do_stuff_later (SomeActor *self)
-{
-self-&gt;idle_id = clutter_threads_add_idle (idle_callback, self)
-// using g_idle_add() here would require thread protection in the callback
-}
+Since: 0.4
+</return>
+</function>
-static void
-some_actor_finalize (GObject *object)
-{
-SomeActor *self = SOME_ACTOR (object);
-if (self-&gt;idle_id)
-g_source_remove (self-&gt;idle_id);
-G_OBJECT_CLASS (parent_class)-&gt;finalize (object);
-}
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+<function name="clutter_scriptable_get_id">
+<description>
+Retrieves the id of @scriptable set using clutter_scriptable_set_id().
</description>
<parameters>
-<parameter name="priority">
-<parameter_description> the priority of the timeout source. Typically this will be in the
-range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
+<parameter name="scriptable">
+<parameter_description> a #ClutterScriptable
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> function to call
+</parameters>
+<return> the id of the object. The returned string is owned by
+the scriptable object and should never be modified of freed
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_actor_get_heightu">
+<description>
+Retrieves the height of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+
+If the actor has a valid allocation, this function will return the
+height of the allocated area given to the actor.
+
+If the actor does not have a valid allocation, this function will
+return the actor's natural height, that is the preferred height of
+the actor.
+
+If you care whether you get the preferred height or the height that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_coords() to retrieve the
+allocated size or clutter_actor_get_preferred_height() to retrieve the
+preferred height.
+
+If an actor has a fixed height, for instance a height that has been
+assigned using clutter_actor_set_height(), the height returned will
+be the same value.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+</parameters>
+<return> the height of the actor, in #ClutterUnit&lt;!-- --&gt;s
+
+since: 0.6
+</return>
+</function>
+
+<function name="json_object_has_member">
+<description>
+Checks whether @object has a member named @member_name.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> functio to call when the idle source is removed
+<parameter name="member_name">
+<parameter_description> the name of a JSON object member
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
+<return> %TRUE if the JSON object has the requested member
+</return>
+</function>
-Since: 0.4
+<function name="clutter_model_get_sorting_column">
+<description>
+Retrieves the number of column used for sorting the @model.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> a column number, or -1 if the model is not sorted
+
+Since: 0.6
</return>
</function>
-<function name="clutter_container_get_children">
+<function name="clutter_color_to_hls">
<description>
-Retrieves all the children of @container.
+Converts @color to the HLS format.
+
+The @hue value is in the 0 .. 360 range. The @luminance and
+ saturation values are in the 0 .. 1 range.
+
+</description>
+<parameters>
+<parameter name="color">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="hue">
+<parameter_description> return location for the hue value or %NULL
+</parameter_description>
+</parameter>
+<parameter name="luminance">
+<parameter_description> return location for the luminance value or %NULL
+</parameter_description>
+</parameter>
+<parameter name="saturation">
+<parameter_description> return location for the saturation value or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_insert_text">
+<description>
+Inserts @text into a #ClutterActor at the given position.
+
+If @position is a negative number, the text will be appended
+at the end of the current contents of the #ClutterText.
+
+The position is expressed in characters, not in bytes.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> the text to be inserted
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of the insertion, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_x11_untrap_x_errors">
+<description>
+Removes the X error trap and returns the current status.
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
</parameters>
-<return> a list of #ClutterActor&lt;!-- --&gt;s. Use g_list_free()
-on the returned list when done.
+<return> the trapped error code, or 0 for success
Since: 0.4
</return>
</function>
-<function name="clutter_actor_get_heightu">
+<function name="clutter_interval_peek_final_value">
<description>
-Retrieves the height of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
-
-This function tries to "do what you mean", by returning the correct
-value depending on the actor's state.
-
-If the actor has a valid allocation, this function will return the
-height of the allocation box.
-
-If the actor does not have a valid allocation, this function will
-return the actor's natural height request.
-
-If you care whether you get the height request or the allocation,
-you should probably call a different function like
-clutter_actor_get_allocation_coords() to retrieve the allocation
-or clutter_actor_get_preferred_height() to retrieve the
-preferred height.
+Gets the pointer to the final value of @interval
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
</parameters>
-<return> the height of the actor, in #ClutterUnit&lt;!-- --&gt;s
+<return> (transfer none): the final value of the interval.
+The value is owned by the #ClutterInterval and it should not be
+modified or freed
-since: 0.6
+Since: 1.0
</return>
</function>
-<function name="json_object_has_member">
+<function name="clutter_model_remove">
<description>
-Checks whether @object has a member named @member_name.
+Removes the row at the given position from the model.
+Since: 0.6
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of a JSON object member
+<parameter name="row">
+<parameter_description> position of row to remove
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the JSON object has the requested member
-</return>
+<return></return>
</function>
-<function name="clutter_model_get_sorting_column">
+<function name="clutter_media_get_progress">
<description>
-Retrieves the number of column used for sorting the @model.
+Retrieves the playback progress of @media.
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return> a column number, or -1 if the model is not sorted
+<return> the playback progress, between 0.0 and 1.0
-Since: 0.6
+Since: 1.0
</return>
</function>
-<function name="clutter_media_get_buffer_percent">
+<function name="clutter_value_get_color">
<description>
-Retrieves the amount of the stream that is buffered.
+Gets the #ClutterColor contained in @value.
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="value">
+<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
</parameter_description>
</parameter>
</parameters>
-<return> percentage value
+<return> the colors inside the passed #GValue
+
+Since: 0.8.4
</return>
</function>
-<function name="clutter_color_to_hls">
+<function name="clutter_actor_set_scale_with_gravity">
<description>
-Converts @src to the HLS format. Returned HLS values are from interval
-0 .. 255.
+Scales an actor with the given factors around the given
+center point. The center point is specified as one of the compass
+directions in #ClutterGravity. For example, setting it to north
+will cause the top of the actor to remain unchanged and the rest of
+the actor to expand left, right and downwards.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="src">
-<parameter_description> a #ClutterColor
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="hue">
-<parameter_description> return location for the hue value or %NULL
+<parameter name="scale_x">
+<parameter_description> double factor to scale actor by horizontally.
</parameter_description>
</parameter>
-<parameter name="luminance">
-<parameter_description> return location for the luminance value or %NULL
+<parameter name="scale_y">
+<parameter_description> double factor to scale actor by vertically.
</parameter_description>
</parameter>
-<parameter name="saturation">
-<parameter_description> return location for the saturation value or %NULL
+<parameter name="gravity">
+<parameter_description> the location of the scale center expressed as a compass
+direction.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="JsonParser">
+<function name="cogl_pango_font_map_get_use_mipmapping">
<description>
-The ::error signal is emitted each time a #JsonParser encounters
-an error in a JSON stream.
+Retrieves whether the #CoglPangoRenderer used by @fm will
+use mipmapping when rendering the glyphs.
+
</description>
<parameters>
-<parameter name="parser">
-<parameter_description> the parser instance that received the signal
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a pointer to the #GError
+<parameter name="fm">
+<parameter_description> a #CoglPangoFontMap
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if mipmapping is used, %FALSE otherwise.
+
+Since: 1.0
+</return>
</function>
<function name="clutter_actor_get_gid">
@@ -5699,50 +6672,59 @@
</return>
</function>
-<function name="clutter_score_rewind">
+<function name="clutter_timeline_is_playing">
<description>
-Rewinds a #ClutterScore to its initial state.
+Queries state of a #ClutterTimeline.
-Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if timeline is currently playing
+</return>
</function>
<function name="clutter_media_set_filename">
<description>
-Sets the filename of the media source.
+Sets the source of @media using a file path.
+
+Since: 0.2
</description>
<parameters>
<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
<parameter name="filename">
-<parameter_description> A filename to media file.
+<parameter_description> A filename
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="CLUTTER_ALPHA_SQUARE">
+<function name="clutter_stage_manager_list_stage">
<description>
-Convenience symbol for clutter_square_func().
+Lists all currently used stages.
-Since: 0.4
</description>
<parameters>
+<parameter name="stage_manager">
+<parameter_description> a #ClutterStageManager
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> (transfer container) (element-type ClutterStage): a newly allocated list
+of #ClutterStage objects. Use g_slist_free() to deallocate it when done.
+
+Since: 0.8
+</return>
</function>
<function name="clutter_get_actor_by_gid">
@@ -5757,8 +6739,8 @@
</parameter_description>
</parameter>
</parameters>
-<return> the actor with the passed id or %NULL. The returned
-actor does not have its reference count increased.
+<return> (transfer none): the actor with the passed id or %NULL.
+The returned actor does not have its reference count increased.
Since: 0.6
</return>
@@ -5788,31 +6770,12 @@
<return></return>
</function>
-<function name="clutter_entry_insert_unichar">
-<description>
-Insert a character to the right of the current position of the cursor,
-and updates the position of the cursor.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_actor_lower_bottom">
<description>
Lowers @self to the bottom.
+This function calls clutter_actor_lower() internally.
+
</description>
<parameters>
<parameter name="self">
@@ -5839,46 +6802,113 @@
</return>
</function>
-<function name="clutter_timeline_set_n_frames">
+<function name="clutter_threads_add_idle_full">
<description>
-Sets the total number of frames for @timeline
+Adds a function to be called whenever there are no higher priority
+events pending. If the function returns %FALSE it is automatically
+removed from the list of event sources and will not be called again.
-</description>
-<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="n_frames">
-<parameter_description> the number of frames
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+This function can be considered a thread-safe variant of g_idle_add_full():
+it will call @function while holding the Clutter lock. It is logically
+equivalent to the following implementation:
-<function name="clutter_sqrti">
-<description>
-Very fast fixed point implementation of square root for integers.
+|[
+static gboolean
+idle_safe_callback (gpointer data)
+{
+SafeClosure *closure = data;
+gboolean res = FALSE;
-This function is at least 6x faster than clib sqrt() on x86, and (this is
-not a typo!) about 500x faster on ARM without FPU. It's error is &lt; 5%
-for arguments &lt; #CLUTTER_SQRTI_ARG_5_PERCENT and &lt; 10% for arguments &lt;
-#CLUTTER_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
-this function is CLUTTER_SQRTI_ARG_MAX.
+/&ast; mark the critical section &ast;/
+
+clutter_threads_enter();
+
+/&ast; the callback does not need to acquire the Clutter
+&ast; lock itself, as it is held by the this proxy handler
+&ast;/
+res = closure-&gt;callback (closure-&gt;data);
+
+clutter_threads_leave();
+
+return res;
+}
+static gulong
+add_safe_idle (GSourceFunc callback,
+gpointer data)
+{
+SafeClosure *closure = g_new0 (SafeClosure, 1);
+
+closure-&gt;callback = callback;
+closure-&gt;data = data;
+
+return g_add_idle_full (G_PRIORITY_DEFAULT_IDLE,
+idle_safe_callback,
+closure,
+g_free)
+}
+]|
+
+This function should be used by threaded applications to make sure
+that @func is emitted under the Clutter threads lock and invoked
+from the same thread that started the Clutter main loop. For instance,
+it can be used to update the UI using the results from a worker
+thread:
+
+|[
+static gboolean
+update_ui (gpointer data)
+{
+SomeClosure *closure = data;
+
+/&ast; it is safe to call Clutter API from this function because
+&ast; it is invoked from the same thread that started the main
+&ast; loop and under the Clutter thread lock
+&ast;/
+clutter_label_set_text (CLUTTER_LABEL (closure-&gt;label),
+closure-&gt;text);
+
+g_object_unref (closure-&gt;label);
+g_free (closure);
+
+return FALSE;
+}
+
+/&ast; within another thread &ast;/
+closure = g_new0 (SomeClosure, 1);
+/&ast; always take a reference on GObject instances &ast;/
+closure-&gt;label = g_object_ref (my_application-&gt;label);
+closure-&gt;text = g_strdup (processed_text_to_update_the_label);
+
+clutter_threads_add_idle_full (G_PRIORITY_HIGH_IDLE,
+update_ui,
+closure,
+NULL);
+]|
</description>
<parameters>
-<parameter name="x">
-<parameter_description> integer value
+<parameter name="priority">
+<parameter_description> the priority of the timeout source. Typically this will be in the
+range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> functio to call when the idle source is removed
</parameter_description>
</parameter>
</parameters>
-<return> integer square root.
-
+<return> the ID (greater than 0) of the event source.
-Since: 0.2
+Since: 0.4
</return>
</function>
@@ -5911,43 +6941,36 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterActor
+<return> (transfer none): a #ClutterActor
Since: 0.8
</return>
</function>
-<function name="clutter_timeline_get_speed">
+<function name="clutter_threads_leave">
<description>
-Gets the frames per second played by @timeline
+Unlocks the Clutter thread lock.
+Since: 0.4
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
</parameters>
-<return> the number of frames per second.
-</return>
+<return></return>
</function>
-<function name="clutter_sqrtx">
+<function name="json_parser_new">
<description>
-A fixed point implementation of squre root
+Creates a new #JsonParser instance. You can use the #JsonParser to
+load a JSON stream from either a file or a buffer and then walk the
+hierarchy using the data types API.
</description>
<parameters>
-<parameter name="x">
-<parameter_description> a #ClutterFixed
-</parameter_description>
-</parameter>
</parameters>
-<return> #ClutterFixed square root.
-
-Since: 0.2
+<return> the newly created #JsonParser. Use g_object_unref()
+to release all the memory it allocates.
</return>
</function>
@@ -5984,90 +7007,146 @@
<return></return>
</function>
-<function name="clutter_behaviour_rotate_set_axis">
+<function name="clutter_get_default_backend1">
<description>
-Sets the axis used by the rotate behaviour.
+Retrieves the default #ClutterBackend used by Clutter. The
+#ClutterBackend holds backend-specific configuration options.
-Since: 0.4
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> a #ClutterRotateAxis
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> (transfer none): the default backend. You should
+not ref or unref the returned object. Applications should rarely
+need to use this.
+
+Since: 0.4
+</return>
</function>
<function name="ClutterStage">
<description>
-The ::activate signal is emitted when the stage loses key focus
-from the underlying window system.
+The ::queue-redraw signal is emitted each time a #ClutterStage
+has been queued for a redraw. You can use this signal to know
+when clutter_stage_queue_redraw() has been called.
+
+Toolkits embedding a #ClutterStage which require a redraw and
+relayout cycle can stop the emission of this signal using the
+GSignal API, redraw the UI and then call clutter_redraw()
+themselves, like:
-Since: 0.6
+|[
+static void
+on_redraw_complete (void)
+{
+/&ast; execute the Clutter drawing pipeline &ast;/
+clutter_redraw ();
+}
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> the stage which was deactivated
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+static void
+on_stage_queue_redraw (ClutterStage *stage)
+{
+/&ast; this prevents the default handler to run &ast;/
+g_signal_stop_emission_by_name (stage, "queue-redraw");
-<function name="SECTION">
-<description>
-#ClutterMedia is an interface for controlling playback of media data.
+/&ast; queue a redraw with the host toolkit and call
+&ast; a function when the redraw has been completed
+&ast;/
+queue_a_redraw (G_CALLBACK (on_redraw_complete));
+}
+]|
+
+&lt;note&gt;&lt;para&gt;This signal is emitted before the Clutter paint
+pipeline is run. If you want to know when the pipeline has been
+completed you should connect to the ::paint signal on the Stage
+with g_signal_connect_after().&lt;/para&gt;&lt;/note&gt;
+
+Since: 1.0
</description>
<parameters>
-<parameter name="short_description">
-<parameter_description> An interface for controlling playback of media data.
+<parameter name="stage">
+<parameter_description> the stage which was queued for redraw
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_smoothstep_dec_func">
+<function name="SECTION">
<description>
-Convenience alpha function for a downward smoothstep curve. You can use
-this function as the alpha function for clutter_alpha_set_func().
+#ClutterBindingPool is a data structure holding a set of key bindings.
+Each key binding associates a key symbol (eventually with modifiers)
+to an action. A callback function is associated to each action.
+
+For a given key symbol and modifier mask combination there can be only one
+action; for each action there can be only one callback. There can be
+multiple actions with the same name, and the same callback can be used
+to handle multiple key bindings.
+
+Actors requiring key bindings should create a new #ClutterBindingPool
+inside their class initialization function and then install actions
+like this:
+|[
+static void
+foo_class_init (FooClass *klass)
+{
+ClutterBindingPool *binding_pool;
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="dummy">
-<parameter_description> unused
-</parameter_description>
-</parameter>
-</parameters>
-<return> an alpha value
-
-Since: 0.4
-</return>
-</function>
+binding_pool = clutter_binding_pool_get_for_class (klass);
-<function name="clutter_score_start">
-<description>
-Starts the score.
+clutter_binding_pool_install_action (binding_pool, "move-up",
+CLUTTER_Up, 0,
+G_CALLBACK (foo_action_move_up),
+NULL, NULL);
+clutter_binding_pool_install_action (binding_pool, "move-up",
+CLUTTER_KP_Up, 0,
+G_CALLBACK (foo_action_move_up),
+NULL, NULL);
+}
+]|
-Since: 0.6
+The callback has a signature of:
+
+|[
+gboolean (* callback) (GObject *instance,
+const gchar *action_name,
+guint key_val,
+ClutterModifierType modifiers,
+gpointer user_data);
+]|
+
+The actor should then override the #ClutterActor::key-press-event and
+use clutter_binding_pool_activate() to match a #ClutterKeyEvent structure
+to one of the actions:
+
+|[
+ClutterBindingPool *pool;
+
+/&ast; retrieve the binding pool for the type of the actor &ast;/
+pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (actor));
+
+/&ast; activate any callback matching the key symbol and modifiers
+&ast; mask of the key event. the returned value can be directly
+&ast; used to signal that the actor has handled the event.
+&ast;/
+return clutter_binding_pool_activate (pool, G_OBJECT (actor),
+key_event-&gt;keyval,
+key_event-&gt;modifier_state);
+]|
+
+The clutter_binding_pool_activate() function will return %FALSE if
+no action for the given key binding was found, if the action was
+blocked (using clutter_binding_pool_block_action()) or if the
+key binding handler returned %FALSE.
+
+#ClutterBindingPool is available since Clutter 1.0
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
+<parameter name="short_description">
+<parameter_description> Pool for key bindings
</parameter_description>
</parameter>
</parameters>
@@ -6092,70 +7171,71 @@
</return>
</function>
-<function name="clutter_smoothstep_inc_func">
+<function name="clutter_actor_lower">
<description>
-Convenience alpha function for a smoothstep curve. You can use this
-function as the alpha function for clutter_alpha_set_func().
+Puts @self below @above.
+
+Both actors must have the same parent.
+This function is the equivalent of clutter_container_lower_child().
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused
+<parameter name="above">
+<parameter_description> (allow-none): A #ClutterActor to lower below
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_actor_lower">
+<function name="clutter_text_activate">
<description>
-Puts @self below @above.
-Both actors must have the same parent.
+Emits the #ClutterText::activate signal, if @self has been set
+as activatable using clutter_text_set_activatable().
+
+This function can be used to emit the ::activate signal inside
+a #ClutterActor::captured-event or #ClutterActor::key-press-event
+signal handlers before the default signal handler for the
+#ClutterText is invoked.
+
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="above">
-<parameter_description> A #ClutterActor to lower below
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the ::activate signal has been emitted,
+and %FALSE otherwise
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_actor_get_anchor_point">
+<function name="clutter_actor_get_z_rotation_gravity">
<description>
-Gets the current anchor point of the @actor in pixels.
+Retrieves the center for the rotation around the Z axis as a
+compass direction. If the center was specified in pixels or units
+this will return %CLUTTER_GRAVITY_NONE.
-Since: 0.6
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="anchor_x">
-<parameter_description> return location for the X coordinate of the anchor point
-</parameter_description>
-</parameter>
-<parameter name="anchor_y">
-<parameter_description> return location for the y coordinate of the anchor point
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the Z rotation center
+
+Since: 1.0
+</return>
</function>
<function name="clutter_behaviour_rotate_set_direction">
@@ -6247,23 +7327,22 @@
<return></return>
</function>
-<function name="json_generator_set_root">
+<function name="clutter_interval_clone">
<description>
-Sets @node as the root of the JSON data stream to be serialized by
-the #JsonGenerator.
+Creates a copy of @interval.
+
</description>
<parameters>
-<parameter name="generator">
-<parameter_description> a #JsonGenerator
-</parameter_description>
-</parameter>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterInterval
+
+Since: 1.0
+</return>
</function>
<function name="clutter_group_add_many_valist">
@@ -6292,15 +7371,84 @@
<return></return>
</function>
-<function name="clutter_label_new">
+<function name="cogl_pango_font_map_new">
+<description>
+Creates a new font map.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #PangoFontMap
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_model_get_iter_at_row">
+<description>
+Retrieves a #ClutterModelIter representing the row at the given index.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> position of the row to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer full): A new #ClutterModelIter, or %NULL if @row was
+out of bounds. When done using the iterator object, call g_object_unref()
+to deallocate its resources
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_animation_update_property">
+<description>
+Changes the @interval for @property_name. The #ClutterAnimation
+will take ownership of the passed #ClutterInterval.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
+</parameter_description>
+</parameter>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_get_duration">
<description>
-Creates a new, empty #ClutterLabel.
+Retrieves the duration of @animation, in milliseconds.
</description>
<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #ClutterLabel
+<return> the duration of the animation
+
+Since: 1.0
</return>
</function>
@@ -6357,37 +7505,14 @@
</return>
</function>
-<function name="clutter_entry_get_visible_cursor">
-<description>
-Return value: whether the input cursor is visible
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-</parameters>
-<return> whether the input cursor is visible
-
-Since: 0.4
-</return>
-</function>
-
-<function name="clutter_model_remove">
+<function name="clutter_actor_remove_clip">
<description>
-Removes the row at the given position from the model.
-
-Since: 0.6
+Removes clip area from @self.
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="row">
-<parameter_description> position of row to remove
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
@@ -6402,7 +7527,7 @@
</description>
<parameters>
</parameters>
-<return> the actor currently holding the pointer grab, or NULL if there is no grab.
+<return> (transfer none): the actor currently holding the pointer grab, or NULL if there is no grab.
Since: 0.6
</return>
@@ -6457,23 +7582,25 @@
</parameter_description>
</parameter>
</parameters>
-<return> A new #ClutterModelIter. Call g_object_unref() when
+<return> (transfer full): A new #ClutterModelIter. Call g_object_unref() when
done using it
Since: 0.6
</return>
</function>
-<function name="ClutterModel">
+<function name="ClutterText">
<description>
-The ::filter-changed signal is emitted when a new filter has been applied
+The ::activate signal is emitted each time the actor is 'activated'
+by the user, normally by pressing the 'Enter' key. The signal is
+emitted only if #ClutterText:activatable is set to %TRUE.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> the #ClutterModel on which the signal is emitted
+<parameter name="self">
+<parameter_description> the #ClutterText that emitted the signal
</parameter_description>
</parameter>
</parameters>
@@ -6493,36 +7620,8 @@
<parameter_description> the object which received the signal
</parameter_description>
</parameter>
-<parameter name="knot">
-<parameter_description> the #ClutterKnot reached
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_entry_insert_text">
-<description>
-Insert text at a specifc position.
-
-A value of 0 indicates that the text will be inserted before the first
-character in the entry's text, and a value of -1 indicates that the text
-will be inserted after the last character in the entry's text.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to insert
-</parameter_description>
-</parameter>
-<parameter name="position">
-<parameter_description> the position at which to insert the text.
+<parameter name="knot_num">
+<parameter_description> the index of the #ClutterPathKnot reached
</parameter_description>
</parameter>
</parameters>
@@ -6533,8 +7632,17 @@
<description>
Grabs pointer events, after the grab is done all pointer related events
(press, motion, release, enter, leave and scroll) are delivered to this
-actor directly. The source set in the event will be the actor that would
-have received the event if the pointer grab was not in effect.
+actor directly without passing through both capture and bubble phases of
+the event delivery chain. The source set in the event will be the actor
+that would have received the event if the pointer grab was not in effect.
+
+&lt;note&gt;&lt;para&gt;Grabs completely override the entire event delivery chain
+done by Clutter. Pointer grabs should only be used as a last resource;
+using the #ClutterActor::captured-event signal should always be the
+preferred way to intercept event delivery to reactive actors.&lt;/para&gt;&lt;/note&gt;
+
+If you wish to grab all the pointer events for a specific input device,
+you should use clutter_grab_pointer_for_device().
Since: 0.6
@@ -6567,34 +7675,21 @@
<return></return>
</function>
-<function name="clutter_stage_set_fog">
+<function name="clutter_animation_set_object">
<description>
-Sets the GL fog settings used to create the depth cueing effect
-on the @stage.
+Attaches @animation to @object. The #ClutterAnimation will take a
+reference on @object.
-If the actors are all near the view point you will need a higher @density
-and a smaller interval between @z_near and @z_far. On the other hand, if
-actors are placed far away from the view point you will need a lower
- density but a bigger interval between @z_near and @z_far.
-
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="density">
-<parameter_description> density of the intensity dampening
-</parameter_description>
-</parameter>
-<parameter name="z_near">
-<parameter_description> starting point of the depth cueing
-</parameter_description>
-</parameter>
-<parameter name="z_far">
-<parameter_description> ending point of the depth cueing
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
</parameters>
@@ -6617,6 +7712,24 @@
<return></return>
</function>
+<function name="clutter_value_get_fixed">
+<description>
+Gets the fixed point value stored inside @value.
+
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GValue initialized to %COGL_TYPE_FIXED
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value inside the passed #GValue
+
+Since: 0.8
+</return>
+</function>
+
<function name="clutter_texture_set_area_from_rgb_data">
<description>
Updates a sub-region of the pixel data in a #ClutterTexture.
@@ -6657,7 +7770,8 @@
</parameter_description>
</parameter>
<parameter name="bpp">
-<parameter_description> bytes per pixel ( Currently only 4 supported )
+<parameter_description> bytes per pixel (Currently only 3 and 4 supported,
+depending on @has_alpha)
</parameter_description>
</parameter>
<parameter name="flags">
@@ -6671,107 +7785,110 @@
</parameters>
<return> %TRUE on success, %FALSE on failure.
-Since 0.6.
+Since: 0.6
</return>
</function>
-<function name="clutter_entry_handle_key_event">
+<function name="clutter_stage_set_color">
<description>
-This function will handle a #ClutterKeyEvent, like those returned in a
-key-press/release-event, and will translate it for the @entry. This includes
-non-alphanumeric keys, such as the arrows keys, which will move the
-input cursor. You should use this function inside a handler for the
-ClutterStage::key-press-event or ClutterStage::key-release-event.
-
-Since: 0.4
-
-Deprecated: 0.8: The key events will automatically be handled when
-giving the key focus to an entry using clutter_stage_set_key_focus().
+Sets the stage color.
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="stage">
+<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="kev">
-<parameter_description> a #ClutterKeyEvent
+<parameter name="color">
+<parameter_description> A #ClutterColor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_generator_new">
+<function name="clutter_actor_get_yu">
<description>
-Creates a new #JsonGenerator. You can use this object to generate a
-JSON data stream starting from a data object model composed by
-#JsonNode&lt;!-- --&gt;s.
+Retrieves the Y coordinate of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+
+This function tries to "do what you mean", by returning the
+correct value depending on the actor's state.
+
+If the actor has a valid allocation, this function will return
+the Y coordinate of the origin of the allocation box.
+
+If the actor has any fixed coordinate set using clutter_actor_set_y(),
+clutter_actor_set_position() or clutter_actor_set_geometry(), this
+function will return that coordinate.
+
+If both the allocation and a fixed position are missing, this function
+will return 0.
</description>
<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #JsonGenerator instance
+<return> the Y coordinate, in #ClutterUnit&lt;!-- --&gt;s, ignoring
+any transformation (i.e. scaling, rotation)
+
+Since: 0.6
</return>
</function>
-<function name="clutter_shader_set_is_enabled">
+<function name="clutter_backend_set_font_options">
<description>
-Enables a shader. This function will attempt to compile and link
-the shader, if it isn't already.
+Sets the new font options for @backend. The #ClutterBackend will
+copy the #cairo_font_options_t.
-When @enabled is %FALSE the default state of the GL pipeline will be
-used instead.
+If @options is %NULL, the first following call to
+clutter_backend_get_font_options() will return the default font
+options for @backend.
-Since: 0.6
+This function is intended for actors creating a Pango layout
+using the PangoCairo API.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
-<parameter name="enabled">
-<parameter_description> The new state of the shader.
+<parameter name="options">
+<parameter_description> Cairo font options for the backend, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_scale_newx">
+<function name="clutter_shader_set_is_enabled">
<description>
-A fixed point implementation of clutter_behaviour_scale_new()
+Enables a shader. This function will attempt to compile and link
+the shader, if it isn't already.
+
+When @enabled is %FALSE the default state of the GL pipeline will be
+used instead.
+Since: 0.6
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> initial scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> initial scale factor on the Y axis
-</parameter_description>
-</parameter>
-<parameter name="x_scale_end">
-<parameter_description> final scale factor on the X axis
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
-<parameter name="y_scale_end">
-<parameter_description> final scale factor on the Y axis
+<parameter name="enabled">
+<parameter_description> The new state of the shader.
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterBehaviourScale
-
-Since: 0.2
-</return>
+<return></return>
</function>
<function name="clutter_glx_texture_pixmap_using_extension">
@@ -6798,6 +7915,8 @@
the alpha value at each frame of the #ClutterTimeline
bound to @alpha.
+This function will not register @func as a global alpha function.
+
Since: 0.2
</description>
@@ -6807,7 +7926,7 @@
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> A #ClutterAlphaAlphaFunc
+<parameter_description> A #ClutterAlphaFunc
</parameter_description>
</parameter>
<parameter name="data">
@@ -6822,14 +7941,21 @@
<return></return>
</function>
-<function name="clutter_actor_remove_clip">
+<function name="clutter_actor_destroy">
<description>
-Removes clip area from @self.
+Destroys an actor. When an actor is destroyed, it will break any
+references it holds to other objects. If the actor is inside a
+container, the actor will be removed.
+
+When you destroy a container, its children will be destroyed as well.
+
+Note: you cannot destroy the #ClutterStage returned by
+clutter_stage_get_default().
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
@@ -6840,20 +7966,22 @@
<description>
Retrieves the width of a #ClutterActor.
-This function tries to "do what you mean", by returning the correct
-value depending on the actor's state.
-
If the actor has a valid allocation, this function will return the
-width of the allocation box.
+width of the allocated area given to the actor.
If the actor does not have a valid allocation, this function will
-return the actor's natural width request.
+return the actor's natural width, that is the preferred width of
+the actor.
-If you care whether you get the width request or the allocation,
-you should probably call a different function like
-clutter_actor_get_allocation_coords() to retrieve the allocation
-or clutter_actor_get_preferred_width() to retrieve the preferred
-width.
+If you care whether you get the preferred width or the width that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_coords() to retrieve the
+allocated size or clutter_actor_get_preferred_width() to retrieve the
+preferred width.
+
+If an actor has a fixed width, for instance a width that has been
+assigned using clutter_actor_set_width(), the width returned will
+be the same value.
</description>
@@ -6891,44 +8019,116 @@
<return></return>
</function>
-<function name="clutter_behaviour_path_remove_knot">
+<function name="clutter_shader_set_uniform">
<description>
-Removes a #ClutterKnot in the path at specified offset.
+Sets a user configurable variable in the GLSL shader programs attached to
+a #ClutterShader.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
+<parameter name="shader">
+<parameter_description> a #ClutterShader.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> name of uniform in GLSL shader program to set.
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> position in path to remove knot.
+<parameter name="value">
+<parameter_description> a #ClutterShaderFloat, #ClutterShaderInt or #ClutterShaderMatrix
+#GValue.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_alpha_get_timeline">
+<function name="clutter_behaviour_ellipse_get_angle_endx">
<description>
-Gets the #ClutterTimeline bound to @alpha.
+Gets the angle at which movements ends.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline instance
+<return> angle, as #CoglFixed, in degrees
-Since: 0.2
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_actor_set_shader_param_int">
+<description>
+Sets the value for a named int parameter of the shader applied to
+ actor
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="param">
+<parameter_description> the name of the parameter
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the parameter
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="json_node_type_name">
+<description>
+Retrieves the user readable name of the data type contained by @node.
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the name of the type. The returned string
+is owned by the node and should never be modified or freed
</return>
</function>
+<function name="clutter_path_foreach">
+<description>
+Calls a function for each node of the path.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the function to call with each node
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_get_center">
<description>
Retrieves the center of rotation set using
@@ -7035,23 +8235,50 @@
<return></return>
</function>
-<function name="clutter_x11_untrap_x_errors">
+<function name="clutter_behaviour_rotate_set_axis">
<description>
-Removes the X error trap and returns the current status.
+Sets the axis used by the rotate behaviour.
+Since: 0.4
</description>
<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> a #ClutterRotateAxis
+</parameter_description>
+</parameter>
</parameters>
-<return> the trapped error code, or 0 for success
+<return></return>
+</function>
-Since: 0.4
-</return>
+<function name="clutter_clone_set_source">
+<description>
+Sets @source as the source actor to be cloned by @clone.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="clone">
+<parameter_description> a #ClutterClone
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> a #ClutterActor, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_threads_add_idle">
<description>
-Simple wrapper around clutter_threads_add_idle_full()
+Simple wrapper around clutter_threads_add_idle_full() using the
+default priority.
</description>
@@ -7093,43 +8320,33 @@
</parameter_description>
</parameter>
<parameter name="box">
-<parameter_description> the function fills this in with the actor's allocation
+<parameter_description> (out): the function fills this in with the actor's allocation
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_label_new_full">
+<function name="clutter_threads_add_frame_source_full">
<description>
-Creates a new #ClutterLabel displaying @text with @color
-using @font_name.
-
+Sets a function to be called at regular intervals holding the Clutter
+threads lock, with the given priority. The function is called repeatedly
+until it returns %FALSE, at which point the timeout is automatically
+removed and the function will not be called again. The @notify function
+is called when the timeout is removed.
+
+This function is similar to clutter_threads_add_timeout_full()
+except that it will try to compensate for delays. For example, if
+ func takes half the interval time to execute then the function
+will be called again half the interval time after it finished. In
+contrast clutter_threads_add_timeout_full() would not fire until a
+full interval after the function completes so the delay between
+calls would be @interval * 1.5. This function does not however try
+to invoke the function multiple times to catch up missing frames if
+ func takes more than @interval ms to execute.
-</description>
-<parameters>
-<parameter name="font_name">
-<parameter_description> the name (and size) of the font to be used
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> #ClutterColor for text
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #ClutterLabel
-</return>
-</function>
+See also clutter_threads_add_idle_full().
-<function name="clutter_threads_add_frame_source_full">
-<description>
-Sets a function to be called at regular intervals holding the Clutter lock,
-with the given priority. The function is called repeatedly until it
-Return value: the ID (greater than 0) of the event source.
</description>
<parameters>
@@ -7161,19 +8378,36 @@
</return>
</function>
-<function name="clutter_event_type">
+<function name="clutter_color_from_string">
<description>
-Retrieves the type of the event.
+Parses a string definition of a color, filling the
+&lt;structfield&gt;red&lt;/structfield&gt;, &lt;structfield&gt;green&lt;/structfield&gt;,
+&lt;structfield&gt;blue&lt;/structfield&gt; and &lt;structfield&gt;alpha&lt;/structfield&gt;
+channels of @color. If alpha is not specified it will be set full opaque.
+
+The @color is not allocated.
+
+The color may be defined by any of the formats understood by
+pango_color_from_string(); these include literal color names, like
+&lt;literal&gt;Red&lt;/literal&gt; or &lt;literal&gt;DarkSlateGray&lt;/literal&gt;, or
+hexadecimal specifications like &lt;literal&gt;&num;3050b2&lt;/literal&gt; or
+&lt;literal&gt;&num;333&lt;/literal&gt;.
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="color">
+<parameter_description> (out): return location for a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> a string specifiying a color (named color or #RRGGBBAA)
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterEventType
+<return> %TRUE if parsing succeeded.
+
+Since: 1.0
</return>
</function>
@@ -7194,69 +8428,78 @@
</return>
</function>
-<function name="clutter_media_get_position">
+<function name="clutter_behaviour_ellipse_set_angle_startx">
<description>
-Retrieves the position of @media.
+Sets the angle at which movement starts; angles &gt;= 360 degress get clamped
+to the canonical interval &lt;0, 360).
+Since: 0.6
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="angle_start">
+<parameter_description> An angle, as #CoglFixed, at which movement starts, in
+degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
-<return> The playback position.
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_angle_startx">
+<function name="clutter_interval_compute_value">
<description>
-Sets the angle at which movement starts; angles &gt;= 360 degress get clamped
-to the canonical interval &lt;0, 360).
+Computes the value between the @interval boundaries given the
+progress @factor and puts it into @value.
-Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="angle_start">
-<parameter_description> An angle, as #ClutterFixed, at which movement starts, in
-degrees, between 0 and 360.
+<parameter name="factor">
+<parameter_description> the progress factor, between 0 and 1
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> return location for an initialized #GValue
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the operation was successful
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_shader_get_vertex_source">
+<function name="clutter_text_get_editable">
<description>
-Query the current GLSL vertex source set on @shader.
+Retrieves whether a #ClutterText is editable or not.
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the source of the vertex shader for this
-ClutterShader object or %NULL. The returned string is owned by the
-shader object and should never be modified or freed
+<return> %TRUE if the actor is editable
-Since: 0.6
+Since: 1.0
</return>
</function>
<function name="clutter_timeline_rewind">
<description>
Rewinds #ClutterTimeline to the first frame if its direction is
-CLUTTER_TIMELINE_FORWARD and the last frame if it is
-CLUTTER_TIMELINE_BACKWARD.
+%CLUTTER_TIMELINE_FORWARD and the last frame if it is
+%CLUTTER_TIMELINE_BACKWARD.
</description>
<parameters>
@@ -7306,28 +8549,90 @@
</return>
</function>
-<function name="clutter_behaviour_bspline_set_origin">
+<function name="clutter_binding_pool_install_action">
<description>
-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.)
+Installs a new action inside a #ClutterBindingPool. The action
+is bound to @key_val and @modifiers.
-Since: 0.4
+The same action name can be used for multiple @key_val, @modifiers
+pairs.
+
+When an action has been activated using clutter_binding_pool_activate()
+the passed @callback will be invoked (with @data).
+
+Actions can be blocked with clutter_binding_pool_block_action()
+and then unblocked using clutter_binding_pool_unblock_action().
+
+Since: 1.0
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
</parameter_description>
</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot origin for the bezier
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask of modifiers
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> function to be called when the action is activated
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to be passed to @callback
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to be called when the action is removed
+from the pool
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_binding_pool_get_for_class">
+<description>
+Retrieves the #ClutterBindingPool for the given #GObject class
+and, eventually, creates it. This function is a wrapper around
+clutter_binding_pool_new() and uses the class type name as the
+unique name for the binding pool.
+
+Calling this function multiple times will return the same
+#ClutterBindingPool.
+
+A binding pool for a class can also be retrieved using
+clutter_binding_pool_find() with the class type name:
+
+|[
+pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (instance));
+]|
+
+
+</description>
+<parameters>
+<parameter name="klass">
+<parameter_description> a #GObjectClass pointer
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the binding pool for the given class.
+The returned #ClutterBindingPool is owned by Clutter and should not
+be freed directly
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_get_clipu">
<description>
Unit-based variant of clutter_actor_get_clip().
@@ -7343,19 +8648,19 @@
</parameter_description>
</parameter>
<parameter name="xoff">
-<parameter_description> return location for the X offset of the clip rectangle, or %NULL
+<parameter_description> (out): return location for the X offset of the clip rectangle, or %NULL
</parameter_description>
</parameter>
<parameter name="yoff">
-<parameter_description> return location for the Y offset of the clip rectangle, or %NULL
+<parameter_description> (out): return location for the Y offset of the clip rectangle, or %NULL
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the width of the clip rectangle, or %NULL
+<parameter_description> (out): return location for the width of the clip rectangle, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the height of the clip rectangle, or %NULL
+<parameter_description> (out): return location for the height of the clip rectangle, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7374,7 +8679,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> angle, as #ClutterFixed, in degrees.
+<return> angle, as #CoglFixed, in degrees.
Since: 0.6
</return>
@@ -7382,7 +8687,7 @@
<function name="clutter_container_class_list_child_properties">
<description>
-Return value: an array of #GParamSpec&lt;!-- --&gt;s which should be freed
+Return value: (array length=n_properties) (transfer container): an array
</description>
<parameters>
@@ -7395,13 +8700,31 @@
</parameter_description>
</parameter>
</parameters>
-<return> an array of #GParamSpec&lt;!-- --&gt;s which should be freed
-after use.
+<return> (array length=n_properties) (transfer container): an array
+of #GParamSpec&lt;!-- --&gt;s which should be freed after use.
Since: 0.8
</return>
</function>
+<function name="clutter_media_get_audio_volume">
+<description>
+Retrieves the playback volume of @media.
+
+
+</description>
+<parameters>
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+</parameters>
+<return> The playback volume between 0.0 and 1.0
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_get_geometry">
<description>
Gets the size and position of an actor relative to its parent
@@ -7416,7 +8739,7 @@
</parameter_description>
</parameter>
<parameter name="geometry">
-<parameter_description> A location to store actors #ClutterGeometry
+<parameter_description> (out): A location to store actors #ClutterGeometry
</parameter_description>
</parameter>
</parameters>
@@ -7425,10 +8748,18 @@
<function name="ClutterActor">
<description>
-The ::unrealize signal is emitted each time an actor is being
-unrealized.
+The ::pick signal is emitted each time an actor is being painted
+in "pick mode". The pick mode is used to identify the actor during
+the event handling phase, or by clutter_stage_get_actor_at_pos().
+The actor should paint its shape using the passed @pick_color.
-Since: 0.8
+Subclasses of #ClutterActor should override the class signal handler
+and paint themselves in that function.
+
+It is possible to connect a handler to the ::pick signal in order
+to set up some custom aspect of a paint in pick mode.
+
+Since: 1.0
</description>
<parameters>
@@ -7436,59 +8767,105 @@
<parameter_description> the #ClutterActor that received the signal
</parameter_description>
</parameter>
+<parameter name="color">
+<parameter_description> the #ClutterColor to be used when picking
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_width">
+<function name="clutter_alpha_set_mode">
<description>
-Sets the width of the elliptical path.
+Sets the progress function of @alpha using the symbolic value
+of @mode, as taken by the #ClutterAnimationMode enumeration or
+using the value returned by clutter_alpha_register_func().
-Since: 0.4
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> a #ClutterAnimationMode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_insert_unichar">
+<description>
+Inserts @wc at the current cursor position of a
+#ClutterText actor.
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> width of the ellipse
+<parameter name="wc">
+<parameter_description> a Unicode character
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_get_yu">
+<function name="clutter_x11_has_event_retrieval">
<description>
-Retrieves the Y coordinate of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+Queries the X11 backend to check if event collection has been disabled.
-This function tries to "do what you mean", by returning the
-correct value depending on the actor's state.
-If the actor has a valid allocation, this function will return
-the Y coordinate of the origin of the allocation box.
+</description>
+<parameters>
+</parameters>
+<return> TRUE if event retrival has been disabled. FALSE otherwise.
-If the actor has any fixed coordinate set using clutter_actor_set_y(),
-clutter_actor_set_position() or clutter_actor_set_geometry(), this
-function will return that coordinate.
+Since: 0.8
+</return>
+</function>
-If both the allocation and a fixed position are missing, this function
-will return 0.
+<function name="clutter_behaviour_ellipse_set_width">
+<description>
+Sets the width of the elliptical path.
+Since: 0.4
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> width of the ellipse
</parameter_description>
</parameter>
</parameters>
-<return> the Y coordinate, in #ClutterUnit&lt;!-- --&gt;s, ignoring
-any transformation (i.e. scaling, rotation)
+<return></return>
+</function>
-Since: 0.6
+<function name="clutter_x11_get_current_event_time">
+<description>
+Retrieves the timestamp of the last X11 event processed by
+Clutter. This might be different from the timestamp returned
+by clutter_get_current_event_time(), as Clutter may synthesize
+or throttle events.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a timestamp, in milliseconds
+
+Since: 1.0
</return>
</function>
@@ -7504,34 +8881,46 @@
</parameter_description>
</parameter>
</parameters>
-<return> the actor with key focus, or the stage
+<return> (transfer none): the actor with key focus, or the stage
Since: 0.6
</return>
</function>
-<function name="clutter_get_motion_events_frequency">
+<function name="clutter_text_get_text">
<description>
-Retrieves the number of motion events per second that are delivered
-to the stage.
+Retrieves a pointer to the current contents of a #ClutterText
+actor.
-See clutter_set_motion_events_frequency().
+If you need a copy of the contents for manipulating, either
+use g_strdup() on the returned string, or use:
+
+|[
+copy = clutter_text_get_chars (text, 0, -1);
+]|
+
+Which will return a newly allocated string.
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
</parameters>
-<return> the number of motion events per second
+<return> the contents of the actor. The returned string
+is owned by the #ClutterText actor and should never be
+modified or freed
-Since: 0.6
+Since: 1.0
</return>
</function>
-<function name="clutter_sine_half_func">
+<function name="clutter_behaviour_path_new_with_description">
<description>
-Convenience alpha function for a sine wave over interval [0, pi].
-You can use this function as the alpha function for
-clutter_alpha_set_func().
+Creates a new path behaviour using the path described by @desc. See
+clutter_path_add_string() for a description of the format.
</description>
@@ -7540,17 +8929,86 @@
<parameter_description> a #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="desc">
+<parameter_description> a string description of the path
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return> a #ClutterBehaviour
-Since: 0.4
+Since: 1.0
</return>
</function>
+<function name="json_node_set_int">
+<description>
+Sets @value as the integer content of the @node, replacing any existing
+content.
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> an integer value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_set_mode">
+<description>
+Sets the animation @mode of @animation. The animation @mode is
+a logical id, either coming from the #ClutterAnimationMode enumeration
+or the return value of clutter_alpha_register_func().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_model_set_types">
+<description>
+Sets the types of the columns inside a #ClutterModel.
+
+This function is meant primarily for #GObjects that inherit from
+#ClutterModel, and should only be used when contructing a #ClutterModel.
+It will not work after the initial creation of the #ClutterModel.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> number of columns for the model
+</parameter_description>
+</parameter>
+<parameter name="types">
+<parameter_description> (array length=n_columns): an array of #GType types
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_shader_compile">
<description>
Compiles and links GLSL sources set for vertex and fragment shaders for
@@ -7601,6 +9059,29 @@
<return></return>
</function>
+<function name="clutter_backend_set_font_name">
+<description>
+Sets the default font to be used by Clutter. The @font_name string
+must either be %NULL, which means that the font name from the
+default #ClutterBackend will be used; or be something that can
+be parsed by the pango_font_description_from_string() function.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
+</parameter_description>
+</parameter>
+<parameter name="font_name">
+<parameter_description> the name of the font
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_container_raise_child">
<description>
Raises @actor to @sibling level, in the depth ordering.
@@ -7629,20 +9110,22 @@
<description>
Retrieves the width of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
-This function tries to "do what you mean", by returning the correct
-value depending on the actor's state.
-
If the actor has a valid allocation, this function will return the
-width of the allocation box.
+width of the allocated area given to the actor.
If the actor does not have a valid allocation, this function will
-return the actor's natural width request.
+return the actor's natural width, that is the preferred width of
+the actor.
-If you care whether you get the width request or the allocation,
-you should probably call a different function like
-clutter_actor_get_allocation_coords() to retrieve the allocation
-or clutter_actor_get_preferred_width() to retrieve the preferred
-width.
+If you care whether you get the preferred width or the width that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_coords() to retrieve the
+allocated size or clutter_actor_get_preferred_width() to retrieve the
+preferred width.
+
+If an actor has a fixed width, for instance a width that has been
+assigned using clutter_actor_set_width(), the width returned will
+be the same value.
</description>
@@ -7658,70 +9141,87 @@
</return>
</function>
-<function name="json_node_take_array">
+<function name="clutter_animation_set_loop">
<description>
-Sets @array into @node without increasing the #JsonArray reference count.
+Sets whether @animation should loop over itself once finished.
+
+A looping #ClutterAnimation will not emit the #ClutterAnimation::completed
+signal when finished.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="loop">
+<parameter_description> %TRUE if the animation should loop
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_effect_scale">
+<function name="clutter_script_get_type_from_name">
<description>
-Simple effect for scaling a single #ClutterActor.
+Looks up a type by name, using the virtual function that
+#ClutterScript has for that purpose. This function should
+rarely be used.
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
+<parameter name="type_name">
+<parameter_description> name of the type to look up
</parameter_description>
</parameter>
-<parameter name="x_scale_end">
-<parameter_description> Final X axis scale factor to apply to actor
+</parameters>
+<return> the type for the requested type name, or
+%G_TYPE_INVALID if not corresponding type was found.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_scriptable_set_custom_property">
+<description>
+Overrides the common properties setting. The underlying virtual
+function should be used when implementing custom properties.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="scriptable">
+<parameter_description> a #ClutterScriptable
</parameter_description>
</parameter>
-<parameter name="y_scale_end">
-<parameter_description> Final Y axis scale factor to apply to actor
+<parameter name="script">
+<parameter_description> the #ClutterScript creating the scriptable instance
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or NULL
+<parameter name="name">
+<parameter_description> the name of the property
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or NULL
+<parameter name="value">
+<parameter_description> the value of the property
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_alpha_set_closure">
<description>
-Sets the #GClosure used to compute
-the alpha value at each frame of the #ClutterTimeline
-bound to @alpha.
+Sets the #GClosure used to compute the alpha value at each
+frame of the #ClutterTimeline bound to @alpha.
Since: 0.8
@@ -7739,48 +9239,117 @@
<return></return>
</function>
-<function name="clutter_texture_get_base_size">
+<function name="clutter_interval_new">
<description>
-Gets the size in pixels of the untransformed underlying texture pixbuf data.
+Creates a new #ClutterInterval holding values of type @gtype.
+
+This function avoids using a #GValue for the initial and final values
+of the interval:
+
+|[
+interval = clutter_interval_new (G_TYPE_FLOAT, 0.0, 1.0);
+interval = clutter_interval_new (G_TYPE_BOOLEAN, FALSE, TRUE);
+interval = clutter_interval_new (G_TYPE_INT, 0, 360);
+]|
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="gtype">
+<parameter_description> the type of the values in the interval
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> Pointer to gint to be populated with width value if non NULL.
+<parameter name="Varargs">
+<parameter_description> the initial value and the final value of the interval
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterInterval
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_actor_allocate_preferred_size">
+<description>
+Allocates the natural size of @self.
+
+This function is a utility call for #ClutterActor implementations
+that allocates the actor's preferred natural size. It can be used
+by fixed layout managers (like #ClutterGroup or so called
+'composite actors') inside the ClutterActor::allocate
+implementation to give each child exactly how much space it
+requires.
+
+This function is not meant to be used by applications. It is also
+not meant to be used outside the implementation of the
+ClutterActor::allocate virtual function.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> Pointer to gint to be populated with height value if non NULL.
+<parameter name="absolute_origin_changed">
+<parameter_description> whether the position of the parent has
+changed in stage coordinates
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_bspline_join">
+<function name="clutter_frame_source_add_full">
<description>
-Joins a copy of bezier spline bs2 onto the end of bezier spline bs1; bs2 is
-not modified.
+Sets a function to be called at regular intervals with the given
+priority. The function is called repeatedly until it returns
+%FALSE, at which point the timeout is automatically destroyed and
+the function will not be called again. The @notify function is
+called when the timeout is destroyed. The first call to the
+function will be at the end of the first @interval.
+
+This function is similar to g_timeout_add_full() except that it
+will try to compensate for delays. For example, if @func takes half
+the interval time to execute then the function will be called again
+half the interval time after it finished. In contrast
+g_timeout_add_full() would not fire until a full interval after the
+function completes so the delay between calls would be @interval *
+1.5. This function does not however try to invoke the function
+multiple times to catch up missing frames if @func takes more than
+ interval ms to execute.
-Since: 0.4
</description>
<parameters>
-<parameter name="bs1">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="priority">
+<parameter_description> the priority of the frame source. Typically this will be in the
+range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
+</parameter_description>
+</parameter>
+<parameter name="interval">
+<parameter_description> the time between calls to the function, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
</parameter_description>
</parameter>
-<parameter name="bs2">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="notify">
+<parameter_description> function to call when the timeout source is removed
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ID (greater than 0) of the event source.
+
+Since: 0.8
+</return>
</function>
<function name="clutter_backend_get_resolution">
@@ -7822,23 +9391,23 @@
<return></return>
</function>
-<function name="clutter_stage_set_perspectivex">
+<function name="clutter_model_iter_is_last">
<description>
-Set the stage perspective. This is the fixed point version of
-clutter_stage_set_perspective().
+Gets whether the iterator is at the end of the model to which it
+belongs.
+
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="perspective">
-<parameter_description> A #ClutterPerspective
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> #TRUE if @iter is the last iter in the filtered model.
+
+Since: 0.6
+</return>
</function>
<function name="clutter_behaviour_get_nth_actor">
@@ -7857,7 +9426,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> A Clutter actor or NULL if @index_ is invalid.
+<return> (transfer none): A Clutter actor or NULL if @index_ is invalid.
Since: 0.2
</return>
@@ -7896,11 +9465,39 @@
<return></return>
</function>
+<function name="clutter_container_add">
+<description>
+Adds a list of #ClutterActor&lt;!-- --&gt;s to @container. Each time and
+actor is added, the "actor-added" signal is emitted. Each actor should
+be parented to @container, which takes a reference on the actor. You
+cannot add a #ClutterActor to more than one #ClutterContainer.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+<parameter name="first_actor">
+<parameter_description> the first #ClutterActor to add
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> %NULL terminated list of actors to add
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_set_width">
<description>
-Forces a width request on an actor, causing the actor's
-normal width and height (if any) to be ignored. This function
-sets both the minimum and natural size request of the actor.
+Forces a width on an actor, causing the actor's preferred width
+and height (if any) to be ignored.
+
+This function sets both the minimum and natural size of the actor.
since: 0.2
@@ -7918,45 +9515,74 @@
<return></return>
</function>
-<function name="clutter_model_get_column_name">
+<function name="clutter_text_get_line_wrap">
<description>
-Retrieves the name of the @column
+Retrieves the value set using clutter_text_set_line_wrap().
</description>
<parameters>
-<parameter name="model">
-<parameter_description> #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="column">
-<parameter_description> the column number
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the name of the column. The model holds the returned
-string, and it should not be modified or freed
+<return> %TRUE if the #ClutterText actor should wrap
+its contents
-Since: 0.6
+Since: 1.0
</return>
</function>
-<function name="clutter_do_event">
+<function name="clutter_interval_set_interval">
<description>
-Processes an event. This function should never be called by applications.
+Variable arguments wrapper for clutter_interval_set_initial_value()
+and clutter_interval_set_final_value() that avoids using the
+#GValue arguments:
-Since: 0.4
+|[
+clutter_interval_set_interval (interval, 0, 50);
+clutter_interval_set_interval (interval, 1.0, 0.0);
+clutter_interval_set_interval (interval, FALSE, TRUE);
+]|
+
+This function is meant for the convenience of the C API; bindings
+should reimplement this function using the #GValue-based API.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent.
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the initial and final values of the interval
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_animation_get_loop">
+<description>
+Retrieves whether @animation is looping.
+
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the animation is looping
+
+Since: 1.0
+</return>
+</function>
+
<function name="json_node_set_array">
<description>
Sets @array inside @node and increases the #JsonArray reference count
@@ -7975,6 +9601,24 @@
<return></return>
</function>
+<function name="clutter_get_input_device_for_id">
+<description>
+Retrieves the #ClutterInputDevice from its id.
+
+
+</description>
+<parameters>
+<parameter name="id">
+<parameter_description> a device id
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): a #ClutterInputDevice, or %NULL
+
+Since: 0.8
+</return>
+</function>
+
<function name="clutter_score_get_loop">
<description>
Gets whether @score is looping
@@ -8044,6 +9688,24 @@
<return></return>
</function>
+<function name="clutter_text_get_cursor_position">
+<description>
+Retrieves the cursor position.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> the cursor position, in characters
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_key_event_unicode">
<description>
Retrieves the unicode value for the key that caused @keyev.
@@ -8077,61 +9739,113 @@
</parameter_description>
</parameter>
</parameters>
-<return> The child actor with the requested name, or %NULL if no
-actor with that name was found.
+<return> (transfer none): The child actor with the requested name,
+or %NULL if no actor with that name was found.
Since: 0.6
</return>
</function>
-<function name="clutter_sine_dec_func">
+<function name="clutter_text_set_font_name">
<description>
-Convenience alpha function for a sine wave over interval [pi / 2, pi].
-You can use this function as the alpha function for
-clutter_alpha_set_func().
+Sets the font used by a #ClutterText. The @font_name string
+must either be %NULL, which means that the font name from the
+default #ClutterBackend will be used; or be something that can
+be parsed by the pango_font_description_from_string() function,
+like:
+
+|[
+clutter_text_set_font_name (text, "Sans 10pt");
+clutter_text_set_font_name (text, "Serif 16px");
+clutter_text_set_font_name (text, "Helvetica 10");
+]|
+Since: 1.0
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="font_name">
+<parameter_description> a font name, or %NULL to set the default font name
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return></return>
+</function>
-Since: 0.4
-</return>
+<function name="clutter_actor_get_scale_center">
+<description>
+Retrieves the scale center coordinate in pixels relative to the top
+left corner of the actor. If the scale center was specified using a
+#ClutterGravity this will calculate the pixel offset using the
+current size of the actor.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="center_x">
+<parameter_description> (out): Location to store the X position of the scale center, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="center_y">
+<parameter_description> (out): Location to store the Y position of the scale center, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="clutter_timeline_clone">
+<function name="clutter_text_set_justify">
<description>
-Create a new #ClutterTimeline instance which has property values
-matching that of supplied timeline. The cloned timeline will not
-be started and will not be positioned to the current position of
- timeline: you will have to start it with clutter_timeline_start().
+Sets whether the text of the #ClutterText actor should be justified
+on both margins. This setting is ignored if Clutter is compiled
+against Pango &lt; 1.18.
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> #ClutterTimeline to duplicate.
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="justify">
+<parameter_description> whether the text should be justified
</parameter_description>
</parameter>
</parameters>
-<return> a new #ClutterTimeline, cloned from @timeline
+<return></return>
+</function>
+
+<function name="clutter_shader_get_cogl_fragment_shader">
+<description>
+Retrieves the underlying #CoglHandle for the fragment shader.
+
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #CoglHandle for the fragment shader, or %NULL
-Since 0.4
+Since: 1.0
</return>
</function>
<function name="clutter_stage_manager_get_default_stage">
<description>
-Return value: the default stage. The returned object is owned by
+Return value: (transfer none): the default stage. The returned object
</description>
<parameters>
@@ -8140,8 +9854,8 @@
</parameter_description>
</parameter>
</parameters>
-<return> the default stage. The returned object is owned by
-Clutter and you should never reference or unreference it
+<return> (transfer none): the default stage. The returned object
+is owned by Clutter and you should never reference or unreference it
Since: 0.8
</return>
@@ -8173,97 +9887,83 @@
<return></return>
</function>
-<function name="clutter_actor_move_anchor_point_from_gravity">
+<function name="clutter_binding_pool_block_action">
<description>
-Sets an anchor point on the actor based on the given gravity, adjusting the
-actor postion so that its relative position within its parent remains
-unchanged.
+Blocks all the actions with name @action_name inside @pool.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
</parameter_description>
</parameter>
-<parameter name="gravity">
-<parameter_description> #ClutterGravity.
+<parameter name="action_name">
+<parameter_description> an action name
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_new_with_text">
+<function name="clutter_actor_move_anchor_point_from_gravity">
<description>
-Creates a new #ClutterEntry displaying @text using @font_name.
+Sets an anchor point on the actor based on the given gravity, adjusting the
+actor postion so that its relative position within its parent remains
+unchanged.
+
+Since version 1.0 the anchor point will be stored as a gravity so
+that if the actor changes size then the anchor point will move. For
+example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST
+and later double the size of the actor, the anchor point will move
+to the bottom right.
+Since: 0.6
</description>
<parameters>
-<parameter name="font_name">
-<parameter_description> the name (and size) of the font to be used
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
+<parameter name="gravity">
+<parameter_description> #ClutterGravity.
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterEntry
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_stage_read_pixels">
+<function name="json_node_set_string">
<description>
-Makes a screenshot of the stage in RGBA 8bit data, returns a
-linear buffer with @width*4 as rowstride.
-Gets a pixel based representation of the current rendered stage.
-
+Sets @value as the string content of the @node, replacing any existing
+content.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> x coordinate of the first pixel that is read from stage
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> y coordinate of the first pixel that is read from stage
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> Width dimention of pixels to be read, or -1 for the
-entire stage width
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> Height dimention of pixels to be read, or -1 for the
-entire stage height
+<parameter name="value">
+<parameter_description> a string value
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to newly allocated memory with the buffer
-that should be free with g_free, or NULL if the read back failed.
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_bspline_clear">
+<function name="clutter_path_node_free">
<description>
-Empties a bspline.
+Frees the memory of an allocated node.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</parameter_description>
</parameter>
</parameters>
@@ -8292,9 +9992,9 @@
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated, %NULL terminated string array
-containing the names of the markers. Use g_strfreev() when
-done.
+<return> (array zero-terminated=1 length=n_markers): a newly
+allocated, %NULL terminated string array containing the names of
+the markers. Use g_strfreev() when done.
Since: 0.8
</return>
@@ -8305,6 +10005,12 @@
Sets an anchor point on the actor, based on the given gravity (this is a
convenience function wrapping clutter_actor_set_anchor_point()).
+Since version 1.0 the anchor point will be stored as a gravity so
+that if the actor changes size then the anchor point will move. For
+example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST
+and later double the size of the actor, the anchor point will move
+to the bottom right.
+
Since: 0.6
</description>
@@ -8321,6 +10027,92 @@
<return></return>
</function>
+<function name="cogl_pango_render_layout_subpixel">
+<description>
+FIXME
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #PangoLayout
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the layout
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to the renderer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_scale_fullu">
+<description>
+%ClutterUnit version of clutter_actor_set_scale_full().
+
+Scales an actor with the given factors around the given center
+point. The center point is specified in
+%ClutterUnit&lt;!-- --&gt;s relative to the anchor point (usually
+the top left corner of the actor).
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="scale_x">
+<parameter_description> double factor to scale actor by horizontally.
+</parameter_description>
+</parameter>
+<parameter name="scale_y">
+<parameter_description> double factor to scale actor by vertically.
+</parameter_description>
+</parameter>
+<parameter name="center_x">
+<parameter_description> X coordinate of the center of the scale.
+</parameter_description>
+</parameter>
+<parameter name="center_y">
+<parameter_description> Y coordinate of the center of the scale
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_x11_texture_pixmap_sync_window">
+<description>
+Resets the texture's pixmap from its window, perhaps in response to the
+pixmap's invalidation as the window changed size.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> the texture to bind
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_get_position">
<description>
This function tries to "do what you mean" and tell you where the
@@ -8369,10 +10161,59 @@
<return></return>
</function>
+<function name="clutter_binding_pool_override_action">
+<description>
+Allows overriding the action for @key_val and @modifiers inside a
+#ClutterBindingPool. See clutter_binding_pool_install_action().
+
+When an action has been activated using clutter_binding_pool_activate()
+the passed @callback will be invoked (with @data).
+
+Actions can be blocked with clutter_binding_pool_block_action()
+and then unblocked using clutter_binding_pool_unblock_action().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask of modifiers
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> function to be called when the action is activated
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to be passed to @callback
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to be called when the action is removed
+from the pool
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_timeline_advance_to_marker">
<description>
Advances @timeline to the frame of the given @marker_name.
+&lt;note&gt;&lt;para&gt;Like clutter_timeline_advance(), this function will not
+emit the #ClutterTimeline::new-frame for the frame where @marker_name
+is set, nor it will emit #ClutterTimeline::marker-reached for
+ marker_name &lt;/para&gt;&lt;/note&gt;
+
Since: 0.8
</description>
@@ -8389,31 +10230,27 @@
<return></return>
</function>
-<function name="clutter_color_shadex">
+<function name="clutter_script_list_objects">
<description>
-Fixed point version of clutter_color_shade().
+Retrieves all the objects created by @script.
-Shades @src by the factor of @shade and saves the modified
-color into @dest.
+Note: this function does not increment the reference count of the
+objects it returns.
-Since: 0.2
</description>
<parameters>
-<parameter name="src">
-<parameter_description> a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="dest">
-<parameter_description> return location for the shaded color
-</parameter_description>
-</parameter>
-<parameter name="shade">
-<parameter_description> #ClutterFixed the shade factor to apply
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer container) (element-type GObject): a list of #GObject&lt;!-- --&gt;s,
+or %NULL. The objects are owned by the #ClutterScript instance. Use g_list_free() on the
+returned value when done.
+
+Since: 0.8.2
+</return>
</function>
<function name="clutter_texture_new_from_file">
@@ -8459,38 +10296,48 @@
</return>
</function>
-<function name="clutter_stage_get_perspective">
+<function name="clutter_path_get_n_nodes">
<description>
-Retrieves the stage perspective.
+Retrieves the number of nodes in the path.
-Since: 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="fovy">
-<parameter_description> return location for the field of view, in degrees, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="aspect">
-<parameter_description> return location for the aspect ratio, or %NULL
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="z_near">
-<parameter_description> return location for the distance of the viewer from the
-near clipping plane, or %NULL
+</parameters>
+<return> the number of nodes.
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_model_filter_row">
+<description>
+Checks whether @row should be filtered or not using the
+filtering function set on @model.
+
+This function should be used only by subclasses of #ClutterModel.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="z_far">
-<parameter_description> return location for the distance of the viewer from the
-far clipping plane, or %NULL
+<parameter name="row">
+<parameter_description> the row to filter
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the row should be displayed,
+%FALSE otherwise
+
+Since: 0.6
+</return>
</function>
<function name="clutter_x11_handle_event">
@@ -8506,8 +10353,13 @@
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterX11FilterReturn indicating what the caller
-should do with the original event.
+<return> #ClutterX11FilterReturn. %CLUTTER_X11_FILTER_REMOVE
+indicates that Clutter has internally handled the event and the
+caller should do no further processing. %CLUTTER_X11_FILTER_CONTINUE
+indicates that Clutter is either not interested in the event,
+or has used the event to update internal state without taking
+any exclusive action. %CLUTTER_X11_FILTER_TRANSLATE will not
+occur.
Since: 0.8
</return>
@@ -8534,6 +10386,7 @@
<function name="clutter_actor_set_xu">
<description>
Sets the actor's X coordinate, relative to its parent.
+
Overrides any layout manager and forces a fixed position for
the actor.
@@ -8553,35 +10406,67 @@
<return></return>
</function>
-<function name="clutter_model_prependv">
+<function name="clutter_alpha_new_with_func">
<description>
-Creates and prepends a new row to the #ClutterModel, setting the row
-values for the given @columns upon creation.
+Creates a new #ClutterAlpha instances and sets the timeline
+and the alpha function.
+
+This function will not register @func as a global alpha function.
+
+See also clutter_alpha_set_timeline() and clutter_alpha_set_func().
-Since: 0.6
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="n_columns">
-<parameter_description> the number of columns and values to set
+<parameter name="func">
+<parameter_description> a #ClutterAlphaFunc
</parameter_description>
</parameter>
-<parameter name="columns">
-<parameter_description> a vector containing the columns to set
+<parameter name="data">
+<parameter_description> data to pass to the function, or %NULL
</parameter_description>
</parameter>
-<parameter name="values">
-<parameter_description> a vector containing the values for the cells
+<parameter name="destroy">
+<parameter_description> function to call when removing the alpha function, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterAlpha
+
+Since: 1.0
+</return>
+</function>
+
+<function name="ClutterModel">
+<description>
+The ::filter-changed signal is emitted when a new filter has been applied
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the #ClutterModel on which the signal is emitted
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_main_quit">
+<description>
+Terminates the Clutter mainloop.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_alpha_get_alpha">
<description>
Query the current alpha value.
@@ -8600,6 +10485,24 @@
</return>
</function>
+<function name="clutter_clone_get_source">
+<description>
+Retrieves the source #ClutterActor being cloned by @clone
+
+
+</description>
+<parameters>
+<parameter name="clone">
+<parameter_description> a #ClutterClone
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the actor source for the clone
+
+Since: 1.0
+</return>
+</function>
+
<function name="json_object_get_member">
<description>
Retrieves the #JsonNode containing the value of @member_name inside
@@ -8617,7 +10520,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the node for the requested object
+<return> (transfer none): a pointer to the node for the requested object
member, or %NULL
</return>
</function>
@@ -8626,14 +10529,17 @@
<description>
Compares two #ClutterColor&lt;!-- --&gt;s and checks if they are the same.
+This function can be passed to g_hash_table_new() as the @key_equal_func
+parameter, when using #ClutterColor&lt;!-- --&gt;s as keys in a #GHashTable.
+
</description>
<parameters>
-<parameter name="a">
+<parameter name="v1">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="b">
+<parameter name="v2">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
@@ -8644,80 +10550,118 @@
</return>
</function>
-<function name="CLUTTER_ALPHA_SMOOTHSTEP_INC">
+<function name="clutter_value_set_shader_float">
<description>
-Convenience symbol for clutter_smoothstep_inc_func().
+Sets @floats as the contents of @value. The passed #GValue
+must have been initialized using %CLUTTER_TYPE_SHADER_FLOAT.
-Since: 0.4
+Since: 0.8
</description>
<parameters>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> number of floating point values in @floats
+</parameter_description>
+</parameter>
+<parameter name="floats">
+<parameter_description> an array of floating point values
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_delete_text">
+<function name="clutter_units_pt">
+<description>
+Converts a value in typographic points to #ClutterUnit&lt;!-- --&gt;s
+at the current DPI.
+
+
+</description>
+<parameters>
+<parameter name="pt">
+<parameter_description> typographic points to convert
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value in units
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_alpha_get_timeline">
+<description>
+Gets the #ClutterTimeline bound to @alpha.
+
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): a #ClutterTimeline instance
+
+Since: 0.2
+</return>
+</function>
+
+<function name="clutter_behaviour_scale_get_bounds">
<description>
-Deletes a sequence of characters. The characters that are deleted are
-those characters at positions from @start_pos up to, but not including,
- end_pos If @end_pos is negative, then the characters deleted will be
-those characters from @start_pos to the end of the text.
+Retrieves the bounds used by scale behaviour.
Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="scale">
+<parameter_description> a #ClutterBehaviourScale
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> return location for the initial scale factor on the X
+axis, or %NULL
</parameter_description>
</parameter>
-<parameter name="start_pos">
-<parameter_description> the starting position.
+<parameter name="y_scale_start">
+<parameter_description> return location for the initial scale factor on the Y
+axis, or %NULL
</parameter_description>
</parameter>
-<parameter name="end_pos">
-<parameter_description> the end position.
+<parameter name="x_scale_end">
+<parameter_description> return location for the final scale factor on the X axis,
+or %NULL
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_stage_get_resolution">
-<description>
-Retrieves the resolution (in DPI) of the stage from the default
-backend.
-
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
+<parameter name="y_scale_end">
+<parameter_description> return location for the final scale factor on the Y axis,
+or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the resolution of the stage
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_x11_get_stage_from_window">
+<function name="clutter_path_clear">
<description>
-Gets the stage for a particular X window.
+Removes all nodes from the path.
+Since: 1.0
</description>
<parameters>
-<parameter name="win">
-<parameter_description> an X Window ID
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
</parameters>
-<return> The stage or NULL if a stage does not exist for the window.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_timeline_has_marker">
@@ -8823,48 +10767,23 @@
<return></return>
</function>
-<function name="clutter_entry_get_font_name">
-<description>
-Retrieves the font used by @entry.
-
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-</parameters>
-<return> a string containing the font name, in a format
-understandable by pango_font_description_from_string(). The
-string is owned by #ClutterEntry and should not be modified
-or freed.
-
-Since: 0.4
-</return>
-</function>
-
-<function name="clutter_model_get_iter_at_row">
+<function name="clutter_texture_get_max_tile_waste">
<description>
-Retrieves a #ClutterModelIter representing the row at the given index.
+Gets the maximum waste that will be used when creating a texture or
+-1 if slicing is disabled.
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="row">
-<parameter_description> position of the row to retrieve
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return> A new #ClutterModelIter, or %NULL if @row was out of bounds.
-When done using the iterator object, call g_object_unref() to deallocate
-its resources
+<return> The maximum waste or -1 if the texture waste is
+unlimited.
-Since: 0.6
+Since: 0.8
</return>
</function>
@@ -8908,13 +10827,44 @@
</parameter_description>
</parameter>
</parameters>
-<return> A new #ClutterModelIter. Call g_object_unref() when
+<return> (transfer full): A new #ClutterModelIter. Call g_object_unref() when
done using it
Since: 0.6
</return>
</function>
+<function name="clutter_text_get_chars">
+<description>
+Retrieves the contents of the #ClutterText actor between
+ start_pos and @end_pos.
+
+The positions are specified in characters, not in bytes.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="start_pos">
+<parameter_description> start of text, in characters
+</parameter_description>
+</parameter>
+<parameter name="end_pos">
+<parameter_description> end of text, in characters
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string with the contents of
+the text actor between the specified positions. Use g_free()
+to free the resources when done
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_container_remove_actor">
<description>
Removes @actor from @container. The actor should be unparented, so
@@ -8957,17 +10907,17 @@
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return value for the X coordinate of the center of rotation,
+<parameter_description> (out): return value for the X coordinate of the center of rotation,
in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return value for the Y coordinate of the center of rotation,
+<parameter_description> (out): return value for the Y coordinate of the center of rotation,
in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
<parameter name="z">
-<parameter_description> return value for the Z coordinate of the center of rotation,
+<parameter_description> (out): return value for the Z coordinate of the center of rotation,
in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
@@ -9031,6 +10981,55 @@
<return></return>
</function>
+<function name="json_node_take_array">
+<description>
+Sets @array into @node without increasing the #JsonArray reference count.
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_create_pango_layout">
+<description>
+Creates a new #PangoLayout from the same #PangoContext used
+by the #ClutterActor. The #PangoLayout is already configured
+with the font map, resolution and font options, and the
+given @text.
+
+If you want to keep around a #PangoLayout created by this
+function you will have to connect to the #ClutterBackend::font-changed
+and #ClutterBackend::resolution-changed signals, and call
+pango_layout_context_changed() in response to them.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> the text to set on the #PangoLayout, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #PangoLayout. Use g_object_unref()
+when done
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_event_get_source">
<description>
Retrieves the source #ClutterActor the event originated from, or
@@ -9044,12 +11043,30 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterActor
+<return> (transfer none): a #ClutterActor
Since: 0.6
</return>
</function>
+<function name="cogl_pango_font_map_get_renderer">
+<description>
+Retrieves the #CoglPangoRenderer for the passed font map.
+
+
+</description>
+<parameters>
+<parameter name="fm">
+<parameter_description> a #CoglPangoFontMap
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #PangoRenderer
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_x11_get_default_display">
<description>
Retrieves the pointer to the default display.
@@ -9084,13 +11101,13 @@
<function name="clutter_color_to_pixel">
<description>
-Converts @src into a packed 32 bit integer, containing
+Converts @color into a packed 32 bit integer, containing
all the four 8 bit channels used by #ClutterColor.
</description>
<parameters>
-<parameter name="src">
+<parameter name="color">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
@@ -9117,86 +11134,65 @@
</return>
</function>
-<function name="clutter_model_iter_get_model">
+<function name="_cogl_set_indirect_context">
<description>
-Retrieves a pointer to the #ClutterModel that this iter is part of.
+Advises COGL that the GL context is indirect (commands are sent
+over a socket). COGL uses this information to try to avoid
+round-trips in its use of GL, for example.
+This function cannot be called "on the fly," only before COGL
+initializes.
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
+<parameter name="indirect">
+<parameter_description> TRUE if GL context is indirect
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to a #ClutterModel.
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_entry_set_invisible_char">
+<function name="clutter_model_iter_get_model">
<description>
-Sets the character to use in place of the actual text when
-clutter_entry_set_visibility() has been called to set text visibility
-to %FALSE. i.e. this is the character used in "password mode" to show the
-user how many characters have been typed. The default invisible char is an
-asterisk ('*'). If you set the invisible char to 0, then the user will get
-no feedback at all; there will be no text on the screen as they type.
+Retrieves a pointer to the #ClutterModel that this iter is part of.
-Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a pointer to a #ClutterModel.
+
+Since: 0.6
+</return>
</function>
-<function name="clutter_script_get_objects">
+<function name="clutter_list_model_newv">
<description>
-Retrieves a list of objects for the given names. After @script, object
-names/return location pairs should be listed, with a %NULL pointer
-ending the list, like:
-
-&lt;informalexample&gt;&lt;programlisting&gt;
-GObject *my_label, *a_button, *main_timeline;
-
-clutter_script_get_objects (script,
-"my-label", &amp;my_label,
-"a-button", &amp;a_button,
-"main-timeline", &amp;main_timeline,
-NULL);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
-
-Note: This function does not increment the reference count of the
-returned objects.
+Non-vararg version of clutter_list_model_new(). This function is
+useful for language bindings.
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
+<parameter name="n_columns">
+<parameter_description> number of columns in the model
</parameter_description>
</parameter>
-<parameter name="first_name">
-<parameter_description> the name of the first object to retrieve
+<parameter name="types">
+<parameter_description> an array of #GType types for the columns, from first to last
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> return location for a #GObject, then additional names, ending
-with %NULL
+<parameter name="names">
+<parameter_description> an array of names for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> the number of objects returned.
+<return> a new default #ClutterModel
Since: 0.6
</return>
@@ -9245,24 +11241,77 @@
</return>
</function>
-<function name="clutter_atan2i">
+<function name="clutter_behaviour_scale_newx">
<description>
-Calculates the arctangent of @y / @x but uses the sign of both
-arguments to return the angle in right quadrant.
+A fixed point implementation of clutter_behaviour_scale_new()
</description>
<parameters>
-<parameter name="y">
-<parameter_description> Numerator of tangent
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> initial scale factor on the Y axis
+</parameter_description>
+</parameter>
+<parameter name="x_scale_end">
+<parameter_description> final scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterBehaviourScale
+
+Since: 0.2
+</return>
+</function>
+
+<function name="clutter_path_add_rel_move_to">
+<description>
+Same as clutter_path_add_move_to() except the coordinates are
+relative to the previous node.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> Denominator of tangent
+<parameter_description> the x coordinate
</parameter_description>
</parameter>
+<parameter name="y">
+<parameter_description> the y coordinate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_get_current_event_time">
+<description>
+Retrieves the timestamp of the last event, if there is an
+event or if the event has a timestamp.
+
+
+</description>
+<parameters>
</parameters>
-<return> The arctangent of @y / @x
+<return> the event timestamp, or %CLUTTER_CURRENT_TIME
+
+Since: 1.0
</return>
</function>
@@ -9313,69 +11362,70 @@
<return></return>
</function>
-<function name="clutter_texture_get_max_tile_waste">
+<function name="clutter_text_get_color">
<description>
-Gets the maximum waste that will be used when creating a texture or
--1 if slicing is disabled.
+Retrieves the text color as set by clutter_text_get_color().
+Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-</parameters>
-<return> The maximum waste or -1 if the texture waste is
-unlimited.
-
-Since: 0.8
-</return>
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="json_object_remove_member">
+<function name="clutter_text_set_markup">
<description>
-Removes @member_name from @object, freeing its allocated resources.
+Sets @markup as the contents of a #ClutterText.
+
+This is a convenience function for setting a string containing
+Pango markup, and it is logically equivalent to:
+
+|[
+clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE);
+clutter_text_set_text (CLUTTER_TEXT (actor), markup);
+]|
+
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member to remove
+<parameter name="markup">
+<parameter_description> a string containing Pango markup. Passing %NULL is the same as passing "" (the empty string)
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_new_full">
+<function name="json_object_remove_member">
<description>
-Creates a new #ClutterEntry displaying @text with @color
-using @font_name.
-
+Removes @member_name from @object, freeing its allocated resources.
</description>
<parameters>
-<parameter name="font_name">
-<parameter_description> the name (and size) of the font to be used
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> the text to be displayed
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> #ClutterColor for text
+<parameter name="member_name">
+<parameter_description> the name of the member to remove
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterEntry
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_actor_get_transformed_size">
@@ -9392,17 +11442,27 @@
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the width, or %NULL
+<parameter_description> (out): return location for the width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the height, or %NULL
+<parameter_description> (out): return location for the height, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="JsonGenerator">
+<description>
+Number of spaces to be used to indent when pretty printing.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_param_spec_unit">
<description>
Creates a #GParamSpec for properties using #ClutterUnit&lt;!-- --&gt;s.
@@ -9445,6 +11505,34 @@
</return>
</function>
+<function name="clutter_actor_set_z_rotation_from_gravity">
+<description>
+Sets the rotation angle of @self around the Z axis using the center
+point specified as a compass point. For example to rotate such that
+the center of the actor remains static you can use
+%CLUTTER_GRAVITY_CENTER. If the actor changes size the center point
+will move accordingly.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_description>
+</parameter>
+<parameter name="gravity">
+<parameter_description> the center point of the rotation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_threads_set_lock_functions">
<description>
Allows the application to replace the standard method that
@@ -9485,6 +11573,58 @@
<return></return>
</function>
+<function name="clutter_texture_set_cogl_material">
+<description>
+Replaces the underlying COGL texture drawn by this actor with
+ cogl_tex A reference to the texture is taken so if the handle is
+no longer needed it should be deref'd with cogl_texture_unref.
+
+Since: 0.8
+
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
+</parameter_description>
+</parameter>
+<parameter name="cogl_material">
+<parameter_description> A CoglHandle for a material
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_x11_enable_xinput">
+<description>
+Enables the use of the XInput extension if present on connected
+XServer and support built into Clutter. XInput allows for multiple
+pointing devices to be used. This must be called before
+clutter_init().
+
+You should use #clutter_x11_has_xinput to see if support was enabled.
+
+Since: 0.8
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="ClutterInterval">
+<description>
+The type of the values in the interval.
+
+Since: 1.0
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_events_pending">
<description>
Checks if events are pending in the event queue.
@@ -9550,41 +11690,51 @@
<return></return>
</function>
-<function name="clutter_media_set_volume">
+<function name="clutter_script_add_search_paths">
<description>
-Sets the playback volume of @media to @volume.
+Adds @paths to the list of search paths held by @script.
+
+The search paths are used by clutter_script_lookup_filename(), which
+can be used to define search paths for the textures source file name
+or other custom, file-based properties.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="volume">
-<parameter_description> The volume as a double between 0.0 and 1.0
+<parameter name="paths">
+<parameter_description> an array of strings containing different search paths
+</parameter_description>
+</parameter>
+<parameter name="n_paths">
+<parameter_description> the length of the passed array
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_get_text">
+<function name="JsonParser">
<description>
-Retrieves the text displayed by @entry.
-
+The ::error signal is emitted each time a #JsonParser encounters
+an error in a JSON stream.
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="parser">
+<parameter_description> the parser instance that received the signal
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to the #GError
</parameter_description>
</parameter>
</parameters>
-<return> the text of the entry. The returned string is
-owned by #ClutterEntry and should not be modified or freed.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_group_remove_all">
@@ -9601,45 +11751,20 @@
<return></return>
</function>
-<function name="clutter_container_add_valist">
+<function name="clutter_value_set_color">
<description>
-Alternative va_list version of clutter_container_add().
+Sets @value to @color.
-Since: 0.4
+Since: 0.8.4
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="first_actor">
-<parameter_description> the first #ClutterActor to add
-</parameter_description>
-</parameter>
-<parameter name="var_args">
-<parameter_description> list of actors to add, followed by %NULL
+<parameter name="value">
+<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_actor_destroy">
-<description>
-Destroys an actor. When an actor is destroyed, it will break any
-references it holds to other objects. If the actor is inside a
-container, the actor will be removed.
-
-When you destroy a container, its children will be destroyed as well.
-
-Note: you cannot destroy the #ClutterStage returned by
-clutter_stage_get_default().
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="color">
+<parameter_description> the color to set
</parameter_description>
</parameter>
</parameters>
@@ -9694,63 +11819,112 @@
<return></return>
</function>
-<function name="json_object_get_size">
+<function name="clutter_interval_set_final_value">
<description>
-Retrieves the number of members of a #JsonObject.
+Sets the final value of @interval to @value. The value is
+copied inside the #ClutterInterval.
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
</parameter_description>
</parameter>
</parameters>
-<return> the number of members
-</return>
+<return></return>
</function>
-<function name="clutter_actor_get_height">
+<function name="clutter_score_remove">
<description>
-Retrieves the height of a #ClutterActor.
+Removes the #ClutterTimeline with the given id inside @score. If
+the timeline has other timelines attached to it, those are removed
+as well.
-This function tries to "do what you mean", by returning the correct
-value depending on the actor's state.
+Since: 0.6
-If the actor has a valid allocation, this function will return the
-height of the allocation box.
+</description>
+<parameters>
+<parameter name="score">
+<parameter_description> a #ClutterScore
+</parameter_description>
+</parameter>
+<parameter name="id">
+<parameter_description> the id of the timeline to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-If the actor does not have a valid allocation, this function will
-return the actor's natural height request.
+<function name="clutter_timeline_pause">
+<description>
+Pauses the #ClutterTimeline on current frame
-If you care whether you get the height request or the allocation,
-you should probably call a different function like
-clutter_actor_get_allocation_coords() to retrieve the allocation
-or clutter_actor_get_preferred_height() to retrieve the
-preferred height.
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_shader_get_cogl_program">
+<description>
+Retrieves the underlying #CoglHandle for the shader program.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return> the height of the actor, in pixels
+<return> A #CoglHandle for the shader program, or %NULL
+
+Since: 1.0
</return>
</function>
-<function name="CLUTTER_ALPHA_SINE">
+<function name="clutter_actor_get_height">
<description>
-Convenience symbol for clutter_sine_func().
+Retrieves the height of a #ClutterActor.
+
+If the actor has a valid allocation, this function will return the
+height of the allocated area given to the actor.
+
+If the actor does not have a valid allocation, this function will
+return the actor's natural height, that is the preferred height of
+the actor.
+
+If you care whether you get the preferred height or the height that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_coords() to retrieve the
+allocated size or clutter_actor_get_preferred_height() to retrieve the
+preferred height.
+
+If an actor has a fixed height, for instance a height that has been
+assigned using clutter_actor_set_height(), the height returned will
+be the same value.
-Since: 0.2
</description>
<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the height of the actor, in pixels
+</return>
</function>
<function name="clutter_container_child_set_property">
@@ -9781,48 +11955,37 @@
<return></return>
</function>
-<function name="clutter_stage_get_perspectivex">
-<description>
-Retrieves the stage perspective. This is the fixed point version of
-clutter_stage_get_perspective().
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="perspective">
-<parameter_description> return location for a #ClutterPerspective
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_threads_init">
+<function name="clutter_animation_set_duration">
<description>
-Initialises the Clutter threading mechanism, so that Clutter API can be
-called by multiple threads, using clutter_threads_enter() and
-clutter_threads_leave() to mark the critical sections.
-
-You must call g_thread_init() before this function.
-
-This function must be called before clutter_init().
+Sets the duration of @animation in milliseconds.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="msecs">
+<parameter_description> the duration in milliseconds
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
<function name="ClutterAlpha">
<description>
-The alpha value as computed by the alpha function.
+The progress function logical id - either a value from the
+#ClutterAnimationMode enumeration or a value returned by
+clutter_alpha_register_func().
+
+If %CLUTTER_CUSTOM_MODE is used then the function set using
+clutter_alpha_set_closure() or clutter_alpha_set_func()
+will be used.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
@@ -9837,6 +12000,8 @@
This function should not be called directly by applications.
Call clutter_actor_queue_redraw() to queue paints, instead.
+This function will emit the #ClutterActor::paint signal.
+
</description>
<parameters>
<parameter name="self">
@@ -9847,6 +12012,32 @@
<return></return>
</function>
+<function name="clutter_path_set_description">
+<description>
+Replaces all of the nodes in the path with nodes described by
+ str See clutter_path_add_string() for details of the format.
+
+If the string is invalid then %FALSE is returned and the path is
+unaltered.
+
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> a string describing the path
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE is the path was valid, %FALSE otherwise.
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_get_xu">
<description>
Retrieves the X coordinate of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
@@ -9886,8 +12077,8 @@
</description>
<parameters>
-<parameter name="dest">
-<parameter_description> return location for a #ClutterColor
+<parameter name="color">
+<parameter_description> (out): return location for a #ClutterColor
</parameter_description>
</parameter>
<parameter name="pixel">
@@ -9913,55 +12104,99 @@
<return></return>
</function>
-<function name="clutter_stage_set_color">
+<function name="clutter_backend_get_font_options">
<description>
-Set the stage color.
+Retrieves the font options for @backend.
+
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> A #ClutterColor
+</parameters>
+<return> (transfer none): the font options of the #ClutterBackend.
+The returned #cairo_font_options_t is owned by the backend and should
+not be modified or freed
+
+Since: 0.8
+</return>
+</function>
+
+<function name="clutter_cairo_texture_new">
+<description>
+Creates a new #ClutterCairoTexture actor, with a surface of @width by
+ height pixels.
+
+
+</description>
+<parameters>
+<parameter name="width">
+<parameter_description> the width of the surface
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the height of the surface
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterCairoTexture actor
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_shader_release">
+<function name="clutter_path_get_description">
<description>
-Frees up any GL context resources held by the shader.
+Return value: a string description of the path. Free with g_free().
-Since: 0.6
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string description of the path. Free with g_free().
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_actor_grab_key_focus">
+<description>
+Sets the key focus of the #ClutterStage including @self
+to this #ClutterActor.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_label_get_text">
+<function name="clutter_stage_unfullscreen">
<description>
-Retrieves the text displayed by @label
-
+Asks to toggle off the fullscreen state for the stage window. Note that
+you shouldn't assume the window is definitely not full screen afterward,
+because other entities (e.g. the user or window manager) could fullscreen
+it again, and not all window managers honor requests to unfullscreen
+windows.
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return> the text of the label. The returned string is
-owned by #ClutterLabel and should not be modified or freed.
-</return>
+<return></return>
</function>
<function name="clutter_actor_move_by">
@@ -9992,18 +12227,44 @@
<return></return>
</function>
+<function name="clutter_text_set_attributes">
+<description>
+Sets the attributes list that are going to be applied to the
+#ClutterText contents.
+
+The #ClutterText actor will take a reference on the #PangoAttrList
+passed to this function.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="attrs">
+<parameter_description> a #PangoAttrList or %NULL to unset the attributes
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_media_set_playing">
<description>
-Starts or stops @media playing.
+Starts or stops playing of @media.
+
+Since: 0.2
</description>
<parameters>
<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
<parameter name="playing">
-<parameter_description> TRUE to start playing, FALSE to stop.
+<parameter_description> %TRUE to start playing
</parameter_description>
</parameter>
</parameters>
@@ -10027,21 +12288,53 @@
<return></return>
</function>
-<function name="clutter_actor_get_stage">
+<function name="clutter_behaviour_scale_new">
<description>
-Retrieves the #ClutterStage where @actor is contained.
+Creates a new #ClutterBehaviourScale instance.
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> initial scale factor on the Y axis
+</parameter_description>
+</parameter>
+<parameter name="x_scale_end">
+<parameter_description> final scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
</parameters>
-<return> the stage containing the actor, or %NULL
+<return> the newly created #ClutterBehaviourScale
-Since: 0.8
+Since: 0.2
+</return>
+</function>
+
+<function name="clutter_event_type">
+<description>
+Retrieves the type of the event.
+
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterEventType
</return>
</function>
@@ -10106,7 +12399,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> the #JsonObject
+<return> (transfer none): the #JsonObject
</return>
</function>
@@ -10128,41 +12421,6 @@
</return>
</function>
-<function name="clutter_label_set_line_wrap">
-<description>
-Toggles line wrapping within the #ClutterLabel widget. %TRUE makes
-it break lines if text exceeds the widget's size. %FALSE lets the
-text get cut off by the edge of the widget if it exceeds the widget
-size.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-<parameter name="wrap">
-<parameter_description> the setting
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_entry_new">
-<description>
-Creates a new, empty #ClutterEntry.
-
-
-</description>
-<parameters>
-</parameters>
-<return> the newly created #ClutterEntry
-</return>
-</function>
-
<function name="clutter_get_debug_enabled">
<description>
Check if clutter has debugging turned on.
@@ -10192,8 +12450,8 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt">
-<parameter_description> tilt, as #ClutterFixed, of the elipse around the center in the given
-axis in degrees.
+<parameter_description> the tilt of the ellipse, in degrees as a fixed point
+value, around the center on the given axis
</parameter_description>
</parameter>
</parameters>
@@ -10218,20 +12476,24 @@
</return>
</function>
-<function name="clutter_score_remove_all">
+<function name="clutter_shader_get_vertex_source">
<description>
-Removes all the timelines inside @score.
+Query the current GLSL vertex source set on @shader.
-Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the source of the vertex shader for this
+ClutterShader object or %NULL. The returned string is owned by the
+shader object and should never be modified or freed
+
+Since: 0.6
+</return>
</function>
<function name="clutter_behaviour_ellipse_set_direction">
@@ -10254,18 +12516,54 @@
<return></return>
</function>
-<function name="CLUTTER_ALPHA_RAMP_INC">
+<function name="clutter_text_get_cursor_color">
<description>
-Convenience symbol for clutter_ramp_inc_func().
+Retrieves the color of the cursor of a #ClutterText actor.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_x11_texture_pixmap_new_with_window">
+<description>
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> the X window to which this texture should be bound
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> the width of the X pixmap
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the height of the X pixmap
+</parameter_description>
+</parameter>
+<parameter name="depth">
+<parameter_description> the depth of the X pixmap
+</parameter_description>
+</parameter>
+</parameters>
+<return> A new #ClutterX11TexturePixmap bound to the given X window.
+
+Since 0.8
+</return>
+</function>
+
<function name="clutter_ungrab_keyboard">
<description>
Removes an existing grab of the keyboard.
@@ -10278,21 +12576,21 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_height">
+<function name="clutter_text_get_single_line_mode">
<description>
-Gets the height of the elliptical path.
+Retrieves whether the #ClutterText actor is in single line mode.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the height of the path
+<return> %TRUE if the #ClutterText actor is in single line mode
-Since: 0.4
+Since: 1.0
</return>
</function>
@@ -10322,6 +12620,13 @@
Gets the absolute size of an actor in #ClutterUnits&lt;!-- --&gt;s, taking
into account the scaling factors.
+If the actor has a valid allocation, the allocated size will be used.
+If the actor has not a valid allocation then the preferred size will
+be transformed and returned.
+
+If you want the transformed allocation, see
+clutter_actor_get_abs_allocation_vertices() instead.
+
&lt;note&gt;When the actor (or one of its ancestors) is rotated around the
X or Y axis, it no longer appears as on the stage as a rectangle, but
as a generic quadrangle; in that case this function returns the size
@@ -10341,11 +12646,11 @@
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the width, or %NULL
+<parameter_description> (out): return location for the width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the height, or %NULL
+<parameter_description> (out): return location for the height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -10364,89 +12669,93 @@
<return></return>
</function>
-<function name="clutter_behaviour_path_append_knots">
+<function name="json_array_remove_element">
<description>
-Adds a NULL-terminated list of knots to a path. This function is
-equivalent to calling clutter_behaviour_path_append_knot() for each
-member of the list.
-
-Since: 0.2
+Removes the #JsonNode inside @array at @index_ freeing its allocated
+resources.
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
+<parameter name="array">
+<parameter_description> a #JsonArray
</parameter_description>
</parameter>
-<parameter name="first_knot">
-<parameter_description> the #ClutterKnot knot to add to the path
+<parameter name="index_">
+<parameter_description> the position of the element to be removed
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> additional knots to add to the path
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_texture_set_max_tile_waste">
+<description>
+Sets the maximum number of pixels in either axis that can be wasted
+for an individual texture slice. If -1 is specified then the
+texture is forced not to be sliced and the texture creation will
+fail if the hardware can't create a texture large enough.
+
+The value is only used when first creating a texture so changing it
+after the texture data has been set has no effect.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
+</parameter_description>
+</parameter>
+<parameter name="max_tile_waste">
+<parameter_description> Maximum amount of waste in pixels or -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_rotate_set_bounds">
+<function name="clutter_cairo_texture_create">
<description>
-Sets the initial and final angles of a rotation behaviour; angles &gt;= 360
-degrees get clamped to the canonical interval &lt;0, 360).
+Creates a new Cairo context for the @cairo texture. It is
+similar to using clutter_cairo_texture_create_region() with @x_offset
+and @y_offset of 0, @width equal to the @cairo texture surface width
+and @height equal to the @cairo texture surface height.
+
+&lt;warning&gt;&lt;para&gt;Do not call this function within the paint virtual
+function or from a callback to the #ClutterActor::paint
+signal.&lt;/para&gt;&lt;/warning&gt;
-Since: 0.4
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="angle_start">
-<parameter_description> initial angle in degrees, between 0 and 360.
-</parameter_description>
-</parameter>
-<parameter name="angle_end">
-<parameter_description> final angle in degrees, between 0 and 360.
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a newly created Cairo context. Use cairo_destroy()
+to upload the contents of the context when done drawing
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_behaviour_scale_new">
+<function name="clutter_path_add_close">
<description>
-Creates a new #ClutterBehaviourScale instance.
+Adds a #CLUTTER_PATH_CLOSE type node to the path. This creates a
+straight line from the last node to the last #CLUTTER_PATH_MOVE_TO
+type node.
+Since: 1.0
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> initial scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> initial scale factor on the Y axis
-</parameter_description>
-</parameter>
-<parameter name="x_scale_end">
-<parameter_description> final scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_end">
-<parameter_description> final scale factor on the Y axis
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterBehaviourScale
-
-Since: 0.2
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_get_angle_start">
@@ -10469,7 +12778,17 @@
<function name="clutter_texture_get_cogl_texture">
<description>
-Return value: COGL texture handle
+Retrieves the handle to the underlying COGL texture used for drawing
+the actor. No extra reference is taken so if you need to keep the
+handle then you should call cogl_texture_ref() on it.
+
+The texture handle returned is the first layer of the material
+handle used by the #ClutterTexture. If you need to access the other
+layers you should use clutter_texture_get_cogl_material() instead
+and use the #CoglMaterial API.
+
+Since: 0.8
+
</description>
<parameters>
@@ -10498,64 +12817,21 @@
<return></return>
</function>
-<function name="clutter_effect_path">
+<function name="clutter_animation_get_timeline">
<description>
-Simple effect for moving a single #ClutterActor along a path.
+Retrieves the #ClutterTimeline used by @animation
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="knots">
-<parameter_description> An array of #ClutterKnots representing path for the actor
-</parameter_description>
-</parameter>
-<parameter name="n_knots">
-<parameter_description> Number of #ClutterKnots in passed array.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or %NULL
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
-
-Since: 0.6
-</return>
-</function>
-
-<function name="clutter_actor_get_opacity">
-<description>
-Retrieves the opacity value of an actor, as set by
-clutter_actor_set_opacity().
-
-For retrieving the absolute opacity of the actor inside a paint
-virtual function, see clutter_actor_get_paint_opacity().
-
+<return> (transfer none): the timeline used by the animation
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return> the opacity of the actor
+Since: 1.0
</return>
</function>
@@ -10575,24 +12851,24 @@
</return>
</function>
-<function name="ClutterBehaviourBspline">
+<function name="clutter_text_get_line_wrap_mode">
<description>
-This signal is emitted at the end of each frame.
+Retrieves the line wrap mode used by the #ClutterText actor.
+
+See clutter_text_set_line_wrap_mode ().
-Since: 0.2
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> the object which received the signal
-</parameter_description>
-</parameter>
-<parameter name="knot">
-<parameter_description> the #ClutterKnot reached
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the wrap mode used by the #ClutterText
+
+Since: 1.0
+</return>
</function>
<function name="clutter_actor_set_anchor_point">
@@ -10630,11 +12906,13 @@
</description>
<parameters>
<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
<return> %TRUE if @media can seek, %FALSE otherwise.
+
+Since: 0.2
</return>
</function>
@@ -10657,9 +12935,10 @@
<function name="clutter_actor_set_widthu">
<description>
-Forces a width request on an actor, causing the actor's
-normal width and height (if any) to be ignored. This function
-sets both the minimum and natural size request of the actor.
+Forces a width on an actor, causing the actor's preferred width
+and height (if any) to be ignored.
+
+This function sets both the minimum and natural size of the actor.
since: 0.6
@@ -10677,40 +12956,55 @@
<return></return>
</function>
-<function name="clutter_label_set_use_markup">
+<function name="clutter_text_set_password_char">
<description>
-Sets whether the text of the label contains markup in &lt;link
-linkend="PangoMarkupFormat"&gt;Pango's text markup
-language&lt;/link&gt;.
+Sets the character to use in place of the actual text in a
+password text actor.
+
+If @wc is 0 the text will be displayed as it is entered in the
+#ClutterText actor.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="setting">
-<parameter_description> %TRUE if the label's text should be parsed for markup.
+<parameter name="wc">
+<parameter_description> a Unicode character, or 0 to unset the password character
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_delete_chars">
+<function name="clutter_interval_get_interval">
<description>
-Characters are removed from before the current postion of the cursor.
+Variable arguments wrapper for clutter_interval_get_initial_value()
+and clutter_interval_get_final_value() that avoids using the
+#GValue arguments:
-Since: 0.4
+|[
+gint a = 0, b = 0;
+clutter_interval_get_interval (interval, &a, &b);
+]|
+
+This function is meant for the convenience of the C API; bindings
+should reimplement this function using the #GValue-based API.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="len">
-<parameter_description> the number of characters to remove.
+<parameter name="Varargs">
+<parameter_description> return locations for the initial and final values of
+the interval
</parameter_description>
</parameter>
</parameters>
@@ -10738,7 +13032,35 @@
</parameter_description>
</parameter>
<parameter name="names">
-<parameter_description> an array of strings
+<parameter_description> (array length=n_columns): an array of strings
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_x11_texture_pixmap_set_window">
+<description>
+Sets up a suitable pixmap for the window, using the composite and damage
+extensions if possible, and then calls
+clutter_x11_texture_pixmap_set_pixmap(). If you want a window in a texture,
+you probably want this function, or its older sister,
+clutter_glx_texture_pixmap_set_window().
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> the texture to bind
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description> the X window to which the texture should be bound
+</parameter_description>
+</parameter>
+<parameter name="automatic">
+<parameter_description> TRUE is automatic window updates, FALSE for manual.
</parameter_description>
</parameter>
</parameters>
@@ -10771,7 +13093,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterContainer
+<return> (transfer none): a #ClutterContainer
Since: 0.8
</return>
@@ -10807,36 +13129,24 @@
</return>
</function>
-<function name="clutter_get_use_mipmapped_text">
-<description>
-Gets whether mipmapped textures are used in text operations.
-See clutter_set_use_mipmapped_text().
-
-
-</description>
-<parameters>
-</parameters>
-<return> %TRUE if text operations should use mipmapped
-textures
-
-Since: 0.8
-</return>
-</function>
-
-<function name="clutter_stage_hide_cursor">
+<function name="clutter_text_get_attributes">
<description>
-Makes the cursor invisible on the stage window
+Gets the attribute list that was set on the #ClutterText actor
+clutter_text_set_attributes(), if any.
-Since: 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): the attribute list, or %NULL if none was set. The
+returned value is owned by the #ClutterText and should not be unreferenced.
+
+Since: 1.0
+</return>
</function>
<function name="json_object_get_members">
@@ -10852,10 +13162,11 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of member names. The content of the list
-is owned by the #JsonObject and should never be modified or
-freed. When you have finished using the returned list, use
-g_list_free() to free the resources it has allocated.
+<return> (transfer container) (element-type utf8): a #GList of
+member names. The content of the list is owned by the #JsonObject
+and should never be modified or freed. When you have finished using
+the returned list, use g_list_free() to free the resources it has
+allocated.
</return>
</function>
@@ -10894,59 +13205,84 @@
<return></return>
</function>
-<function name="CLUTTER_ALPHA_EXP_DEC">
+<function name="json_array_unref">
<description>
-Convenience symbold for clutter_exp_dec_func().
-
-Since: 0.4
+Decreases by one the reference count of a #JsonArray. If the
+reference count reaches zero, the array is destroyed and all
+its allocated resources are freed.
</description>
<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
<function name="clutter_color_shade">
<description>
-Shades @src by the factor of @shade and saves the modified
-color into @dest.
+Shades @color by @factor and saves the modified color into @result.
</description>
<parameters>
-<parameter name="src">
+<parameter name="color">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the shaded color
+<parameter name="factor">
+<parameter_description> the shade factor to apply
</parameter_description>
</parameter>
-<parameter name="shade">
-<parameter_description> the shade factor to apply
+<parameter name="result">
+<parameter_description> (out): return location for the shaded color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_container_lower_child">
+<function name="clutter_text_set_line_wrap">
<description>
-Lowers @actor to @sibling level, in the depth ordering.
+Sets whether the contents of a #ClutterText actor should wrap,
+if they don't fit the size assigned to the actor.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> the actor to raise
+<parameter name="line_wrap">
+<parameter_description> whether the contents should wrap
</parameter_description>
</parameter>
-<parameter name="sibling">
-<parameter_description> the sibling to lower to, or %NULL to lower to the bottom
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_value_set_shader_int">
+<description>
+Sets @ints as the contents of @value. The passed #GValue
+must have been initialized using %CLUTTER_TYPE_SHADER_INT.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> number of integer values in @ints
+</parameter_description>
+</parameter>
+<parameter name="ints">
+<parameter_description> an array of integer values
</parameter_description>
</parameter>
</parameters>
@@ -10982,53 +13318,55 @@
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store the x coordinace of the center, or NULL
+<parameter_description> return location for the X coordinate of the center, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store the y coordinace of the center, or NULL
+<parameter_description> return location for the Y coordinate of the center, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_entry_get_color">
+<function name="clutter_behaviour_ellipse_set_center">
<description>
-Retrieves the color of @entry.
+Sets the center of the elliptical path to the point represented by knot.
Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> return location for a #ClutterColor
+<parameter name="x">
+<parameter_description> x coordinace of centre
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y coordinace of centre
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_label_set_line_wrap_mode">
+<function name="clutter_animation_unbind_property">
<description>
-If line wrapping is on (see clutter_label_set_line_wrap()) this controls how
-the line wrapping is done. The default is %PANGO_WRAP_WORD which means
-wrap on word boundaries.
+Removes @property_name from the list of animated properties.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="wrap_mode">
-<parameter_description> the line wrapping mode
+<parameter name="property_name">
+<parameter_description> name of the property
</parameter_description>
</parameter>
</parameters>
@@ -11072,26 +13410,6 @@
</return>
</function>
-<function name="clutter_entry_set_alignment">
-<description>
-Sets text alignment of the entry.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="alignment">
-<parameter_description> A #PangoAlignment
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_model_append">
<description>
Creates and appends a new row to the #ClutterModel, setting the
@@ -11122,18 +13440,64 @@
<return></return>
</function>
-<function name="CLUTTER_ACTOR_IS_VISIBLE">
+<function name="clutter_script_get_object">
+<description>
+Retrieves the object bound to @name. This function does not increment
+the reference count of the returned object.
+
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the object to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> : (transfer none): the named object, or %NULL if no object
+with the given name was available
+
+Since: 0.6
+</return>
+</function>
+
+<function name="CLUTTER_ACTOR_IS_VISIBLE">
+<description>
+Evaluates to %TRUE if the actor is both realized and mapped.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="e">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_grab_pointer_for_device">
<description>
-Evaluates to %TRUE if the actor is both realized and mapped.
+Grabs all the pointer events coming from the device @id for @actor.
-Since: 0.2
+If @id is -1 then this function is equivalent to clutter_grab_pointer().
+
+Since: 0.8
</description>
<parameters>
-<parameter name="e">
+<parameter name="actor">
<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
+<parameter name="id">
+<parameter_description> a device id, or -1
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -11154,52 +13518,68 @@
</return>
</function>
-<function name="json_parser_new">
+<function name="clutter_text_set_color">
<description>
-Creates a new #JsonParser instance. You can use the #JsonParser to
-load a JSON stream from either a file or a buffer and then walk the
-hierarchy using the data types API.
+Sets the color of the contents of a #ClutterText actor.
+The overall opacity of the #ClutterText actor will be the
+result of the alpha value of @color and the composited
+opacity of the actor itself on the scenegraph, as returned
+by clutter_actor_get_paint_opacity().
+
+Since: 1.0
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #JsonParser. Use g_object_unref()
-to release all the memory it allocates.
-</return>
+<return></return>
</function>
-<function name="clutter_label_get_line_wrap">
+<function name="cogl_util_next_p2">
<description>
-Return value: %TRUE if the lines of the label are automatically wrapped.
+Calculates the next power greater than @a.
+
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="a">
+<parameter_description> Value to get the next power
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the lines of the label are automatically wrapped.
-
-Since: 0.2
+<return> The next power after @a.
</return>
</function>
-<function name="cogl_util_next_p2">
+<function name="clutter_text_set_cursor_size">
<description>
-Calculates the next power greater than @a.
+Sets the size of the cursor of a #ClutterText. The cursor
+will only be visible if the #ClutterText:cursor-visible property
+is set to %TRUE.
+Since: 1.0
</description>
<parameters>
-<parameter name="a">
-<parameter_description> Value to get the next power
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of the cursor, in pixels, or -1 to use the
+default value
</parameter_description>
</parameter>
</parameters>
-<return> The next power after @a.
-</return>
+<return></return>
</function>
<function name="clutter_actor_get_size">
@@ -11234,24 +13614,52 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_angle_endx">
+<function name="clutter_param_spec_color">
<description>
-Gets the angle at which movements ends.
+Creates a #GParamSpec for properties using #ClutterColor.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="name">
+<parameter_description> name of the property
+</parameter_description>
+</parameter>
+<parameter name="nick">
+<parameter_description> short name
+</parameter_description>
+</parameter>
+<parameter name="blurb">
+<parameter_description> description (can be translatable)
+</parameter_description>
+</parameter>
+<parameter name="default_value">
+<parameter_description> default value
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags for the param spec
</parameter_description>
</parameter>
</parameters>
-<return> angle, as #ClutterFixed, in degrees
+<return> the newly created #GParamSpec
-Since: 0.4
+Since: 0.8.4
</return>
</function>
+<function name="ClutterBindingPool">
+<description>
+The unique name of the #ClutterBindingPool.
+
+Since: 1.0
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_group_get_nth_child">
<description>
Gets a groups child held at @index_ in stack.
@@ -11268,7 +13676,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> A Clutter actor or NULL if @index_ is invalid.
+<return> (transfer none): A Clutter actor or NULL if @index_ is invalid.
Since: 0.2
</return>
@@ -11291,82 +13699,168 @@
<return></return>
</function>
-<function name="clutter_stage_set_title">
+<function name="clutter_actor_animate">
<description>
-Sets the stage title.
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite duration and a speed given by the @mode.
+
+For example, this:
+
+|[
+clutter_actor_animate (rectangle, CLUTTER_LINEAR, 250,
+"width", 100,
+"height", 100,
+NULL);
+]|
+
+will make width and height properties of the #ClutterActor "rectangle"
+grow linearly between the current value and 100 pixels, in 250 milliseconds.
+
+The animation @mode is a logical id, either from the #ClutterAnimationMode
+enumeration of from clutter_alpha_register_func().
+
+All the properties specified will be animated between the current value
+and the final value. If a property should be set at the beginning of
+the animation but not updated during the animation, it should be prefixed
+by the "fixed::" string, for instance:
+
+|[
+clutter_actor_animate (actor, CLUTTER_EASE_IN, 100,
+"rotation-angle-z", 360,
+"fixed::rotation-center-z", &amp;center,
+NULL);
+]|
+
+Will animate the "rotation-angle-z" property between the current value
+and 360 degrees, and set the "rotation-center-z" property to the fixed
+value of the #ClutterVertex "center".
+
+This function will implicitly create a #ClutterAnimation object which
+will be assigned to the @actor and will be returned to the developer
+to control the animation or to know when the animation has been
+completed.
+
+Calling this function on an actor that is already being animated
+will cause the current animation to change with the new final values,
+the new easing mode and the new duration - that is, this code:
+
+|[
+clutter_actor_animate (actor, 250, CLUTTER_LINEAR,
+"width", 100,
+"height", 100,
+NULL);
+clutter_actor_animate (actor, 500, CLUTTER_EASE_IN_CUBIC,
+"x", 100,
+"y", 100,
+"width", 200,
+NULL);
+]|
+
+is the equivalent of:
+
+|[
+clutter_actor_animate (actor, 500, CLUTTER_EASE_IN_CUBIC,
+"x", 100,
+"y", 100,
+"width", 200,
+"height", 100,
+NULL);
+]|
+
+&lt;note&gt;Unless the animation is looping, it will become invalid as soon
+as it is complete. To avoid this, you should keep a reference on the
+returned value using g_object_ref().&lt;/note&gt;
-Since 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="title">
-<parameter_description> A utf8 string for the stage windows title.
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> duration of the animation, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of a property
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> a %NULL terminated list of property names and
+property values
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #ClutterAnimation object. The object is
+owned by the #ClutterActor and should not be unreferenced with
+g_object_unref()
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_model_iter_get_value">
+<function name="clutter_stage_set_title">
<description>
-Sets an initializes @value to that at @column. When done with @value,
-g_value_unset() needs to be called to free any allocated memory.
+Sets the stage title.
-Since: 0.6
+Since: 0.4
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
-</parameter_description>
-</parameter>
-<parameter name="column">
-<parameter_description> column number to retrieve the value from
+<parameter name="stage">
+<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> an empty #GValue to set
+<parameter name="title">
+<parameter_description> A utf8 string for the stage windows title.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_media_get_volume">
+<function name="clutter_x11_get_stage_window">
<description>
-Retrieves the playback volume of @media.
+Gets the stages X Window.
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return> The playback volume between 0.0 and 1.0
+<return> An XID for the stage window.
+
+Since: 0.4
</return>
</function>
-<function name="json_node_type_name">
+<function name="clutter_behaviour_ellipse_set_height">
<description>
-Retrieves the user readable name of the data type contained by @node.
+Sets the height of the elliptical path.
+Since: 0.4
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> height of the ellipse
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the name of the type. The returned string
-is owned by the node and should never be modified or freed
-</return>
+<return></return>
</function>
<function name="clutter_rectangle_set_border_color">
@@ -11409,11 +13903,14 @@
</description>
<parameters>
<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return> The URI as a string.
+<return> the URI of the media stream. Use g_free()
+to free the returned string
+
+Since: 0.2
</return>
</function>
@@ -11426,6 +13923,9 @@
Applications rarely need to call this, as redraws are handled
automatically by modification functions.
+This function will not do anything if @self is not visible, or
+if the actor is inside an invisible part of the scenegraph.
+
</description>
<parameters>
<parameter name="self">
@@ -11462,6 +13962,40 @@
</return>
</function>
+<function name="ClutterClone">
+<description>
+This property specifies the source actor being cloned.
+
+Since: 1.0
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_path_set_path">
+<description>
+Change the path that the actors will follow. This will take the
+floating reference on the #ClutterPath so you do not need to unref
+it.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="pathb">
+<parameter_description> the path behaviour
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the new path to follow
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_set_anchor_pointu">
<description>
Sets an anchor point for @self. The anchor point is a point in the
@@ -11489,54 +14023,27 @@
<return></return>
</function>
-<function name="clutter_frame_source_add_full">
+<function name="clutter_text_set_selection_bound">
<description>
-Sets a function to be called at regular intervals with the given
-priority. The function is called repeatedly until it returns
-%FALSE, at which point the timeout is automatically destroyed and
-the function will not be called again. The @notify function is
-called when the timeout is destroyed. The first call to the
-function will be at the end of the first @interval.
+Sets the other end of the selection, starting from the current
+cursor position.
-This function is similar to g_timeout_add_full() except that it
-will try to compensate for delays. For example, if @func takes half
-the interval time to execute then the function will be called again
-half the interval time after it finished. In contrast
-g_timeout_add_full() would not fire until a full interval after the
-function completes so the delay between calls would be @interval *
-1.5. This function does not however try to invoke the function
-multiple times to catch up missing frames if @func takes more than
- interval ms to execute.
+If @selection_bound is -1, the selection unset.
+Since: 1.0
</description>
<parameters>
-<parameter name="priority">
-<parameter_description> the priority of the frame source. Typically this will be in the
-range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
-</parameter_description>
-</parameter>
-<parameter name="interval">
-<parameter_description> the time between calls to the function, in milliseconds
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> function to call when the timeout source is removed
+<parameter name="selection_bound">
+<parameter_description> the position of the end of the selection, in characters
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_texture_set_from_rgb_data">
@@ -11573,7 +14080,8 @@
</parameter_description>
</parameter>
<parameter name="bpp">
-<parameter_description> bytes per pixel ( Currently only 4 supported )
+<parameter_description> bytes per pixel (Currently only 3 and 4 supported,
+depending on @has_alpha)
</parameter_description>
</parameter>
<parameter name="flags">
@@ -11591,27 +14099,25 @@
</return>
</function>
-<function name="clutter_container_add">
+<function name="clutter_text_set_line_alignment">
<description>
-Adds a list of #ClutterActor&lt;!-- --&gt;s to @container. Each time and
-actor is added, the "actor-added" signal is emitted. Each actor should
-be parented to @container, which takes a reference on the actor. You
-cannot add a #ClutterActor to more than one #ClutterContainer.
+Sets the way that the lines of a wrapped label are aligned with
+respect to each other. This does not affect the overall alignment
+of the label within its allocated or specified width.
-Since: 0.4
+To align a #ClutterText actor you should add it to a container
+that supports alignment, or use the anchor point.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="first_actor">
-<parameter_description> the first #ClutterActor to add
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> %NULL terminated list of actors to add
+<parameter name="alignment">
+<parameter_description> A #PangoAlignment
</parameter_description>
</parameter>
</parameters>
@@ -11664,7 +14170,7 @@
<function name="clutter_behaviour_ellipse_get_angle_tiltx">
<description>
-Gets the tilt of the ellipse around the center in the given axis.
+Gets the tilt of the ellipse around the center in the given axis
</description>
@@ -11678,43 +14184,34 @@
</parameter_description>
</parameter>
</parameters>
-<return> angle, as #ClutterFixed, in degrees
+<return> the tilt angle in degrees, as a fixed point value
Since: 0.4
</return>
</function>
-<function name="clutter_entry_get_cursor_position">
+<function name="clutter_cairo_texture_get_surface_size">
<description>
-Gets the position, in characters, of the cursor in @entry.
-
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-</parameters>
-<return> the position of the cursor.
-
-Since: 0.6
-</return>
-</function>
+Retrieves the surface width and height for @self.
-<function name="clutter_label_get_use_markup">
-<description>
-Return value: %TRUE if the label's text will be parsed for markup.
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the surface width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the surface height, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the label's text will be parsed for markup.
-</return>
+<return></return>
</function>
<function name="clutter_actor_is_scaled">
@@ -11772,61 +14269,85 @@
<return></return>
</function>
-<function name="clutter_actor_get_rotationx">
+<function name="clutter_score_list_timelines">
<description>
-Retrieves the angle and center of rotation on the given axis,
-set using clutter_actor_set_rotation().
-
-This function is the fixed point variant of clutter_actor_get_rotation().
+Retrieves a list of all the #ClutterTimelines managed by @score.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> return value for the X coordinate of the center of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> return value for the Y coordinate of the center of rotation
-</parameter_description>
-</parameter>
-<parameter name="z">
-<parameter_description> return value for the Z coordinate of the center of rotation
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation as a fixed point value.
+<return> (transfer container) (element-type ClutterTimeline): a #GSList
+containing all the timelines in the score. This function does not increase
+the reference count of the returned timelines. Use g_slist_free() on the
+returned list to deallocate its resources.
Since: 0.6
</return>
</function>
-<function name="clutter_score_list_timelines">
+<function name="clutter_path_add_string">
<description>
-Retrieves a list of all the #ClutterTimelines managed by @score.
+Adds new nodes to the end of the path as described in @str. The
+format is a subset of the SVG path format. Each node is represented
+by a letter and is followed by zero, one or three pairs of
+coordinates. The coordinates can be separated by spaces or a
+comma. The types are:
+
+&lt;variablelist&gt;
+&lt;varlistentry&gt;&lt;term&gt;M&lt;/term&gt;
+&lt;listitem&gt;&lt;para&gt;
+Adds a %CLUTTER_PATH_MOVE_TO node. Takes one pair of coordinates.
+&lt;/para&gt;&lt;/listitem&gt;&lt;/varlistentry&gt;
+&lt;varlistentry&gt;&lt;term&gt;L&lt;/term&gt;
+&lt;listitem&gt;&lt;para&gt;
+Adds a %CLUTTER_PATH_LINE_TO node. Takes one pair of coordinates.
+&lt;/para&gt;&lt;/listitem&gt;&lt;/varlistentry&gt;
+&lt;varlistentry&gt;&lt;term&gt;C&lt;/term&gt;
+&lt;listitem&gt;&lt;para&gt;
+Adds a %CLUTTER_PATH_CURVE_TO node. Takes three pairs of coordinates.
+&lt;/para&gt;&lt;/listitem&gt;&lt;/varlistentry&gt;
+&lt;varlistentry&gt;&lt;term&gt;z&lt;/term&gt;
+&lt;listitem&gt;&lt;para&gt;
+Adds a %CLUTTER_PATH_CLOSE node. No coordinates are needed.
+&lt;/para&gt;&lt;/listitem&gt;&lt;/varlistentry&gt;
+&lt;/variablelist&gt;
+
+The M, L and C commands can also be specified in lower case which
+means the coordinates are relative to the previous node.
+
+For example, to move an actor in a 100 by 100 pixel square centered
+on the point 300,300 you could use the following path:
+
+&lt;informalexample&gt;
+&lt;programlisting&gt;
+M 250,350 l 0 -100 L 350,250 l 0 100 z
+&lt;/programlisting&gt;
+&lt;/informalexample&gt;
+
+If the path description isn't valid %FALSE will be returned and no
+nodes will be added.
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> a string describing the new nodes
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList containing all the timelines in the score.
-This function does not increase the reference count of the
-returned timelines. Use g_slist_free() on the returned list to
-deallocate its resources.
+<return> %TRUE is the path description was valid or %FALSE
+otherwise.
-Since: 0.6
+Since: 1.0
</return>
</function>
@@ -11848,32 +14369,6 @@
</return>
</function>
-<function name="clutter_behaviour_bspline_append_knots">
-<description>
-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
-
-</description>
-<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
-</parameter_description>
-</parameter>
-<parameter name="first_knot">
-<parameter_description> first #ClutterKnot
-</parameter_description>
-</parameter>
-<parameter name="VarArgs">
-<parameter_description> a NULL-terminated array of #ClutterKnot control points.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_x11_texture_pixmap_new_with_pixmap">
<description>
@@ -11944,6 +14439,20 @@
<return></return>
</function>
+<function name="json_generator_new">
+<description>
+Creates a new #JsonGenerator. You can use this object to generate a
+JSON data stream starting from a data object model composed by
+#JsonNode&lt;!-- --&gt;s.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #JsonGenerator instance
+</return>
+</function>
+
<function name="clutter_timeline_set_delay">
<description>
Sets the delay, in milliseconds, before @timeline should start.
@@ -11964,59 +14473,41 @@
<return></return>
</function>
-<function name="clutter_timeline_pause">
+<function name="clutter_path_node_copy">
<description>
-Pauses the #ClutterTimeline on current frame
+Makes an allocated copy of a node.
+
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the copied node.
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_effect_move">
+<function name="clutter_actor_get_anchor_point_gravity">
<description>
-Simple effect for moving a single #ClutterActor along to a
-destination point.
+Retrieves the anchor position expressed as a #ClutterGravity. If
+the anchor point was specified using pixels or units this will
+return %CLUTTER_GRAVITY_NONE.
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X coordinate of the destination
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate of the destination
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or %NULL
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
+<return> the #ClutterGravity used by the anchor point
-Since: 0.6
+Since: 1.0
</return>
</function>
@@ -12034,18 +14525,37 @@
</parameter_description>
</parameter>
</parameters>
-<return> The passed iterator, updated to point at the previous
+<return> (transfer none): The passed iterator, updated to point at the previous
row in the model.
Since: 0.6
</return>
</function>
+<function name="clutter_path_get_length">
+<description>
+Retrieves an approximation of the total length of the path.
+
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+</parameters>
+<return> the length of the path.
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_set_height">
<description>
-Forces a height request on an actor, causing the actor's
-normal width and height (if any) to be ignored. This function
-sets both the minimum and natural size request of the actor.
+Forces a height on an actor, causing the actor's preferred width
+and height (if any) to be ignored.
+
+This function sets both the minimum and natural size of the actor.
since: 0.2
@@ -12063,33 +14573,30 @@
<return></return>
</function>
-<function name="clutter_stage_unfullscreen">
+<function name="clutter_texture_get_cogl_material">
<description>
-Asks to toggle off the fullscreen state for the stage window. Note that
-you shouldn't assume the window is definitely not full screen afterward,
-because other entities (e.g. the user or window manager) could fullscreen
-it again, and not all window managers honor requests to unfullscreen
-windows.
+Return value: COGL material handle
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> COGL material handle
+</return>
</function>
<function name="clutter_stage_manager_get_default">
<description>
-Return value: the default stage manager instance. The returned object
+Return value: (transfer none): the default stage manager instance. The returned
</description>
<parameters>
</parameters>
-<return> the default stage manager instance. The returned object
-is owned by Clutter and you should not reference or unreference it.
+<return> (transfer none): the default stage manager instance. The returned
+object is owned by Clutter and you should not reference or unreference it.
Since: 0.8
</return>
@@ -12111,19 +14618,111 @@
</return>
</function>
-<function name="clutter_label_get_justify">
+<function name="json_generator_to_file">
+<description>
+Creates a JSON data stream and puts it inside @filename, overwriting the
+current file contents. This operation is atomic.
+
+
+</description>
+<parameters>
+<parameter name="generator">
+<parameter_description> a #JsonGenerator
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> path to the target file
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if saving was successful.
+</return>
+</function>
+
+<function name="clutter_texture_new_from_actor">
<description>
-Retrieves whether the label should justify the text on both margins.
+Creates a new #ClutterTexture object with its source a prexisting
+actor (and associated children). The textures content will contain
+'live' redirected output of the actors scene.
+
+Note this function is intented as a utility call for uniformly applying
+shaders to groups and other potential visual effects. It requires that
+the %CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend
+and the target system.
+
+Some tips on usage:
+
+&lt;itemizedlist&gt;
+&lt;listitem&gt;
+&lt;para&gt;The source actor must be made visible (i.e by calling
+#clutter_actor_show).&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;The source actor must have a parent in order for it to be
+allocated a size from the layouting mechanism. If the source
+actor does not have a parent when this function is called then
+the ClutterTexture will adopt it and allocate it at its
+preferred size. Using this you can clone an actor that is
+otherwise not displayed. Because of this feature if you do
+intend to display the source actor then you must make sure that
+the actor is parented before calling
+clutter_texture_new_from_actor() or that you unparent it before
+adding it to a container.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;When getting the image for the clone texture, Clutter
+will attempt to render the source actor exactly as it would
+appear if it was rendered on screen. The source actor's parent
+transformations are taken into account. Therefore if your
+source actor is rotated along the X or Y axes so that it has
+some depth, the texture will appear differently depending on
+the on-screen location of the source actor. While painting the
+source actor, Clutter will set up a temporary asymmetric
+perspective matrix as the projection matrix so that the source
+actor will be projected as if a small section of the screen was
+being viewed. Before version 0.8.2, an orthogonal identity
+projection was used which meant that the source actor would be
+clipped if any part of it was not on the zero Z-plane.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;Avoid reparenting the source with the created texture.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;A group can be padded with a transparent rectangle as to
+provide a border to contents for shader output (blurring text
+for example).&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;The texture will automatically resize to contain a further
+transformed source. However, this involves overhead and can be
+avoided by placing the source actor in a bounding group
+sized large enough to contain any child tranformations.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;Uploading pixel data to the texture (e.g by using
+clutter_actor_set_from_file()) will destroy the offscreen texture data
+and end redirection.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;listitem&gt;
+&lt;para&gt;cogl_texture_get_data() with the handle returned by
+clutter_texture_get_cogl_texture() can be used to read the
+offscreen texture pixels into a pixbuf.&lt;/para&gt;
+&lt;/listitem&gt;
+&lt;/itemizedlist&gt;
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="actor">
+<parameter_description> A source #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the text should be justified
+<return> A newly created #ClutterTexture object, or %NULL on failure.
Since: 0.6
</return>
@@ -12142,18 +14741,18 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt_x">
-<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
-center in X axis in degrees, or NULL.
+<parameter_description> location for tilt of the elipse, as #CoglFixed, around
+the center in X axis in degrees, or %NULL.
</parameter_description>
</parameter>
<parameter name="angle_tilt_y">
-<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
-center in Y axis in degress, or NULL.
+<parameter_description> location for tilt of the elipse, as #CoglFixed, around
+the center in Y axis in degress, or %NULL.
</parameter_description>
</parameter>
<parameter name="angle_tilt_z">
-<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
-center in Z axis in degrees, or NULL.
+<parameter_description> location for tilt of the elipse, as #CoglFixed, around
+the center in Z axis in degrees, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -12180,18 +14779,6 @@
<return></return>
</function>
-<function name="CLUTTER_ALPHA_SINE_INC">
-<description>
-Convenience symbol for clutter_sine_inc_func().
-
-Since: 0.2
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_model_iter_is_first">
<description>
Gets whether the current iterator is at the beginning of the model
@@ -12211,54 +14798,6 @@
</return>
</function>
-<function name="clutter_entry_set_font_name">
-<description>
-Sets @font_name as the font used by @entry.
-
- font_name must be a string containing the font name and its
-size, similarly to what you would feed to the
-pango_font_description_from_string() function.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="font_name">
-<parameter_description> a font name and size, or %NULL for the default font
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_ramp_func">
-<description>
-Convenience alpha function for a full ramp function (increase for
-half the time, decrease for the remaining half). You can use this
-function as the alpha function for clutter_alpha_set_func().
-
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
-</parameter_description>
-</parameter>
-</parameters>
-<return> an alpha value.
-
-Since: 0.2
-</return>
-</function>
-
<function name="clutter_actor_get_preferred_size">
<description>
Computes the preferred minimum and natural size of an actor, taking into
@@ -12282,19 +14821,19 @@
</parameter_description>
</parameter>
<parameter name="min_width_p">
-<parameter_description> return location for the minimum width, or %NULL
+<parameter_description> (out) (allow-none): return location for the minimum width, or %NULL
</parameter_description>
</parameter>
<parameter name="min_height_p">
-<parameter_description> return location for the minimum height, or %NULL
+<parameter_description> (out) (allow-none): return location for the minimum height, or %NULL
</parameter_description>
</parameter>
<parameter name="natural_width_p">
-<parameter_description> return location for the natural width, or %NULL
+<parameter_description> (out) (allow-none): return location for the natural width, or %NULL
</parameter_description>
</parameter>
<parameter name="natural_height_p">
-<parameter_description> return location for the natural height, or %NULL
+<parameter_description> (out) (allow-none): return location for the natural height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -12328,6 +14867,28 @@
</return>
</function>
+<function name="clutter_text_set_cursor_position">
+<description>
+Sets the cursor of a #ClutterText actor at @position.
+
+The position is expressed in characters, not in bytes.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the new cursor position, in characters
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_parser_get_root">
<description>
Retrieves the top level node from the parsed JSON stream.
@@ -12340,26 +14901,34 @@
</parameter_description>
</parameter>
</parameters>
-<return> the root #JsonNode . The returned node is owned by
-the #JsonParser and should never be modified or freed.
+<return> (transfer none): the root #JsonNode . The returned node
+is owned by the #JsonParser and should never be modified or freed.
</return>
</function>
-<function name="clutter_backend_set_double_click_time">
+<function name="clutter_actor_get_abs_allocation_vertices">
<description>
-Sets the maximum time between two button press events, used to
-verify whether it's a double click event or not.
+Calculates the transformed screen coordinates of the four corners of
+the actor; the returned vertices relate to the #ClutterActorBox
+coordinates as follows:
+&lt;itemizedlist&gt;
+&lt;listitem&gt;&lt;para&gt;v[0] contains (x1, y1)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;v[1] contains (x2, y1)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;v[2] contains (x1, y2)&lt;/para&gt;&lt;/listitem&gt;
+&lt;listitem&gt;&lt;para&gt;v[3] contains (x2, y2)&lt;/para&gt;&lt;/listitem&gt;
+&lt;/itemizedlist&gt;
Since: 0.4
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="msec">
-<parameter_description> milliseconds between two button press events
+<parameter name="verts">
+<parameter_description> Pointer to a location of an array of 4 #ClutterVertex where to
+store the result.
</parameter_description>
</parameter>
</parameters>
@@ -12437,14 +15006,12 @@
Connects all the signals defined into a UI definition file to their
handlers.
-This method is a simpler variation of clutter_script_connect_signals_full().
-It uses #GModule's introspective features (by opening the module %NULL)
-to look at the application's symbol table. From here it tries to match
-the signal handler names given in the interface description with
-symbols in the application and connects the signals.
+This method invokes clutter_script_connect_signals_full() internally
+and uses #GModule's introspective features (by opening the current
+module's scope) to look at the application's symbol table.
-Note that this function will not work correctly if #GModule is not
-supported on the platform.
+Note that this function will not work if #GModule is not supported by
+the platform Clutter is running on.
Since: 0.6
@@ -12495,33 +15062,42 @@
</parameter_description>
</parameter>
</parameters>
-<return> The #ClutterActor parent, or %NULL if no parent is set
+<return> (transfer none): The #ClutterActor parent, or %NULL if no parent is set
</return>
</function>
<function name="clutter_stage_get_fog">
<description>
-Retrieves the settings used by the GL fog to create the
-depth cueing effect on the @stage.
+Retrieves the current depth cueing settings from the stage.
Since: 0.6
</description>
<parameters>
<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter_description> the #ClutterStage
</parameter_description>
</parameter>
-<parameter name="density">
-<parameter_description> return location for the intensity dampening
+<parameter name="fog">
+<parameter_description> return location for a #ClutterFog structure
</parameter_description>
</parameter>
-<parameter name="z_near">
-<parameter_description> return location for the starting point of the depth cueing
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_timeline_set_loop">
+<description>
+Sets whether @timeline should loop.
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="z_far">
-<parameter_description> return location for the ending point of the depth cueing
+<parameter name="loop">
+<parameter_description> %TRUE for enable looping
</parameter_description>
</parameter>
</parameters>
@@ -12530,8 +15106,11 @@
<function name="ClutterTexture">
<description>
-The ::pixbuf-change signal is emitted each time the pixbuf
-used by @texture changes.
+The ::load-finished signal is emitted when a texture load has
+completed. If there was an error during loading, @error will
+be set, otherwise it will be %NULL
+
+Since: 1.0
</description>
<parameters>
@@ -12539,22 +15118,28 @@
<parameter_description> the texture which received the signal
</parameter_description>
</parameter>
+<parameter name="error">
+<parameter_description> A set error, or %NULL
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_timeline_set_loop">
+<function name="cogl_pango_font_map_set_resolution">
<description>
-Sets whether @timeline should loop.
+Sets the resolution to be used by @font_map at @dpi.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="font_map">
+<parameter_description> a #CoglPangoFontMap
</parameter_description>
</parameter>
-<parameter name="loop">
-<parameter_description> %TRUE for enable looping
+<parameter name="dpi">
+<parameter_description> DPI to set
</parameter_description>
</parameter>
</parameters>
@@ -12582,27 +15167,20 @@
<return></return>
</function>
-<function name="clutter_model_iter_set_value">
+<function name="clutter_threads_init">
<description>
-Sets the data in the cell specified by @iter and @column. The type of
- value must be convertable to the type of the column.
+Initialises the Clutter threading mechanism, so that Clutter API can be
+called by multiple threads, using clutter_threads_enter() and
+clutter_threads_leave() to mark the critical sections.
-Since: 0.6
+You must call g_thread_init() before this function.
+
+This function must be called before clutter_init().
+
+Since: 0.4
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
-</parameter_description>
-</parameter>
-<parameter name="column">
-<parameter_description> column number to retrieve the value from
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> new value for the cell
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -12715,87 +15293,34 @@
<return></return>
</function>
-<function name="clutter_glx_texture_pixmap_new_with_pixmap">
+<function name="clutter_x11_has_xinput">
<description>
+Gets whether Clutter has XInput support.
+
</description>
<parameters>
-<parameter name="pixmap">
-<parameter_description> the X Pixmap to which this texture should be bound
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> the width of the X pixmap
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> the height of the X pixmap
-</parameter_description>
-</parameter>
-<parameter name="depth">
-<parameter_description> the depth of the X pixmap
-</parameter_description>
-</parameter>
</parameters>
-<return> A new #ClutterGLXTexturePixmap bound to the given X Pixmap
+<return> %TRUE if Clutter was compiled with XInput support
+and XInput support is available at run time.
Since: 0.8
</return>
</function>
-<function name="clutter_effect_rotate">
+<function name="clutter_glx_texture_pixmap_new_with_pixmap">
<description>
-Simple effect for rotating a single #ClutterActor.
-
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> a #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> final angle to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="center_x">
-<parameter_description> position on X axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="center_y">
-<parameter_description> position on Y axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="center_z">
-<parameter_description> position on Z axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="direction">
-<parameter_description> a #ClutterRotateDirection for the rotation.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> user data to pass to supplied @func or %NULL
+<parameter name="pixmap">
+<parameter_description> the X Pixmap to which this texture should be bound
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
+<return> A new #ClutterGLXTexturePixmap bound to the given X Pixmap
-Since: 0.6
+Since: 0.8
</return>
</function>
@@ -12837,50 +15362,29 @@
</return>
</function>
-<function name="clutter_effect_template_new_for_duration">
+<function name="cogl_sqrti">
<description>
-Creates a new #ClutterEffectTemplate, to be used with the effects API.
-
-A #ClutterEffectTemplate binds a timeline and an alpha function and can
-be used as a template for multiple calls of clutter_effect_fade(),
-clutter_effect_move() and clutter_effect_scale().
-
-This API is intended for simple animations involving a single actor;
-for more complex animations, you should see #ClutterBehaviour and the
-derived classes.
+Very fast fixed point implementation of square root for integers.
-This function creates a #ClutterTimeline with a duration of @msecs
-milliseconds and transfers ownership of the timeline object to the
-returned #ClutterEffectTemplate.
+This function is at least 6x faster than clib sqrt() on x86, and (this is
+not a typo!) about 500x faster on ARM without FPU. It's error is &lt; 5%
+for arguments &lt; #COGL_SQRTI_ARG_5_PERCENT and &lt; 10% for arguments &lt;
+#COGL_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
+this function is COGL_SQRTI_ARG_MAX.
</description>
<parameters>
-<parameter name="msecs">
-<parameter_description> the duration of the effects, in milliseconds
-</parameter_description>
-</parameter>
-<parameter name="alpha_func">
-<parameter_description> an alpha function to use for the template
+<parameter name="x">
+<parameter_description> integer value
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterEffectTemplate object
-
-Since: 0.6
-</return>
-</function>
-
-<function name="ClutterEffectTemplate">
-<description>
-Controls if effects should clone or reference the templated timeline
+<return> integer square root.
-Since: 0.6
-</description>
-<parameters>
-</parameters>
-<return></return>
+Since: 0.2
+</return>
</function>
<function name="clutter_actor_set_geometry">
@@ -12915,6 +15419,31 @@
</return>
</function>
+<function name="clutter_model_iter_set_value">
+<description>
+Sets the data in the cell specified by @iter and @column. The type of
+ value must be convertable to the type of the column.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> column number to retrieve the value from
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> new value for the cell
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_get_allocation_coords">
<description>
Gets the layout box an actor has been assigned. The allocation can
@@ -12934,131 +15463,127 @@
<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="x1">
-<parameter_description> x1 coord
+<parameter name="x_1">
+<parameter_description> (out): x1 coordinate
</parameter_description>
</parameter>
-<parameter name="y1">
-<parameter_description> y1 coord
+<parameter name="y_1">
+<parameter_description> (out): y1 coordinate
</parameter_description>
</parameter>
-<parameter name="x2">
-<parameter_description> x2 coord
+<parameter name="x_2">
+<parameter_description> (out): x2 coordinate
</parameter_description>
</parameter>
-<parameter name="y2">
-<parameter_description> y2 coord
+<parameter name="y_2">
+<parameter_description> (out): y2 coordinate
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_score_remove">
+<function name="clutter_behaviour_opacity_new">
<description>
-Removes the #ClutterTimeline with the given id inside @score. If
-the timeline has other timelines attached to it, those are removed
-as well.
+Creates a new #ClutterBehaviourOpacity object, driven by @alpha
+which controls the opacity property of every actor, making it
+change in the interval between @opacity_start and @opacity_end.
-Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
-</parameter_description>
-</parameter>
-<parameter name="id">
-<parameter_description> the id of the timeline to remove
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha instance, or %NULL
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_ramp_dec_func">
-<description>
-Convenience alpha function for a monotonic decreasing ramp. You
-can use this function as the alpha function for clutter_alpha_set_func().
-
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="opacity_start">
+<parameter_description> minimum level of opacity
</parameter_description>
</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
+<parameter name="opacity_end">
+<parameter_description> maximum level of opacity
</parameter_description>
</parameter>
</parameters>
-<return> an alpha value.
+<return> the newly created #ClutterBehaviourOpacity
Since: 0.2
</return>
</function>
-<function name="clutter_behaviour_opacity_new">
+<function name="clutter_binding_pool_find_action">
<description>
-Creates a new #ClutterBehaviourOpacity object, driven by @alpha
-which controls the opacity property of every actor, making it
-change in the interval between @opacity_start and @opacity_end.
+Retrieves the name of the action matching the given key symbol
+and modifiers bitmask.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha instance, or %NULL
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
</parameter_description>
</parameter>
-<parameter name="opacity_start">
-<parameter_description> minimum level of opacity
+<parameter name="key_val">
+<parameter_description> a key symbol
</parameter_description>
</parameter>
-<parameter name="opacity_end">
-<parameter_description> maximum level of opacity
+<parameter name="modifiers">
+<parameter_description> a bitmask for the modifiers
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterBehaviourOpacity
+<return> the name of the action, if found, or %NULL. The
+returned string is owned by the binding pool and should never
+be modified or freed
-Since: 0.2
+Since: 1.0
</return>
</function>
-<function name="json_node_get_parent">
+<function name="clutter_behaviour_ellipse_set_angle_tilt">
<description>
-Retrieves the parent #JsonNode of @node.
+Sets the angle at which the ellipse should be tilted around it's center.
+Since: 0.4
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> a #ClutterRotateAxis
+</parameter_description>
+</parameter>
+<parameter name="angle_tilt">
+<parameter_description> tilt of the elipse around the center in the given axis in
+degrees.
</parameter_description>
</parameter>
</parameters>
-<return> the parent node, or %NULL if @node is the root node
-</return>
+<return></return>
</function>
-<function name="clutter_timeout_pool_remove">
+<function name="clutter_actor_set_shader_param_float">
<description>
-Removes a timeout function with @id from the timeout pool. The id
-is the same returned when adding a function to the timeout pool with
-clutter_timeout_pool_add().
+Sets the value for a named float parameter of the shader applied
+to @actor.
-Since: 0.4
+Since: 0.8
</description>
<parameters>
-<parameter name="pool">
-<parameter_description> a #ClutterTimeoutPool
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="id">
-<parameter_description> the id of the timeout to remove
+<parameter name="param">
+<parameter_description> the name of the parameter
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the parameter
</parameter_description>
</parameter>
</parameters>
@@ -13082,31 +15607,28 @@
</return>
</function>
-<function name="clutter_texture_set_from_file">
+<function name="clutter_container_lower_child">
<description>
-Sets the #ClutterTexture image data from an image file. In case of
-failure, %FALSE is returned and @error is set.
+Lowers @actor to @sibling level, in the depth ordering.
+Since: 0.6
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> The filename of the image in GLib file name encoding
+<parameter name="actor">
+<parameter_description> the actor to raise
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for a #GError, or %NULL
+<parameter name="sibling">
+<parameter_description> the sibling to lower to, or %NULL to lower to the bottom
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the image was successfully loaded and set
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_texture_new">
@@ -13121,29 +15643,50 @@
</return>
</function>
-<function name="json_generator_to_file">
+<function name="clutter_text_set_use_markup">
<description>
-Creates a JSON data stream and puts it inside @filename, overwriting the
-current file contents. This operation is atomic.
+Sets whether the contents of the #ClutterText actor contains markup
+in &lt;link linkend="PangoMarkupFormat"&gt;Pango's text markup language&lt;/link&gt;.
+Setting #ClutterText:use-markup on an editable #ClutterText will
+make the actor discard any markup.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="generator">
-<parameter_description> a #JsonGenerator
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> path to the target file
+<parameter name="setting">
+<parameter_description> %TRUE if the text should be parsed for markup.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_raise">
+<description>
+Puts @self above @below.
+
+Both actors must have the same parent.
+
+This function is the equivalent of clutter_container_raise_child().
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="below">
+<parameter_description> (allow-none): A #ClutterActor to raise above.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if saving was successful.
-</return>
+<return></return>
</function>
<function name="clutter_model_iter_set_valist">
@@ -13241,7 +15784,7 @@
</parameters>
<return> %TRUE if the texture was successfully updated
-Since 0.4.
+Since: 0.4
</return>
</function>
@@ -13249,31 +15792,48 @@
<description>
Sets the stage perspective.
-Since: 0.4
-
</description>
<parameters>
<parameter name="stage">
<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="fovy">
-<parameter_description> the field of view angle, in degrees, in the y direction
+<parameter name="perspective">
+<parameter_description> A #ClutterPerspective
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_scale_set_boundsx">
+<description>
+Fixed point version of clutter_behaviour_scale_set_bounds().
+
+Sets the bounds used by scale behaviour.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="scale">
+<parameter_description> a #ClutterBehaviourScale
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
</parameter_description>
</parameter>
-<parameter name="aspect">
-<parameter_description> the aspect ratio that determines the field of view in the x
-direction. The aspect ratio is the ratio of x (width) to y (height)
+<parameter name="y_scale_start">
+<parameter_description> initial scale factor on the Y axis
</parameter_description>
</parameter>
-<parameter name="z_near">
-<parameter_description> the distance from the viewer to the near clipping
-plane (always positive)
+<parameter name="x_scale_end">
+<parameter_description> final scale factor on the X axis
</parameter_description>
</parameter>
-<parameter name="z_far">
-<parameter_description> the distance from the viewer to the far clipping
-plane (always positive)
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
</parameters>
@@ -13318,9 +15878,22 @@
<function name="clutter_threads_add_timeout_full">
<description>
-Sets a function to be called at regular intervals holding the Clutter lock,
-with the given priority. The function is called repeatedly until it
-Return value: the ID (greater than 0) of the event source.
+Sets a function to be called at regular intervals holding the Clutter
+threads lock, with the given priority. The function is called repeatedly
+until it returns %FALSE, at which point the timeout is automatically
+removed and the function will not be called again. The @notify function
+is called when the timeout is removed.
+
+The first call to the function will be at the end of the first @interval.
+
+It is important to note that, due to how the Clutter main loop is
+implemented, the timing will not be accurate and it will not try to
+"keep up" with the interval. A more reliable source is available
+using clutter_threads_add_frame_source_full(), which is also internally
+used by #ClutterTimeline.
+
+See also clutter_threads_add_idle_full().
+
</description>
<parameters>
@@ -13352,85 +15925,107 @@
</return>
</function>
-<function name="clutter_log2x">
+<function name="clutter_text_get_ellipsize">
<description>
-Calculates base 2 logarithm.
-
-This function is some 2.5 times faster on x86, and over 12 times faster on
-fpu-less arm, than using libc log().
-
+Return value: #PangoEllipsizeMode
</description>
<parameters>
-<parameter name="x">
-<parameter_description> value to calculate base 2 logarithm from
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> base 2 logarithm.
+<return> #PangoEllipsizeMode
-Since: 0.4
+Since: 1.0
</return>
</function>
-<function name="json_node_free">
+<function name="clutter_text_delete_text">
<description>
-Frees the resources allocated by @node.
-
-</description>
-<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Deletes the text inside a #ClutterText actor between @start_pos
+and @end_pos.
-<function name="clutter_threads_leave">
-<description>
-Unlocks the Clutter thread lock.
+The starting and ending positions are expressed in characters,
+not in bytes.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="start_pos">
+<parameter_description> starting position
+</parameter_description>
+</parameter>
+<parameter name="end_pos">
+<parameter_description> ending position
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_timeline_get_duration">
+<function name="clutter_path_add_curve_to">
<description>
-Retrieves the duration of a #ClutterTimeline in milliseconds.
-See clutter_timeline_set_duration().
+Adds a #CLUTTER_PATH_CURVE_TO type node to the path. This causes
+the actor to follow a bezier from the last node to (@x_3, @y_3) using
+(@x_1, @y_1) and (@x_2,@y_2) as control points.
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="x_1">
+<parameter_description> the x coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="y_1">
+<parameter_description> the y coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="x_2">
+<parameter_description> the x coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="y_2">
+<parameter_description> the y coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="x_3">
+<parameter_description> the x coordinate of the third control point
+</parameter_description>
+</parameter>
+<parameter name="y_3">
+<parameter_description> the y coordinate of the third control point
</parameter_description>
</parameter>
</parameters>
-<return> the duration of the timeline, in milliseconds.
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_entry_get_invisible_char">
+<function name="clutter_get_font_map">
<description>
-Return value: a Unicode character
+Retrieves the #PangoFontMap instance used by Clutter.
+You can use the global font map object with the COGL
+Pango API.
+
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
</parameters>
-<return> a Unicode character
+<return> (transfer none): the #PangoFontMap instance. The returned
+value is owned by Clutter and it should never be unreferenced.
+Since: 1.0
</return>
</function>
@@ -13454,7 +16049,7 @@
<function name="clutter_key_event_symbol">
<description>
-Retrieves the value of the key that caused @keyev.
+Retrieves the symbol of the key that caused @keyev.
</description>
@@ -13464,26 +16059,24 @@
</parameter_description>
</parameter>
</parameters>
-<return> The keysym representing the key
+<return> The key symbol representing the key
</return>
</function>
-<function name="clutter_timeline_get_delay">
+<function name="clutter_score_pause">
<description>
-Retrieves the delay set using clutter_timeline_set_delay().
+Pauses a playing score @score.
+Since: 0.6
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> the delay in milliseconds.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="json_parser_load_from_file">
@@ -13551,24 +16144,6 @@
<return></return>
</function>
-<function name="clutter_clone_texture_get_parent_texture">
-<description>
-Retrieves the parent #ClutterTexture used by @clone.
-
-
-</description>
-<parameters>
-<parameter name="clone">
-<parameter_description> a #ClutterCloneTexture
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #ClutterTexture actor, or %NULL
-
-Since: 0.2
-</return>
-</function>
-
<function name="clutter_stage_show_cursor">
<description>
Shows the cursor on the stage window
@@ -13604,7 +16179,7 @@
<function name="clutter_timeline_skip">
<description>
-Advance timeline by requested number of frames.
+Advance timeline by the requested number of frames.
</description>
<parameters>
@@ -13620,6 +16195,55 @@
<return></return>
</function>
+<function name="clutter_binding_pool_activate">
+<description>
+Activates the callback associated to the action that is
+bound to the @key_val and @modifiers pair.
+
+The callback has the following signature:
+
+|[
+void (* callback) (GObject *gobject,
+const gchar *action_name,
+guint key_val,
+ClutterModifierType modifiers,
+gpointer user_data);
+]|
+
+Where the #GObject instance is @gobject and the user data
+is the one passed when installing the action with
+clutter_binding_pool_install_action().
+
+If the action bound to the @key_val, @modifiers pair has been
+blocked using clutter_binding_pool_block_action(), the callback
+will not be invoked, and this function will return %FALSE.
+
+
+</description>
+<parameters>
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> the key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask for the modifiers
+</parameter_description>
+</parameter>
+<parameter name="gobject">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if an action was found and was activated
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_model_iter_get">
<description>
Gets the value of one or more cells in the row referenced by @iter. The
@@ -13651,6 +16275,24 @@
<return></return>
</function>
+<function name="clutter_behaviour_ellipse_get_width">
+<description>
+Gets the width of the elliptical path.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+</parameters>
+<return> the width of the path
+
+Since: 0.4
+</return>
+</function>
+
<function name="clutter_actor_set_opacity">
<description>
Sets the actor's opacity, with zero being completely transparent and
@@ -13675,9 +16317,12 @@
Connects all the signals defined into a UI definition file to their
handlers.
-This function is similar to clutter_script_connect_signals() but it
-does not require GModule to be supported. It is mainly targeted at
-interpreted languages for controlling the signal connection.
+This function allows to control how the signal handlers are
+going to be connected to their respective signals. It is meant
+primarily for language bindings to allow resolving the function
+names using the native API.
+
+Applications should use clutter_script_connect_signals().
Since: 0.6
@@ -13699,71 +16344,53 @@
<return></return>
</function>
-<function name="clutter_label_set_attributes">
+<function name="clutter_x11_texture_pixmap_set_pixmap">
<description>
-Sets a #PangoAttrList; the attributes in the list are applied to the
-label text. The attributes set with this function will be ignored
-if the "use_markup" property
-is %TRUE.
+Sets the X Pixmap to which the texture should be bound.
-Since: 0.2
+Since: 0.8
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="texture">
+<parameter_description> the texture to bind
</parameter_description>
</parameter>
-<parameter name="attrs">
-<parameter_description> a #PangoAttrList
+<parameter name="pixmap">
+<parameter_description> the X Pixmap to which the texture should be bound
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_x11_texture_pixmap_set_pixmap">
+<function name="clutter_shader_set_uniform_1f">
<description>
-Sets the X Pixmap to which the texture should be bound.
+Sets a user configurable variable in the shader programs attached
+to a #ClutterShader.
-Since: 0.8
+Since: 0.6
+
+Deprecated: 1.0: Use clutter_shader_set_uniform() instead
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> the texture to bind
-</parameter_description>
-</parameter>
-<parameter name="pixmap">
-<parameter_description> the X Pixmap to which the texture should be bound
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> the Pixmap width
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> the Pixmap height
+<parameter name="name">
+<parameter_description> name of uniform in vertex or fragment program to set.
</parameter_description>
</parameter>
-<parameter name="depth">
-<parameter_description> the Pixmap depth, in number of bits
+<parameter name="value">
+<parameter_description> the new value of the uniform.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="JsonGenerator">
-<description>
-Number of spaces to be used to indent when pretty printing.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_actor_get_transformed_position">
<description>
Gets the absolute position of an actor, in pixels, relative
@@ -13778,11 +16405,11 @@
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return location for the X coordinate, or %NULL
+<parameter_description> (out): return location for the X coordinate, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return location for the Y coordinate, or %NULL
+<parameter_description> (out): return location for the Y coordinate, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -13791,7 +16418,12 @@
<function name="clutter_timeline_advance">
<description>
-Advance timeline to requested frame number
+Advance timeline to the requested frame number.
+
+&lt;note&gt;&lt;para&gt;The @timeline will not emit the #ClutterTimeline::new-frame
+signal for @frame_num. The first ::new-frame signal after the call to
+clutter_timeline_advance() will be emitted for a frame following
+ frame_num &lt;/para&gt;&lt;/note&gt;
</description>
<parameters>
@@ -13807,51 +16439,97 @@
<return></return>
</function>
-<function name="clutter_behaviour_bspline_split">
+<function name="clutter_text_get_use_markup">
+<description>
+Retrieves whether the contents of the #ClutterText actor should be
+parsed for the Pango text markup.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the contents will be parsed for markup
+
+Since: 1.0
+</return>
+</function>
+
+<function name="cogl_pango_render_layout_line">
<description>
-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.
+Renders @line at the given coordinates using the given color.
+Since: 1.0
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="line">
+<parameter_description> a #PangoLayoutLine
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> an offset of the control point at which to split the spline.
+<parameter name="x">
+<parameter_description> X coordinate to render the line at
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate to render the line at
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the line
</parameter_description>
</parameter>
</parameters>
-<return> new ClutterBehaviourBspline.
+<return></return>
+</function>
-Since: 0.4
+<function name="clutter_text_get_selection">
+<description>
+Retrieves the currently selected text.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing the currently
+selected text, or %NULL. Use g_free() to free the returned
+string.
+
+Since: 1.0
</return>
</function>
-<function name="json_generator_to_data">
+<function name="clutter_actor_move_anchor_point">
<description>
-Generates a JSON data stream from @generator and returns it as a
-buffer.
+Sets an anchor point for the @actor, and adjusts the actor postion so
+that the relative position of the actor toward its parent remains the
+same.
+Since: 0.6
</description>
<parameters>
-<parameter name="generator">
-<parameter_description> a #JsonGenerator
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> return location for the length of the returned buffer, or %NULL
+<parameter name="anchor_x">
+<parameter_description> X coordinate of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> Y coordinate of the anchor point
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated buffer holding a JSON data stream. Use
-g_free() to free the allocated resources.
-</return>
+<return></return>
</function>
<function name="clutter_actor_set_shader">
@@ -13897,21 +16575,40 @@
<return></return>
</function>
-<function name="clutter_grab_keyboard">
+<function name="clutter_actor_set_rotationu">
<description>
-Grabs keyboard events, after the grab is done keyboard events ("key-press-event"
-and "key-release-event") are delivered to this actor directly. The source
-set in the event will be the actor that would have received the event if the
-keyboard grab was not in effect.
+Sets the rotation angle of @self around the given axis.
-Since: 0.6
+This function is the units based variant of clutter_actor_set_rotation().
+
+Since: 0.8
</description>
<parameters>
-<parameter name="actor">
+<parameter name="self">
<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> Z coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -13927,11 +16624,11 @@
</description>
<parameters>
<parameter name="argc">
-<parameter_description> The number of arguments in @argv
+<parameter_description> (inout): The number of arguments in @argv
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> A pointer to an array of arguments.
+<parameter_description> (array length=argc) (inout): A pointer to an array of arguments.
</parameter_description>
</parameter>
</parameters>
@@ -13952,12 +16649,98 @@
</parameter>
</parameters>
<return> %TRUE if playing, %FALSE if stopped.
+
+Since: 0.2
+</return>
+</function>
+
+<function name="clutter_value_get_shader_int">
+<description>
+Retrieves the list of integer values stored inside the passed
+#GValue. @value must have been initialized with
+%CLUTTER_TYPE_SHADER_INT.
+
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> return location for the number of returned integer
+values, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the pointer to a list of integer values.
+The returned value is owned by the #GValue and should never
+be modified or freed.
+
+Since: 0.8
+</return>
+</function>
+
+<function name="CoglMatrixStack">
+<description>
+Stores a cogl-side matrix stack, which we use as a cache
+so we can get the matrix efficiently when using indirect
+rendering.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_create_pango_context">
+<description>
+Creates a #PangoContext for the given actor. The #PangoContext
+is already configured using the appropriate font map, resolution
+and font options.
+
+See also clutter_actor_get_pango_context().
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #PangoContext. Use g_object_unref()
+on the returned value to deallocate its resources
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_binding_pool_new">
+<description>
+Creates a new #ClutterBindingPool that can be used to store
+key bindings for an actor. The @name must be a unique identifier
+for the binding pool, so that clutter_binding_pool_find() will
+be able to return the correct binding pool.
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name of the binding pool
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created binding pool with the given
+name. Use g_object_unref() when done.
+
+Since: 1.0
</return>
</function>
<function name="clutter_timeline_set_speed">
<description>
-Set the speed in frames per second of the timeline.
+Sets the speed of @timeline in frames per second.
</description>
<parameters>
@@ -13966,7 +16749,8 @@
</parameter_description>
</parameter>
<parameter name="fps">
-<parameter_description> New speed of timeline as frames per second
+<parameter_description> New speed of timeline as frames per second,
+between 1 and 1000
</parameter_description>
</parameter>
</parameters>
@@ -13985,82 +16769,79 @@
<return></return>
</function>
-<function name="clutter_clone_texture_new">
+<function name="clutter_stage_ensure_viewport">
<description>
-Creates an efficient 'clone' of a pre-existing texture with which it
-shares the underlying pixbuf data.
+Ensures that the GL viewport is updated with the current
+stage window size.
+
+This function will queue a redraw of @stage.
-You can use clutter_clone_texture_set_parent_texture() to change the
-cloned texture.
+This function should not be called by applications; it is used
+when embedding a #ClutterStage into a toolkit with another
+windowing system, like GTK+.
+Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture, or %NULL
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterCloneTexture
-</return>
+<return></return>
</function>
-<function name="clutter_color_subtract">
+<function name="clutter_behaviour_rotate_set_center">
<description>
-Subtracts @src2 from @src1 and saves the resulting
-color inside @dest. This function assumes that the components
-of @src1 are greater than the components of @src2; the result is,
-otherwise, undefined.
+Sets the center of rotation. The coordinates are relative to the plane
+normal to the rotation axis set with clutter_behaviour_rotate_set_axis().
-The alpha channel of @dest is set as the minimum value
-between the alpha channels of @src1 and @src2.
+Since: 0.4
</description>
<parameters>
-<parameter name="src1">
-<parameter_description> a #ClutterColor
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="src2">
-<parameter_description> a #ClutterColor
+<parameter name="x">
+<parameter_description> X axis center of rotation
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y axis center of rotation
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the result
+<parameter name="z">
+<parameter_description> Z axis center of rotation
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_effect_template_new">
+<function name="clutter_text_set_cursor_color">
<description>
-Creates a new #ClutterEffectTemplate, to be used with the effects API.
+Sets the color of the cursor of a #ClutterText actor.
-A #ClutterEffectTemplate binds a timeline and an alpha function and can
-be used as a template for multiple calls of clutter_effect_fade(),
-clutter_effect_move() and clutter_effect_scale().
-
-This API is intended for simple animations involving a single actor;
-for more complex animations, you should see #ClutterBehaviour and the
-derived classes.
+If @color is %NULL, the cursor color will be the same as the
+text color.
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline for the template (will be cloned)
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="alpha_func">
-<parameter_description> An alpha func to use for the template.
+<parameter name="color">
+<parameter_description> the color of the cursor, or %NULL to unset it
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterEffectTemplate
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="ClutterShader">
@@ -14108,6 +16889,43 @@
<return></return>
</function>
+<function name="clutter_shader_get_cogl_vertex_shader">
+<description>
+Retrieves the underlying #CoglHandle for the vertex shader.
+
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #CoglHandle for the vertex shader, or %NULL
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_units_mm">
+<description>
+Converts a value in millimeters to #ClutterUnit&lt;!-- --&gt;s at
+the current DPI.
+
+
+</description>
+<parameters>
+<parameter name="mm">
+<parameter_description> millimeters to convert
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value in units
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_stage_new">
<description>
Creates a new, non-default stage. A non-default stage is a new
@@ -14125,12 +16943,83 @@
</description>
<parameters>
</parameters>
-<return> a new stage, or %NULL if the default backend does
-not support multiple stages. Use clutter_actor_destroy() to
-programmatically close the returned stage.
-
-Since: 0.8
-</return>
+<return> a new stage, or %NULL if the default backend does
+not support multiple stages. Use clutter_actor_destroy() to
+programmatically close the returned stage.
+
+Since: 0.8
+</return>
+</function>
+
+<function name="clutter_binding_pool_install_closure">
+<description>
+A #GClosure variant of clutter_binding_pool_install_action().
+
+Installs a new action inside a #ClutterBindingPool. The action
+is bound to @key_val and @modifiers.
+
+The same action name can be used for multiple @key_val, @modifiers
+pairs.
+
+When an action has been activated using clutter_binding_pool_activate()
+the passed @closure will be invoked.
+
+Actions can be blocked with clutter_binding_pool_block_action()
+and then unblocked using clutter_binding_pool_unblock_action().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask of modifiers
+</parameter_description>
+</parameter>
+<parameter name="closure">
+<parameter_description> a #GClosure
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_set_selection">
+<description>
+Selects the region of text between @start_pos and @end_pos.
+
+This function changes the position of the cursor to match
+ start_pos and the selection bound to match @end_pos.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="start_pos">
+<parameter_description> start of the selection, in characters
+</parameter_description>
+</parameter>
+<parameter name="end_pos">
+<parameter_description> end of the selection, in characters
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="ClutterRectangle">
@@ -14166,37 +17055,6 @@
<return></return>
</function>
-<function name="clutter_behaviour_bspline_new">
-<description>
-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 &gt;=1; any trailing points passed
-into this function are stored internally and used during any subsequent
-clutter_behaviour_bspline_append_* operations.
-
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="knots">
-<parameter_description> a list of #ClutterKnots representing individual control points
-</parameter_description>
-</parameter>
-<parameter name="n_knots">
-<parameter_description> the number of control points
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #ClutterBehaviour
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_actor_transform_stage_point">
<description>
This function translates screen coordinates (@x, @y) to
@@ -14222,20 +17080,20 @@
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> x screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> (in): x screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> y screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> (in): y screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
<parameter name="x_out">
-<parameter_description> return location for the unprojected x coordinance, in
+<parameter_description> (out): return location for the unprojected x coordinance, in
#ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
<parameter name="y_out">
-<parameter_description> return location for the unprojected y coordinance, in
+<parameter_description> (out): return location for the unprojected y coordinance, in
#ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
@@ -14288,14 +17146,43 @@
</parameter_description>
</parameter>
</parameters>
-<return> the #ClutterChildMeta for the @actor child of @container
-or %NULL if the specifiec actor does not exist or the container is not
-configured to provide #ClutterChildMeta&lt;!-- --&gt;s
+<return> (transfer none): the #ClutterChildMeta for the @actor child
+of @container or %NULL if the specifiec actor does not exist or the
+container is not configured to provide #ClutterChildMeta&lt;!-- --&gt;s
Since: 0.8
</return>
</function>
+<function name="clutter_interval_new_with_values">
+<description>
+Creates a new #ClutterInterval of type @gtype, between @initial
+and @final.
+
+This function is useful for language bindings.
+
+
+</description>
+<parameters>
+<parameter name="gtype">
+<parameter_description> the type of the values in the interval
+</parameter_description>
+</parameter>
+<parameter name="initial">
+<parameter_description> a #GValue holding the initial value of the interval
+</parameter_description>
+</parameter>
+<parameter name="final">
+<parameter_description> a #GValue holding the final value of the interval
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterInterval
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_actor_set_positionu">
<description>
Sets the actor's position in #ClutterUnit&lt;!-- --&gt;s relative to any
@@ -14372,6 +17259,7 @@
<function name="clutter_actor_set_x">
<description>
Sets the actor's X coordinate, relative to its parent, in pixels.
+
Overrides any layout manager and forces a fixed position for
the actor.
@@ -14393,7 +17281,8 @@
<function name="clutter_actor_set_y">
<description>
-Sets the actor's Y coordinate, relative to its parent, in pixels.
+Sets the actor's Y coordinate, relative to its parent, in pixels.#
+
Overrides any layout manager and forces a fixed position for
the actor.
@@ -14440,21 +17329,45 @@
</return>
</function>
-<function name="ClutterEntry">
+<function name="clutter_alpha_register_closure">
<description>
-The ::activate signal is emitted each time the entry is 'activated'
-by the user, normally by pressing the 'Enter' key.
+#GClosure variant of clutter_alpha_register_func().
+
+Registers a global alpha function and returns its logical id
+to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
+
+The logical id is always greater than %CLUTTER_ANIMATION_LAST.
+
+
+</description>
+<parameters>
+<parameter name="closure">
+<parameter_description> a #GClosure
+</parameter_description>
+</parameter>
+</parameters>
+<return> the logical id of the alpha function
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_binding_pool_find">
+<description>
+Finds the #ClutterBindingPool with @name.
-Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> the actor which received the event
+<parameter name="name">
+<parameter_description> the name of the binding pool to find
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a pointer to the #ClutterBindingPool, or %NULL
+
+Since: 1.0
+</return>
</function>
<function name="clutter_model_get_n_columns">
@@ -14487,111 +17400,121 @@
</parameter_description>
</parameter>
</parameters>
-<return> the #JsonArray
+<return> (transfer none): the #JsonArray
</return>
</function>
-<function name="clutter_model_iter_is_last">
+<function name="ClutterAnimation">
<description>
-Gets whether the iterator is at the end of the model to which it
-belongs.
+The #ClutterAlpha used by the animation.
+Since: 1.0
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
-</parameter_description>
-</parameter>
</parameters>
-<return> #TRUE if @iter is the last iter in the filtered model.
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_label_set_color">
+<function name="ClutterAniamtion">
<description>
-Sets the color of @label.
+The ::completed signal is emitted once the animation has
+been completed.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> a #ClutterColor
+<parameter name="animation">
+<parameter_description> the animation that emitted the signal
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_get_scalex">
+<function name="clutter_score_start">
<description>
-Fixed point version of clutter_actor_get_scale().
-
-Retrieves the scale factors of an actor.
+Starts the score.
-Since: 0.2
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="scale_x">
-<parameter_description> Location to store horizonal scale factor, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="scale_y">
-<parameter_description> Location to store vertical scale factor, or %NULL.
+<parameter name="score">
+<parameter_description> A #ClutterScore
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_node_set_string">
+<function name="clutter_stage_read_pixels">
<description>
-Sets @value as the string content of the @node, replacing any existing
-content.
+Makes a screenshot of the stage in RGBA 8bit data, returns a
+linear buffer with @width * 4 as rowstride.
+
+The alpha data contained in the returned buffer is driver-dependent,
+and not guaranteed to hold any sensible value.
+
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="stage">
+<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a string value
+<parameter name="x">
+<parameter_description> x coordinate of the first pixel that is read from stage
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y coordinate of the first pixel that is read from stage
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width dimention of pixels to be read, or -1 for the
+entire stage width
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height dimention of pixels to be read, or -1 for the
+entire stage height
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a pointer to newly allocated memory with the buffer
+or %NULL if the read failed. Use g_free() on the returned data
+to release the resources it has allocated.
+</return>
</function>
-<function name="clutter_actor_set_scalex">
+<function name="cogl_pango_render_layout">
<description>
-Fixed point version of clutter_actor_set_scale().
+Renders @layout.
-Scales an actor with the given factors. The scaling is always
-relative to the anchor point.
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="layout">
+<parameter_description> a #PangoLayout
</parameter_description>
</parameter>
-<parameter name="scale_x">
-<parameter_description> #ClutterFixed factor to scale actor by horizontally.
+<parameter name="x">
+<parameter_description> X coordinate to render the layout at
</parameter_description>
</parameter>
-<parameter name="scale_y">
-<parameter_description> #ClutterFixed factor to scale actor by vertically.
+<parameter name="y">
+<parameter_description> Y coordinate to render the layout at
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the layout
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to the renderer
</parameter_description>
</parameter>
</parameters>
@@ -14600,24 +17523,23 @@
<function name="clutter_color_add">
<description>
-Adds @src2 to @src1 and saves the resulting color
-inside @dest.
+Adds @a to @b and saves the resulting color inside @result.
-The alpha channel of @dest is as the maximum value
-between the alpha channels of @src1 and @src2.
+The alpha channel of @result is set as as the maximum value
+between the alpha channels of @a and @b.
</description>
<parameters>
-<parameter name="src1">
+<parameter name="a">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="src2">
+<parameter name="b">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the result
+<parameter name="result">
+<parameter_description> (out): return location for the result
</parameter_description>
</parameter>
</parameters>
@@ -14646,8 +17568,14 @@
<function name="clutter_x11_set_display">
<description>
-Sets the display connection clutter should use; must be called
-before clutter_init().
+Sets the display connection Clutter should use; must be called
+before clutter_init(), clutter_init_with_args() or other functions
+pertaining Clutter's initialization process.
+
+If you are parsing the command line arguments by retrieving Clutter's
+#GOptionGroup with clutter_get_option_group() and calling
+g_option_context_parse() yourself, you should also call
+clutter_x11_set_display() before g_option_context_parse().
Since: 0.8
@@ -14664,7 +17592,9 @@
<function name="clutter_alpha_new_full">
<description>
Creates a new #ClutterAlpha instance and sets the timeline
-and alpha function.
+and animation mode.
+
+See also clutter_alpha_set_timeline() and clutter_alpha_set_mode().
</description>
@@ -14673,40 +17603,55 @@
<parameter_description> #ClutterTimeline timeline
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> #ClutterAlphaFunc alpha function
+<parameter name="mode">
+<parameter_description> animation mode
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to be passed to the alpha function
+</parameters>
+<return> the newly created #ClutterAlpha
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_texture_get_base_size">
+<description>
+Gets the size in pixels of the untransformed underlying texture pixbuf data.
+
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="destroy">
-<parameter_description> notify to be called when removing the alpha function
+<parameter name="width">
+<parameter_description> Pointer to gint to be populated with width value if non NULL.
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Pointer to gint to be populated with height value if non NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterAlpha
-
-Since: 0.2
-</return>
+<return></return>
</function>
-<function name="clutter_stage_get_resolutionx">
+<function name="clutter_text_get_selectable">
<description>
-Fixed point version of clutter_stage_get_resolution().
+Retrieves whether a #ClutterText is selectable or not.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> the #ClutterStage
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the resolution of the stage
+<return> %TRUE if the actor is selectable
-Since: 0.6
+Since: 1.0
</return>
</function>
@@ -14773,8 +17718,8 @@
</parameter_description>
</parameter>
</parameters>
-<return> a list of actors. You should free the returned list
-with g_slist_free() when finished using it.
+<return> (transfer container) (element-type ClutterActor): a list of actors.
+You should free the returned list with g_slist_free() when finished using it.
Since: 0.2
</return>
@@ -14798,19 +17743,37 @@
</return>
</function>
+<function name="clutter_text_get_cursor_size">
+<description>
+Retrieves the size of the cursor of a #ClutterText actor.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> the size of the cursor, in pixels
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_color_lighten">
<description>
-Lightens @src by a fixed amount, and saves the changed
-color in @dest.
+Lightens @color by a fixed amount, and saves the changed color
+in @result.
</description>
<parameters>
-<parameter name="src">
+<parameter name="color">
<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the lighter color
+<parameter name="result">
+<parameter_description> (out): return location for the lighter color
</parameter_description>
</parameter>
</parameters>
@@ -14833,27 +17796,21 @@
</return>
</function>
-<function name="clutter_qdivx">
+<function name="clutter_actor_get_stage">
<description>
+Retrieves the #ClutterStage where @actor is contained.
+
</description>
<parameters>
-<parameter name="op1">
-<parameter_description> #ClutterFixed
-</parameter_description>
-</parameter>
-<parameter name="op2">
-<parameter_description> #ClutterFixed
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterFixed.
+<return> (transfer none): the stage containing the actor, or %NULL
-Divides two fixed values using 64bit arithmetic; this provides
-significantly better precission than the #CLUTTER_FIXED_DIV macro,
-but at performance cost.
-
-Since: 0.4
+Since: 0.8
</return>
</function>
@@ -14875,23 +17832,28 @@
</return>
</function>
-<function name="clutter_effect_template_get_timeline_clone">
+<function name="clutter_binding_pool_unblock_action">
<description>
-Gets whether timelines should be cloned when creating a new
-effect or just referenced.
+Unblockes all the actions with name @action_name inside @pool.
+
+Unblocking an action does not cause the callback bound to it to
+be invoked in case clutter_binding_pool_activate() was called on
+an action previously blocked with clutter_binding_pool_block_action().
+Since: 1.0
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> an action name
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the templates timeline is to be cloned.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_group_new">
@@ -14906,89 +17868,55 @@
</return>
</function>
-<function name="ClutterX11TexturePixmap">
-<description>
-The ::hide signal is emitted to ask the texture to update its
-content from its source pixmap.
-
-Since: 0.8
-
-</description>
-<parameters>
-<parameter name="texture">
-<parameter_description> the object which received the signal
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_behaviour_path_clear">
-<description>
-Removes all knots from a path
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehvaiourPath
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_label_get_ellipsize">
+<function name="clutter_text_get_cursor_visible">
<description>
-Return value: #PangoEllipsizeMode
+Retrieves whether the cursor of a #ClutterText actor is visible.
+
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> #PangoEllipsizeMode
+<return> %TRUE if the cursor is visible
-Since: 0.2
+Since: 1.0
</return>
</function>
-<function name="clutter_behaviour_ellipse_get_width">
+<function name="ClutterX11TexturePixmap">
<description>
-Gets the width of the elliptical path.
+The ::hide signal is emitted to ask the texture to update its
+content from its source pixmap.
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="texture">
+<parameter_description> the object which received the signal
</parameter_description>
</parameter>
</parameters>
-<return> the width of the path
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_atani">
+<function name="clutter_score_remove_all">
<description>
-Fast fixed-point version of the arctangent function.
+Removes all the timelines inside @score.
+Since: 0.6
</description>
<parameters>
-<parameter name="x">
-<parameter_description> The tangent to calculate the angle for
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> The angle in radians represented as a #ClutterFixed
-for which the tangent is @x.
-</return>
+<return></return>
</function>
<function name="clutter_get_show_fps">
@@ -15029,14 +17957,39 @@
<return></return>
</function>
-<function name="CLUTTER_ALPHA_RAMP_DEC">
+<function name="clutter_binding_pool_override_closure">
<description>
-Convenience symbol for clutter_ramp_dec_func().
+A #GClosure variant of clutter_binding_pool_override_action().
-Since: 0.2
+Allows overriding the action for @key_val and @modifiers inside a
+#ClutterBindingPool. See clutter_binding_pool_install_closure().
+
+When an action has been activated using clutter_binding_pool_activate()
+the passed @callback will be invoked (with @data).
+
+Actions can be blocked with clutter_binding_pool_block_action()
+and then unblocked using clutter_binding_pool_unblock_action().
+
+Since: 1.0
</description>
<parameters>
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask of modifiers
+</parameter_description>
+</parameter>
+<parameter name="closure">
+<parameter_description> a #GClosure
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -15069,23 +18022,29 @@
</return>
</function>
-<function name="clutter_label_get_font_name">
+<function name="clutter_binding_pool_remove_action">
<description>
-Retrieves the font used by @label.
+Removes the action matching the given @key_val, @modifiers pair,
+if any exists.
+Since: 1.0
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> a key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> a bitmask for the modifiers
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the font name, in a format
-understandable by pango_font_description_from_string(). The
-string is owned by @label and should not be modified
-or freed.
-</return>
+<return></return>
</function>
<function name="clutter_container_remove_valist">
@@ -15173,38 +18132,39 @@
<return></return>
</function>
-<function name="clutter_shader_get_is_enabled">
+<function name="clutter_event_get_device_id">
<description>
-Checks whether @shader is enabled.
+Retrieves the events device id if set.
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="event">
+<parameter_description> a clutter event
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the shader is enabled.
-
-Since: 0.6
+<return> A unique identifier for the device or -1 if the event has
+no specific device set.
</return>
</function>
-<function name="clutter_actor_hide_all">
+<function name="clutter_shader_get_is_enabled">
<description>
-Calls clutter_actor_hide() on all child actors (if any).
+Checks whether @shader is enabled.
-Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the shader is enabled.
+
+Since: 0.6
+</return>
</function>
<function name="json_node_copy">
@@ -15224,305 +18184,394 @@
</return>
</function>
-<function name="clutter_frame_source_add">
+<function name="clutter_stage_hide_cursor">
<description>
-Simple wrapper around clutter_frame_source_add_full().
+Makes the cursor invisible on the stage window
+Since: 0.4
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> the time between calls to the function, in milliseconds
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> function to call
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_rectangle_new">
+<description>
+Creates a new #ClutterActor with a rectangular shape.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #ClutterActor
+</return>
+</function>
+
+<function name="clutter_backend_set_double_click_time">
+<description>
+Sets the maximum time between two button press events, used to
+verify whether it's a double click event or not.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="msec">
+<parameter_description> milliseconds between two button press events
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
+<return></return>
+</function>
-Since: 0.8
+<function name="json_node_get_parent">
+<description>
+Retrieves the parent #JsonNode of @node.
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the parent node, or %NULL if @node is the root node
</return>
</function>
-<function name="clutter_pow2x">
+<function name="clutter_knot_free">
<description>
-Calculates 2 to x power.
-
-This function is around 11 times faster on x86, and around 22 times faster
-on fpu-less arm than libc pow(2, x).
+Frees the memory of an allocated knot.
+Since: 0.2
</description>
<parameters>
-<parameter name="x">
-<parameter_description> exponent
+<parameter name="knot">
+<parameter_description> a #ClutterKnot
</parameter_description>
</parameter>
</parameters>
-<return> 2 in x power.
+<return></return>
+</function>
-Since: 0.4
+<function name="clutter_get_option_group">
+<description>
+Return value: (transfer full): a #GOptionGroup for the commandline arguments
+
+</description>
+<parameters>
+</parameters>
+<return> (transfer full): a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+Since: 0.2
</return>
</function>
-<function name="clutter_actor_get_abs_allocation_vertices">
+<function name="clutter_media_get_buffer_fill">
<description>
-Calculates the transformed screen coordinates of the four corners of
-the actor; the returned vertices relate to the #ClutterActorBox
-coordinates as follows:
-&lt;itemizedlist&gt;
-&lt;listitem&gt;&lt;para&gt;v[0] contains (x1, y1)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[1] contains (x2, y1)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[2] contains (x1, y2)&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;v[3] contains (x2, y2)&lt;/para&gt;&lt;/listitem&gt;
-&lt;/itemizedlist&gt;
+Retrieves the amount of the stream that is buffered.
-Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="verts">
-<parameter_description> Pointer to a location of an array of 4 #ClutterVertex where to
-store the result.
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the fill level, between 0.0 and 1.0
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_entry_set_cursor_position">
+<function name="clutter_behaviour_path_get_path">
<description>
-Sets the position of the cursor. The @position must be less than or
-equal to the number of characters in the entry. A value of -1 indicates
-that the position should be set after the last character in the entry.
-Note that this position is in characters, not in bytes.
+Get the current path of the behaviour
-Since: 0.6
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="pathb">
+<parameter_description> a #ClutterBehaviourPath instance
</parameter_description>
</parameter>
-<parameter name="position">
-<parameter_description> the position of the cursor.
+</parameters>
+<return> (transfer none): the path
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_animation_get_mode">
+<description>
+Retrieves the animation mode of @animation, as set by
+clutter_animation_set_mode().
+
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the mode for the animation
+
+Since: 1.0
+</return>
</function>
-<function name="clutter_knot_free">
+<function name="clutter_actor_hide_all">
<description>
-Frees the memory of an allocated knot.
+Calls clutter_actor_hide() on all child actors (if any).
Since: 0.2
</description>
<parameters>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_rectangle_new">
+<function name="clutter_value_set_unit">
<description>
-Creates a new #ClutterActor with a rectangular shape.
+Sets @value to @units
+Since: 0.8
</description>
<parameters>
+<parameter name="value">
+<parameter_description> a #GValue initialized to #CLUTTER_TYPE_UNIT
+</parameter_description>
+</parameter>
+<parameter name="units">
+<parameter_description> the units to set
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #ClutterActor
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_bspline_adjust">
+<function name="clutter_path_add_rel_line_to">
<description>
-Change the coordinaces of control point at index to those represented by
-the knot.
+Same as clutter_path_add_line_to() except the coordinates are
+relative to the previous node.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> an index of control point to ajdust
+<parameter name="x">
+<parameter_description> the x coordinate
</parameter_description>
</parameter>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot with new coordinances for the control point.
+<parameter name="y">
+<parameter_description> the y coordinate
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_get_option_group">
+<function name="clutter_model_get_column_name">
<description>
-Return value: a GOptionGroup for the commandline arguments
+Retrieves the name of the @column
+
</description>
<parameters>
+<parameter name="model">
+<parameter_description> #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column number
+</parameter_description>
+</parameter>
</parameters>
-<return> a GOptionGroup for the commandline arguments
-recognized by Clutter
+<return> the name of the column. The model holds the returned
+string, and it should not be modified or freed
-Since: 0.2
+Since: 0.6
</return>
</function>
-<function name="clutter_script_get_type_from_name">
+<function name="clutter_text_set_text">
<description>
-Looks up a type by name, using the virtual function that
-#ClutterScript has for that purpose. This function should
-rarely be used.
+Sets the contents of a #ClutterText actor.
+Since: 1.0
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="type_name">
-<parameter_description> name of the type to look up
+<parameter name="text">
+<parameter_description> the text to set. Passing %NULL is the same as passing "" (the empty string)
</parameter_description>
</parameter>
</parameters>
-<return> the type for the requested type name, or
-%G_TYPE_INVALID if not corresponding type was found.
+<return></return>
+</function>
-Since: 0.6
+<function name="clutter_interval_get_value_type">
+<description>
+Retrieves the #GType of the values inside @interval.
+
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the value, or G_TYPE_INVALID
+
+Since: 1.0
</return>
</function>
-<function name="clutter_event_get_state">
+<function name="clutter_cairo_texture_create_region">
<description>
-Retrieves the modifier state of the event.
+Creates a new Cairo context that will updat the region defined
+by @x_offset, @y_offset, @width and @height.
+
+&lt;warning&gt;&lt;para&gt;Do not call this function within the paint virtual
+function or from a callback to the #ClutterActor::paint
+signal.&lt;/para&gt;&lt;/warning&gt;
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
+</parameter_description>
+</parameter>
+<parameter name="x_offset">
+<parameter_description> offset of the region on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_offset">
+<parameter_description> offset of the region on the Y axis
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> width of the region, or -1 for the full surface width
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> height of the region, or -1 for the full surface height
</parameter_description>
</parameter>
</parameters>
-<return> the modifier state parameter, or 0
+<return> a newly created Cairo context. Use cairo_destroy()
+to upload the contents of the context when done drawing
-Since: 0.4
+Since: 1.0
</return>
</function>
-<function name="clutter_value_set_unit">
+<function name="clutter_color_subtract">
<description>
-Sets @value to @units
+Subtracts @b from @a and saves the resulting color inside @result.
-Since: 0.8
+This function assumes that the components of @a are greater than the
+components of @b; the result is, otherwise, undefined.
+
+The alpha channel of @result is set as the minimum value
+between the alpha channels of @a and @b.
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to #CLUTTER_TYPE_UNIT
+<parameter name="a">
+<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="units">
-<parameter_description> the units to set
+<parameter name="b">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> (out): return location for the result
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_set_rotationu">
+<function name="clutter_color_new">
<description>
-Sets the rotation angle of @self around the given axis.
-
-This function is the units based variant of clutter_actor_set_rotation().
+Creates a new #ClutterColor with the given values.
-Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> the angle of rotation
+<parameter name="red">
+<parameter_description> red component of the color, between 0 and 255
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> X coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter name="green">
+<parameter_description> green component of the color, between 0 and 255
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter name="blue">
+<parameter_description> blue component of the color, between 0 and 255
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter name="alpha">
+<parameter_description> alpha component of the color, between 0 and 255
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly allocated color. Use clutter_color_free()
+when done
+
+Since: 0.8.4
+</return>
</function>
-<function name="clutter_actor_set_rotationx">
+<function name="clutter_text_set_selectable">
<description>
-Sets the rotation angle of @self around the given axis.
+Sets whether a #ClutterText actor should be selectable.
-This function is the fixed point variant of clutter_actor_set_rotation().
+A selectable #ClutterText will allow selecting its contents using
+the pointer or the keyboard.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> the angle of rotation
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X coordinate of the rotation center
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate of the rotation center
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z coordinate of the rotation center
+<parameter name="selectable">
+<parameter_description> whether the #ClutterText actor should be selectable
</parameter_description>
</parameter>
</parameters>
@@ -15554,6 +18603,35 @@
<return></return>
</function>
+<function name="clutter_text_set_cursor_visible">
+<description>
+Sets whether the cursor of a #ClutterText actor should be
+visible or not.
+
+The color of the cursor will be the same as the text color
+unless clutter_text_set_cursor_color() has been called.
+
+The size of the cursor can be set using clutter_text_set_cursor_size().
+
+The position of the cursor can be changed programmatically using
+clutter_text_set_cursor_position().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="cursor_visible">
+<parameter_description> whether the cursor should be visible
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_scale_get_boundsx">
<description>
Fixed point version of clutter_behaviour_scale_get_bounds().
@@ -15609,48 +18687,26 @@
<return></return>
</function>
-<function name="clutter_square_func">
+<function name="clutter_grab_keyboard">
<description>
-Convenience alpha function for a square wave. You can use this
-function as the alpha function for clutter_alpha_set_func().
-
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="dummy">
-<parameter_description> unused argument
-</parameter_description>
-</parameter>
-</parameters>
-<return> an alpha value
+Grabs keyboard events, after the grab is done keyboard
+events (#ClutterActor::key-press-event and #ClutterActor::key-release-event)
+are delivered to this actor directly. The source set in the event will be
+the actor that would have received the event if the keyboard grab was not
+in effect.
-Since: 0.4
-</return>
-</function>
+Like pointer grabs, keyboard grabs should only be used as a last
+resource.
-<function name="clutter_behaviour_ellipse_set_angle_tilt">
-<description>
-Sets the angle at which the ellipse should be tilted around it's center.
+See also clutter_stage_set_key_focus() and clutter_actor_grab_key_focus()
+to perform a "soft" key grab and assign key focus to a specific actor.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> a #ClutterRotateAxis
-</parameter_description>
-</parameter>
-<parameter name="angle_tilt">
-<parameter_description> tilt of the elipse around the center in the given axis in
-degrees.
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
@@ -15676,57 +18732,37 @@
<return></return>
</function>
-<function name="clutter_model_appendv">
+<function name="clutter_texture_set_from_file">
<description>
-Creates and appends a new row to the #ClutterModel, setting the row
-values for the given @columns upon creation.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="n_columns">
-<parameter_description> the number of columns and values
-</parameter_description>
-</parameter>
-<parameter name="columns">
-<parameter_description> a vector with the columns to set
-</parameter_description>
-</parameter>
-<parameter name="values">
-<parameter_description> a vector with the values
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Sets the #ClutterTexture image data from an image file. In case of
+failure, %FALSE is returned and @error is set.
-<function name="clutter_actor_get_anchor_pointu">
-<description>
-Gets the current anchor point of the @actor in #ClutterUnit&lt;!-- --&gt;s.
+If #ClutterTexture:load-async is set to %TRUE, this function
+will return as soon as possible, and the actual image loading
+from disk will be performed asynchronously. #ClutterTexture::load-finished
+will be emitted when the image has been loaded or if an error
+occurred.
-Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="anchor_x">
-<parameter_description> return location for the X coordinace of the anchor point
+<parameter name="filename">
+<parameter_description> The filename of the image in GLib file name encoding
</parameter_description>
</parameter>
-<parameter name="anchor_y">
-<parameter_description> return location for the X coordinace of the anchor point
+<parameter name="error">
+<parameter_description> Return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the image was successfully loaded and set
+
+Since: 0.8
+</return>
</function>
<function name="clutter_actor_get_preferred_width">
@@ -15755,11 +18791,11 @@
</parameter_description>
</parameter>
<parameter name="min_width_p">
-<parameter_description> return location for min width, or %NULL
+<parameter_description> (out): return location for minimum width, or %NULL
</parameter_description>
</parameter>
<parameter name="natural_width_p">
-<parameter_description> return location for min width, or %NULL
+<parameter_description> (out): return location for the natural width, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -15804,94 +18840,91 @@
<return></return>
</function>
-<function name="clutter_texture_new_from_actor">
+<function name="clutter_animation_get_object">
<description>
-Creates a new #ClutterTexture object with its source a prexisting
-actor (and associated children). The textures content will contain
-'live' redirected output of the actors scene.
+Retrieves the #GObject attached to @animation.
-Note this function is intented as a utility call for uniformly applying
-shaders to groups and other potential visual effects. It requires that
-the %CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend
-and the target system.
-Some tips on usage:
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): a #GObject
-&lt;itemizedlist&gt;
-&lt;listitem&gt;
-&lt;para&gt;The source actor must be made visible (i.e by calling
-#clutter_actor_show). The source actor does not however have to
-have a parent.&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;listitem&gt;
-&lt;para&gt;Avoid reparenting the source with the created texture.&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;listitem&gt;
-&lt;para&gt;A group can be padded with a transparent rectangle as to
-provide a border to contents for shader output (blurring text
-for example).&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;listitem&gt;
-&lt;para&gt;The texture will automatically resize to contain a further
-transformed source. However, this involves overhead and can be
-avoided by placing the source actor in a bounding group
-sized large enough to contain any child tranformations.&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;listitem&gt;
-&lt;para&gt;Uploading pixel data to the texture (e.g by using
-clutter_actor_set_from_file()) will destroy the offscreen texture data
-and end redirection.&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;listitem&gt;
-&lt;para&gt;cogl_texture_get_data() with the handle returned by
-clutter_texture_get_cogl_texture() can be used to read the
-offscreen texture pixels into a pixbuf.&lt;/para&gt;
-&lt;/listitem&gt;
-&lt;/itemizedlist&gt;
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_actor_get_opacity">
+<description>
+Retrieves the opacity value of an actor, as set by
+clutter_actor_set_opacity().
+
+For retrieving the absolute opacity of the actor inside a paint
+virtual function, see clutter_actor_get_paint_opacity().
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> A source #ClutterActor
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #ClutterTexture object, or %NULL on failure.
-
-Since: 0.6
+<return> the opacity of the actor
</return>
</function>
-<function name="clutter_behaviour_get_alpha">
+<function name="clutter_actor_get_pango_context">
<description>
-Retrieves the #ClutterAlpha object bound to @behave.
+Retrieves the #PangoContext for @self. The actor's #PangoContext
+is already configured using the appropriate font map, resolution
+and font options.
+
+Unlike clutter_actor_create_pango_context(), this context is owend
+by the #ClutterActor and it will be updated each time the options
+stored by the #ClutterBackend change.
+
+You can use the returned #PangoContext to create a #PangoLayout
+and render text using cogl_pango_render_layout() to reuse the
+glyphs cache also used by Clutter.
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterAlpha object, or %NULL if no alpha
-object has been bound to this behaviour.
+<return> (transfer none): the #PangoContext for a #ClutterActor.
+The returned #PangoContext is owned by the actor and should not be
+unreferenced by the application code
-Since: 0.2
+Since: 1.0
</return>
</function>
-<function name="CLUTTER_ALPHA_EXP_INC">
+<function name="clutter_behaviour_get_alpha">
<description>
-Convenience symbol for clutter_exp_inc_func()
+Retrieves the #ClutterAlpha object bound to @behave.
-Since: 0.4
</description>
<parameters>
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #ClutterAlpha object, or %NULL if no alpha
+object has been bound to this behaviour.
+
+Since: 0.2
+</return>
</function>
</root>
Modified: cluttermm/trunk/clutter/src/clutter_enums.defs
==============================================================================
--- cluttermm/trunk/clutter/src/clutter_enums.defs (original)
+++ cluttermm/trunk/clutter/src/clutter_enums.defs Sat Mar 28 15:18:02 2009
@@ -1,4 +1,4 @@
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-actor.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-actor.h
(define-flags-extended ActorFlags
(in-module "Clutter")
@@ -10,31 +10,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-debug.h
-
-(define-flags-extended DebugFlag
- (in-module "Clutter")
- (c-name "ClutterDebugFlag")
- (values
- '("misc" "CLUTTER_DEBUG_MISC" "1 << 0")
- '("actor" "CLUTTER_DEBUG_ACTOR" "1 << 1")
- '("texture" "CLUTTER_DEBUG_TEXTURE" "1 << 2")
- '("event" "CLUTTER_DEBUG_EVENT" "1 << 3")
- '("paint" "CLUTTER_DEBUG_PAINT" "1 << 4")
- '("gl" "CLUTTER_DEBUG_GL" "1 << 5")
- '("alpha" "CLUTTER_DEBUG_ALPHA" "1 << 6")
- '("behaviour" "CLUTTER_DEBUG_BEHAVIOUR" "1 << 7")
- '("pango" "CLUTTER_DEBUG_PANGO" "1 << 8")
- '("backend" "CLUTTER_DEBUG_BACKEND" "1 << 9")
- '("scheduler" "CLUTTER_DEBUG_SCHEDULER" "1 << 10")
- '("script" "CLUTTER_DEBUG_SCRIPT" "1 << 11")
- '("shader" "CLUTTER_DEBUG_SHADER" "1 << 12")
- '("multistage" "CLUTTER_DEBUG_MULTISTAGE" "1 << 13")
- '("animation" "CLUTTER_DEBUG_ANIMATION" "1 << 14")
- )
-)
-
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-event.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-event.h
(define-flags-extended ModifierType
(in-module "Clutter")
@@ -110,7 +86,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-feature.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-feature.h
(define-flags-extended FeatureFlags
(in-module "Clutter")
@@ -129,7 +105,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-main.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-main.h
(define-enum-extended InitError
(in-module "Clutter")
@@ -143,7 +119,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-path.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-path.h
(define-enum-extended PathNodeType
(in-module "Clutter")
@@ -159,33 +135,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-private.h
-
-(define-flags-extended PrivateFlags
- (in-module "Clutter")
- (c-name "ClutterPrivateFlags")
- (values
- '("actor-unused-flag" "CLUTTER_ACTOR_UNUSED_FLAG" "0")
- '("actor-in-destruction" "CLUTTER_ACTOR_IN_DESTRUCTION" "1 << 0")
- '("actor-is-toplevel" "CLUTTER_ACTOR_IS_TOPLEVEL" "1 << 1")
- '("actor-in-reparent" "CLUTTER_ACTOR_IN_REPARENT" "1 << 2")
- '("actor-in-paint" "CLUTTER_ACTOR_IN_PAINT" "1 << 4")
- '("actor-in-relayout" "CLUTTER_ACTOR_IN_RELAYOUT" "1 << 5")
- '("texture-in-clone-paint" "CLUTTER_TEXTURE_IN_CLONE_PAINT" "1 << 6")
- )
-)
-
-(define-enum-extended PickMode
- (in-module "Clutter")
- (c-name "ClutterPickMode")
- (values
- '("none" "CLUTTER_PICK_NONE" "0")
- '("reactive" "CLUTTER_PICK_REACTIVE" "1")
- '("all" "CLUTTER_PICK_ALL" "2")
- )
-)
-
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-script.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-script.h
(define-enum-extended ScriptError
(in-module "Clutter")
@@ -197,7 +147,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-shader.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-shader.h
(define-enum-extended ShaderError
(in-module "Clutter")
@@ -209,7 +159,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-texture.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-texture.h
(define-enum-extended TextureError
(in-module "Clutter")
@@ -241,7 +191,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-timeline.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-timeline.h
(define-enum-extended TimelineDirection
(in-module "Clutter")
@@ -252,7 +202,7 @@
)
)
-;; From /home/murrayc/svn/gnome220/branches/clutter/clutter/clutter-types.h
+;; From /usr/local/include/clutter-0.9/clutter/clutter-types.h
(define-enum-extended Gravity
(in-module "Clutter")
Modified: cluttermm/trunk/clutter/src/clutter_methods.defs
==============================================================================
--- cluttermm/trunk/clutter/src/clutter_methods.defs (original)
+++ cluttermm/trunk/clutter/src/clutter_methods.defs Sat Mar 28 15:18:02 2009
@@ -1836,10 +1836,20 @@
(return-type "ClutterAlpha*")
)
-(define-method bind_property
+(define-method bind
(of-object "ClutterAnimation")
- (c-name "clutter_animation_bind_property")
- (return-type "none")
+ (c-name "clutter_animation_bind")
+ (return-type "ClutterAnimation*")
+ (parameters
+ '("const-gchar*" "property_name")
+ '("const-GValue*" "final")
+ )
+)
+
+(define-method bind_interval
+ (of-object "ClutterAnimation")
+ (c-name "clutter_animation_bind_interval")
+ (return-type "ClutterAnimation*")
(parameters
'("const-gchar*" "property_name")
'("ClutterInterval*" "interval")
@@ -1855,9 +1865,9 @@
)
)
-(define-method update_property
+(define-method update_interval
(of-object "ClutterAnimation")
- (c-name "clutter_animation_update_property")
+ (c-name "clutter_animation_update_interval")
(return-type "none")
(parameters
'("const-gchar*" "property_name")
@@ -1883,6 +1893,12 @@
)
)
+(define-method completed
+ (of-object "ClutterAnimation")
+ (c-name "clutter_animation_completed")
+ (return-type "none")
+)
+
(define-method animate
(of-object "ClutterActor")
(c-name "clutter_actor_animate")
@@ -1956,6 +1972,12 @@
)
)
+(define-method get_animation
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_get_animation")
+ (return-type "ClutterAnimation*")
+)
+
;; From clutter-backend.h
@@ -3659,7 +3681,7 @@
(c-name "clutter_frame_source_add")
(return-type "guint")
(parameters
- '("guint" "interval")
+ '("guint" "fps")
'("GSourceFunc" "func")
'("gpointer" "data")
)
@@ -3670,7 +3692,7 @@
(return-type "guint")
(parameters
'("gint" "priority")
- '("guint" "interval")
+ '("guint" "fps")
'("GSourceFunc" "func")
'("gpointer" "data")
'("GDestroyNotify" "notify")
@@ -4102,7 +4124,7 @@
(c-name "clutter_threads_add_frame_source")
(return-type "guint")
(parameters
- '("guint" "interval")
+ '("guint" "fps")
'("GSourceFunc" "func")
'("gpointer" "data")
)
@@ -4113,7 +4135,7 @@
(return-type "guint")
(parameters
'("gint" "priority")
- '("guint" "interval")
+ '("guint" "fps")
'("GSourceFunc" "func")
'("gpointer" "data")
'("GDestroyNotify" "notify")
@@ -6638,7 +6660,7 @@
(c-name "clutter_timeout_pool_add")
(return-type "guint")
(parameters
- '("guint" "interval")
+ '("guint" "fps")
'("GSourceFunc" "func")
'("gpointer" "data")
'("GDestroyNotify" "notify")
Modified: cluttermm/trunk/clutter/src/clutter_signals.defs
==============================================================================
--- cluttermm/trunk/clutter/src/clutter_signals.defs (original)
+++ cluttermm/trunk/clutter/src/clutter_signals.defs Sat Mar 28 15:18:02 2009
@@ -27,6 +27,15 @@
)
)
+(define-signal queue-redraw
+ (of-object "ClutterActor")
+ (return-type "void")
+ (when "last")
+ (parameters
+ '("ClutterActor*" "p0")
+ )
+)
+
(define-signal event
(of-object "ClutterActor")
(return-type "gboolean")
@@ -353,6 +362,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterActor")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterActor")
(prop-type "GParamUChar")
@@ -553,6 +571,68 @@
(construct-only #f)
)
+;; From ClutterAnimation
+
+(define-signal completed
+ (of-object "ClutterAnimation")
+ (return-type "void")
+ (when "last")
+)
+
+(define-property object
+ (of-object "ClutterAnimation")
+ (prop-type "GParamObject")
+ (docs "Object to which the animation applies")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property mode
+ (of-object "ClutterAnimation")
+ (prop-type "GParamULong")
+ (docs "The mode of the animation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property duration
+ (of-object "ClutterAnimation")
+ (prop-type "GParamUInt")
+ (docs "Duration of the animation, in milliseconds")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property loop
+ (of-object "ClutterAnimation")
+ (prop-type "GParamBoolean")
+ (docs "Whether the animation should loop")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property timeline
+ (of-object "ClutterAnimation")
+ (prop-type "GParamObject")
+ (docs "The timeline used by the animation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property alpha
+ (of-object "ClutterAnimation")
+ (prop-type "GParamObject")
+ (docs "The alpha used by the animation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
;; From ClutterBackend
(define-signal resolution-changed
@@ -619,7 +699,7 @@
(define-property width
(of-object "ClutterBehaviourEllipse")
(prop-type "GParamInt")
- (docs "Width of ellipse")
+ (docs "Width of the ellipse")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1087,6 +1167,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterCairoTexture")
(prop-type "GParamUChar")
@@ -1330,6 +1419,15 @@
(construct-only #f)
)
+(define-property cogl-material
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoxed")
+ (docs "The underlying COGL material handle used to draw this actor")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property filename
(of-object "ClutterCairoTexture")
(prop-type "GParamString")
@@ -1352,7 +1450,16 @@
(of-object "ClutterCairoTexture")
(prop-type "GParamBoolean")
(docs "Load files inside a thread to avoid blocking when loading images.")
- (readable #t)
+ (readable #f)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property load-data-async
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoolean")
+ (docs "Decode image data files inside a thread to reduce blocking when loading images.")
+ (readable #f)
(writable #t)
(construct-only #f)
)
@@ -1586,6 +1693,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterClone")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterClone")
(prop-type "GParamUChar")
@@ -1800,8 +1916,6 @@
;; From ClutterEvent
-;; From ClutterFixed
-
;; From ClutterGroup
(define-signal add
@@ -2011,6 +2125,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterGroup")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterGroup")
(prop-type "GParamUChar")
@@ -2182,6 +2305,17 @@
(construct-only #f)
)
+;; From ClutterInterval
+
+(define-property value-type
+ (of-object "ClutterInterval")
+ (prop-type "GParamGType")
+ (docs "The type of the values in the interval")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
;; From ClutterMedia
(define-signal eos
@@ -2199,28 +2333,28 @@
)
)
-(define-property uri
+(define-property playing
(of-object "ClutterMedia")
- (prop-type "GParamString")
- (docs "URI of a media file")
+ (prop-type "GParamBoolean")
+ (docs "Wheter the actor is playing")
(readable #t)
(writable #t)
(construct-only #f)
)
-(define-property can-seek
+(define-property buffer-fill
(of-object "ClutterMedia")
- (prop-type "GParamBoolean")
- (docs "Whether the current stream is seekable")
+ (prop-type "GParamDouble")
+ (docs "The fill level of the buffer")
(readable #t)
(writable #f)
(construct-only #f)
)
-(define-property playing
+(define-property audio-volume
(of-object "ClutterMedia")
- (prop-type "GParamBoolean")
- (docs "Wheter the actor is playing")
+ (prop-type "GParamDouble")
+ (docs "The volume of the audio")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2235,10 +2369,10 @@
(construct-only #f)
)
-(define-property audio-volume
+(define-property uri
(of-object "ClutterMedia")
- (prop-type "GParamDouble")
- (docs "The volume of the audio")
+ (prop-type "GParamString")
+ (docs "URI of a media file")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2246,17 +2380,17 @@
(define-property duration
(of-object "ClutterMedia")
- (prop-type "GParamUInt")
+ (prop-type "GParamDouble")
(docs "The duration of the stream, in seconds")
(readable #t)
(writable #f)
(construct-only #f)
)
-(define-property buffer-fill
+(define-property can-seek
(of-object "ClutterMedia")
- (prop-type "GParamDouble")
- (docs "The fill level of the buffer")
+ (prop-type "GParamBoolean")
+ (docs "Whether the current stream is seekable")
(readable #t)
(writable #f)
(construct-only #f)
@@ -2473,6 +2607,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterRectangle")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterRectangle")
(prop-type "GParamUChar")
@@ -2773,12 +2916,6 @@
(when "last")
)
-(define-signal queue-redraw
- (of-object "ClutterStage")
- (return-type "void")
- (when "last")
-)
-
(define-property name
(of-object "ClutterStage")
(prop-type "GParamString")
@@ -2968,6 +3105,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterStage")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterStage")
(prop-type "GParamUChar")
@@ -3211,6 +3357,15 @@
(construct-only #f)
)
+(define-property fog
+ (of-object "ClutterStage")
+ (prop-type "GParamBoxed")
+ (docs "Settings for the depth cueing")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
;; From ClutterText
(define-signal activate
@@ -3424,6 +3579,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterText")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterText")
(prop-type "GParamUChar")
@@ -4009,6 +4173,15 @@
(construct-only #f)
)
+(define-property clip-to-allocation
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoolean")
+ (docs "Sets the clip region to track the actor's allocation")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property opacity
(of-object "ClutterTexture")
(prop-type "GParamUChar")
@@ -4252,6 +4425,15 @@
(construct-only #f)
)
+(define-property cogl-material
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoxed")
+ (docs "The underlying COGL material handle used to draw this actor")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property filename
(of-object "ClutterTexture")
(prop-type "GParamString")
@@ -4274,7 +4456,16 @@
(of-object "ClutterTexture")
(prop-type "GParamBoolean")
(docs "Load files inside a thread to avoid blocking when loading images.")
- (readable #t)
+ (readable #f)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property load-data-async
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoolean")
+ (docs "Decode image data files inside a thread to reduce blocking when loading images.")
+ (readable #f)
(writable #t)
(construct-only #f)
)
Added: cluttermm/trunk/clutter/src/interval.ccg
==============================================================================
--- (empty file)
+++ cluttermm/trunk/clutter/src/interval.ccg Sat Mar 28 15:18:02 2009
@@ -0,0 +1,46 @@
+/* Copyright (C) 2007 The cluttermm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free
+ * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include <clutter/clutter.h>
+
+namespace Clutter
+{
+
+Interval::Interval(GType type, const Glib::ValueBase& initial, const Glib::ValueBase& final)
+:
+ // Mark this class as non-derived to allow C++ vfuncs to be skipped.
+ Glib::ObjectBase(0),
+ Glib::Object(Glib::ConstructParams(interval_class_.init(), "value_type", type, static_cast<char*>(0)))
+{
+ _INITIALLY_UNOWNED_SINK
+ set_interval(initial, final);
+}
+
+void Interval::set_interval(const Glib::ValueBase& initial, const Glib::ValueBase& final)
+{
+ set_initial_value(initial);
+ set_final_value(final);
+}
+
+void Interval::get_interval(Glib::ValueBase& initial, Glib::ValueBase& final)
+{
+ get_initial_value(initial);
+ get_final_value(final);
+}
+
+} //namespace Clutter
+
Added: cluttermm/trunk/clutter/src/interval.hg
==============================================================================
--- (empty file)
+++ cluttermm/trunk/clutter/src/interval.hg Sat Mar 28 15:18:02 2009
@@ -0,0 +1,81 @@
+/* Copyright (C) 2009 The cluttermm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free
+ * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include <glibmm/object.h>
+#include <clutter/clutter.h>
+
+_DEFS(cluttermm,clutter)
+_PINCLUDE(glibmm/private/object_p.h)
+
+namespace Clutter
+{
+
+class Interval : public Glib::Object
+{
+
+ _CLASS_GOBJECT(Interval, ClutterInterval, CLUTTER_INTERVAL, Glib::Object, GObject)
+ _DERIVES_INITIALLY_UNOWNED()
+
+protected:
+ Interval(GType type, const Glib::ValueBase& initial, const Glib::ValueBase& final);
+
+public:
+
+ template <typename ValueType>
+ Glib::RefPtr<Interval> static create(const ValueType initial, const ValueType final);
+ template <typename ValueType>
+ Glib::RefPtr<Interval> static create_with_values(const Glib::Value<ValueType>& initial, const Glib::Value<ValueType>& final);
+
+ _WRAP_METHOD(Glib::RefPtr<Interval> clone() const, clutter_interval_clone)
+ _WRAP_METHOD(GType get_value_type() const, clutter_interval_get_value_type)
+ _WRAP_METHOD(void set_initial_value(const Glib::ValueBase& value), clutter_interval_set_initial_value)
+ _WRAP_METHOD(void get_initial_value(Glib::ValueBase& value) const, clutter_interval_get_initial_value)
+ _WRAP_METHOD(GValue* peek_initial_value(), clutter_interval_peek_initial_value)
+ _WRAP_METHOD(void set_final_value(const Glib::ValueBase& value), clutter_interval_set_final_value)
+ _WRAP_METHOD(void get_final_value(Glib::ValueBase& value) const, clutter_interval_get_final_value)
+ _WRAP_METHOD(GValue* peek_final_value(), clutter_interval_peek_final_value)
+
+ void set_interval(const Glib::ValueBase& initial, const Glib::ValueBase& final);
+ void get_interval(Glib::ValueBase& initial, Glib::ValueBase& final);
+
+ _WRAP_METHOD(bool compute_value(double factor, Glib::ValueBase& value) const, clutter_interval_compute_value)
+ _WRAP_METHOD(bool validate(GParamSpec *pspec) const, clutter_interval_validate)
+
+ _WRAP_PROPERTY("value-type", GType)
+
+ _IGNORE(clutter_interval_get_interval, clutter_interval_set_interval)
+};
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+template <typename ValueType>
+Glib::RefPtr<Interval> Interval::create(const ValueType initial, const ValueType final)
+{
+ Glib::Value<ValueType> initial_val, final_val;
+ initial_val.init(Glib::Value<ValueType>::value_type());
+ final_val.init(Glib::Value<ValueType>::value_type());
+ initial_val.set(initial);
+ final_val.set(final);
+ return create_with_values(initial_val, final_val);
+}
+
+template <typename ValueType>
+Glib::RefPtr<Interval> Interval::create_with_values(const Glib::Value<ValueType>& initial, const Glib::Value<ValueType>& final)
+{
+ return Glib::RefPtr<Interval>( new Interval(initial.value_type(), initial, final) );
+}
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+} // namespace Clutter
Modified: cluttermm/trunk/tests/Makefile.am
==============================================================================
--- cluttermm/trunk/tests/Makefile.am (original)
+++ cluttermm/trunk/tests/Makefile.am Sat Mar 28 15:18:02 2009
@@ -4,7 +4,8 @@
include $(top_srcdir)/examples/Makefile.am_fragment
-noinst_PROGRAMS = test-alpha-creation test-alpha-func
+noinst_PROGRAMS = test-alpha-creation test-alpha-func test-interval-creation
test_alpha_creation_SOURCES = test-alpha-creation.cc
test_alpha_func_SOURCES = test-alpha-func.cc
+test_interval_creation = test-interval-creation.cc
Added: cluttermm/trunk/tests/test-interval-creation.cc
==============================================================================
--- (empty file)
+++ cluttermm/trunk/tests/test-interval-creation.cc Sat Mar 28 15:18:02 2009
@@ -0,0 +1,45 @@
+#include <cluttermm.h>
+#include <iostream>
+
+int main(int argc, char** argv)
+{
+ // initialize the C++ wrapper types
+ Clutter::init(&argc, &argv);
+
+ std::cout << "Creating Clutter::Interval with (int) values: 10, 20" << std::endl;
+
+ Glib::RefPtr<Clutter::Interval> interval1 = Clutter::Interval::create(10, 20);
+ Glib::Value<int> initial1, final1, compute1;
+ initial1.init(initial1.value_type());
+ final1.init(final1.value_type());
+ compute1.init(compute1.value_type());
+
+ interval1->get_interval(initial1, final1);
+ std::cout << "Getting values from created interval: " << initial1.get() << ", " << final1.get() << std::endl;
+
+ interval1->compute_value(0.5, compute1);
+ std::cout << "Computing a value with factor = 0.5: " << compute1.get() << std::endl << std::endl;
+
+
+ Glib::Value<double> initial2, final2, compute2;
+ initial2.init(initial2.value_type());
+ final2.init(final2.value_type());
+ compute2.init(compute2.value_type());
+ initial2.set(10.35);
+ final2.set(20.73);
+
+ std::cout << "Creating Clutter::Interval with Glib::Value<double> values: " << initial2.get() << ", " << final2.get() << std::endl;
+
+ Glib::RefPtr<Clutter::Interval> interval2 = Clutter::Interval::create_with_values(initial2, final2);
+
+ initial2.reset();
+ final2.reset();
+
+ interval2->get_interval(initial2, final2);
+ std::cout << "Getting values from created interval: " << initial2.get() << ", " << final2.get() << std::endl;
+
+ interval2->compute_value(0.7, compute2);
+ std::cout << "Computing a value with factor = 0.7: " << compute2.get() << std::endl;
+
+ return 0;
+}
Modified: cluttermm/trunk/tools/extra_defs_gen/generate_defs_clutter.cc
==============================================================================
--- cluttermm/trunk/tools/extra_defs_gen/generate_defs_clutter.cc (original)
+++ cluttermm/trunk/tools/extra_defs_gen/generate_defs_clutter.cc Sat Mar 28 15:18:02 2009
@@ -26,6 +26,7 @@
std::cout
<< get_defs(CLUTTER_TYPE_ACTOR)
<< get_defs(CLUTTER_TYPE_ALPHA)
+ << get_defs(CLUTTER_TYPE_ANIMATION)
<< get_defs(CLUTTER_TYPE_BACKEND)
<< get_defs(CLUTTER_TYPE_BEHAVIOUR_DEPTH)
<< get_defs(CLUTTER_TYPE_BEHAVIOUR_ELLIPSE)
@@ -43,6 +44,7 @@
<< get_defs(CLUTTER_TYPE_EVENT)
// << get_defs(CLUTTER_TYPE_FIXED)
<< get_defs(CLUTTER_TYPE_GROUP)
+ << get_defs(CLUTTER_TYPE_INTERVAL)
// << get_defs(CLUTTER_TYPE_HBOX)
// << get_defs(CLUTTER_TYPE_LAYOUT)
<< get_defs(CLUTTER_TYPE_MEDIA)
Modified: cluttermm/trunk/tools/m4/convert_cluttermm.m4
==============================================================================
--- cluttermm/trunk/tools/m4/convert_cluttermm.m4 (original)
+++ cluttermm/trunk/tools/m4/convert_cluttermm.m4 Sat Mar 28 15:18:02 2009
@@ -18,6 +18,14 @@
_CONVERSION(`ClutterAlpha*',`Glib::RefPtr<Alpha>',`Glib::wrap($3)')
_CONVERSION(`ClutterAlpha*',`Glib::RefPtr<const Alpha>',`Glib::wrap($3)')
+_CONVERSION(`const Glib::RefPtr<Animation>&',`ClutterAnimation*',__CONVERT_REFPTR_TO_P)
+_CONVERSION(`ClutterAnimation*',`Glib::RefPtr<Animation>',`Glib::wrap($3)')
+_CONVERSION(`ClutterAnimation*',`Glib::RefPtr<const Animation>',`Glib::wrap($3)')
+
+_CONVERSION(`const Glib::RefPtr<Interval>&',`ClutterInterval*',__CONVERT_REFPTR_TO_P)
+_CONVERSION(`ClutterInterval*',`Glib::RefPtr<Interval>',`Glib::wrap($3)')
+_CONVERSION(`ClutterInterval*',`Glib::RefPtr<const Interval>',`Glib::wrap($3)')
+
_CONVERSION(`const Glib::RefPtr<Texture>&',`ClutterTexture*',__CONVERT_REFPTR_TO_P)
_CONVERSION(`ClutterTexture*',`Glib::RefPtr<Texture>',`Glib::wrap($3)')
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
