[cluttermm] Regenerated all defs and updated the API
- From: Siavash Safi <siavashs src gnome org>
- To: svn-commits-list gnome org
- Subject: [cluttermm] Regenerated all defs and updated the API
- Date: Fri, 15 May 2009 10:19:12 -0400 (EDT)
commit eeab2680a2cda1f2926e040183539acdff7bf92f
Author: Siavash Safi <siavash siavashs org>
Date: Fri May 15 18:48:36 2009 +0430
Regenerated all defs and updated the API
---
.gitignore | 107 +
ChangeLog | 13 +
clutter/src/animation.hg | 2 +-
clutter/src/cairo-texture.hg | 3 +
clutter/src/clutter_docs.xml | 4597 +++++++++++++++++++-------------------
clutter/src/clutter_methods.defs | 522 +++--
clutter/src/clutter_signals.defs | 68 +-
clutter/src/text.ccg | 7 +
clutter/src/text.hg | 37 +-
configure.in | 4 +-
10 files changed, 2808 insertions(+), 2552 deletions(-)
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..f17d56c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,107 @@
+# wildcard patterns
+*.o
+*.lo
+*.a
+*.la
+Makefile
+Makefile.in
+.deps/
+.libs/
+.stamps/
+# generated private headers
+*_p.h
+
+# /
+aclocal.m4
+INSTALL
+autom4te.cache/
+config.h
+config.log
+config.status
+configure
+libtool
+stamp-h1
+
+# clutter
+clutter/cluttermm-0.9.pc
+clutter/cluttermm/actor.cc
+clutter/cluttermm/actor.h
+clutter/cluttermm/alpha.cc
+clutter/cluttermm/alpha.h
+clutter/cluttermm/animation.cc
+clutter/cluttermm/animation.h
+clutter/cluttermm/behaviour-depth.cc
+clutter/cluttermm/behaviour-depth.h
+clutter/cluttermm/behaviour-ellipse.cc
+clutter/cluttermm/behaviour-ellipse.h
+clutter/cluttermm/behaviour-opacity.cc
+clutter/cluttermm/behaviour-opacity.h
+clutter/cluttermm/behaviour-path.cc
+clutter/cluttermm/behaviour-path.h
+clutter/cluttermm/behaviour-rotate.cc
+clutter/cluttermm/behaviour-rotate.h
+clutter/cluttermm/behaviour-scale.cc
+clutter/cluttermm/behaviour-scale.h
+clutter/cluttermm/behaviour.cc
+clutter/cluttermm/behaviour.h
+clutter/cluttermm/cairo-texture.cc
+clutter/cluttermm/cairo-texture.h
+clutter/cluttermm/childmeta.cc
+clutter/cluttermm/childmeta.h
+clutter/cluttermm/clone.cc
+clutter/cluttermm/clone.h
+clutter/cluttermm/color.cc
+clutter/cluttermm/color.h
+clutter/cluttermm/container.cc
+clutter/cluttermm/container.h
+clutter/cluttermm/group.cc
+clutter/cluttermm/group.h
+clutter/cluttermm/interval.cc
+clutter/cluttermm/interval.h
+clutter/cluttermm/media.cc
+clutter/cluttermm/media.h
+clutter/cluttermm/path.cc
+clutter/cluttermm/path.h
+clutter/cluttermm/rectangle.cc
+clutter/cluttermm/rectangle.h
+clutter/cluttermm/score.cc
+clutter/cluttermm/score.h
+clutter/cluttermm/script.cc
+clutter/cluttermm/script.h
+clutter/cluttermm/scriptable.cc
+clutter/cluttermm/scriptable.h
+clutter/cluttermm/shader.cc
+clutter/cluttermm/shader.h
+clutter/cluttermm/stage.cc
+clutter/cluttermm/stage.h
+clutter/cluttermm/text.cc
+clutter/cluttermm/text.h
+clutter/cluttermm/texture.cc
+clutter/cluttermm/texture.h
+clutter/cluttermm/timeline.cc
+clutter/cluttermm/timeline.h
+clutter/cluttermm/types.cc
+clutter/cluttermm/types.h
+clutter/cluttermm/wrap_init.cc
+clutter/cluttermmconfig.h
+
+# docs
+docs/reference/Doxyfile
+docs/reference/html/
+
+# examples
+examples/actors
+
+# scripts
+scripts/config.guess
+scripts/config.sub
+scripts/ltmain.sh
+
+# tests
+tests/test-alpha-creation
+tests/test-alpha-func
+tests/test-interval-creation
+
+# tools
+tools/extra_defs_gen/generate_extra_defs_clutter
+
diff --git a/ChangeLog b/ChangeLog
index e19c96e..dc3e924 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2009-05-15 Siavash Safi <siavash siavashs org>
+
+ * .gitignore:
+ * clutter/src/animation.hg: Do not use _DERIVES_INITIALLY_UNOWNED because of
+ the changes in the C API, Wrap started() signal
+ * clutter/src/cairo-texture.hg: Add clear() method
+ * clutter/src/clutter_docs.xml:
+ * clutter/src/clutter_methods.defs:
+ * clutter/src/clutter_signals.defs: Regenerate all defs
+ * clutter/src/text.ccg:
+ * clutter/src/text.hg: Wrap new methods and properties
+ * configure.in: Increase version and required clutter version to 0.9.3
+
2009-04-27 Siavash Safi <siavash siavashs org>
* clutter/src/actor.hg: Reverted overloaded methods for now since
diff --git a/clutter/src/animation.hg b/clutter/src/animation.hg
index 281b9d6..7d44971 100644
--- a/clutter/src/animation.hg
+++ b/clutter/src/animation.hg
@@ -32,7 +32,6 @@ class Animation : public Glib::Object
{
_CLASS_GOBJECT(Animation, ClutterAnimation, CLUTTER_ANIMATION, Glib::Object, GObject)
- _DERIVES_INITIALLY_UNOWNED()
protected:
_CTOR_DEFAULT()
@@ -61,6 +60,7 @@ public:
_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 started(), "started")
_WRAP_SIGNAL(void completed(), "completed")
};
diff --git a/clutter/src/cairo-texture.hg b/clutter/src/cairo-texture.hg
index 8d22a64..a77cffb 100644
--- a/clutter/src/cairo-texture.hg
+++ b/clutter/src/cairo-texture.hg
@@ -40,8 +40,11 @@ protected:
public:
_WRAP_CREATE(guint width, guint height)
+ _WRAP_METHOD(void clear(), clutter_cairo_texture_clear)
+
_WRAP_METHOD(void set_surface_size(guint width, guint height), clutter_cairo_texture_set_surface_size)
_WRAP_METHOD(void get_surface_size(guint& width, guint& height) const, clutter_cairo_texture_get_surface_size)
+
_WRAP_METHOD(Glib::RefPtr< ::Cairo::Context > create_context(), clutter_cairo_texture_create)
_WRAP_METHOD(Glib::RefPtr< ::Cairo::Context > create_context_region(int x_offset, int y_offset, int width, int height), clutter_cairo_texture_create_region)
};
diff --git a/clutter/src/clutter_docs.xml b/clutter/src/clutter_docs.xml
index 10ea88a..3655959 100644
--- a/clutter/src/clutter_docs.xml
+++ b/clutter/src/clutter_docs.xml
@@ -17,7 +17,7 @@ Since: 0.4
<function name="clutter_value_get_unit">
<description>
-Gets the #ClutterUnit&lt;!-- --&gt;s contained in @value.
+Gets the #ClutterUnit<!-- -->s contained in @value.
</description>
@@ -126,25 +126,22 @@ Since: 0.4
</return>
</function>
-<function name="clutter_interval_set_initial_value">
+<function name="clutter_keysym_to_unicode">
<description>
-Sets the initial value of @interval to @value. The value is copied
-inside the #ClutterInterval.
+Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode)
+character.
-Since: 1.0
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #GValue
+<parameter name="keyval">
+<parameter_description> a key symbol
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the corresponding unicode character, or 0 if there
+is no corresponding character.
+</return>
</function>
<function name="ClutterModelIter">
@@ -159,37 +156,43 @@ Since: 0.6
<return></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_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="self">
-<parameter_description> A #ClutterGroup
+<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> A list of #ClutterActors. You should free the returned
-list using g_list_free() when finished using it.
-
- Deprecated: 0.4: This function is obsolete, use
-clutter_container_get_children() instead.
+<return> (transfer none): a pointer to the #JsonNode at the requested index
</return>
</function>
@@ -466,20 +469,26 @@ Since: 0.4
</return>
</function>
-<function name="clutter_timeline_get_speed">
+<function name="clutter_actor_raise">
<description>
-Gets the frames per second played by @timeline
+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="timeline">
-<parameter_description> a #ClutterTimeline
+<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> the number of frames per second.
-</return>
+<return></return>
</function>
<function name="clutter_value_set_fixed">
@@ -502,24 +511,22 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_path_replace_node">
+<function name="clutter_text_set_ellipsize">
<description>
-Replaces the node at offset @index_ with @node.
+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="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> index to the existing node
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the replacement node
+<parameter name="mode">
+<parameter_description> a #PangoEllipsizeMode
</parameter_description>
</parameter>
</parameters>
@@ -561,19 +568,19 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="xoff">
-<parameter_description> X offset of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> X offset of the clip rectangle, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="yoff">
-<parameter_description> Y offset of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Y offset of the clip rectangle, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> Width of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Width of the clip rectangle, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> Height of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Height of the clip rectangle, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -732,6 +739,9 @@ to animate @actor.
This is the vector-based variant of clutter_actor_animate_with_timeline(),
useful for language bindings.
+<warning>Unlike clutter_actor_animate_with_timeline(), this function
+will not allow you to specify "signal::" names and callbacks.</warning>
+
</description>
<parameters>
@@ -955,27 +965,6 @@ Sets @object inside @node. The reference count of @object is not increased.
<return></return>
</function>
-<function name="json_array_get_element">
-<description>
-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
@@ -1019,40 +1008,24 @@ Since: 1.0
</return>
</function>
-<function name="json_array_get_elements">
+<function name="clutter_binding_pool_block_action">
<description>
-Gets the elements of a #JsonArray as a list of #JsonNode&lt;!-- --&gt;s.
+Blocks all the actions with name @action_name inside @pool.
+Since: 1.0
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> an action name
</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>
+<return></return>
</function>
<function name="clutter_actor_animatev">
@@ -1064,6 +1037,9 @@ definite duration and a speed given by the @mode.
This is the vector-based variant of clutter_actor_animate(), useful
for language bindings.
+<warning>Unlike clutter_actor_animate(), this function will not
+allow you to specify "signal::" names and callbacks.</warning>
+
</description>
<parameters>
@@ -1200,12 +1176,12 @@ as a side-effect.
Calculates the transformed coordinates of the four corners of the
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;@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;
+<itemizedlist>
+<listitem><para>@verts[0] contains (x1, y1)</para></listitem>
+<listitem><para>@verts[1] contains (x2, y1)</para></listitem>
+<listitem><para>@verts[2] contains (x1, y2)</para></listitem>
+<listitem><para>@verts[3] contains (x2, y2)</para></listitem>
+</itemizedlist>
If @ancestor is %NULL the ancestor will be the #ClutterStage. In
this case, the coordinates returned will be the coordinates on
@@ -1283,12 +1259,12 @@ Sets whether per-actor motion events should be enabled or not (the
default is to enable them).
If @enable is %FALSE the following events will not work:
-&lt;itemizedlist&gt;
-&lt;listitem&gt;&lt;para&gt;ClutterActor::motion-event, unless on the
-#ClutterStage&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;ClutterActor::enter-event&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;ClutterActor::leave-event&lt;/para&gt;&lt;/listitem&gt;
-&lt;/itemizedlist&gt;
+<itemizedlist>
+<listitem><para>ClutterActor::motion-event, unless on the
+#ClutterStage</para></listitem>
+<listitem><para>ClutterActor::enter-event</para></listitem>
+<listitem><para>ClutterActor::leave-event</para></listitem>
+</itemizedlist>
Since: 0.6
@@ -1302,25 +1278,34 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_model_get_column_type">
+<function name="clutter_animation_bind_interval">
<description>
-Retrieves the type of the @column.
+Binds @interval to the @property_name of the #GObject
+attached to @animation. The #ClutterAnimation will take
+ownership of the passed #ClutterInterval. For more information
+about animations, see clutter_actor_animate().
+
+If you need to update the interval instance use
+clutter_animation_update_property() instead.
</description>
<parameters>
-<parameter name="model">
-<parameter_description> #ClutterModel
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="column">
-<parameter_description> the column number
+<parameter name="property_name">
+<parameter_description> the property to control
+</parameter_description>
+</parameter>
+<parameter name="interval">
+<parameter_description> (transfer full): a #ClutterInterval
</parameter_description>
</parameter>
</parameters>
-<return> the type of the column.
-
-Since: 0.6
+<return> (transfer none): The animation itself.
+Since: 1.0
</return>
</function>
@@ -1387,7 +1372,7 @@ from 0.
<function name="clutter_actor_set_heightu">
<description>
-Forces a height on an actor, causing the actor's preferred width
+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.
@@ -1401,7 +1386,7 @@ since: 0.6
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> Requested new height for the actor, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Requested new height for the actor, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -1434,36 +1419,37 @@ Since: 0.2
</return>
</function>
-<function name="clutter_actor_get_clip">
+<function name="clutter_color_from_string">
<description>
-Gets the clip area for @self, in pixels.
+Parses a string definition of a color, filling the
+<structfield>red</structfield>, <structfield>green</structfield>,
+<structfield>blue</structfield> and <structfield>alpha</structfield>
+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
+<literal>Red</literal> or <literal>DarkSlateGray</literal>, or
+hexadecimal specifications like <literal>#3050b2</literal> or
+<literal>#333</literal>.
-Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<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 name="color">
+<parameter_description> (out): return location for a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> (out): return location for the height of the clip rectangle, or %NULL
+<parameter name="str">
+<parameter_description> a string specifiying a color (named color or #RRGGBBAA)
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if parsing succeeded.
+
+Since: 1.0
+</return>
</function>
<function name="clutter_behaviour_depth_get_bounds">
@@ -1536,7 +1522,7 @@ Since: 0.1.1
<function name="clutter_container_sort_depth_order">
<description>
-Sorts a container's children using their depth. This function should not
+Sorts a container's children using their depth. This function should not
be normally used by applications.
Since: 0.6
@@ -1613,50 +1599,22 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_group_add_many">
+<function name="clutter_get_input_device_for_id">
<description>
-Adds a %NULL-terminated list of actors to a group. This function is
-equivalent to calling clutter_group_add() for each member of the list.
+Retrieves the #ClutterInputDevice from its id.
- Deprecated: 0.4: This function is obsolete, use clutter_container_add()
-instead.
</description>
<parameters>
-<parameter name="group">
-<parameter_description> A #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="first_actor">
-<parameter_description> the #ClutterActor actor to add to the group
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> additional actors to add to the group
+<parameter name="id">
+<parameter_description> a device id
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<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.
-
-Since: 0.1.1
+<return> (transfer none): a #ClutterInputDevice, or %NULL
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
+Since: 0.8
+</return>
</function>
<function name="clutter_timeline_remove_marker">
@@ -1684,7 +1642,7 @@ Since: 0.8
Sets a function to be called at regular intervals, and puts it inside
the @pool. The function is repeatedly called until it returns %FALSE,
at which point the timeout is automatically destroyed and the function
-won't be called again. If @notify is not %NULL, the @notify function
+won't be called again. If @notify is not %NULL, the @notify function
will be called. The first call to @func will be at the end of @interval.
Since version 0.8 this will try to compensate for delays. For
@@ -1703,8 +1661,8 @@ invoke the function multiple times to catch up missing frames if
<parameter_description> a #ClutterTimeoutPool
</parameter_description>
</parameter>
-<parameter name="interval">
-<parameter_description> the time between calls to the function, in milliseconds
+<parameter name="fps">
+<parameter_description> the time between calls to the function, in frames per second
</parameter_description>
</parameter>
<parameter name="func">
@@ -1734,12 +1692,12 @@ and names passed in.
For example:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
model = clutter_list_model_new (3,
G_TYPE_INT, "Score",
G_TYPE_STRING, "Team",
GDK_TYPE_PIXBUF, "Logo");
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
will create a new #ClutterModel with three columns of type int,
string and #GdkPixbuf respectively.
@@ -1788,62 +1746,9 @@ Since: 1.0
<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.8
-</return>
-</function>
-
<function name="clutter_actor_get_anchor_pointu">
<description>
-Gets the current anchor point of the @actor in #ClutterUnit&lt;!-- --&gt;s.
+Gets the current anchor point of the @actor in #ClutterUnit<!-- -->s.
Since: 0.6
@@ -1865,41 +1770,21 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_score_append_at_marker">
+<function name="clutter_path_node_copy">
<description>
-Appends @timeline at the given @marker_name on the @parent
-#ClutterTimeline.
-
-If you want to append @timeline at the end of @parent, use
-clutter_score_append().
-
-The #ClutterScore will take a reference on @timeline.
+Makes an allocated copy of a node.
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
-</parameter_description>
-</parameter>
-<parameter name="parent">
-<parameter_description> the parent #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="marker_name">
-<parameter_description> the name of the marker to use
-</parameter_description>
-</parameter>
-<parameter name="timeline">
-<parameter_description> the #ClutterTimeline to append
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</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> the copied node.
-Since: 0.8
+Since: 1.0
</return>
</function>
@@ -1915,6 +1800,22 @@ destroy or unref the returned actor.
</return>
</function>
+<function name="clutter_stage_hide_cursor">
+<description>
+Makes the cursor invisible on the stage window
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_container_foreach">
<description>
Calls @callback for each child of @container.
@@ -1953,6 +1854,9 @@ to animate @actor.
This is the vector-based variant of clutter_actor_animate_with_alpha(),
useful for language bindings.
+<warning>Unlike clutter_actor_animate_with_alpha(), this function will
+not allow you to specify "signal::" names and callbacks.</warning>
+
</description>
<parameters>
@@ -1986,22 +1890,21 @@ Since: 1.0
</return>
</function>
-<function name="clutter_timeline_get_delay">
+<function name="ClutterAnimation">
<description>
-Retrieves the delay set using clutter_timeline_set_delay().
+The ::started signal is emitted once the animation has been
+started
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="animation">
+<parameter_description> the animation that emitted the signal
</parameter_description>
</parameter>
</parameters>
-<return> the delay in milliseconds.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_text_get_max_length">
@@ -2049,15 +1952,40 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_animation_update_interval">
+<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_actor_get_preferred_height">
<description>
Computes the requested minimum and natural heights for an actor,
or if they are already computed, returns the cached values.
An actor may not get its request - depending on the layout
-manager that's in effect.
+manager that's in effect.
-A request should not incorporate the actor's scale or anchor point;
+A request should not incorporate the actor's scale or anchor point;
those transformations do not affect layout, only rendering.
Since: 0.8
@@ -2232,6 +2160,23 @@ Since: 0.4
</return>
</function>
+<function name="clutter_get_default_backend">
+<description>
+Retrieves the default #ClutterBackend used by Clutter. The
+#ClutterBackend holds backend-specific configuration options.
+
+
+</description>
+<parameters>
+</parameters>
+<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="clutter_score_get_timeline">
<description>
Retrieves the #ClutterTimeline for @id inside @score.
@@ -2256,16 +2201,46 @@ Since: 0.6
</return>
</function>
-<function name="json_array_new">
+<function name="clutter_score_pause">
<description>
-Creates a new #JsonArray.
+Pauses a playing score @score.
+Since: 0.6
</description>
<parameters>
+<parameter name="score">
+<parameter_description> a #ClutterScore
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #JsonArray
-</return>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_position">
+<description>
+Sets the actor's fixed position in pixels relative to any parent
+actor.
+
+If a layout manager is in use, this position will override the
+layout manager and force a fixed position.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> New left position of actor in pixels.
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> New top position of actor in pixels.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_get_angle_end">
@@ -2316,12 +2291,33 @@ Since: 0.4
<return></return>
</function>
+<function name="clutter_text_delete_selection">
+<description>
+Deletes the currently selected text
+
+This function is only useful in subclasses of #ClutterText
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if text was deleted or if the text actor
+is empty, and %FALSE otherwise
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_color_hash">
<description>
Converts a #ClutterColor to a hash value.
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.
+parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
</description>
@@ -2364,19 +2360,19 @@ 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,
+/* set the fog color to the stage background color */
+clutter_stage_get_color (CLUTTER_STAGE (actor), &stage_color);
+cogl_color_set_from_4ub (&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;/
+/* enable fog */
+cogl_set_fog (&fog_color,
+COGL_FOG_MODE_EXPONENTIAL, /* mode */
+0.5, /* density */
+5.0, 30.0); /* z_near and z_far */
}
]|
@@ -2431,7 +2427,7 @@ Since: 0.2
<function name="clutter_actor_set_sizeu">
<description>
-Overrides the actor's size request in #ClutterUnit&lt;!-- --&gt;s. If @width
+Overrides the actor's size request in #ClutterUnit<!-- -->s. If @width
and/or @height are -1 the actor will use its normal size request (the
override is removed).
@@ -2446,11 +2442,11 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> New width of actor in #ClutterUnit&lt;!-- --&gt;s, or -1
+<parameter_description> New width of actor in #ClutterUnit<!-- -->s, or -1
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> New height of actor in #ClutterUnit&lt;!-- --&gt;s, or -1
+<parameter_description> New height of actor in #ClutterUnit<!-- -->s, or -1
</parameter_description>
</parameter>
</parameters>
@@ -2476,26 +2472,50 @@ Since: 0.8
</return>
</function>
-<function name="clutter_container_class_find_child_property">
+<function name="clutter_threads_add_timeout">
<description>
-Looks up the #GParamSpec for a child property of @klass.
+Simple wrapper around clutter_threads_add_timeout_full().
</description>
<parameters>
-<parameter name="klass">
-<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
+<parameter name="interval">
+<parameter_description> the time between calls to the function, in milliseconds
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> a property name.
+<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> (transfer none): The #GParamSpec for the property or %NULL
-if no such property exist.
+<return> the ID (greater than 0) of the event source.
-Since: 0.8
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_actor_should_pick_paint">
+<description>
+Should be called inside the implementation of the
+#ClutterActor::pick virtual function in order to check whether
+the actor should paint itself in pick mode or not.
+
+This function should never be called directly by applications.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the actor should paint its silhouette,
+%FALSE otherwise
</return>
</function>
@@ -2583,7 +2603,7 @@ Since: 0.6
<description>
Calls the animate_property() virtual function for @animatable.
-The @initial_value and @final_value #GValue&lt;!-- --&gt;s must contain
+The @initial_value and @final_value #GValue<!-- -->s must contain
the same type; @value must have been initialized to the same
type of @initial_value and @final_value.
@@ -2653,7 +2673,7 @@ Since: 0.6
<function name="clutter_units_em">
<description>
-Converts a value in em to #ClutterUnit&lt;!-- --&gt;s at the
+Converts a value in em to #ClutterUnit<!-- -->s at the
current DPI
@@ -2672,7 +2692,7 @@ Since: 1.0
<function name="clutter_actor_get_scale_centeru">
<description>
-ClutterUnit&lt;!-- --&gt;s version of clutter_actor_get_scale_center().
+ClutterUnit<!-- -->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
@@ -2807,24 +2827,38 @@ Since: 1.0
</return>
</function>
-<function name="clutter_text_get_font_name">
+<function name="clutter_behaviour_scale_set_boundsx">
<description>
-Retrieves the font name as set by clutter_text_set_font_name().
+Fixed point version of clutter_behaviour_scale_set_bounds().
+Sets the bounds used by scale behaviour.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<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_description>
+</parameter>
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the font name. The returned
-string is owned by the #ClutterText actor and should not be
-modified or freed
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_get_n_actors">
@@ -2875,7 +2909,7 @@ Since: 0.6
<description>
This function does the same work as clutter_init(). Additionally,
it allows you to add your own command line options, and it
-automatically generates nicely formatted &lt;option&gt;--help&lt;/option&gt;
+automatically generates nicely formatted <option>--help</option>
output. Note that your program will be terminated after writing
out the help output. Also note that, in case of error, the
error message will be placed inside @error instead of being
@@ -2894,18 +2928,18 @@ printed on the display.
</parameter>
<parameter name="parameter_string">
<parameter_description> a string which is displayed in the
-first line of &lt;option&gt;--help&lt;/option&gt; output, after
-&lt;literal&gt;&lt;replaceable&gt;programname&lt;/replaceable&gt; [OPTION...]&lt;/literal&gt;
+first line of <option>--help</option> output, after
+<literal><replaceable>programname</replaceable> [OPTION...]</literal>
</parameter_description>
</parameter>
<parameter name="entries">
-<parameter_description> a %NULL terminated array of #GOptionEntry&lt;!-- --&gt;s
+<parameter_description> a %NULL terminated array of #GOptionEntry<!-- -->s
describing the options of your program
</parameter_description>
</parameter>
<parameter name="translation_domain">
<parameter_description> a translation domain to use for translating
-the &lt;option&gt;--help&lt;/option&gt; output for the options in @entries
+the <option>--help</option> output for the options in @entries
with gettext(), or %NULL
</parameter_description>
</parameter>
@@ -2955,7 +2989,7 @@ Since: 1.0
<function name="clutter_behaviour_remove">
<description>
-Removes @actor from the list of #ClutterActor&lt;!-- --&gt;s to which
+Removes @actor from the list of #ClutterActor<!-- -->s to which
@behave applies. This function removes a reference on the actor.
Since: 0.2
@@ -3057,7 +3091,7 @@ set progress function
<function name="clutter_units_to_pixels">
<description>
-Converts a value in #ClutterUnit&lt;!-- --&gt;s to pixels
+Converts a value in #ClutterUnit<!-- -->s to pixels
</description>
@@ -3078,11 +3112,11 @@ Since: 1.0
Sets the rotation angle of @self around the given axis.
The rotation center coordinates used depend on the value of @axis:
-&lt;itemizedlist&gt;
-&lt;listitem&gt;&lt;para&gt;%CLUTTER_X_AXIS requires @y and @z&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;%CLUTTER_Y_AXIS requires @x and @z&lt;/para&gt;&lt;/listitem&gt;
-&lt;listitem&gt;&lt;para&gt;%CLUTTER_Z_AXIS requires @x and @y&lt;/para&gt;&lt;/listitem&gt;
-&lt;/itemizedlist&gt;
+<itemizedlist>
+<listitem><para>%CLUTTER_X_AXIS requires @y and @z</para></listitem>
+<listitem><para>%CLUTTER_Y_AXIS requires @x and @z</para></listitem>
+<listitem><para>%CLUTTER_Z_AXIS requires @x and @y</para></listitem>
+</itemizedlist>
The rotation coordinates are relative to the anchor point of the
actor, set using clutter_actor_set_anchor_point(). If no anchor
@@ -3307,55 +3341,30 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_timeline_get_delta">
+<function name="clutter_grab_keyboard">
<description>
-Retrieves the number of frames and the amount of time elapsed since
-the last ClutterTimeline::new-frame signal.
-
-This function is only useful inside handlers for the ::new-frame
-signal, and its behaviour is undefined if the timeline is not
-playing.
+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.
+Like pointer grabs, keyboard grabs should only be used as a last
+resource.
-</description>
-<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="msecs">
-<parameter_description> return location for the milliseconds elapsed since the last
-frame, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> the amount of frames elapsed since the last one
+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.6
-</return>
-</function>
-
-<function name="clutter_animation_has_property">
-<description>
-Checks whether @animation is controlling @property_name.
-
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
-</parameter_description>
-</parameter>
-<parameter name="property_name">
-<parameter_description> name of the property
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the property is animated by the
-#ClutterAnimation, %FALSE otherwise
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_newx">
@@ -3405,23 +3414,18 @@ Since: 0.4
</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="self">
-<parameter_description> a #ClutterActor
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The currently set #ClutterShader or %NULL if no
-shader is set.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_rotate_get_boundsx">
@@ -3486,22 +3490,24 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_text_set_ellipsize">
+<function name="clutter_path_replace_node">
<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
+Replaces the node at offset @index_ with @node.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> a #PangoEllipsizeMode
+<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>
@@ -3546,9 +3552,9 @@ Since: 0.6
<description>
Creates a behaviour that drives actors along an elliptical path with
given center, width and height; the movement starts at @start
-degrees (with 0 corresponding to 12 o'clock) and ends at @end
+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
+interval <0, 360); if @start is equal to @end, the behaviour will
rotate by exacly 360 degrees.
@@ -3617,27 +3623,28 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_event_get_state">
+<function name="json_array_get_elements">
<description>
-Retrieves the modifier state of the event.
+Gets the elements of a #JsonArray as a list of #JsonNode<!-- -->s.
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="array">
+<parameter_description> a #JsonArray
</parameter_description>
</parameter>
</parameters>
-<return> the modifier state parameter, or 0
-
-Since: 0.4
+<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_units_pixels">
<description>
-Converts a value in pixels to #ClutterUnit&lt;!-- --&gt;s
+Converts a value in pixels to #ClutterUnit<!-- -->s
</description>
@@ -3698,7 +3705,7 @@ Since: 1.0
<function name="clutter_behaviour_ellipse_set_tilt">
<description>
-Sets the angles at which the ellipse should be tilted around it's center.
+Sets the angles at which the ellipse should be tilted around it's center.
Since: 0.4
@@ -3724,21 +3731,16 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_media_set_progress">
+<function name="clutter_actor_lower_bottom">
<description>
-Sets the playback progress of @media. The @progress is
-a normalized value between 0.0 (begin) and 1.0 (end).
+Lowers @self to the bottom.
-Since: 1.0
+This function calls clutter_actor_lower() internally.
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
-</parameter_description>
-</parameter>
-<parameter name="progress">
-<parameter_description> the progress of the playback, between 0.0 and 1.0
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
@@ -3789,29 +3791,12 @@ and 360.
<return></return>
</function>
-<function name="clutter_group_sort_depth_order">
-<description>
-Sorts a #ClutterGroup's children by their depth value.
-This function should not be used by applications.
-
-Deprecated: 0.6: Use clutter_container_sort_depth_order() instead.
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterGroup
-</parameter_description>
-</parameter>
-</parameters>
-<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
+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
@@ -3833,30 +3818,28 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_frame_source_add">
+<function name="clutter_text_set_password_char">
<description>
-Simple wrapper around clutter_frame_source_add_full().
+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="interval">
-<parameter_description> the time between calls to the function, in milliseconds
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="wc">
+<parameter_description> a Unicode character, or 0 to unset the password character
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="json_node_set_double">
@@ -3880,7 +3863,7 @@ content.
<function name="clutter_actor_set_yu">
<description>
-Sets the actor's Y coordinate, relative to its parent.
+Sets the actor's Y coordinate, relative to its parent.
Overrides any layout manager and forces a fixed position for
the actor.
@@ -3894,7 +3877,7 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> the actor's position on the Y axis, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> the actor's position on the Y axis, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -3993,10 +3976,10 @@ Since: 0.8
This function tries to "do what you mean" and tell you where the
actor is, prior to any transformations. Retrieves the fixed
position of an actor in pixels, if one has been set; otherwise, if
-the allocation is valid, returns the actor's allocated position;
+the allocation is valid, returns the actor's allocated position;
otherwise, returns 0,0.
-The returned position is in #ClutterUnit&lt;!-- --&gt;s.
+The returned position is in #ClutterUnit<!-- -->s.
Since: 0.6
@@ -4043,28 +4026,20 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_behaviour_rotate_get_bounds">
+<function name="clutter_timeline_get_speed">
<description>
-Retrieves the rotation boundaries of the rotate behaviour.
+Gets the frames per second played by @timeline
-Since: 0.4
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="angle_start">
-<parameter_description> return value for the initial angle
-</parameter_description>
-</parameter>
-<parameter name="angle_end">
-<parameter_description> return value for the final angle
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the number of frames per second.
+</return>
</function>
<function name="clutter_timeline_get_loop">
@@ -4085,8 +4060,8 @@ Gets whether @timeline is looping
<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).
+Sets the angle at which movement ends; angles >= 360 degress get clamped
+to the canonical interval <0, 360).
Since: 0.4
@@ -4193,13 +4168,30 @@ Gets the boolean value stored inside a #JsonNode
</return>
</function>
-<function name="clutter_redraw">
+<function name="clutter_model_set_types">
<description>
-Forces a redraw of the entire stage. Applications should never use this
-function, but queue a redraw using clutter_actor_queue_redraw().
+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>
@@ -4216,25 +4208,11 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_get_option_group_without_init">
-<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.8.2
-</return>
-</function>
-
<function name="clutter_texture_set_cogl_texture">
<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.
+no longer needed it should be deref'd with cogl_handle_unref.
Since: 0.8
@@ -4252,11 +4230,12 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_raise_top">
+<function name="clutter_actor_get_scale_gravity">
<description>
-Raises @self to the top.
+Retrieves the scale center as a compass direction. If the scale
+center was specified in pixels or units this will return
+%CLUTTER_GRAVITY_NONE.
-This function calls clutter_actor_raise() internally.
</description>
<parameters>
@@ -4265,7 +4244,10 @@ This function calls clutter_actor_raise() internally.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the scale gravity
+
+Since: 1.0
+</return>
</function>
<function name="clutter_win32_get_stage_from_window">
@@ -4324,11 +4306,11 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="dx">
-<parameter_description> Distance to move Actor on X axis, in #ClutterUnit&lt;!-- --&gt;s.
+<parameter_description> Distance to move Actor on X axis, in #ClutterUnit<!-- -->s.
</parameter_description>
</parameter>
<parameter name="dy">
-<parameter_description> Distance to move Actor on Y axis, in #ClutterUnit&lt;!-- --&gt;s.
+<parameter_description> Distance to move Actor on Y axis, in #ClutterUnit<!-- -->s.
</parameter_description>
</parameter>
</parameters>
@@ -4376,6 +4358,30 @@ Since: 0.6
<return></return>
</function>
+<function name="clutter_behaviour_rotate_get_bounds">
+<description>
+Retrieves the rotation boundaries of the rotate behaviour.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="angle_start">
+<parameter_description> return value for the initial angle
+</parameter_description>
+</parameter>
+<parameter name="angle_end">
+<parameter_description> return value for the final angle
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_stage_is_default">
<description>
Checks if @stage is the default stage, or an instance created using
@@ -4395,20 +4401,20 @@ Since: 0.8
</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_color_darken">
@@ -4430,6 +4436,39 @@ in @result.
<return></return>
</function>
+<function name="clutter_text_set_justify">
+<description>
+Sets whether the text of the #ClutterText actor should be justified
+on both margins. This setting is ignored if Clutter is compiled
+against Pango < 1.18.
+
+Since: 1.0
+
+</description>
+<parameters>
+<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></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_interval_validate">
<description>
Validates the initial and final values of @interval against
@@ -4592,18 +4631,21 @@ Since: 0.8
</return>
</function>
-<function name="clutter_text_new">
+<function name="clutter_value_get_fixed">
<description>
-Creates a new #ClutterText actor. This actor can be used to
-display and edit text.
+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 newly created #ClutterText actor
+<return> the value inside the passed #GValue
-Since: 1.0
+Since: 0.8
</return>
</function>
@@ -4717,7 +4759,7 @@ Since: 0.6
<function name="clutter_actor_queue_relayout">
<description>
-Indicates that the actor's size request or other layout-affecting
+Indicates that the actor's size request or other layout-affecting
properties may have changed. This function is used inside #ClutterActor
subclass implementations, not by applications directly.
@@ -4774,8 +4816,8 @@ Simple wrapper around clutter_threads_add_frame_source_full().
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> the time between calls to the function, in milliseconds
+<parameter name="fps">
+<parameter_description> the number of times per second to call the function
</parameter_description>
</parameter>
<parameter name="func">
@@ -4825,7 +4867,7 @@ Since: 0.6
<function name="clutter_actor_get_paint_visibility">
<description>
-Retrieves the 'paint' visibility of an actor recursively checking for non
+Retrieves the 'paint' visibility of an actor recursively checking for non
visible parents.
@@ -4869,7 +4911,7 @@ Gets the layout box an actor has been assigned. The allocation can
only be assumed valid inside a paint() method; anywhere else, it
may be out-of-date.
-An allocation does not incorporate the actor's scale or anchor point;
+An allocation does not incorporate the actor's scale or anchor point;
those transformations do not affect layout, only rendering.
The returned rectangle is in pixels.
@@ -4895,7 +4937,7 @@ Since: 0.8
Retrieves the X coordinate of a #ClutterActor.
This function tries to "do what you mean", by returning the
-correct value depending on the actor's state.
+correct value depending on the actor's state.
If the actor has a valid allocation, this function will return
the X coordinate of the origin of the allocation box.
@@ -4925,7 +4967,7 @@ transformation (i.e. scaling, rotation)
Retrieves the Y coordinate of a #ClutterActor.
This function tries to "do what you mean", by returning the
-correct value depending on the actor's state.
+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.
@@ -4950,26 +4992,6 @@ transformation (i.e. scaling, rotation)
</return>
</function>
-<function name="clutter_path_add_cairo_path">
-<description>
-Add the nodes of the Cairo path to the end of @path.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-<parameter name="cpath">
-<parameter_description> a Cairo path
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_text_delete_chars">
<description>
Deletes @n_chars inside a #ClutterText actor, starting from the
@@ -5095,9 +5117,9 @@ column number followed by the value to be set. The list is terminated by a
-1.
For example, to set column 0 with type %G_TYPE_STRING, use:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
clutter_model_iter_set (iter, 0, "foo", -1);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
Since: 0.6
@@ -5142,25 +5164,46 @@ values into a #ClutterColor.
<return></return>
</function>
-<function name="clutter_actor_set_name">
+<function name="clutter_text_get_color">
<description>
-Sets the given name to @self. The name can be used to identify
-a #ClutterActor.
+Retrieves the text color as set by clutter_text_get_color().
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> Textual tag to apply to actor
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
</parameters>
<return></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="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> the opacity of the actor
+</return>
+</function>
+
<function name="clutter_texture_set_filter_quality">
<description>
Sets the filter quality when scaling a texture. The quality is an
@@ -5188,28 +5231,16 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_get_scale">
+<function name="clutter_main_level">
<description>
-Retrieves an actors scale in floating point.
+Retrieves the depth of the Clutter mainloop.
-Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="scale_x">
-<parameter_description> (out): Location to store horizonal float scale factor, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="scale_y">
-<parameter_description> (out): Location to store vertical float scale factor, or %NULL.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> The level of the mainloop.
+</return>
</function>
<function name="clutter_event_get_stage">
@@ -5231,6 +5262,27 @@ Since: 0.8
</return>
</function>
+<function name="json_object_get_members">
+<description>
+Retrieves all the names of the members of a #JsonObject. You can
+obtain the value for each member using json_object_get_member().
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #JsonObject
+</parameter_description>
+</parameter>
+</parameters>
+<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>
+
<function name="clutter_actor_get_depthu">
<description>
Retrieves the depth of @self.
@@ -5243,7 +5295,7 @@ Retrieves the depth of @self.
</parameter_description>
</parameter>
</parameters>
-<return> the depth of the actor, in #ClutterUnit&lt;!-- --&gt;s
+<return> the depth of the actor, in #ClutterUnit<!-- -->s
Since: 0.6
</return>
@@ -5335,8 +5387,8 @@ Since: 0.8
<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).
+Sets the initial and final angles of a rotation behaviour; angles >= 360
+degrees get clamped to the canonical interval <0, 360).
Since: 0.4
@@ -5358,27 +5410,6 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_timeline_clone">
-<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().
-
-
-</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.
@@ -5399,46 +5430,32 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_script_get_objects">
+<function name="clutter_x11_texture_pixmap_set_window">
<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.
+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="script">
-<parameter_description> a #ClutterScript
+<parameter name="texture">
+<parameter_description> the texture to bind
</parameter_description>
</parameter>
-<parameter name="first_name">
-<parameter_description> the name of the first object to retrieve
+<parameter name="window">
+<parameter_description> the X window to which the texture should be bound
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> return location for a #GObject, then additional names, ending
-with %NULL
+<parameter name="automatic">
+<parameter_description> TRUE is automatic window updates, FALSE for manual.
</parameter_description>
</parameter>
</parameters>
-<return> the number of objects returned.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="json_node_get_int">
@@ -5470,12 +5487,11 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_actor_get_scale_gravity">
+<function name="clutter_actor_raise_top">
<description>
-Retrieves the scale center as a compass direction. If the scale
-center was specified in pixels or units this will return
-%CLUTTER_GRAVITY_NONE.
+Raises @self to the top.
+This function calls clutter_actor_raise() internally.
</description>
<parameters>
@@ -5484,38 +5500,6 @@ center was specified in pixels or units this will return
</parameter_description>
</parameter>
</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="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>
@@ -5559,16 +5543,24 @@ Since: 1.0
</return>
</function>
-<function name="clutter_ungrab_pointer_for_device">
+<function name="clutter_cairo_texture_get_surface_size">
<description>
-Removes an existing grab of the pointer events for device @id.
+Retrieves the surface width and height for @self.
-Since: 0.8
+Since: 1.0
</description>
<parameters>
-<parameter name="id">
-<parameter_description> a device id
+<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>
@@ -5579,8 +5571,11 @@ Since: 0.8
<description>
Queues a redraw for the passed stage.
-&lt;note&gt;Applications should call clutter_actor_queue_redraw() and not
-this function.&lt;/note&gt;
+<note>Applications should call clutter_actor_queue_redraw() and not
+this function.</note>
+
+<note>This function is just a wrapper for clutter_actor_queue_redraw()
+and should probably go away.</note>
Since: 0.8
@@ -5618,6 +5613,26 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_event_put">
+<description>
+Puts a copy of the event on the back of the event queue. The event will have
+the #CLUTTER_EVENT_FLAG_SYNTHETIC flag set. If the source is set event
+signals will be emitted for this source and capture/bubbling for it's
+ancestors. If the source is not set it will be generated by picking or use
+the actor that currently has keyboard focus.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_param_spec_fixed">
<description>
Creates a #GParamSpec for properties using #CoglFixed values
@@ -5678,30 +5693,6 @@ Since: 1.0
</return>
</function>
-<function name="clutter_group_lower">
-<description>
-Lowers @actor to @sibling level in the depth ordering.
-
-Deprecated: 0.6: Use clutter_container_lower_child() instead
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="sibling">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_rotate_get_axis">
<description>
Retrieves the #ClutterRotateAxis used by the rotate behaviour.
@@ -5759,7 +5750,7 @@ Since: 0.6
<function name="clutter_behaviour_ellipse_set_tiltx">
<description>
-Sets the angle at which the ellipse should be tilted around it's center.
+Sets the angle at which the ellipse should be tilted around it's center.
Since: 0.4
@@ -5827,27 +5818,9 @@ Since: 0.8
</return>
</function>
-<function name="clutter_timeline_set_n_frames">
-<description>
-Sets the total number of frames for @timeline
-
-</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>
-
<function name="clutter_container_remove">
<description>
-Removes a %NULL terminated list of #ClutterActor&lt;!-- --&gt;s from
+Removes a %NULL terminated list of #ClutterActor<!-- -->s from
@container. Each actor should be unparented, so if you want to keep it
around you must hold a reference to it yourself, using g_object_ref().
Each time an actor is removed, the "actor-removed" signal is
@@ -5880,7 +5853,7 @@ 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.
+%CLUTTER_PATH_LINE_TO<!-- -->s.
</description>
@@ -5890,7 +5863,7 @@ A path will be created where the first knot is used in a
</parameter_description>
</parameter>
<parameter name="knots">
-<parameter_description> an array of #ClutterKnot&lt;!-- --&gt;s
+<parameter_description> an array of #ClutterKnot<!-- -->s
</parameter_description>
</parameter>
<parameter name="n_knots">
@@ -5939,12 +5912,44 @@ Sets @objects inside @node. The reference count of @object is increased.
<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> (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>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_new">
<description>
Creates a new #ClutterBehaviourRotate. This behaviour will rotate actors
bound to it on @axis, following @direction, between @angle_start and
- angle_end Angles &gt;= 360 degrees will be clamped to the canonical interval
-&lt;0, 360), if angle_start == angle_end, the behaviour will carry out a
+ angle_end Angles >= 360 degrees will be clamped to the canonical interval
+<0, 360), if angle_start == angle_end, the behaviour will carry out a
single rotation of 360 degrees.
@@ -5999,7 +6004,7 @@ Since: 0.6
<function name="clutter_alpha_get_mode">
<description>
-Retrieves the #ClutterAnimatioMode used by @alpha.
+Retrieves the #ClutterAnimationMode used by @alpha.
</description>
@@ -6017,7 +6022,7 @@ Since: 1.0
<function name="clutter_win32_get_stage_window">
<description>
-Gets the stage's window handle
+Gets the stage's window handle
</description>
@@ -6117,7 +6122,7 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="frame_num">
-<parameter_description> the marker's frame
+<parameter_description> the marker's frame
</parameter_description>
</parameter>
</parameters>
@@ -6133,7 +6138,7 @@ a container or layout manager).
Actors can know from their allocation box whether they have moved
with respect to their parent actor. The absolute_origin_changed
parameter additionally indicates whether the parent has moved with
-respect to the stage, for example because a grandparent's origin
+respect to the stage, for example because a grandparent's origin
has moved.
Since: 0.8
@@ -6173,20 +6178,20 @@ Retrieves the length of a #JsonArray
</return>
</function>
-<function name="clutter_path_add_node">
+<function name="clutter_text_get_selection_color">
<description>
-Adds @node to the end of the path.
+Retrieves the color of the selection of a #ClutterText actor.
Since: 1.0
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> a #ClutterPathNode
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
</parameters>
@@ -6293,22 +6298,25 @@ Since: 1.0
</return>
</function>
-<function name="clutter_keysym_to_unicode">
+<function name="clutter_interval_set_initial_value">
<description>
-Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode)
-character.
+Sets the initial value of @interval to @value. The value is copied
+inside the #ClutterInterval.
+Since: 1.0
</description>
<parameters>
-<parameter name="keyval">
-<parameter_description> a key symbol
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
</parameter_description>
</parameter>
</parameters>
-<return> the corresponding unicode character, or 0 if there
-is no corresponding character.
-</return>
+<return></return>
</function>
<function name="clutter_x11_trap_x_errors">
@@ -6342,6 +6350,40 @@ the #JsonGenerator.
<return></return>
</function>
+<function name="clutter_text_position_to_coords">
+<description>
+Retrieves the coordinates of the given @position.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> position in characters
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> 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>
+</parameter>
+<parameter name="line_height">
+<parameter_description> return location for the line height, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the conversion was successful
+
+Since: 1.0
+</return>
+</function>
+
<function name="clutter_container_get_children">
<description>
Retrieves all the children of @container.
@@ -6355,7 +6397,7 @@ Retrieves all the children of @container.
</parameter>
</parameters>
<return> (element-type Actor) (transfer container): a list
-of #ClutterActor&lt;!-- --&gt;s. Use g_list_free() on the returned
+of #ClutterActor<!-- -->s. Use g_list_free() on the returned
list when done.
Since: 0.4
@@ -6383,13 +6425,13 @@ Since: 0.6
<function name="clutter_actor_get_heightu">
<description>
-Retrieves the height of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+Retrieves the height of a #ClutterActor, in #ClutterUnit<!-- -->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
+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
@@ -6410,7 +6452,7 @@ be the same value.
</parameter_description>
</parameter>
</parameters>
-<return> the height of the actor, in #ClutterUnit&lt;!-- --&gt;s
+<return> the height of the actor, in #ClutterUnit<!-- -->s
since: 0.6
</return>
@@ -6546,20 +6588,20 @@ Since: 1.0
</return>
</function>
-<function name="clutter_model_remove">
+<function name="clutter_animation_set_duration">
<description>
-Removes the row at the given position from the model.
+Sets the duration of @animation in milliseconds.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="row">
-<parameter_description> position of row to remove
+<parameter name="msecs">
+<parameter_description> the duration in milliseconds
</parameter_description>
</parameter>
</parameters>
@@ -6672,20 +6714,20 @@ Since: 0.6
</return>
</function>
-<function name="clutter_timeline_is_playing">
+<function name="clutter_score_rewind">
<description>
-Queries state of a #ClutterTimeline.
+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
-</return>
+<return></return>
</function>
<function name="clutter_media_set_filename">
@@ -6770,16 +6812,21 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_actor_lower_bottom">
+<function name="clutter_media_set_progress">
<description>
-Lowers @self to the bottom.
+Sets the playback progress of @media. The @progress is
+a normalized value between 0.0 (begin) and 1.0 (end).
-This function calls clutter_actor_lower() internally.
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> the progress of the playback, between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
@@ -6789,7 +6836,7 @@ This function calls clutter_actor_lower() internally.
<function name="clutter_score_new">
<description>
Creates a new #ClutterScore. A #ClutterScore is an object that can
-hold multiple #ClutterTimeline&lt;!-- --&gt;s in a sequential order.
+hold multiple #ClutterTimeline<!-- -->s in a sequential order.
</description>
@@ -6802,114 +6849,22 @@ Since: 0.6
</return>
</function>
-<function name="clutter_threads_add_idle_full">
+<function name="clutter_timeline_set_n_frames">
<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.
-
-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:
-
-|[
-static gboolean
-idle_safe_callback (gpointer data)
-{
-SafeClosure *closure = data;
-gboolean res = FALSE;
-
-/&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);
-]|
-
+Sets the total number of frames for @timeline
</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_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="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> functio to call when the idle source is removed
+<parameter name="n_frames">
+<parameter_description> the number of frames
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="json_object_ref">
@@ -6959,18 +6914,15 @@ Since: 0.4
<return></return>
</function>
-<function name="json_parser_new">
+<function name="json_array_new">
<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.
+Creates a new #JsonArray.
</description>
<parameters>
</parameters>
-<return> the newly created #JsonParser. Use g_object_unref()
-to release all the memory it allocates.
+<return> the newly created #JsonArray
</return>
</function>
@@ -7007,66 +6959,47 @@ pairs terminated with NULL.
<return></return>
</function>
-<function name="clutter_get_default_backend1">
+<function name="clutter_text_get_text">
<description>
-Retrieves the default #ClutterBackend used by Clutter. The
-#ClutterBackend holds backend-specific configuration options.
+Retrieves a pointer to the current contents of a #ClutterText
+actor.
+
+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> (transfer none): the default backend. You should
-not ref or unref the returned object. Applications should rarely
-need to use this.
+<return> the contents of the actor. The returned string
+is owned by the #ClutterText actor and should never be
+modified or freed
-Since: 0.4
+Since: 1.0
</return>
</function>
<function name="ClutterStage">
<description>
-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:
-
-|[
-static void
-on_redraw_complete (void)
-{
-/&ast; execute the Clutter drawing pipeline &ast;/
-clutter_redraw ();
-}
-
-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");
+The ::activate signal is emitted when the stage loses key focus
+from the underlying window system.
-/&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
+Since: 0.6
</description>
<parameters>
<parameter name="stage">
-<parameter_description> the stage which was queued for redraw
+<parameter_description> the stage which was deactivated
</parameter_description>
</parameter>
</parameters>
@@ -7075,78 +7008,52 @@ Since: 1.0
<function name="SECTION">
<description>
-#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.
+#ClutterCairoTexture is a #ClutterTexture that displays the contents
+of a Cairo context. The #ClutterCairoTexture actor will create a
+Cairo image surface which will then be uploaded to a GL texture when
+needed.
-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.
+#ClutterCairoTexture will provide a #cairo_t context by using the
+clutter_cairo_texture_create() and clutter_cairo_texture_create_region()
+functions; you can use the Cairo API to draw on the context and then
+call cairo_destroy() when done.
-Actors requiring key bindings should create a new #ClutterBindingPool
-inside their class initialization function and then install actions
-like this:
+As soon as the context is destroyed with cairo_destroy(), the contents
+of the surface will be uploaded into the #ClutterCairoTexture actor:
|[
-static void
-foo_class_init (FooClass *klass)
-{
-ClutterBindingPool *binding_pool;
-
-binding_pool = clutter_binding_pool_get_for_class (klass);
-
-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);
-}
-]|
+cairo_t *cr;
-The callback has a signature of:
+cr = clutter_cairo_texture_create (CLUTTER_CAIRO_TEXTURE (texture));
-|[
-gboolean (* callback) (GObject *instance,
-const gchar *action_name,
-guint key_val,
-ClutterModifierType modifiers,
-gpointer user_data);
+/* draw on the context */
+
+cairo_destroy (cr);
]|
-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:
+Although a new #cairo_t is created each time you call
+clutter_cairo_texture_create() or
+clutter_cairo_texture_create_region(), it uses the same
+#cairo_surface_t each time. You can call
+clutter_cairo_texture_clear() to erase the contents between calls.
-|[
-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);
-]|
+<warning><para>Note that you should never use the code above inside the
+#ClutterActor::paint or #ClutterActor::pick virtual functions or
+signal handlers because it will lead to performance
+degradation.</para></warning>
-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.
+<note><para>Since #ClutterCairoTexture uses a Cairo image surface
+internally all the drawing operations will be performed in
+software and not using hardware acceleration. This can lead to
+performance degradation if the contents of the texture change
+frequently.</para></note>
-#ClutterBindingPool is available since Clutter 1.0
+#ClutterCairoTexture is available since Clutter 1.0.
</description>
<parameters>
<parameter name="short_description">
-<parameter_description> Pool for key bindings
+<parameter_description> Texture with Cairo integration
</parameter_description>
</parameter>
</parameters>
@@ -7165,7 +7072,7 @@ Gets the width (in pixels) of the border used by @rectangle
</parameter_description>
</parameter>
</parameters>
-<return> the border's width
+<return> the border's width
Since: 0.2
</return>
@@ -7327,111 +7234,128 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_interval_clone">
+<function name="clutter_threads_add_idle_full">
<description>
-Creates a copy of @interval.
+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.
+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:
-</description>
-<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
-</parameter_description>
-</parameter>
-</parameters>
-<return> the newly created #ClutterInterval
+|[
+static gboolean
+idle_safe_callback (gpointer data)
+{
+SafeClosure *closure = data;
+gboolean res = FALSE;
-Since: 1.0
-</return>
-</function>
+/* mark the critical section */
-<function name="clutter_group_add_many_valist">
-<description>
-Similar to clutter_group_add_many() but using a va_list. Use this
-function inside bindings.
+clutter_threads_enter();
- Deprecated: 0.4: This function is obsolete, use
-clutter_container_add_valist() instead.
+/* the callback does not need to acquire the Clutter
+* lock itself, as it is held by the this proxy handler
+*/
+res = closure->callback (closure->data);
-</description>
-<parameters>
-<parameter name="group">
-<parameter_description> a #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="first_actor">
-<parameter_description> the #ClutterActor actor to add to the group
-</parameter_description>
-</parameter>
-<parameter name="var_args">
-<parameter_description> the actors to be added
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+clutter_threads_leave();
-<function name="cogl_pango_font_map_new">
-<description>
-Creates a new font map.
+return res;
+}
+static gulong
+add_safe_idle (GSourceFunc callback,
+gpointer data)
+{
+SafeClosure *closure = g_new0 (SafeClosure, 1);
+closure->callback = callback;
+closure->data = data;
-</description>
-<parameters>
-</parameters>
-<return> the newly created #PangoFontMap
+return g_add_idle_full (G_PRIORITY_DEFAULT_IDLE,
+idle_safe_callback,
+closure,
+g_free)
+}
+]|
-Since: 1.0
-</return>
-</function>
+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:
-<function name="clutter_model_get_iter_at_row">
-<description>
-Retrieves a #ClutterModelIter representing the row at the given index.
+|[
+static gboolean
+update_ui (gpointer data)
+{
+SomeClosure *closure = data;
+
+/* it is safe to call Clutter API from this function because
+* it is invoked from the same thread that started the main
+* loop and under the Clutter thread lock
+*/
+clutter_label_set_text (CLUTTER_LABEL (closure->label),
+closure->text);
+
+g_object_unref (closure->label);
+g_free (closure);
+
+return FALSE;
+}
+
+/* within another thread */
+closure = g_new0 (SomeClosure, 1);
+/* always take a reference on GObject instances */
+closure->label = g_object_ref (my_application->label);
+closure->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="model">
-<parameter_description> a #ClutterModel
+<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="row">
-<parameter_description> position of the row to retrieve
+<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> (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
+<return> the ID (greater than 0) of the event source.
-Since: 0.6
+Since: 0.4
</return>
</function>
-<function name="clutter_animation_update_property">
+<function name="cogl_pango_font_map_new">
<description>
-Changes the @interval for @property_name. The #ClutterAnimation
-will take ownership of the passed #ClutterInterval.
+Creates a new font map.
-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>
+<return> the newly created #PangoFontMap
+
+Since: 1.0
+</return>
</function>
<function name="clutter_animation_get_duration">
@@ -7452,24 +7376,22 @@ Since: 1.0
</return>
</function>
-<function name="clutter_event_put">
+<function name="clutter_interval_clone">
<description>
-Puts a copy of the event on the back of the event queue. The event will have
-the #CLUTTER_EVENT_FLAG_SYNTHETIC flag set. If the source is set event
-signals will be emitted for this source and capture/bubbling for it's
-ancestors. If the source is not set it will be generated by picking or use
-the actor that currently has keyboard focus.
+Creates a copy of @interval.
-Since: 0.6
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<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_egl_display">
@@ -7505,14 +7427,42 @@ Since: 0.8
</return>
</function>
-<function name="clutter_actor_remove_clip">
+<function name="clutter_model_get_column_type">
<description>
-Removes clip area from @self.
+Retrieves the type of the @column.
+
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="model">
+<parameter_description> #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column number
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the column.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_model_remove">
+<description>
+Removes the row at the given position from the model.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> position of row to remove
</parameter_description>
</parameter>
</parameters>
@@ -7535,8 +7485,8 @@ Since: 0.6
<function name="clutter_behaviour_ellipse_set_angle_end">
<description>
-Sets the angle at which movement ends; angles &gt;= 360 degress get clamped
-to the canonical interval &lt;0, 360).
+Sets the angle at which movement ends; angles >= 360 degress get clamped
+to the canonical interval <0, 360).
Since: 0.4
@@ -7572,7 +7522,8 @@ Creates a new #JsonArray with @n_elements slots already allocated.
<function name="clutter_model_get_first_iter">
<description>
-Retrieves a #ClutterModelIter representing the first row in @model.
+Retrieves a #ClutterModelIter representing the first non-filtered
+row in @model.
</description>
@@ -7582,8 +7533,8 @@ Retrieves a #ClutterModelIter representing the first row in @model.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full): A new #ClutterModelIter. Call g_object_unref() when
-done using it
+<return> (transfer full): A new #ClutterModelIter.
+Call g_object_unref() when done using it
Since: 0.6
</return>
@@ -7591,8 +7542,8 @@ Since: 0.6
<function name="ClutterText">
<description>
-The ::activate signal is emitted each time the actor is 'activated'
-by the user, normally by pressing the 'Enter' key. The signal is
+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: 1.0
@@ -7628,6 +7579,20 @@ Since: 0.2
<return></return>
</function>
+<function name="clutter_actor_remove_clip">
+<description>
+Removes clip area from @self.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_grab_pointer">
<description>
Grabs pointer events, after the grab is done all pointer related events
@@ -7636,10 +7601,10 @@ 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
+<note><para>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;
+preferred way to intercept event delivery to reactive actors.</para></note>
If you wish to grab all the pointer events for a specific input device,
you should use clutter_grab_pointer_for_device().
@@ -7658,7 +7623,7 @@ Since: 0.6
<function name="clutter_actor_set_depthu">
<description>
-Sets the Z co-ordinate of @self to @depth in #ClutterUnit&lt;!-- --&gt;s, the
+Sets the Z co-ordinate of @self to @depth in #ClutterUnit<!-- -->s, the
units of which are dependant on the perspective setup.
</description>
@@ -7668,28 +7633,38 @@ units of which are dependant on the perspective setup.
</parameter_description>
</parameter>
<parameter name="depth">
-<parameter_description> Z co-ordinate, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Z co-ordinate, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_animation_set_object">
+<function name="clutter_interval_set_interval">
<description>
-Attaches @animation to @object. The #ClutterAnimation will take a
-reference on @object.
+Variable arguments wrapper for clutter_interval_set_initial_value()
+and clutter_interval_set_final_value() that avoids using the
+#GValue arguments:
+
+|[
+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="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="object">
-<parameter_description> a #GObject
+<parameter name="Varargs">
+<parameter_description> the initial and final values of the interval
</parameter_description>
</parameter>
</parameters>
@@ -7712,21 +7687,18 @@ Since: 0.2
<return></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 %COGL_TYPE_FIXED
-</parameter_description>
-</parameter>
</parameters>
-<return> the value inside the passed #GValue
+<return> the newly created #ClutterText actor
-Since: 0.8
+Since: 1.0
</return>
</function>
@@ -7809,10 +7781,10 @@ Sets the stage color.
<function name="clutter_actor_get_yu">
<description>
-Retrieves the Y coordinate of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+Retrieves the Y coordinate of a #ClutterActor, in #ClutterUnit<!-- -->s.
This function tries to "do what you mean", by returning the
-correct value depending on the actor's state.
+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.
@@ -7832,7 +7804,7 @@ will return 0.
</parameter_description>
</parameter>
</parameters>
-<return> the Y coordinate, in #ClutterUnit&lt;!-- --&gt;s, ignoring
+<return> the Y coordinate, in #ClutterUnit<!-- -->s, ignoring
any transformation (i.e. scaling, rotation)
Since: 0.6
@@ -7870,7 +7842,7 @@ Since: 0.8
<function name="clutter_shader_set_is_enabled">
<description>
Enables a shader. This function will attempt to compile and link
-the shader, if it isn't already.
+the shader, if it isn't already.
When @enabled is %FALSE the default state of the GL pipeline will be
used instead.
@@ -7901,7 +7873,7 @@ Since: 0.6
</parameter_description>
</parameter>
</parameters>
-<return> A boolean indicating if the texture is using the
+<return> A boolean indicating if the texture is using the
GLX_EXT_texture_from_pixmap OpenGL extension or falling back to
slower software mechanism.
@@ -7970,7 +7942,7 @@ If the actor has a valid allocation, this function will return the
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, that is the preferred width of
+return the actor's natural width, that is the preferred width of
the actor.
If you care whether you get the preferred width or the width that
@@ -8211,13 +8183,13 @@ Creates and prepends a new row to the #ClutterModel, setting the row
values upon creation. For example, to prepend a new row where column 0
is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
ClutterModel *model;
model = clutter_model_default_new (2,
G_TYPE_INT, "Score",
G_TYPE_STRING, "Team");
clutter_model_prepend (model, 0, 42, 1, "Team #1", -1);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
Since: 0.6
@@ -8304,12 +8276,12 @@ Gets the layout box an actor has been assigned. The allocation can
only be assumed valid inside a paint() method; anywhere else, it
may be out-of-date.
-An allocation does not incorporate the actor's scale or anchor point;
+An allocation does not incorporate the actor's scale or anchor point;
those transformations do not affect layout, only rendering.
-&lt;note&gt;Do not call any of the clutter_actor_get_allocation_*() family
+<note>Do not call any of the clutter_actor_get_allocation_*() family
of functions inside the implementation of the get_preferred_width()
-or get_preferred_height() virtual functions.&lt;/note&gt;
+or get_preferred_height() virtual functions.</note>
Since: 0.8
@@ -8320,7 +8292,7 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="box">
-<parameter_description> (out): 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>
@@ -8355,8 +8327,8 @@ See also clutter_threads_add_idle_full().
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 name="fps">
+<parameter_description> the number of times per second to call the function
</parameter_description>
</parameter>
<parameter name="func">
@@ -8378,36 +8350,19 @@ Since: 0.8
</return>
</function>
-<function name="clutter_color_from_string">
+<function name="clutter_event_type">
<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 @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;.
+Retrieves the type of the event.
</description>
<parameters>
-<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 name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if parsing succeeded.
-
-Since: 1.0
+<return> a #ClutterEventType
</return>
</function>
@@ -8428,10 +8383,44 @@ increased by one.
</return>
</function>
+<function name="clutter_texture_set_from_file">
+<description>
+Sets the #ClutterTexture image data from an image file. In case of
+failure, %FALSE is returned and @error is set.
+
+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::size-change
+will be emitten when the size of the texture is available and
+#ClutterTexture::load-finished will be emitted when the image has been
+loaded or if an error occurred.
+
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> The filename of the image in GLib file name encoding
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the image was successfully loaded and set
+
+Since: 0.8
+</return>
+</function>
+
<function name="clutter_behaviour_ellipse_set_angle_startx">
<description>
-Sets the angle at which movement starts; angles &gt;= 360 degress get clamped
-to the canonical interval &lt;0, 360).
+Sets the angle at which movement starts; angles >= 360 degress get clamped
+to the canonical interval <0, 360).
Since: 0.6
@@ -8532,7 +8521,8 @@ Since: 0.6
<function name="clutter_model_get_n_rows">
<description>
-Retrieves the number of rows inside @model.
+Retrieves the number of rows inside @model, eventually taking
+into account any filtering function set using clutter_model_set_filter().
</description>
@@ -8637,7 +8627,7 @@ Since: 1.0
<description>
Unit-based variant of clutter_actor_get_clip().
-Gets the clip area for @self, in #ClutterUnit&lt;!-- --&gt;s.
+Gets the clip area for @self, in #ClutterUnit<!-- -->s.
Since: 0.6
@@ -8701,7 +8691,7 @@ Return value: (array length=n_properties) (transfer container): an array
</parameter>
</parameters>
<return> (array length=n_properties) (transfer container): an array
-of #GParamSpec&lt;!-- --&gt;s which should be freed after use.
+of #GParamSpec<!-- -->s which should be freed after use.
Since: 0.8
</return>
@@ -8730,7 +8720,7 @@ Since: 1.0
Gets the size and position of an actor relative to its parent
actor. This is the same as calling clutter_actor_get_position() and
clutter_actor_get_size(). It tries to "do what you mean" and get the
-requested size and position if the actor's allocation is invalid.
+requested size and position if the actor's allocation is invalid.
</description>
<parameters>
@@ -8746,33 +8736,25 @@ requested size and position if the actor's allocation is invalid.
<return></return>
</function>
-<function name="ClutterActor">
+<function name="clutter_score_list_timelines">
<description>
-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.
-
-Subclasses of #ClutterActor should override the class signal handler
-and paint themselves in that function.
+Retrieves a list of all the #ClutterTimelines managed by @score.
-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>
-<parameter name="actor">
-<parameter_description> the #ClutterActor that received the signal
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> the #ClutterColor to be used when picking
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<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_alpha_set_mode">
@@ -8797,25 +8779,21 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_text_insert_unichar">
+<function name="clutter_path_get_description">
<description>
-Inserts @wc at the current cursor position of a
-#ClutterText actor.
-
-Since: 1.0
+Return value: a string description of the path. Free with g_free().
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a string description of the path. Free with g_free().
+
+Since: 1.0
+</return>
</function>
<function name="clutter_x11_has_event_retrieval">
@@ -8887,33 +8865,20 @@ Since: 0.6
</return>
</function>
-<function name="clutter_text_get_text">
+<function name="clutter_get_motion_events_frequency">
<description>
-Retrieves a pointer to the current contents of a #ClutterText
-actor.
-
-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);
-]|
+Retrieves the number of motion events per second that are delivered
+to the stage.
-Which will return a newly allocated string.
+See clutter_set_motion_events_frequency().
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
</parameters>
-<return> the contents of the actor. The returned string
-is owned by the #ClutterText actor and should never be
-modified or freed
+<return> the number of motion events per second
-Since: 1.0
+Since: 0.6
</return>
</function>
@@ -8940,6 +8905,21 @@ Since: 1.0
</return>
</function>
+<function name="json_parser_new">
+<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.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #JsonParser. Use g_object_unref()
+to release all the memory it allocates.
+</return>
+</function>
+
<function name="json_node_set_int">
<description>
Sets @value as the integer content of the @node, replacing any existing
@@ -8981,34 +8961,6 @@ Since: 1.0
<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
@@ -9051,7 +9003,7 @@ Since: 0.4
</parameter_description>
</parameter>
<parameter name="dpi">
-<parameter_description> the resolution in "dots per inch" (Physical inches aren't
+<parameter_description> the resolution in "dots per inch" (Physical inches aren't
actually involved; the terminology is conventional).
</parameter_description>
</parameter>
@@ -9108,13 +9060,13 @@ Since: 0.6
<function name="clutter_actor_get_widthu">
<description>
-Retrieves the width of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+Retrieves the width of a #ClutterActor, in #ClutterUnit<!-- -->s.
If the actor has a valid allocation, this function will return the
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, that is the preferred width of
+return the actor's natural width, that is the preferred width of
the actor.
If you care whether you get the preferred width or the width that
@@ -9135,7 +9087,7 @@ be the same value.
</parameter_description>
</parameter>
</parameters>
-<return> the width of the actor, in #ClutterUnit&lt;!-- --&gt;s
+<return> the width of the actor, in #ClutterUnit<!-- -->s
since: 0.6
</return>
@@ -9270,86 +9222,50 @@ Since: 1.0
</return>
</function>
-<function name="clutter_actor_allocate_preferred_size">
+<function name="clutter_texture_get_base_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.
+Gets the size in pixels of the untransformed underlying texture pixbuf data.
-Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="absolute_origin_changed">
-<parameter_description> whether the position of the parent has
-changed in stage coordinates
+<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></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_backend_get_resolution">
@@ -9391,22 +9307,27 @@ Appends @node inside @array. The array will take ownership of the
<return></return>
</function>
-<function name="clutter_model_iter_is_last">
+<function name="clutter_script_lookup_filename">
<description>
-Gets whether the iterator is at the end of the model to which it
-belongs.
+Looks up @filename inside the search paths of @script. If @filename
+is found, its full path will be returned .
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
+<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> #TRUE if @iter is the last iter in the filtered model.
+<return> the full path of @filename or %NULL if no path was
+found.
-Since: 0.6
+Since: 0.8
</return>
</function>
@@ -9465,100 +9386,83 @@ Since: 0.6
<return></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>
<return></return>
</function>
-<function name="clutter_actor_set_width">
+<function name="clutter_get_option_group">
<description>
-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
+Return value: (transfer full): a #GOptionGroup for the commandline arguments
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> Requested new width for the actor, in pixels
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> (transfer full): a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+Since: 0.2
+</return>
</function>
-<function name="clutter_text_get_line_wrap">
+<function name="clutter_model_get_column_name">
<description>
-Retrieves the value set using clutter_text_set_line_wrap().
+Retrieves the name of the @column
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="model">
+<parameter_description> #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column number
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #ClutterText actor should wrap
-its contents
+<return> the name of the column. The model holds the returned
+string, and it should not be modified or freed
-Since: 1.0
+Since: 0.6
</return>
</function>
-<function name="clutter_interval_set_interval">
+<function name="clutter_animation_set_object">
<description>
-Variable arguments wrapper for clutter_interval_set_initial_value()
-and clutter_interval_set_final_value() that avoids using the
-#GValue arguments:
-
-|[
-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.
+Attaches @animation to @object. The #ClutterAnimation will take a
+reference on @object.
Since: 1.0
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the initial and final values of the interval
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
</parameters>
@@ -9601,22 +9505,24 @@ Sets @array inside @node and increases the #JsonArray reference count
<return></return>
</function>
-<function name="clutter_get_input_device_for_id">
+<function name="clutter_actor_unparent">
<description>
-Retrieves the #ClutterInputDevice from its id.
+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.
+Since: 0.1.1
</description>
<parameters>
-<parameter name="id">
-<parameter_description> a device id
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterInputDevice, or %NULL
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_score_get_loop">
@@ -9803,26 +9709,25 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_text_set_justify">
+<function name="clutter_timeline_clone">
<description>
-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.
+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().
-Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="justify">
-<parameter_description> whether the text should be justified
+<parameter name="timeline">
+<parameter_description> #ClutterTimeline to duplicate.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #ClutterTimeline, cloned from @timeline
+
+Since: 0.4
+</return>
</function>
<function name="clutter_shader_get_cogl_fragment_shader">
@@ -9861,50 +9766,42 @@ Since: 0.8
</return>
</function>
-<function name="clutter_actor_set_position">
+<function name="clutter_score_append_at_marker">
<description>
-Sets the actor's fixed position in pixels relative to any parent
-actor.
+Appends @timeline at the given @marker_name on the @parent
+#ClutterTimeline.
+
+If you want to append @timeline at the end of @parent, use
+clutter_score_append().
+
+The #ClutterScore will take a reference on @timeline.
-If a layout manager is in use, this position will override the
-layout manager and force a fixed position.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> New left position of actor in pixels.
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> New top position of actor in pixels.
+<parameter name="parent">
+<parameter_description> the parent #ClutterTimeline
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_binding_pool_block_action">
-<description>
-Blocks all the actions with name @action_name inside @pool.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="pool">
-<parameter_description> a #ClutterBindingPool
+<parameter name="marker_name">
+<parameter_description> the name of the marker to use
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> an action name
+<parameter name="timeline">
+<parameter_description> the #ClutterTimeline to append
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<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
+</return>
</function>
<function name="clutter_actor_move_anchor_point_from_gravity">
@@ -10065,7 +9962,7 @@ Since: 1.0
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
+%ClutterUnit<!-- -->s relative to the anchor point (usually
the top left corner of the actor).
Since: 1.0
@@ -10098,8 +9995,8 @@ Since: 1.0
<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.
+Resets the texture's pixmap from its window, perhaps in response to the
+pixmap's invalidation as the window changed size.
Since: 0.8
@@ -10118,7 +10015,7 @@ Since: 0.8
This function tries to "do what you mean" and tell you where the
actor is, prior to any transformations. Retrieves the fixed
position of an actor in pixels, if one has been set; otherwise, if
-the allocation is valid, returns the actor's allocated position;
+the allocation is valid, returns the actor's allocated position;
otherwise, returns 0,0.
The returned position is in pixels.
@@ -10209,10 +10106,10 @@ from the pool
<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
+<note><para>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;
+ marker_name </para></note>
Since: 0.8
@@ -10245,7 +10142,7 @@ objects it returns.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer container) (element-type GObject): a list of #GObject&lt;!-- --&gt;s,
+<return> (transfer container) (element-type GObject): a list of #GObject<!-- -->s,
or %NULL. The objects are owned by the #ClutterScript instance. Use g_list_free() on the
returned value when done.
@@ -10367,8 +10264,8 @@ Since: 0.8
<function name="clutter_get_default_frame_rate">
<description>
-Retrieves the default frame rate used when creating #ClutterTimeline&lt;!--
---&gt;s.
+Retrieves the default frame rate used when creating #ClutterTimeline<!--
+-->s.
This value is also used to compute the default frequency of motion
events.
@@ -10385,7 +10282,7 @@ Since: 0.6
<function name="clutter_actor_set_xu">
<description>
-Sets the actor's X coordinate, relative to its parent.
+Sets the actor's X coordinate, relative to its parent.
Overrides any layout manager and forces a fixed position for
the actor.
@@ -10399,7 +10296,32 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> the actor's position on the X axis, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> the actor's position on the X axis, in #ClutterUnit<!-- -->s
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_transformed_positionu">
+<description>
+Gets the absolute position of an actor, in #ClutterUnit<!-- -->s,
+relative to the stage.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> 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>
</parameter>
</parameters>
@@ -10441,16 +10363,20 @@ Since: 1.0
</return>
</function>
-<function name="ClutterModel">
+<function name="clutter_path_add_cairo_path">
<description>
-The ::filter-changed signal is emitted when a new filter has been applied
+Add the nodes of the Cairo path to the end of @path.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> the #ClutterModel on which the signal is emitted
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="cpath">
+<parameter_description> a Cairo path
</parameter_description>
</parameter>
</parameters>
@@ -10527,10 +10453,10 @@ member, or %NULL
<function name="clutter_color_equal">
<description>
-Compares two #ClutterColor&lt;!-- --&gt;s and checks if they are the same.
+Compares two #ClutterColor<!-- -->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.
+parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
</description>
@@ -10577,7 +10503,7 @@ Since: 0.8
<function name="clutter_units_pt">
<description>
-Converts a value in typographic points to #ClutterUnit&lt;!-- --&gt;s
+Converts a value in typographic points to #ClutterUnit<!-- -->s
at the current DPI.
@@ -10767,23 +10693,31 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_texture_get_max_tile_waste">
+<function name="clutter_model_get_iter_at_row">
<description>
-Gets the maximum waste that will be used when creating a texture or
--1 if slicing is disabled.
+Retrieves a #ClutterModelIter representing the row at the given index.
+
+If a filter function has been set using clutter_model_set_filter()
+then the @model implementation will return the first non filtered
+row.
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<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> The maximum waste or -1 if the texture waste is
-unlimited.
+<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.8
+Since: 0.6
</return>
</function>
@@ -10817,7 +10751,8 @@ Creates a new #JsonObject, an JSON object type representation.
<function name="clutter_model_get_last_iter">
<description>
-Retrieves a #ClutterModelIter representing the last row in @model.
+Retrieves a #ClutterModelIter representing the last non-filtered
+row in @model.
</description>
@@ -10827,8 +10762,8 @@ Retrieves a #ClutterModelIter representing the last row in @model.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full): A new #ClutterModelIter. Call g_object_unref() when
-done using it
+<return> (transfer full): A new #ClutterModelIter.
+Call g_object_unref() when done using it
Since: 0.6
</return>
@@ -10888,44 +10823,48 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_actor_get_rotationu">
+<function name="clutter_shader_set_fragment_source">
<description>
-Retrieves the angle and center of rotation on the given axis,
-set using clutter_actor_set_rotation().
-
-This function is the units based variant of clutter_actor_get_rotation().
+Sets the GLSL source code to be used by a #ClutterShader for the fragment
+program.
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
+<parameter name="data">
+<parameter_description> GLSL source code.
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> (out): return value for the X coordinate of the center of rotation,
-in #ClutterUnit&lt;!-- --&gt;s
+<parameter name="length">
+<parameter_description> length of source buffer (currently ignored)
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> (out): return value for the Y coordinate of the center of rotation,
-in #ClutterUnit&lt;!-- --&gt;s
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_name">
+<description>
+Sets the given name to @self. The name can be used to identify
+a #ClutterActor.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> (out): return value for the Z coordinate of the center of rotation,
-in #ClutterUnit&lt;!-- --&gt;s
+<parameter name="name">
+<parameter_description> Textual tag to apply to actor
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_model_iter_copy">
@@ -11171,6 +11110,27 @@ Since: 0.6
</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 #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="wc">
+<parameter_description> a Unicode character
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_list_model_newv">
<description>
Non-vararg version of clutter_list_model_new(). This function is
@@ -11362,24 +11322,24 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_text_get_color">
+<function name="clutter_texture_get_max_tile_waste">
<description>
-Retrieves the text color as set by clutter_text_get_color().
+Gets the maximum waste that will be used when creating a texture or
+-1 if slicing is disabled.
-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 name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The maximum waste or -1 if the texture waste is
+unlimited.
+
+Since: 0.8
+</return>
</function>
<function name="clutter_text_set_markup">
@@ -11403,13 +11363,44 @@ Since: 1.0
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> a string containing Pango markup. Passing %NULL is the same as passing "" (the empty string)
+<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_animation_bind">
+<description>
+Adds a single property with name @property_name to the
+animation @animation. For more information about animations,
+see clutter_actor_animate().
+
+This method returns the animation primarily to make chained
+calls convenient in language bindings.
+
+
+</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="final">
+<parameter_description> The final value of the property
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): The animation itself.
+Since: 1.0
+</return>
+</function>
+
<function name="json_object_remove_member">
<description>
Removes @member_name from @object, freeing its allocated resources.
@@ -11453,19 +11444,9 @@ Since: 0.8
<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.
+Creates a #GParamSpec for properties using #ClutterUnit<!-- -->s.
</description>
@@ -11552,7 +11533,7 @@ lock that when held, holds the Clutter lock as well. When Clutter
unlocks the Clutter lock when entering a recursive main loop, the
application must temporarily release its lock as well.
-Most threaded Clutter apps won't need to use this method.
+Most threaded Clutter apps won't need to use this method.
This method must be called before clutter_threads_init(), and cannot
be called multiple times.
@@ -11577,7 +11558,7 @@ Since: 0.4
<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.
+no longer needed it should be deref'd with cogl_handle_unref.
Since: 0.8
@@ -11625,6 +11606,24 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_actor_is_rotated">
+<description>
+Checks whether any rotation is applied to the actor.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the actor is rotated.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_events_pending">
<description>
Checks if events are pending in the event queue.
@@ -11639,16 +11638,28 @@ Since: 0.4
</return>
</function>
-<function name="clutter_main_level">
+<function name="clutter_actor_get_scale">
<description>
-Retrieves the depth of the Clutter mainloop.
+Retrieves an actors scale in floating point.
+Since: 0.2
</description>
<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="scale_x">
+<parameter_description> (out): Location to store horizonal float scale factor, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="scale_y">
+<parameter_description> (out): Location to store vertical float scale factor, or %NULL.
+</parameter_description>
+</parameter>
</parameters>
-<return> The level of the mainloop.
-</return>
+<return></return>
</function>
<function name="clutter_rectangle_get_color">
@@ -11671,8 +11682,8 @@ Retrieves the color of @rectangle.
<function name="clutter_behaviour_ellipse_set_angle_start">
<description>
-Sets the angle at which movement starts; angles &gt;= 360 degress get clamped
-to the canonical interval &lt;0, 360).
+Sets the angle at which movement starts; angles >= 360 degress get clamped
+to the canonical interval <0, 360).
Since: 0.6
@@ -11771,28 +11782,6 @@ Since: 0.8.4
<return></return>
</function>
-<function name="ClutterGroup">
-<description>
-The ::remove signal is emitted each time an actor has been removed
-from the group
-
- Deprecated: 0.4: This signal is deprecated, you should connect
-to the ClutterContainer::actor-removed signal instead
-
-</description>
-<parameters>
-<parameter name="group">
-<parameter_description> the #ClutterGroup that received the signal
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> the actor added to the group
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_timeline_add_marker_at_time">
<description>
Time-based variant of clutter_timeline_add_marker_at_frame().
@@ -11862,18 +11851,24 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_timeline_pause">
+<function name="clutter_actor_get_anchor_point_gravity">
<description>
-Pauses the #ClutterTimeline on current frame
+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="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #ClutterGravity used by the anchor point
+
+Since: 1.0
+</return>
</function>
<function name="clutter_shader_get_cogl_program">
@@ -11902,7 +11897,7 @@ 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
+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
@@ -11955,24 +11950,40 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_animation_set_duration">
+<function name="clutter_threads_init">
<description>
-Sets the duration of @animation in milliseconds.
+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: 1.0
+You must call g_thread_init() before this function.
+
+This function must be called before clutter_init().
+
+Since: 0.4
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
-</parameter_description>
-</parameter>
-<parameter name="msecs">
-<parameter_description> the duration in milliseconds
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_event_get_time">
+<description>
+Retrieves the time of the event.
+
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the time of the event, or %CLUTTER_CURRENT_TIME
+
+Since: 0.4
+</return>
</function>
<function name="ClutterAlpha">
@@ -12040,10 +12051,10 @@ Since: 1.0
<function name="clutter_actor_get_xu">
<description>
-Retrieves the X coordinate of a #ClutterActor, in #ClutterUnit&lt;!-- --&gt;s.
+Retrieves the X coordinate of a #ClutterActor, in #ClutterUnit<!-- -->s.
This function tries to "do what you mean", by returning the
-correct value depending on the actor's state.
+correct value depending on the actor's state.
If the actor has a valid allocation, this function will return
the X coordinate of the origin of the allocation box.
@@ -12063,7 +12074,7 @@ will return 0.
</parameter_description>
</parameter>
</parameters>
-<return> the X coordinate, in #ClutterUnit&lt;!-- --&gt;s, ignoring
+<return> the X coordinate, in #ClutterUnit<!-- -->s, ignoring
any transformation (i.e. scaling, rotation)
Since: 0.6
@@ -12104,6 +12115,51 @@ displayed.
<return></return>
</function>
+<function name="clutter_text_set_line_wrap">
+<description>
+Sets whether the contents of a #ClutterText actor should wrap,
+if they don't fit the size assigned to the actor.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="line_wrap">
+<parameter_description> whether the contents should wrap
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_set_selection_color">
+<description>
+Sets the color of the selection of a #ClutterText actor.
+
+If @color is %NULL, the selection color will be the same as the
+cursor color, or if no cursor color is set either then it will be
+the same as the text color.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> the color of the selection, or %NULL to unset it
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_backend_get_font_options">
<description>
Retrieves the font options for @backend.
@@ -12147,23 +12203,6 @@ Since: 1.0
</return>
</function>
-<function name="clutter_path_get_description">
-<description>
-Return value: a string description of the path. Free with g_free().
-
-</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
@@ -12184,7 +12223,7 @@ Since: 1.0
<function name="clutter_stage_unfullscreen">
<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,
+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.
@@ -12271,10 +12310,28 @@ Since: 0.2
<return></return>
</function>
+<function name="clutter_cairo_texture_clear">
+<description>
+Clears @self's internal drawing surface, so that the next upload
+will replace the previous contents of the #ClutterCairoTexture
+rather than adding to it.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_set_default_frame_rate">
<description>
-Sets the default frame rate to be used when creating #ClutterTimeline&lt;!--
---&gt;s
+Sets the default frame rate to be used when creating #ClutterTimeline<!--
+-->s
Since: 0.6
@@ -12322,44 +12379,22 @@ 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>
-
-<function name="clutter_group_raise">
+<function name="clutter_text_get_cursor_visible">
<description>
-Raises @actor to @sibling level in the depth ordering.
+Retrieves whether the cursor of a #ClutterText actor is visible.
-Deprecated: 0.6: Use clutter_container_raise_child() instead.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="sibling">
-<parameter_description> a #ClutterActor
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the cursor is visible
+
+Since: 1.0
+</return>
</function>
<function name="clutter_behaviour_set_alpha">
@@ -12435,7 +12470,7 @@ Check if clutter has debugging turned on.
<function name="clutter_behaviour_ellipse_set_angle_tiltx">
<description>
-Sets the angle at which the ellipse should be tilted around it's center.
+Sets the angle at which the ellipse should be tilted around it's center.
Since: 0.4
@@ -12545,18 +12580,6 @@ Since: 1.0
<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.
@@ -12617,7 +12640,7 @@ Since: 0.6
<function name="clutter_actor_get_transformed_sizeu">
<description>
-Gets the absolute size of an actor in #ClutterUnits&lt;!-- --&gt;s, taking
+Gets the absolute size of an actor in #ClutterUnits<!-- -->s, taking
into account the scaling factors.
If the actor has a valid allocation, the allocated size will be used.
@@ -12627,7 +12650,7 @@ 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
+<note>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
of the smallest rectangle that encapsulates the entire quad. Please
@@ -12635,7 +12658,7 @@ note that in this case no assumptions can be made about the relative
position of this envelope to the absolute position of the actor, as
returned by clutter_actor_get_transformed_position(); if you need this
information, you need to use clutter_actor_get_abs_allocation_vertices()
-to get the coords of the actual quadrangle.&lt;/note&gt;
+to get the coords of the actual quadrangle.</note>
Since: 0.8
@@ -12693,7 +12716,7 @@ resources.
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.
+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.
@@ -12721,9 +12744,9 @@ 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
+<warning><para>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;
+signal.</para></warning>
</description>
@@ -12780,7 +12803,7 @@ Since: 0.6
<description>
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.
+handle then you should call cogl_handle_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
@@ -12935,7 +12958,7 @@ owned by the actor and should not be modified or freed.
<function name="clutter_actor_set_widthu">
<description>
-Forces a width on an actor, causing the actor's preferred width
+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.
@@ -12949,31 +12972,54 @@ since: 0.6
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> Requested new width for the actor, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Requested new width for the actor, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_text_set_password_char">
+<function name="clutter_animation_new">
<description>
-Sets the character to use in place of the actual text in a
-password text actor.
+Creates a new #ClutterAnimation instance. You should set the
+#GObject to be animated using clutter_animation_set_object(),
+set the duration with clutter_animation_set_duration() and the
+easing mode using clutter_animation_set_mode().
-If @wc is 0 the text will be displayed as it is entered in the
-#ClutterText actor.
+Use clutter_animation_bind() or clutter_animation_bind_interval()
+to define the properties to be animated. The interval and the
+animated properties can be updated at runtime.
+
+The clutter_actor_animate() and relative family of functions provide
+an easy way to animate a #ClutterActor and automatically manage the
+lifetime of a #ClutterAnimation instance, so you should consider using
+those functions instead of manually creating an animation.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #ClutterAnimation. Use g_object_unref()
+to release the associated resources
+
+Since: 1.0
+</return>
+</function>
+
+<function name="clutter_path_add_node">
+<description>
+Adds @node to the end of the path.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character, or 0 to unset the password character
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</parameter_description>
</parameter>
</parameters>
@@ -13039,34 +13085,6 @@ Since: 0.6
<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>
-<return></return>
-</function>
-
<function name="clutter_x11_get_root_window">
<description>
Retrieves the root window.
@@ -13129,45 +13147,88 @@ Since: 0.6
</return>
</function>
-<function name="clutter_text_get_attributes">
+<function name="clutter_script_get_objects">
<description>
-Gets the attribute list that was set on the #ClutterText actor
-clutter_text_set_attributes(), if any.
+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:
+
+<informalexample><programlisting>
+GObject *my_label, *a_button, *main_timeline;
+
+clutter_script_get_objects (script,
+"my-label", &my_label,
+"a-button", &a_button,
+"main-timeline", &main_timeline,
+NULL);
+</programlisting></informalexample>
+
+Note: This function does not increment the reference count of the
+returned objects.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="first_name">
+<parameter_description> the name of the first object to retrieve
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> return location for a #GObject, then additional names, ending
+with %NULL
</parameter_description>
</parameter>
</parameters>
-<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.
+<return> the number of objects returned.
-Since: 1.0
+Since: 0.6
</return>
</function>
-<function name="json_object_get_members">
+<function name="clutter_path_add_curve_to">
<description>
-Retrieves all the names of the members of a #JsonObject. You can
-obtain the value for each member using json_object_get_member().
+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="object">
-<parameter_description> a #JsonObject
+<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> (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>
+<return></return>
</function>
<function name="clutter_model_insert">
@@ -13177,13 +13238,13 @@ values upon creation. For example, to insert a new row at index 100,
where column 0 is type %G_TYPE_INT and column 1 is of type
%G_TYPE_STRING:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
ClutterModel *model;
model = clutter_model_default_new (2,
G_TYPE_INT, "Score",
G_TYPE_STRING, "Team");
clutter_model_insert (model, 3, 0, 42, 1, "Team #1", -1);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
Since: 0.6
@@ -13243,21 +13304,16 @@ Shades @color by @factor and saves the modified color into @result.
<return></return>
</function>
-<function name="clutter_text_set_line_wrap">
+<function name="clutter_ungrab_pointer_for_device">
<description>
-Sets whether the contents of a #ClutterText actor should wrap,
-if they don't fit the size assigned to the actor.
+Removes an existing grab of the pointer events for device @id.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="line_wrap">
-<parameter_description> whether the contents should wrap
+<parameter name="id">
+<parameter_description> a device id
</parameter_description>
</parameter>
</parameters>
@@ -13416,13 +13472,13 @@ Creates and appends a new row to the #ClutterModel, setting the
row values upon creation. For example, to append a new row where
column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
ClutterModel *model;
model = clutter_model_default_new (2,
G_TYPE_INT, "Score",
G_TYPE_STRING, "Team");
clutter_model_append (model, 0, 42, 1, "Team #1", -1);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
Since: 0.6
@@ -13676,7 +13732,8 @@ Gets a groups child held at @index_ in stack.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): 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>
@@ -13728,7 +13785,7 @@ by the "fixed::" string, for instance:
|[
clutter_actor_animate (actor, CLUTTER_EASE_IN, 100,
"rotation-angle-z", 360,
-"fixed::rotation-center-z", &amp;center,
+"fixed::rotation-center-z", &center,
NULL);
]|
@@ -13741,16 +13798,36 @@ 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.
+If a name argument starts with "signal::" the two following arguments
+are used as callback function and userdata for a signal handler installed
+on the #ClutterAnimation object for the specified signal name, for
+instance:
+
+|[
+
+static void
+on_animation_completed (ClutterAnimation *animation,
+ClutterActor *actor)
+{
+clutter_actor_hide (actor);
+}
+
+clutter_actor_animate (actor, CLUTTER_EASE_IN, 100,
+"opacity", 0,
+"signal::completed", on_animation_completed, actor,
+NULL);
+]|
+
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,
+clutter_actor_animate (actor, CLUTTER_LINEAR, 250,
"width", 100,
"height", 100,
NULL);
-clutter_actor_animate (actor, 500, CLUTTER_EASE_IN_CUBIC,
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
"x", 100,
"y", 100,
"width", 200,
@@ -13760,7 +13837,7 @@ NULL);
is the equivalent of:
|[
-clutter_actor_animate (actor, 500, CLUTTER_EASE_IN_CUBIC,
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
"x", 100,
"y", 100,
"width", 200,
@@ -13768,9 +13845,51 @@ clutter_actor_animate (actor, 500, CLUTTER_EASE_IN_CUBIC,
NULL);
]|
-&lt;note&gt;Unless the animation is looping, it will become invalid as soon
+<note>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;
+returned value using g_object_ref(). If you want to keep the animation
+alive across multiple cycles, you also have to add a reference each
+time the #ClutterAnimation::completed signal is emitted.</note>
+
+Since the created #ClutterAnimation instance attached to @actor
+is guaranteed to be valid throughout the #ClutterAnimation::completed
+signal emission chain, you will not be able to create a new animation
+using clutter_actor_animate() on the same @actor from within the
+#ClutterAnimation::completed signal handler. Instead, you should use
+clutter_threads_add_idle() to install an idle handler and call
+clutter_actor_animate() in the handler, for instance:
+
+|[
+static gboolean
+queue_animation (gpointer data)
+{
+ClutterActor *actor = data;
+
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 250,
+"width", 200,
+"height", 200,
+NULL);
+
+return FALSE;
+}
+
+static void
+on_animation_completed (ClutterAnimation *animation)
+{
+clutter_threads_add_idle (queue_animation,
+clutter_animation_get_object (animation));
+}
+
+...
+animation = clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 250,
+"x", 100,
+"y", 100,
+NULL);
+g_signal_connect (animation, "completed",
+G_CALLBACK (on_animation_completed),
+NULL);
+...
+]|
</description>
@@ -13936,29 +14055,26 @@ if the actor is inside an invisible part of the scenegraph.
<return></return>
</function>
-<function name="clutter_threads_add_timeout">
+<function name="clutter_container_class_find_child_property">
<description>
-Simple wrapper around clutter_threads_add_timeout_full().
+Looks up the #GParamSpec for a child property of @klass.
</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 name="klass">
+<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="property_name">
+<parameter_description> a property name.
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
+<return> (transfer none): The #GParamSpec for the property or %NULL
+if no such property exist.
-Since: 0.4
+Since: 0.8
</return>
</function>
@@ -14012,38 +14128,65 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="anchor_x">
-<parameter_description> X coordinate of the anchor point, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> X coordinate of the anchor point, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="anchor_y">
-<parameter_description> Y coordinate of the anchor point, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Y coordinate of the anchor point, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_text_set_selection_bound">
+<function name="clutter_frame_source_add_full">
<description>
-Sets the other end of the selection, starting from the current
-cursor position.
+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.
-If @selection_bound is -1, the selection unset.
+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 1.0 / @fps *
+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: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<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="selection_bound">
-<parameter_description> the position of the end of the selection, in characters
+<parameter name="fps">
+<parameter_description> the number of times per second to call the function
+</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> 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_texture_set_from_rgb_data">
@@ -14099,25 +14242,27 @@ Since: 0.4.
</return>
</function>
-<function name="clutter_text_set_line_alignment">
+<function name="clutter_container_add">
<description>
-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.
-
-To align a #ClutterText actor you should add it to a container
-that supports alignment, or use the anchor point.
+Adds a list of #ClutterActor<!-- -->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: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="alignment">
-<parameter_description> A #PangoAlignment
+<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>
@@ -14190,30 +14335,6 @@ Since: 0.4
</return>
</function>
-<function name="clutter_cairo_texture_get_surface_size">
-<description>
-Retrieves the surface width and height for @self.
-
-Since: 1.0
-
-</description>
-<parameters>
-<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></return>
-</function>
-
<function name="clutter_actor_is_scaled">
<description>
Checks whether the actor is scaled in either dimension.
@@ -14269,25 +14390,33 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_score_list_timelines">
+<function name="ClutterActor">
<description>
-Retrieves a list of all the #ClutterTimelines managed by @score.
+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.
+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>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="actor">
+<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> (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>
+<return></return>
</function>
<function name="clutter_path_add_string">
@@ -14298,24 +14427,24 @@ 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;
+<variablelist>
+<varlistentry><term>M</term>
+<listitem><para>
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;
+</para></listitem></varlistentry>
+<varlistentry><term>L</term>
+<listitem><para>
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;
+</para></listitem></varlistentry>
+<varlistentry><term>C</term>
+<listitem><para>
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;
+</para></listitem></varlistentry>
+<varlistentry><term>z</term>
+<listitem><para>
Adds a %CLUTTER_PATH_CLOSE node. No coordinates are needed.
-&lt;/para&gt;&lt;/listitem&gt;&lt;/varlistentry&gt;
-&lt;/variablelist&gt;
+</para></listitem></varlistentry>
+</variablelist>
The M, L and C commands can also be specified in lower case which
means the coordinates are relative to the previous node.
@@ -14323,13 +14452,13 @@ 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;
+<informalexample>
+<programlisting>
M 250,350 l 0 -100 L 350,250 l 0 100 z
-&lt;/programlisting&gt;
-&lt;/informalexample&gt;
+</programlisting>
+</informalexample>
-If the path description isn't valid %FALSE will be returned and no
+If the path description isn't valid %FALSE will be returned and no
nodes will be added.
@@ -14378,18 +14507,6 @@ Since: 0.4
<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 #ClutterX11TexturePixmap bound to the given X Pixmap
@@ -14443,7 +14560,7 @@ Since: 0.8
<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.
+#JsonNode<!-- -->s.
</description>
@@ -14473,42 +14590,18 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_path_node_copy">
-<description>
-Makes an allocated copy of a node.
-
-
-</description>
-<parameters>
-<parameter name="node">
-<parameter_description> a #ClutterPathNode
-</parameter_description>
-</parameter>
-</parameters>
-<return> the copied node.
-
-Since: 1.0
-</return>
-</function>
-
-<function name="clutter_actor_get_anchor_point_gravity">
+<function name="clutter_timeline_pause">
<description>
-Retrieves the anchor position expressed as a #ClutterGravity. If
-the anchor point was specified using pixels or units this will
-return %CLUTTER_GRAVITY_NONE.
-
+Pauses the #ClutterTimeline on current frame
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> the #ClutterGravity used by the anchor point
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_model_iter_prev">
@@ -14532,27 +14625,9 @@ 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 on an actor, causing the actor's preferred width
+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.
@@ -14643,91 +14718,6 @@ current file contents. This operation is atomic.
</return>
</function>
-<function name="clutter_texture_new_from_actor">
-<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.
-
-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="actor">
-<parameter_description> A source #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return> A newly created #ClutterTexture object, or %NULL on failure.
-
-Since: 0.6
-</return>
-</function>
-
<function name="clutter_behaviour_ellipse_get_tiltx">
<description>
Gets the tilt of the ellipse around the center in Y axis.
@@ -14801,15 +14791,15 @@ Since: 0.6
<function name="clutter_actor_get_preferred_size">
<description>
Computes the preferred minimum and natural size of an actor, taking into
-account the actor's geometry management (either height-for-width
+account the actor's geometry management (either height-for-width
or width-for-height).
The width and height used to compute the preferred height and preferred
-width are the actor's natural ones.
+width are the actor's natural ones.
If you need to control the height for the preferred width, or the width for
the preferred height, you should use clutter_actor_get_preferred_width()
-and clutter_actor_get_preferred_height(), and check the actor's preferred
+and clutter_actor_get_preferred_height(), and check the actor's preferred
geometry management using the #ClutterActor:request-mode property.
Since: 0.8
@@ -14911,12 +14901,12 @@ is owned by the #JsonParser and should never be modified or freed.
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;
+<itemizedlist>
+<listitem><para>v[0] contains (x1, y1)</para></listitem>
+<listitem><para>v[1] contains (x2, y1)</para></listitem>
+<listitem><para>v[2] contains (x1, y2)</para></listitem>
+<listitem><para>v[3] contains (x2, y2)</para></listitem>
+</itemizedlist>
Since: 0.4
@@ -15007,8 +14997,8 @@ Connects all the signals defined into a UI definition file to their
handlers.
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.
+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 if #GModule is not supported by
the platform Clutter is running on.
@@ -15031,7 +15021,7 @@ Since: 0.6
<function name="clutter_actor_show">
<description>
-Flags an actor to be displayed. An actor that isn't shown will not
+Flags an actor to be displayed. An actor that isn't shown will not
be rendered on the stage.
Actors are visible by default.
@@ -15086,18 +15076,23 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_timeline_set_loop">
+<function name="clutter_animation_completed">
<description>
-Sets whether @timeline should loop.
+Emits the ::completed signal on @animation
+
+When using this function with a #ClutterAnimation created
+by the clutter_actor_animate() family of functions, @animation
+will be unreferenced and it will not be valid anymore,
+unless g_object_ref() was called before calling this function
+or unless a reference was taken inside a handler for the
+#ClutterAnimation::completed signal
+
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="loop">
-<parameter_description> %TRUE for enable looping
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
@@ -15146,41 +15141,42 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_group_remove">
+<function name="clutter_x11_has_xinput">
<description>
-Removes a child #ClutterActor from the parent #ClutterGroup.
+Gets whether Clutter has XInput support.
- Deprecated: 0.4: This function is obsolete, use
-clutter_container_remove_actor() instead.
</description>
<parameters>
-<parameter name="group">
-<parameter_description> A #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<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_threads_init">
+<function name="clutter_model_iter_set_value">
<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 data in the cell specified by @iter and @column. The type of
+ value must be convertable to the type of the column.
-Since: 0.4
+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>
@@ -15201,26 +15197,33 @@ Create a new #ClutterTimeline instance.
</parameter_description>
</parameter>
</parameters>
-<return> a new #ClutterTimeline
+<return> the newly created #ClutterTimeline instance. Use
+g_object_unref() when done using it
</return>
</function>
-<function name="clutter_actor_is_rotated">
+<function name="clutter_text_set_use_markup">
<description>
-Checks whether any rotation is applied to the actor.
+Sets whether the contents of the #ClutterText actor contains markup
+in <link linkend="PangoMarkupFormat">Pango's text markup language</link>.
+Setting #ClutterText:use-markup on an editable #ClutterText will
+make the actor discard any markup.
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE if the text should be parsed for markup.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor is rotated.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_x11_get_stage_visual">
@@ -15293,21 +15296,6 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_x11_has_xinput">
-<description>
-Gets whether Clutter has XInput support.
-
-
-</description>
-<parameters>
-</parameters>
-<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_glx_texture_pixmap_new_with_pixmap">
<description>
@@ -15338,7 +15326,8 @@ equivalent number of frames.
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterTimeline
+<return> the newly created #ClutterTimeline instance. Use
+g_object_unref() when done using it
Since: 0.6
</return>
@@ -15367,8 +15356,8 @@ Since: 0.6
Very fast fixed point implementation of square root for integers.
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;
+not a typo!) about 500x faster on ARM without FPU. It's error is < 5%
+for arguments < #COGL_SQRTI_ARG_5_PERCENT and < 10% for arguments <
#COGL_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
this function is COGL_SQRTI_ARG_MAX.
@@ -15389,7 +15378,7 @@ Since: 0.2
<function name="clutter_actor_set_geometry">
<description>
-Sets the actor's fixed position and forces its minimum and natural
+Sets the actor's fixed position and forces its minimum and natural
size, in pixels. This means the untransformed actor will have the
given geometry. This is the same as calling clutter_actor_set_position()
and clutter_actor_set_size().
@@ -15419,38 +15408,13 @@ Return value: Number of microseconds since clutter_init() was called.
</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
only be assumed valid inside a paint() method; anywhere else, it
may be out-of-date.
-An allocation does not incorporate the actor's scale or anchor point;
+An allocation does not incorporate the actor's scale or anchor point;
those transformations do not affect layout, only rendering.
The returned coordinates are in pixels.
@@ -15542,7 +15506,7 @@ Since: 1.0
<function name="clutter_behaviour_ellipse_set_angle_tilt">
<description>
-Sets the angle at which the ellipse should be tilted around it's center.
+Sets the angle at which the ellipse should be tilted around it's center.
Since: 0.4
@@ -15607,6 +15571,46 @@ with its reference count increased by one.
</return>
</function>
+<function name="clutter_actor_get_rotationu">
+<description>
+Retrieves the angle and center of rotation on the given axis,
+set using clutter_actor_set_rotation().
+
+This function is the units based variant of clutter_actor_get_rotation().
+
+
+</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> (out): return value for the X coordinate of the center of rotation,
+in #ClutterUnit<!-- -->s
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> (out): return value for the Y coordinate of the center of rotation,
+in #ClutterUnit<!-- -->s
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> (out): return value for the Z coordinate of the center of rotation,
+in #ClutterUnit<!-- -->s
+</parameter_description>
+</parameter>
+</parameters>
+<return> the angle of rotation
+
+Since: 0.8
+</return>
+</function>
+
<function name="clutter_container_lower_child">
<description>
Lowers @actor to @sibling level, in the depth ordering.
@@ -15643,50 +15647,36 @@ Creates a new empty #ClutterTexture object.
</return>
</function>
-<function name="clutter_text_set_use_markup">
+<function name="clutter_timeline_set_loop">
<description>
-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
+Sets whether @timeline should loop.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="setting">
-<parameter_description> %TRUE if the text should be parsed for markup.
+<parameter name="loop">
+<parameter_description> %TRUE for enable looping
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_raise">
+<function name="clutter_get_option_group_without_init">
<description>
-Puts @self above @below.
-
-Both actors must have the same parent.
-
-This function is the equivalent of clutter_container_raise_child().
+Return value: (transfer full): a #GOptionGroup for the commandline arguments
</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></return>
+<return> (transfer full): a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+Since: 0.8.2
+</return>
</function>
<function name="clutter_model_iter_set_valist">
@@ -15806,38 +15796,24 @@ Sets the stage perspective.
<return></return>
</function>
-<function name="clutter_behaviour_scale_set_boundsx">
+<function name="clutter_text_get_font_name">
<description>
-Fixed point version of clutter_behaviour_scale_set_bounds().
+Retrieves the font name as set by clutter_text_set_font_name().
-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_description>
-</parameter>
-<parameter name="y_scale_end">
-<parameter_description> final scale factor on the Y axis
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a string containing the font name. The returned
+string is owned by the #ClutterText actor and should not be
+modified or freed
+
+Since: 1.0
+</return>
</function>
<function name="clutter_actor_apply_relative_transform_to_point">
@@ -15925,6 +15901,29 @@ Since: 0.4
</return>
</function>
+<function name="clutter_actor_set_width">
+<description>
+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
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Requested new width for the actor, in pixels
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_text_get_ellipsize">
<description>
Return value: #PangoEllipsizeMode
@@ -15970,46 +15969,21 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_path_add_curve_to">
+<function name="clutter_model_get_filter_set">
<description>
-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
+Return value: %TRUE if a filter is set
</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 name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if a filter is set
+
+Since: 1.0
+</return>
</function>
<function name="clutter_get_font_map">
@@ -16063,20 +16037,22 @@ Retrieves the symbol of the key that caused @keyev.
</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="json_parser_load_from_file">
@@ -16158,23 +16134,20 @@ Shows the cursor on the stage window
<return></return>
</function>
-<function name="clutter_actor_should_pick_paint">
+<function name="clutter_actor_hide_all">
<description>
-Utility call for subclasses overiding the pick method.
-
-This function should never be called directly by applications.
+Calls clutter_actor_hide() on all child actors (if any).
+Since: 0.2
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor should paint its silhouette,
-%FALSE otherwise
-</return>
+<return></return>
</function>
<function name="clutter_timeline_skip">
@@ -16252,9 +16225,9 @@ column number followed by a place to store the value being retrieved. The
list is terminated by a -1.
For example, to get a value from column 0 with type %G_TYPE_STRING use:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
clutter_model_iter_get (iter, 0, &place_string_here, -1);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
where place_string_here is a gchar* to be filled with the string. If
appropriate, the returned values have to be freed or unreferenced.
@@ -16295,7 +16268,7 @@ Since: 0.4
<function name="clutter_actor_set_opacity">
<description>
-Sets the actor's opacity, with zero being completely transparent and
+Sets the actor's opacity, with zero being completely transparent and
255 (0xff) being fully opaque.
</description>
@@ -16364,29 +16337,12 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_shader_set_uniform_1f">
+<function name="JsonGenerator">
<description>
-Sets a user configurable variable in the shader programs attached
-to a #ClutterShader.
-
-Since: 0.6
-
-Deprecated: 1.0: Use clutter_shader_set_uniform() instead
+Number of spaces to be used to indent when pretty printing.
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> name of uniform in vertex or fragment program to set.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> the new value of the uniform.
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -16420,10 +16376,10 @@ Since: 0.8
<description>
Advance timeline to the requested frame number.
-&lt;note&gt;&lt;para&gt;The @timeline will not emit the #ClutterTimeline::new-frame
+<note><para>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;
+ frame_num </para></note>
</description>
<parameters>
@@ -16458,6 +16414,26 @@ Since: 1.0
</return>
</function>
+<function name="clutter_text_get_attributes">
+<description>
+Gets the attribute list that was set on the #ClutterText actor
+clutter_text_set_attributes(), if any.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<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="cogl_pango_render_layout_line">
<description>
Renders @line at the given coordinates using the given color.
@@ -16598,15 +16574,15 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> X coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> X coordinate of the rotation center, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> Y coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Y coordinate of the rotation center, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="z">
-<parameter_description> Z coordinate of the rotation center, in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> Z coordinate of the rotation center, in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -16632,7 +16608,7 @@ arguments.
</parameter_description>
</parameter>
</parameters>
-<return> 1 on success, &lt; 0 on failure.
+<return> 1 on success, < 0 on failure.
</return>
</function>
@@ -16909,7 +16885,7 @@ Since: 1.0
<function name="clutter_units_mm">
<description>
-Converts a value in millimeters to #ClutterUnit&lt;!-- --&gt;s at
+Converts a value in millimeters to #ClutterUnit<!-- -->s at
the current DPI.
@@ -16951,50 +16927,6 @@ 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.
@@ -17080,21 +17012,21 @@ Note: This function only works when the allocation is up-to-date, i.e. inside of
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> (in): 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<!-- -->s
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> (in): 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<!-- -->s
</parameter_description>
</parameter>
<parameter name="x_out">
<parameter_description> (out): return location for the unprojected x coordinance, in
-#ClutterUnit&lt;!-- --&gt;s
+#ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="y_out">
<parameter_description> (out): return location for the unprojected y coordinance, in
-#ClutterUnit&lt;!-- --&gt;s
+#ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -17104,25 +17036,16 @@ Since: 0.6
</return>
</function>
-<function name="clutter_actor_get_transformed_positionu">
+<function name="ClutterModel">
<description>
-Gets the absolute position of an actor, in #ClutterUnit&lt;!-- --&gt;s,
-relative to the stage.
+The ::filter-changed signal is emitted when a new filter has been applied
-Since: 0.8
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> 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 name="model">
+<parameter_description> the #ClutterModel on which the signal is emitted
</parameter_description>
</parameter>
</parameters>
@@ -17148,7 +17071,7 @@ Retrieves the #ClutterChildMeta which contains the data about the
</parameters>
<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
+container is not configured to provide #ClutterChildMeta<!-- -->s
Since: 0.8
</return>
@@ -17185,7 +17108,7 @@ Since: 1.0
<function name="clutter_actor_set_positionu">
<description>
-Sets the actor's position in #ClutterUnit&lt;!-- --&gt;s relative to any
+Sets the actor's position in #ClutterUnit<!-- -->s relative to any
parent actor.
If a layout manager is in use, this position will override the
@@ -17200,11 +17123,11 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> New left position of actor in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> New left position of actor in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> New top position of actor in #ClutterUnit&lt;!-- --&gt;s
+<parameter_description> New top position of actor in #ClutterUnit<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -17220,7 +17143,7 @@ detailed with the name of the marker as well, so it is
possible to connect a callback to the ::marker-reached signal
for a specific marker with:
-&lt;informalexample&gt;&lt;programlisting&gt;
+<informalexample><programlisting>
clutter_timeline_add_marker_at_frame (timeline, "foo", 24);
clutter_timeline_add_marker_at_frame (timeline, "bar", 48);
@@ -17230,7 +17153,7 @@ g_signal_connect (timeline, "marker-reached::foo",
G_CALLBACK (foo_marker_reached), NULL);
g_signal_connect (timeline, "marker-reached::bar",
G_CALLBACK (bar_marker_reached), NULL);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</programlisting></informalexample>
In the example, the first callback will be invoked for both
the "foo" and "bar" marker, while the second and third callbacks
@@ -17258,7 +17181,7 @@ Since: 0.8
<function name="clutter_actor_set_x">
<description>
-Sets the actor's X coordinate, relative to its parent, in pixels.
+Sets the actor's X coordinate, relative to its parent, in pixels.
Overrides any layout manager and forces a fixed position for
the actor.
@@ -17272,7 +17195,7 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> the actor's position on the X axis
+<parameter_description> the actor's position on the X axis
</parameter_description>
</parameter>
</parameters>
@@ -17281,7 +17204,7 @@ Since: 0.6
<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.
@@ -17295,7 +17218,7 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> the actor's position on the Y axis
+<parameter_description> the actor's position on the Y axis
</parameter_description>
</parameter>
</parameters>
@@ -17305,7 +17228,7 @@ Since: 0.6
<function name="clutter_behaviour_depth_new">
<description>
Creates a new #ClutterBehaviourDepth which can be used to control
-the ClutterActor:depth property of a set of #ClutterActor&lt;!-- --&gt;s.
+the ClutterActor:depth property of a set of #ClutterActor<!-- -->s.
</description>
@@ -17404,16 +17327,23 @@ Retrieves the #JsonArray stored inside a #JsonNode
</return>
</function>
-<function name="ClutterAnimation">
+<function name="clutter_model_iter_is_last">
<description>
-The #ClutterAlpha used by the animation.
+Gets whether the iterator is at the end of the model to which it
+belongs.
-Since: 1.0
</description>
<parameters>
+<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="ClutterAniamtion">
@@ -17421,6 +17351,9 @@ Since: 1.0
The ::completed signal is emitted once the animation has
been completed.
+The @animation instance is guaranteed to be valid for the entire
+duration of the signal emission chain.
+
Since: 1.0
</description>
@@ -17570,9 +17503,9 @@ Since: 0.6
<description>
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.
+pertaining Clutter's initialization process.
-If you are parsing the command line arguments by retrieving Clutter's
+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().
@@ -17614,29 +17547,6 @@ 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="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></return>
-</function>
-
<function name="clutter_text_get_selectable">
<description>
Retrieves whether a #ClutterText is selectable or not.
@@ -17814,21 +17724,31 @@ Since: 0.8
</return>
</function>
-<function name="clutter_event_get_time">
+<function name="clutter_timeline_get_delta">
<description>
-Retrieves the time of the event.
+Retrieves the number of frames and the amount of time elapsed since
+the last ClutterTimeline::new-frame signal.
+
+This function is only useful inside handlers for the ::new-frame
+signal, and its behaviour is undefined if the timeline is not
+playing.
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="msecs">
+<parameter_description> return location for the milliseconds elapsed since the last
+frame, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the time of the event, or %CLUTTER_CURRENT_TIME
+<return> the amount of frames elapsed since the last one
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -17868,19 +17788,20 @@ Create a new #ClutterGroup.
</return>
</function>
-<function name="clutter_text_get_cursor_visible">
+<function name="clutter_animation_get_mode">
<description>
-Retrieves whether the cursor of a #ClutterText actor is visible.
+Retrieves the animation mode of @animation, as set by
+clutter_animation_set_mode().
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the cursor is visible
+<return> the mode for the animation
Since: 1.0
</return>
@@ -18073,7 +17994,7 @@ Since: 0.4
<function name="clutter_actor_set_size">
<description>
-Sets the actor's size request in pixels. This overrides any
+Sets the actor's size request in pixels. This overrides any
"normal" size request the actor would have. For example
a text actor might normally request the size of the text;
this function would force a specific size instead.
@@ -18184,38 +18105,68 @@ count of the objects is increased.
</return>
</function>
-<function name="clutter_stage_hide_cursor">
+<function name="clutter_actor_allocate_preferred_size">
<description>
-Makes the cursor invisible on the stage window
+Allocates the natural size of @self.
-Since: 0.4
+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="stage">
-<parameter_description> a #ClutterStage
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<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_rectangle_new">
+<function name="clutter_frame_source_add">
<description>
-Creates a new #ClutterActor with a rectangular shape.
+Simple wrapper around clutter_frame_source_add_full().
</description>
<parameters>
+<parameter name="fps">
+<parameter_description> the number of times per second to call the function
+</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> a new #ClutterActor
+<return> the ID (greater than 0) of the event source.
+
+Since: 0.8
</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.
+verify whether it's a double click event or not.
Since: 0.4
@@ -18265,89 +18216,88 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_get_option_group">
+<function name="clutter_rectangle_new">
<description>
-Return value: (transfer full): a #GOptionGroup for the commandline arguments
+Creates a new #ClutterActor with a rectangular shape.
+
</description>
<parameters>
</parameters>
-<return> (transfer full): a #GOptionGroup for the commandline arguments
-recognized by Clutter
-
-Since: 0.2
+<return> a new #ClutterActor
</return>
</function>
-<function name="clutter_media_get_buffer_fill">
+<function name="clutter_path_get_length">
<description>
-Retrieves the amount of the stream that is buffered.
+Retrieves an approximation of the total length of the path.
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
</parameters>
-<return> the fill level, between 0.0 and 1.0
+<return> the length of the path.
Since: 1.0
</return>
</function>
-<function name="clutter_behaviour_path_get_path">
+<function name="clutter_media_get_buffer_fill">
<description>
-Get the current path of the behaviour
+Retrieves the amount of the stream that is buffered.
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehaviourPath instance
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the path
+<return> the fill level, between 0.0 and 1.0
Since: 1.0
</return>
</function>
-<function name="clutter_animation_get_mode">
+<function name="clutter_behaviour_path_get_path">
<description>
-Retrieves the animation mode of @animation, as set by
-clutter_animation_set_mode().
+Get the current path of the behaviour
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="pathb">
+<parameter_description> a #ClutterBehaviourPath instance
</parameter_description>
</parameter>
</parameters>
-<return> the mode for the animation
+<return> (transfer none): the path
Since: 1.0
</return>
</function>
-<function name="clutter_actor_hide_all">
+<function name="clutter_event_get_state">
<description>
-Calls clutter_actor_hide() on all child actors (if any).
+Retrieves the modifier state of the event.
-Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the modifier state parameter, or 0
+
+Since: 0.4
+</return>
</function>
<function name="clutter_value_set_unit">
@@ -18395,26 +18345,22 @@ Since: 1.0
<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>
@@ -18431,7 +18377,8 @@ Since: 1.0
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> the text to set. Passing %NULL is the same as passing "" (the empty string)
+<parameter_description> the text to set. Passing %NULL is the same as passing "" (the
+empty string)
</parameter_description>
</parameter>
</parameters>
@@ -18461,9 +18408,9 @@ Since: 1.0
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
+<warning><para>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;
+signal.</para></warning>
</description>
@@ -18578,25 +18525,44 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_shader_set_fragment_source">
+<function name="clutter_binding_pool_install_closure">
<description>
-Sets the GLSL source code to be used by a #ClutterShader for the fragment
-program.
+A #GClosure variant of clutter_binding_pool_install_action().
-Since: 0.6
+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="shader">
-<parameter_description> a #ClutterShader
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> GLSL source code.
+<parameter name="action_name">
+<parameter_description> the name of the action
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> length of source buffer (currently ignored)
+<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>
@@ -18673,7 +18639,7 @@ or %NULL
<function name="clutter_stage_fullscreen">
<description>
Asks to place the stage window in the fullscreen state. Note that you
-shouldn't assume the window is definitely full screen afterward, because
+shouldn't assume the window is definitely full screen afterward, because
other entities (e.g. the user or window manager) could unfullscreen it
again, and not all window managers honor requests to fullscreen windows.
@@ -18687,30 +18653,27 @@ again, and not all window managers honor requests to fullscreen windows.
<return></return>
</function>
-<function name="clutter_grab_keyboard">
+<function name="clutter_animation_has_property">
<description>
-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.
-
-Like pointer grabs, keyboard grabs should only be used as a last
-resource.
-
-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.
+Checks whether @animation is controlling @property_name.
-Since: 0.6
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the property is animated by the
+#ClutterAnimation, %FALSE otherwise
+
+Since: 1.0
+</return>
</function>
<function name="json_node_get_value">
@@ -18732,36 +18695,51 @@ using it, call g_value_unset() on the #GValue.
<return></return>
</function>
-<function name="clutter_texture_set_from_file">
+<function name="clutter_model_appendv">
<description>
-Sets the #ClutterTexture image data from an image file. In case of
-failure, %FALSE is returned and @error is set.
-
-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.
+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="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> The filename of the image in GLib file name encoding
+<parameter name="n_columns">
+<parameter_description> the number of columns and values
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for a #GError, or %NULL
+<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> %TRUE if the image was successfully loaded and set
+<return></return>
+</function>
-Since: 0.8
+<function name="clutter_actor_get_animation">
+<description>
+Retrieves the #ClutterAnimation used by @actor, if clutter_actor_animate()
+has been called on @actor.
+
+
+</description>
+<parameters>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): a #ClutterAnimation, or %NULL
+
+Since: 1.0
</return>
</function>
@@ -18772,9 +18750,9 @@ optionally depending on the specified height, or if they are
already computed, returns the cached values.
An actor may not get its request - depending on the layout
-manager that's in effect.
+manager that's in effect.
-A request should not incorporate the actor's scale or anchor point;
+A request should not incorporate the actor's scale or anchor point;
those transformations do not affect layout, only rendering.
Since: 0.8
@@ -18858,29 +18836,94 @@ Since: 1.0
</return>
</function>
-<function name="clutter_actor_get_opacity">
+<function name="clutter_texture_new_from_actor">
<description>
-Retrieves the opacity value of an actor, as set by
-clutter_actor_set_opacity().
+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.
-For retrieving the absolute opacity of the actor inside a paint
-virtual function, see clutter_actor_get_paint_opacity().
+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:
+
+<itemizedlist>
+<listitem>
+<para>The source actor must be made visible (i.e by calling
+#clutter_actor_show).</para>
+</listitem>
+<listitem>
+<para>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.</para>
+</listitem>
+<listitem>
+<para>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.</para>
+</listitem>
+<listitem>
+<para>Avoid reparenting the source with the created texture.</para>
+</listitem>
+<listitem>
+<para>A group can be padded with a transparent rectangle as to
+provide a border to contents for shader output (blurring text
+for example).</para>
+</listitem>
+<listitem>
+<para>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.</para>
+</listitem>
+<listitem>
+<para>Uploading pixel data to the texture (e.g by using
+clutter_actor_set_from_file()) will destroy the offscreen texture data
+and end redirection.</para>
+</listitem>
+<listitem>
+<para>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.</para>
+</listitem>
+</itemizedlist>
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="actor">
+<parameter_description> A source #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the opacity of the actor
+<return> A newly created #ClutterTexture object, or %NULL on failure.
+
+Since: 0.6
</return>
</function>
<function name="clutter_actor_get_pango_context">
<description>
-Retrieves the #PangoContext for @self. The actor's #PangoContext
+Retrieves the #PangoContext for @self. The actor's #PangoContext
is already configured using the appropriate font map, resolution
and font options.
diff --git a/clutter/src/clutter_methods.defs b/clutter/src/clutter_methods.defs
index 4626dce..73bae97 100644
--- a/clutter/src/clutter_methods.defs
+++ b/clutter/src/clutter_methods.defs
@@ -22,7 +22,7 @@
(define-object Animation
(in-module "Clutter")
- (parent "GInitiallyUnowned")
+ (parent "GObject")
(c-name "ClutterAnimation")
(gtype-id "CLUTTER_TYPE_ANIMATION")
)
@@ -264,7 +264,7 @@
(c-name "ClutterEventFlags")
(gtype-id "CLUTTER_TYPE_EVENT_FLAGS")
(values
- '("c" "CLUTTER_EVENT_FLAG_SYNTHETIC")
+ '("synthetic" "CLUTTER_EVENT_FLAG_SYNTHETIC")
)
)
@@ -457,8 +457,8 @@
(c-name "ClutterRotateDirection")
(gtype-id "CLUTTER_TYPE_ROTATE_DIRECTION")
(values
- '("w" "CLUTTER_ROTATE_CW")
- '("cw" "CLUTTER_ROTATE_CCW")
+ '("cw" "CLUTTER_ROTATE_CW")
+ '("ccw" "CLUTTER_ROTATE_CCW")
)
)
@@ -2356,6 +2356,94 @@
+;; From clutter-behaviour.h
+
+(define-function clutter_behaviour_get_type
+ (c-name "clutter_behaviour_get_type")
+ (return-type "GType")
+)
+
+(define-method apply
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_apply")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
+(define-method remove
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_remove")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
+(define-method remove_all
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_remove_all")
+ (return-type "none")
+)
+
+(define-method actors_foreach
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_actors_foreach")
+ (return-type "none")
+ (parameters
+ '("ClutterBehaviourForeachFunc" "func")
+ '("gpointer" "data")
+ )
+)
+
+(define-method get_n_actors
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_get_n_actors")
+ (return-type "gint")
+)
+
+(define-method get_nth_actor
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_get_nth_actor")
+ (return-type "ClutterActor*")
+ (parameters
+ '("gint" "index_")
+ )
+)
+
+(define-method get_actors
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_get_actors")
+ (return-type "GSList*")
+)
+
+(define-method get_alpha
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_get_alpha")
+ (return-type "ClutterAlpha*")
+)
+
+(define-method set_alpha
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_set_alpha")
+ (return-type "none")
+ (parameters
+ '("ClutterAlpha*" "alpha")
+ )
+)
+
+(define-method is_applied
+ (of-object "ClutterBehaviour")
+ (c-name "clutter_behaviour_is_applied")
+ (return-type "gboolean")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
+
+
;; From clutter-behaviour-opacity.h
(define-function clutter_behaviour_opacity_get_type
@@ -2657,94 +2745,6 @@
-;; From clutter-behaviour.h
-
-(define-function clutter_behaviour_get_type
- (c-name "clutter_behaviour_get_type")
- (return-type "GType")
-)
-
-(define-method apply
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_apply")
- (return-type "none")
- (parameters
- '("ClutterActor*" "actor")
- )
-)
-
-(define-method remove
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_remove")
- (return-type "none")
- (parameters
- '("ClutterActor*" "actor")
- )
-)
-
-(define-method remove_all
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_remove_all")
- (return-type "none")
-)
-
-(define-method actors_foreach
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_actors_foreach")
- (return-type "none")
- (parameters
- '("ClutterBehaviourForeachFunc" "func")
- '("gpointer" "data")
- )
-)
-
-(define-method get_n_actors
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_get_n_actors")
- (return-type "gint")
-)
-
-(define-method get_nth_actor
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_get_nth_actor")
- (return-type "ClutterActor*")
- (parameters
- '("gint" "index_")
- )
-)
-
-(define-method get_actors
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_get_actors")
- (return-type "GSList*")
-)
-
-(define-method get_alpha
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_get_alpha")
- (return-type "ClutterAlpha*")
-)
-
-(define-method set_alpha
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_set_alpha")
- (return-type "none")
- (parameters
- '("ClutterAlpha*" "alpha")
- )
-)
-
-(define-method is_applied
- (of-object "ClutterBehaviour")
- (c-name "clutter_behaviour_is_applied")
- (return-type "gboolean")
- (parameters
- '("ClutterActor*" "actor")
- )
-)
-
-
-
;; From clutter-binding-pool.h
(define-function clutter_binding_pool_get_type
@@ -2933,6 +2933,12 @@
)
)
+(define-method clear
+ (of-object "ClutterCairoTexture")
+ (c-name "clutter_cairo_texture_clear")
+ (return-type "none")
+)
+
(define-function clutter_cairo_set_source_color
(c-name "clutter_cairo_set_source_color")
(return-type "none")
@@ -3737,6 +3743,10 @@
+;; From clutter.h
+
+
+
;; From clutter-interval.h
(define-function clutter_interval_get_type
@@ -4516,6 +4526,12 @@
)
)
+(define-method get_filter_set
+ (of-object "ClutterModel")
+ (c-name "clutter_model_get_filter_set")
+ (return-type "gboolean")
+)
+
(define-method resort
(of-object "ClutterModel")
(c-name "clutter_model_resort")
@@ -5087,6 +5103,53 @@
+;; From clutter-scriptable.h
+
+(define-function clutter_scriptable_get_type
+ (c-name "clutter_scriptable_get_type")
+ (return-type "GType")
+)
+
+(define-method set_id
+ (of-object "ClutterScriptable")
+ (c-name "clutter_scriptable_set_id")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "id")
+ )
+)
+
+(define-method get_id
+ (of-object "ClutterScriptable")
+ (c-name "clutter_scriptable_get_id")
+ (return-type "const-gchar*")
+)
+
+(define-method parse_custom_node
+ (of-object "ClutterScriptable")
+ (c-name "clutter_scriptable_parse_custom_node")
+ (return-type "gboolean")
+ (parameters
+ '("ClutterScript*" "script")
+ '("GValue*" "value")
+ '("const-gchar*" "name")
+ '("JsonNode*" "node")
+ )
+)
+
+(define-method set_custom_property
+ (of-object "ClutterScriptable")
+ (c-name "clutter_scriptable_set_custom_property")
+ (return-type "none")
+ (parameters
+ '("ClutterScript*" "script")
+ '("const-gchar*" "name")
+ '("const-GValue*" "value")
+ )
+)
+
+
+
;; From clutter-script.h
(define-function clutter_script_error_quark
@@ -5223,129 +5286,6 @@
-;; From clutter-scriptable.h
-
-(define-function clutter_scriptable_get_type
- (c-name "clutter_scriptable_get_type")
- (return-type "GType")
-)
-
-(define-method set_id
- (of-object "ClutterScriptable")
- (c-name "clutter_scriptable_set_id")
- (return-type "none")
- (parameters
- '("const-gchar*" "id")
- )
-)
-
-(define-method get_id
- (of-object "ClutterScriptable")
- (c-name "clutter_scriptable_get_id")
- (return-type "const-gchar*")
-)
-
-(define-method parse_custom_node
- (of-object "ClutterScriptable")
- (c-name "clutter_scriptable_parse_custom_node")
- (return-type "gboolean")
- (parameters
- '("ClutterScript*" "script")
- '("GValue*" "value")
- '("const-gchar*" "name")
- '("JsonNode*" "node")
- )
-)
-
-(define-method set_custom_property
- (of-object "ClutterScriptable")
- (c-name "clutter_scriptable_set_custom_property")
- (return-type "none")
- (parameters
- '("ClutterScript*" "script")
- '("const-gchar*" "name")
- '("const-GValue*" "value")
- )
-)
-
-
-
-;; From clutter-shader-types.h
-
-(define-function clutter_shader_float_get_type
- (c-name "clutter_shader_float_get_type")
- (return-type "GType")
-)
-
-(define-function clutter_shader_int_get_type
- (c-name "clutter_shader_int_get_type")
- (return-type "GType")
-)
-
-(define-function clutter_shader_matrix_get_type
- (c-name "clutter_shader_matrix_get_type")
- (return-type "GType")
-)
-
-(define-function clutter_value_set_shader_float
- (c-name "clutter_value_set_shader_float")
- (return-type "none")
- (parameters
- '("GValue*" "value")
- '("gint" "size")
- '("const-gfloat*" "floats")
- )
-)
-
-(define-function clutter_value_set_shader_int
- (c-name "clutter_value_set_shader_int")
- (return-type "none")
- (parameters
- '("GValue*" "value")
- '("gint" "size")
- '("const-gint*" "ints")
- )
-)
-
-(define-function clutter_value_set_shader_matrix
- (c-name "clutter_value_set_shader_matrix")
- (return-type "none")
- (parameters
- '("GValue*" "value")
- '("gint" "size")
- '("const-gfloat*" "matrix")
- )
-)
-
-(define-function clutter_value_get_shader_float
- (c-name "clutter_value_get_shader_float")
- (return-type "const-gfloat*")
- (parameters
- '("const-GValue*" "value")
- '("gsize*" "length")
- )
-)
-
-(define-function clutter_value_get_shader_int
- (c-name "clutter_value_get_shader_int")
- (return-type "const-COGLint*")
- (parameters
- '("const-GValue*" "value")
- '("gsize*" "length")
- )
-)
-
-(define-function clutter_value_get_shader_matrix
- (c-name "clutter_value_get_shader_matrix")
- (return-type "const-gfloat*")
- (parameters
- '("const-GValue*" "value")
- '("gsize*" "length")
- )
-)
-
-
-
;; From clutter-shader.h
(define-function clutter_shader_error_quark
@@ -5462,37 +5402,78 @@
-;; From clutter-stage-manager.h
+;; From clutter-shader-types.h
-(define-function clutter_stage_manager_get_type
- (c-name "clutter_stage_manager_get_type")
+(define-function clutter_shader_float_get_type
+ (c-name "clutter_shader_float_get_type")
(return-type "GType")
)
-(define-function clutter_stage_manager_get_default
- (c-name "clutter_stage_manager_get_default")
- (return-type "ClutterStageManager*")
+(define-function clutter_shader_int_get_type
+ (c-name "clutter_shader_int_get_type")
+ (return-type "GType")
)
-(define-method set_default_stage
- (of-object "ClutterStageManager")
- (c-name "clutter_stage_manager_set_default_stage")
+(define-function clutter_shader_matrix_get_type
+ (c-name "clutter_shader_matrix_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_value_set_shader_float
+ (c-name "clutter_value_set_shader_float")
(return-type "none")
(parameters
- '("ClutterStage*" "stage")
+ '("GValue*" "value")
+ '("gint" "size")
+ '("const-gfloat*" "floats")
)
)
-(define-method get_default_stage
- (of-object "ClutterStageManager")
- (c-name "clutter_stage_manager_get_default_stage")
- (return-type "ClutterStage*")
+(define-function clutter_value_set_shader_int
+ (c-name "clutter_value_set_shader_int")
+ (return-type "none")
+ (parameters
+ '("GValue*" "value")
+ '("gint" "size")
+ '("const-gint*" "ints")
+ )
)
-(define-method list_stages
- (of-object "ClutterStageManager")
- (c-name "clutter_stage_manager_list_stages")
- (return-type "GSList*")
+(define-function clutter_value_set_shader_matrix
+ (c-name "clutter_value_set_shader_matrix")
+ (return-type "none")
+ (parameters
+ '("GValue*" "value")
+ '("gint" "size")
+ '("const-gfloat*" "matrix")
+ )
+)
+
+(define-function clutter_value_get_shader_float
+ (c-name "clutter_value_get_shader_float")
+ (return-type "const-gfloat*")
+ (parameters
+ '("const-GValue*" "value")
+ '("gsize*" "length")
+ )
+)
+
+(define-function clutter_value_get_shader_int
+ (c-name "clutter_value_get_shader_int")
+ (return-type "const-gint*")
+ (parameters
+ '("const-GValue*" "value")
+ '("gsize*" "length")
+ )
+)
+
+(define-function clutter_value_get_shader_matrix
+ (c-name "clutter_value_get_shader_matrix")
+ (return-type "const-gfloat*")
+ (parameters
+ '("const-GValue*" "value")
+ '("gsize*" "length")
+ )
)
@@ -5720,6 +5701,41 @@
+;; From clutter-stage-manager.h
+
+(define-function clutter_stage_manager_get_type
+ (c-name "clutter_stage_manager_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_stage_manager_get_default
+ (c-name "clutter_stage_manager_get_default")
+ (return-type "ClutterStageManager*")
+)
+
+(define-method set_default_stage
+ (of-object "ClutterStageManager")
+ (c-name "clutter_stage_manager_set_default_stage")
+ (return-type "none")
+ (parameters
+ '("ClutterStage*" "stage")
+ )
+)
+
+(define-method get_default_stage
+ (of-object "ClutterStageManager")
+ (c-name "clutter_stage_manager_get_default_stage")
+ (return-type "ClutterStage*")
+)
+
+(define-method list_stages
+ (of-object "ClutterStageManager")
+ (c-name "clutter_stage_manager_list_stages")
+ (return-type "GSList*")
+)
+
+
+
;; From clutter-text.h
(define-function clutter_text_get_type
@@ -6107,6 +6123,30 @@
(return-type "gchar*")
)
+(define-method set_selection_color
+ (of-object "ClutterText")
+ (c-name "clutter_text_set_selection_color")
+ (return-type "none")
+ (parameters
+ '("const-ClutterColor*" "color")
+ )
+)
+
+(define-method get_selection_color
+ (of-object "ClutterText")
+ (c-name "clutter_text_get_selection_color")
+ (return-type "none")
+ (parameters
+ '("ClutterColor*" "color")
+ )
+)
+
+(define-method delete_selection
+ (of-object "ClutterText")
+ (c-name "clutter_text_delete_selection")
+ (return-type "gboolean")
+)
+
(define-method set_password_char
(of-object "ClutterText")
(c-name "clutter_text_set_password_char")
@@ -6158,6 +6198,18 @@
(return-type "gboolean")
)
+(define-method position_to_coords
+ (of-object "ClutterText")
+ (c-name "clutter_text_position_to_coords")
+ (return-type "gboolean")
+ (parameters
+ '("gint" "position")
+ '("gfloat*" "x")
+ '("gfloat*" "y")
+ '("gfloat*" "line_height")
+ )
+)
+
;; From clutter-texture.h
@@ -6751,7 +6803,3 @@
;; From clutter-version.h
-
-;; From clutter.h
-
-
diff --git a/clutter/src/clutter_signals.defs b/clutter/src/clutter_signals.defs
index 08f4552..e754398 100644
--- a/clutter/src/clutter_signals.defs
+++ b/clutter/src/clutter_signals.defs
@@ -579,6 +579,12 @@
(when "last")
)
+(define-signal started
+ (of-object "ClutterAnimation")
+ (return-type "void")
+ (when "last")
+)
+
(define-property object
(of-object "ClutterAnimation")
(prop-type "GParamObject")
@@ -2315,66 +2321,66 @@
)
)
-(define-property buffer-fill
+(define-property progress
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "The fill level of the buffer")
+ (docs "Current progress of the playback")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
-(define-property duration
+(define-property audio-volume
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "The duration of the stream, in seconds")
+ (docs "The volume of the audio")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
-(define-property can-seek
+(define-property playing
(of-object "ClutterMedia")
(prop-type "GParamBoolean")
- (docs "Whether the current stream is seekable")
+ (docs "Wheter the actor is playing")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
-(define-property progress
+(define-property buffer-fill
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "Current progress of the playback")
+ (docs "The fill level of the buffer")
(readable #t)
- (writable #t)
+ (writable #f)
(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)
)
-(define-property uri
+(define-property duration
(of-object "ClutterMedia")
- (prop-type "GParamString")
- (docs "URI of a media file")
+ (prop-type "GParamDouble")
+ (docs "The duration of the stream, in seconds")
(readable #t)
- (writable #t)
+ (writable #f)
(construct-only #f)
)
-(define-property playing
+(define-property can-seek
(of-object "ClutterMedia")
(prop-type "GParamBoolean")
- (docs "Wheter the actor is playing")
+ (docs "Whether the current stream is seekable")
(readable #t)
- (writable #t)
+ (writable #f)
(construct-only #f)
)
@@ -3849,6 +3855,24 @@
(construct-only #f)
)
+(define-property selection-color
+ (of-object "ClutterText")
+ (prop-type "ClutterParamSpecColor")
+ (docs "Selection Color")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property selection-color-set
+ (of-object "ClutterText")
+ (prop-type "GParamBoolean")
+ (docs "Whether the selection color has been set")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property cursor-visible
(of-object "ClutterText")
(prop-type "GParamBoolean")
diff --git a/clutter/src/text.ccg b/clutter/src/text.ccg
index 2181065..0215c02 100644
--- a/clutter/src/text.ccg
+++ b/clutter/src/text.ccg
@@ -27,4 +27,11 @@ Color Text::get_color() const
return color;
}
+Color Text::get_selection_color() const
+{
+ Color color;
+ clutter_text_get_selection_color(const_cast<ClutterText*>(gobj()), color.gobj());
+ return color;
+}
+
} // namespace Clutter
diff --git a/clutter/src/text.hg b/clutter/src/text.hg
index 0d99087..cd10ab0 100644
--- a/clutter/src/text.hg
+++ b/clutter/src/text.hg
@@ -92,6 +92,11 @@ public:
_WRAP_METHOD(void set_selection_bound(int selection_bound), clutter_text_set_selection_bound)
_WRAP_METHOD(int get_selection_bound() const, clutter_text_get_selection_bound)
+ _WRAP_METHOD(void set_selection_color(const Color& color), clutter_text_set_selection_color)
+ _WRAP_METHOD_DOCS_ONLY(clutter_text_get_selection_color)
+ Color get_selection_color() const;
+ _IGNORE(clutter_text_get_color)
+
_WRAP_METHOD(void set_single_line_mode(bool single_line=true), clutter_text_set_single_line_mode)
_WRAP_METHOD(bool get_single_line_mode() const, clutter_text_get_single_line_mode)
@@ -106,6 +111,7 @@ public:
_WRAP_METHOD(void delete_chars(guint len), clutter_text_delete_chars)
_WRAP_METHOD(void delete_text(gssize start_pos, gssize end_pos), clutter_text_delete_text)
+ _WRAP_METHOD(bool delete_selection(), clutter_text_delete_selection)
_WRAP_METHOD(Glib::ustring get_chars(gssize start_pos, gssize end_pos) const, clutter_text_get_chars)
@@ -123,31 +129,36 @@ public:
_WRAP_METHOD(bool activate(), clutter_text_activate)
+ _WRAP_METHOD(bool position_to_coords(int position, float &x, float &y, float &line_height), clutter_text_position_to_coords)
+
_WRAP_SIGNAL(void activate(), "activate")
_WRAP_SIGNAL(void text_changed(), "text_changed")
_WRAP_SIGNAL(void cursor_event(const Geometry& geometry), "cursor_event")
- _WRAP_PROPERTY("font-name", Glib::ustring)
- _WRAP_PROPERTY("text", Glib::ustring)
- _WRAP_PROPERTY("color", Color)
- _WRAP_PROPERTY("editable", bool)
- _WRAP_PROPERTY("selectable", bool)
_WRAP_PROPERTY("activatable", bool)
- _WRAP_PROPERTY("cursor-visible", bool)
+ _WRAP_PROPERTY("attributes", Pango::AttrList)
+ _WRAP_PROPERTY("color", Color)
_WRAP_PROPERTY("cursor-color", Color)
_WRAP_PROPERTY("cursor-color-set", bool)
_WRAP_PROPERTY("cursor-size", int)
- _WRAP_PROPERTY("position", int)
- _WRAP_PROPERTY("selection-bound", int)
- _WRAP_PROPERTY("attributes", Pango::AttrList)
- _WRAP_PROPERTY("use-markup", bool)
- _WRAP_PROPERTY("line-wrap", bool)
- _WRAP_PROPERTY("line-wrap-mode", Pango::WrapMode)
+ _WRAP_PROPERTY("cursor-visible", bool)
+ _WRAP_PROPERTY("editable", bool)
_WRAP_PROPERTY("ellipsize", Pango::EllipsizeMode)
+ _WRAP_PROPERTY("font-name", Glib::ustring)
_WRAP_PROPERTY("justify", bool)
- _WRAP_PROPERTY("password-char", gunichar)
+ _WRAP_PROPERTY("line-alignment", Pango::Alignment)
+ _WRAP_PROPERTY("line-wrap-mode", Pango::WrapMode)
+ _WRAP_PROPERTY("line-wrap", bool)
_WRAP_PROPERTY("max-length", int)
+ _WRAP_PROPERTY("password-char", gunichar)
+ _WRAP_PROPERTY("position", int)
+ _WRAP_PROPERTY("selectable", bool)
+ _WRAP_PROPERTY("selection-bound", int)
+ _WRAP_PROPERTY("selection-color", Color)
+ _WRAP_PROPERTY("selection-color-set", bool)
_WRAP_PROPERTY("single-line-mode", bool)
+ _WRAP_PROPERTY("text", Glib::ustring)
+ _WRAP_PROPERTY("use-markup", bool)
};
} // namespace Clutter
diff --git a/configure.in b/configure.in
index b11b2e0..382c3b3 100644
--- a/configure.in
+++ b/configure.in
@@ -5,7 +5,7 @@ AC_INIT(clutter/cluttermmconfig.h.in)
#########################################################################
CLUTTERMM_MAJOR_VERSION=0
CLUTTERMM_MINOR_VERSION=9
-CLUTTERMM_MICRO_VERSION=0
+CLUTTERMM_MICRO_VERSION=3
#
# +1 : ? : +1 == new interface that does not break old one
@@ -74,7 +74,7 @@ AC_CHECK_PROGS(PERL, perl5 perl)
# Note: We depend on cairomm only because pangomm depends on it
# (but it was not in the pangomm .pc file until recently).
PKG_CHECK_MODULES(CLUTTERMM,
- [clutter-0.9 >= 0.9.1
+ [clutter-0.9 >= 0.9.3
glibmm-2.4 >= 2.14
pangomm-1.4 >= 2.12
cairomm-1.0])
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
