gnomemm r1287 - in cluttermm/trunk: . clutter/src tools/m4
- From: jjongsma svn gnome org
- To: svn-commits-list gnome org
- Subject: gnomemm r1287 - in cluttermm/trunk: . clutter/src tools/m4
- Date: Sun, 20 Jan 2008 04:33:52 +0000 (GMT)
Author: jjongsma
Date: Sun Jan 20 04:33:51 2008
New Revision: 1287
URL: http://svn.gnome.org/viewvc/gnomemm?rev=1287&view=rev
Log:
* clutter/src/clutter_docs.xml: re-generated documentation
* clutter/src/stage.hg: wrapped missing functions
* clutter/src/timeline.hg: wrapped missing functions
* tools/m4/convert_cluttermm.m4: moved a conversion to the source file
Modified:
cluttermm/trunk/ChangeLog
cluttermm/trunk/clutter/src/clutter_docs.xml
cluttermm/trunk/clutter/src/stage.hg
cluttermm/trunk/clutter/src/timeline.hg
cluttermm/trunk/tools/m4/convert_cluttermm.m4
Modified: cluttermm/trunk/clutter/src/clutter_docs.xml
==============================================================================
--- cluttermm/trunk/clutter/src/clutter_docs.xml (original)
+++ cluttermm/trunk/clutter/src/clutter_docs.xml Sun Jan 20 04:33:51 2008
@@ -1,111 +1,76 @@
<root>
-<function name="clutter_eglx_get_stage_visual">
+<function name="CLUTTER_ACTOR_IS_REALIZED">
<description>
-FIXME
+Evaluates to %TRUE if the %CLUTTER_ACTOR_REALIZED flag is set.
+Since: 0.2
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="e">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> FIXME
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_label_get_alignment">
+<function name="clutter_event_get">
<description>
-Return value: The labels #PangoAlignment
+Pops an event off the event queue. Applications should not need to call
+this.
+
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
-</parameter_description>
-</parameter>
</parameters>
-<return> The labels #PangoAlignment
+<return> A #ClutterEvent or NULL if queue empty
-Since 0.2
+Since: 0.4
</return>
</function>
-<function name="clutter_layout_natural_request">
+<function name="clutter_score_append">
<description>
-Queries a #ClutterLayout actor for its natural (default) width
-and height.
+Appends a timeline to another one existing in the score; the newly
+appended timeline will be started when @parent is complete.
+
+If @parent is %NULL, the new #ClutterTimeline will be started when
+clutter_score_start() is called.
+
+#ClutterScore will take a reference on @timeline.
-Since: 0.4
</description>
<parameters>
-<parameter name="layout">
-<parameter_description> a #ClutterLayout
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> return location for the natural width
+<parameter name="parent">
+<parameter_description> a #ClutterTimeline in the score or %NULL
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> return location for the natural height
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="ClutterLayout">
-<description>
-The layout types that the #ClutterLayout supports.
-
-Since: 0.4
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_event_get">
-<description>
-Pops an event off the event queue. Applications should not need to call
-this.
-
-
-</description>
-<parameters>
-</parameters>
-<return> A #ClutterEvent or NULL if queue empty
+<return> the id of the newly added timeline, to be used with
+clutter_score_get_timeline() and clutter_score_remove().
-Since: 0.4
+Since: 0.6
</return>
</function>
-<function name="clutter_score_append">
+<function name="ClutterModelIter">
<description>
-Appends a new timeline to an one existing in the score.
+The row number to which this iter points to.
+Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
-</parameter_description>
-</parameter>
-<parameter name="timeline_existing">
-<parameter_description> A #ClutterTimeline in the score
-</parameter_description>
-</parameter>
-<parameter name="timeline_new">
-<parameter_description> A new #ClutterTimeline to start when #timeline_existing has
-completed,
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -131,6 +96,23 @@
</return>
</function>
+<function name="clutter_label_get_alignment">
+<description>
+Return value: The labels #PangoAlignment
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #ClutterLabel
+</parameter_description>
+</parameter>
+</parameters>
+<return> The labels #PangoAlignment
+
+Since 0.2
+</return>
+</function>
+
<function name="json_generator_to_file">
<description>
Creates a JSON data stream and puts it inside @filename, overwriting the
@@ -174,6 +156,18 @@
<return></return>
</function>
+<function name="CLUTTER_ALPHA_RAMP">
+<description>
+Convenience symbol for clutter_ramp_func().
+
+Since: 0.2
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_stage_get_actor_at_pos">
<description>
Checks the scene at the coordinates @x and @y and returns a pointer
@@ -250,24 +244,45 @@
<return></return>
</function>
-<function name="clutter_actor_get_rxang">
+<function name="clutter_stage_get_use_fog">
<description>
-Gets the angle of rotation around the X axis.
+Gets whether the depth cueing effect is enabled on @stage.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="stage">
+<parameter_description> the #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation
+<return> %TRUE if the the depth cueing effect is enabled
-Since: 0.4
+Since: 0.6
</return>
</function>
+<function name="clutter_stage_get_fogx">
+<description>
+Retrieves the current depth cueing settings from the stage. This is the
+fixed point version of clutter_stage_get_fog().
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="fog">
+<parameter_description> return location for a #ClutterFog structure
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_alpha_set_timeline">
<description>
Binds @alpha to @timeline.
@@ -288,33 +303,21 @@
<return></return>
</function>
-<function name="clutter_actor_set_scale_with_gravityx">
+<function name="clutter_entry_get_visibility">
<description>
-Scales the actor by scale_x, scale_y taking into consideration the
-required gravity.
-
-Since: 0.4
+Return value: TRUE if the contents of the entry are displayed as plaintext.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="scale_x">
-<parameter_description> #ClutterFixed scaling factor for x axis
-</parameter_description>
-</parameter>
-<parameter name="scale_y">
-<parameter_description> #ClutterFixed scaling factor for y axis
-</parameter_description>
-</parameter>
-<parameter name="gravity">
-<parameter_description> #ClutterGravity to apply to scaling.
+<parameter name="entry">
+<parameter_description> a #ClutterEntry
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> TRUE if the contents of the entry are displayed as plaintext.
+
+Since: 0.4
+</return>
</function>
<function name="clutter_actor_get_abs_position">
@@ -340,25 +343,68 @@
<return></return>
</function>
-<function name="clutter_color_darken">
+<function name="clutter_actor_set_clipu">
<description>
-Darkens @src by a fixed amount, and saves the changed color
-in @dest.
+Unit-based variant of clutter_actor_set_clip()
+
+Sets clip area for @self. The clip area is always computed from the
+upper left corner of the actor, even if the anchor point is set
+otherwise.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="src">
-<parameter_description> a #ClutterColor
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="dest">
-<parameter_description> return location for the darker color
+<parameter name="xoff">
+<parameter_description> X offset of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="yoff">
+<parameter_description> Y offset of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height of the clip rectangle, in #ClutterUnit&lt;!-- --&gt;s
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="ClutterBehaviourDepth">
+<description>
+End depth level to apply to the actors.
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_get_keyboard_grab">
+<description>
+Queries the current keyboard grab of clutter.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the actor currently holding the keyboard grab, or NULL if there is no grab.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_timeout_pool_new">
<description>
Creates a new timeout pool source. A timeout pool should be used when
@@ -409,6 +455,18 @@
<return></return>
</function>
+<function name="CLUTTER_ALPHA_SINE_HALF">
+<description>
+Convenience symbol for clutter_sine_half_func().
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_alpha_new">
<description>
Creates a new #ClutterAlpha instance. You must set a function
@@ -535,24 +593,16 @@
<return></return>
</function>
-<function name="clutter_group_get_children">
+<function name="CLUTTER_ALPHA_RAMP_INC">
<description>
-Get a list containing all actors contained in the group.
+Convenience symbol for clutter_ramp_inc_func().
+Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterGroup
-</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>
+<return></return>
</function>
<function name="clutter_effect_template_new">
@@ -585,6 +635,25 @@
</return>
</function>
+<function name="clutter_scriptable_get_id">
+<description>
+Retrieves the id of @scriptable set using clutter_scriptable_set_id().
+
+
+</description>
+<parameters>
+<parameter name="scriptable">
+<parameter_description> a #ClutterScriptable
+</parameter_description>
+</parameter>
+</parameters>
+<return> the id of the object. The returned string is owned by
+the scriptable object and should never be modified of freed
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_behaviour_remove_all">
<description>
Removes every actor from the list that @behave holds.
@@ -641,67 +710,91 @@
</return>
</function>
-<function name="clutter_hbox_new">
+<function name="clutter_shader_get_fragment_source">
<description>
-Creates a new horizontal layout box.
+FIXME
</description>
<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #ClutterHBox
+<return> the source of the fragment shader for this ClutterShader object
+or %NULL. The returned string is owned by the shader object and should never
+be modified or freed
-Since: 0.4
+Since: 0.6
</return>
</function>
-<function name="clutter_actor_get_rzang">
+<function name="clutter_actor_hide">
<description>
-Gets the angle of rotation around the Z axis.
-
+Flags a clutter actor to be hidden. An actor not shown will not
+appear on the display.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_entry_get_visible_cursor">
+<function name="clutter_set_motion_events_enabled">
<description>
-Return value: whether the input cursor is visible
+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;
+
+Since: 0.6
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="enable">
+<parameter_description> %TRUE to enable per-actor motion events
</parameter_description>
</parameter>
</parameters>
-<return> whether the input cursor is visible
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_glx_get_stage_visual">
+<function name="ClutterLabel">
<description>
-Return value: The XVisualInfo for the stage.
+Whether the contents of the label should be justified on both
+margins.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_entry_get_visible_cursor">
+<description>
+Return value: whether the input cursor is visible
+
+</description>
+<parameters>
+<parameter name="entry">
+<parameter_description> a #ClutterEntry
</parameter_description>
</parameter>
</parameters>
-<return> The XVisualInfo for the stage.
+<return> whether the input cursor is visible
Since: 0.4
</return>
@@ -745,6 +838,26 @@
</return>
</function>
+<function name="clutter_actor_set_heightu">
+<description>
+Requests a new height for actor
+
+since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Requested new height for actor in #ClutterUnit
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_effect_template_set_timeline_clone">
<description>
Sets if effects using this template should make a copy of the
@@ -793,63 +906,91 @@
</return>
</function>
-<function name="clutter_scriptable_set_name">
+<function name="clutter_actor_get_clip">
<description>
-Sets @name as the name for this instance of #ClutterScriptableIface.
-This name can be used by user interface designer applications.
+Gets the clip area for @self, in pixels.
Since: 0.6
</description>
<parameters>
-<parameter name="scriptable">
-<parameter_description> a #ClutterScriptable
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name of the object
+<parameter name="xoff">
+<parameter_description> return location for the X offset of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="yoff">
+<parameter_description> return location for the Y offset of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the width of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the height of the clip rectangle, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_box_pack_defaults">
+<function name="clutter_entry_get_max_length">
<description>
-Packs @actor into @box, using the default settings for the
-pack type and padding.
+Gets the maximum length of text that can be set into @entry.
+See clutter_entry_set_max_length().
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
+<parameter name="entry">
+<parameter_description> a #ClutterEntry
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+</parameters>
+<return> the maximum number of characters.
+
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_feature_available">
+<description>
+Checks whether @feature is available. @feature can be a logical
+OR of #ClutterFeatureFlags.
+
+
+</description>
+<parameters>
+<parameter name="feature">
+<parameter_description> a #ClutterFeatureFlags
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if a feature is available
+
+Since: 0.1.1
+</return>
</function>
-<function name="json_node_type_name">
+<function name="clutter_container_sort_depth_order">
<description>
-Retrieves the user readable name of the data type contained by @node.
+Sorts a container children using their depth. This function should not
+be normally used by applications.
+Since: 0.6
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the name of the type. The returned string
-is owned by the node and should never be modified or freed
-</return>
+<return></return>
</function>
<function name="clutter_knot_copy">
@@ -939,20 +1080,6 @@
<return></return>
</function>
-<function name="clutter_vbox_new">
-<description>
-Creates a new vertical layout box.
-
-
-</description>
-<parameters>
-</parameters>
-<return> the newly created #ClutterVBox
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_actor_unparent">
<description>
This function should not be used in applications. It should be called by
@@ -1061,20 +1188,43 @@
<return></return>
</function>
-<function name="clutter_box_remove_all">
+<function name="clutter_list_model_new">
<description>
-Removes all children actors from the #ClutterBox
+Creates a new default model with @n_columns columns with the types
+and names passed in.
+
+For example:
+
+&lt;informalexample&gt;&lt;programlisting&gt;
+model = clutter_list_model_new (3,
+G_TYPE_INT, "Score",
+G_TYPE_STRING, "Team",
+GDK_TYPE_PIXBUF, "Logo");
+&lt;/programlisting&gt;&lt;/informalexample&gt;
+
+will create a new #ClutterModel with three columns of type int,
+string and #GdkPixbuf respectively.
+
+Note that the name of the column can be set to %NULL, in which case
+the canonical name of the type held by the column will be used as
+the title.
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
+<parameter name="n_columns">
+<parameter_description> number of columns in the model
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> @n_columns number of #GType and string pairs
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #ClutterListModel
+
+Since: 0.6
+</return>
</function>
<function name="json_array_remove_element">
@@ -1108,51 +1258,92 @@
</return>
</function>
-<function name="clutter_actor_push_transform_child">
+<function name="clutter_container_foreach">
<description>
-Makes all the children follow the parent's transformation matrix
-until clutter_actor_pop_transform_child().
+Calls @callback for each child of @container.
-This function should be used by every actor with children inside
-its paint function, in order to make its children transform (that is:
-rotate, scale, etc.) with its parent, like:
+Since: 0.4
-&lt;informalexample&gt;&lt;programlisting&gt;
-clutter_actor_push_transform_child (&lt;!-- --&gt;);
-for (l = my_actor-&gt;children; l != NULL; l = l-&gt;next)
-{
-ClutterActor *actor = l-&gt;data;
-clutter_actor_paint (child);
-}
-clutter_actor_pop_transform_child (&lt;!-- --&gt;);
-&lt;/programlisting&gt;&lt;/informalexample&gt;
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a function to be called for each child
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to be passed to the function, or %NULL
+</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
+useful for language bindings.
+
+
+</description>
+<parameters>
+<parameter name="n_columns">
+<parameter_description> number of columns in the model
+</parameter_description>
+</parameter>
+<parameter name="types">
+<parameter_description> an array of #GType types for the columns, from first to last
+</parameter_description>
+</parameter>
+<parameter name="names">
+<parameter_description> an array of names for the columns, from first to last
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new default #ClutterModel
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_score_pause">
+<description>
+Pauses a playing score @score.
Since: 0.6
</description>
<parameters>
+<parameter name="score">
+<parameter_description> a #ClutterScore
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_container_foreach">
+<function name="clutter_actor_set_shader_param">
<description>
-Calls @callback for each child of @container.
+Sets the value for a named parameter of the shader applied
+to @actor.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a function to be called for each child
+<parameter name="param">
+<parameter_description> the name of the parameter
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data to be passed to the function, or %NULL
+<parameter name="value">
+<parameter_description> the value of the parameter
</parameter_description>
</parameter>
</parameters>
@@ -1195,32 +1386,93 @@
<return></return>
</function>
-<function name="clutter_behaviour_bspline_append">
+<function name="CLUTTER_ACTOR_IS_REACTIVE">
<description>
-Appends a bezier spline defined by the last control point of bezier spline
-bs and the array of #ClutterKnot control points to the orginal bezier spline
-bs.
+Evaluates to %TRUE if the %CLUTTER_ACTOR_REACTIVE flag is set.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="e">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="first_knot">
-<parameter_description> first #ClutterKnot
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_model_insertv">
+<description>
+Inserts data at @row into 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="VarArgs">
-<parameter_description> a NULL-terminated array of #ClutterKnot control points.
+<parameter name="row">
+<parameter_description> row index
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> the number of columns and values to set
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> a vector containing the columns to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> a vector containing the values for the cells
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_shader_release">
+<description>
+FIXME
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_x11_set_stage_foreign">
+<description>
+Target the #ClutterStage to use an existing external X Window
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="xwindow">
+<parameter_description> an existing X Window id
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if foreign window is valid
+
+Since: 0.4
+</return>
+</function>
+
<function name="clutter_label_new_with_text">
<description>
Creates a new #ClutterLabel displaying @text using @font_name.
@@ -1263,22 +1515,6 @@
<return></return>
</function>
-<function name="clutter_score_is_playing">
-<description>
-Query state of a #ClutterScore instance.
-
-
-</description>
-<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
-</parameter_description>
-</parameter>
-</parameters>
-<return> TRUE if score is currently playing, FALSE if not.
-</return>
-</function>
-
<function name="clutter_get_default_backend">
<description>
FIXME
@@ -1295,21 +1531,26 @@
</return>
</function>
-<function name="clutter_glx_get_stage_window">
+<function name="clutter_score_get_timeline">
<description>
-Gets the stages X Window.
+Retrieves the #ClutterTimeline for @id inside @score.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="score">
+<parameter_description> a #ClutterScore
+</parameter_description>
+</parameter>
+<parameter name="id">
+<parameter_description> the id of the timeline
</parameter_description>
</parameter>
</parameters>
-<return> An XID for the stage window.
+<return> the requested timeline, or %NULL. This function does
+not increase the reference count on the returned #ClutterTimeline
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -1333,10 +1574,18 @@
<function name="clutter_actor_pick">
<description>
-Renders a silhouette of the actor in supplied color.
+Renders a silhouette of the actor in supplied color. Used internally for
+mapping pointer events to actors.
This function should not never be called directly by applications.
+Subclasses overiding this method should call
+clutter_actor_should_pick_paint() to decide if to render there
+silhouette but in any case should still recursively call pick for
+any children.
+
+Since 0.4
+
</description>
<parameters>
<parameter name="self">
@@ -1370,18 +1619,27 @@
</return>
</function>
-<function name="clutter_glx_get_default_screen">
+<function name="clutter_entry_set_max_length">
<description>
-Gets the number of the default X Screen object.
+Sets the maximum allowed length of the contents of the actor. If the
+current contents are longer than the given length, then they will be
+truncated to fit.
+Since: 0.4
</description>
<parameters>
+<parameter name="entry">
+<parameter_description> a #ClutterEntry
+</parameter_description>
+</parameter>
+<parameter name="max">
+<parameter_description> the maximum number of characters allowed in the entry, or -1
+to disable
+</parameter_description>
+</parameter>
</parameters>
-<return> the number of the default Screen object.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_media_get_duration">
@@ -1421,6 +1679,31 @@
<return></return>
</function>
+<function name="clutter_actor_set_sizeu">
+<description>
+Sets the actors size in #ClutterUnit. If @width and/or @height are -1 the
+actor will assume the same size of its bounding box.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> New width of actor in #ClutterUnit, or -1
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> New height of actor in #ClutterUnit, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_threads_add_timeout">
<description>
Simple wrapper around clutter_threads_add_timeout_full().
@@ -1447,38 +1730,65 @@
</return>
</function>
-<function name="json_node_new">
+<function name="clutter_actor_should_pick_paint">
<description>
-Creates a new #JsonNode of @type.
+Utility call for subclasses overiding the pick method.
+
+This function should not never be called directly by applications.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a #JsonNodeType
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #JsonNode
+<return> %TRUE if the actor should paint its silhouette,
+%FALSE otherwise
</return>
</function>
-<function name="clutter_behaviour_bspline_clear">
+<function name="clutter_shader_set_vertex_source">
<description>
-Empties a bspline.
+FIXME
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="bs">
-<parameter_description> a #ClutterBehaviourBspline
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> FIXME (currently ignored)
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="json_node_new">
+<description>
+Creates a new #JsonNode of @type.
+
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> a #JsonNodeType
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #JsonNode
+</return>
+</function>
+
<function name="clutter_ramp_inc_func">
<description>
Convenience alpha function for a monotonic increasing ramp. You
@@ -1502,6 +1812,25 @@
</return>
</function>
+<function name="clutter_timeline_get_direction">
+<description>
+Retrieves the direction of the timeline set with
+clutter_timeline_set_direction().
+
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return> the direction of the timeline
+
+Since: 0.6
+</return>
+</function>
+
<function name="json_array_unref">
<description>
Decreases by one the reference count of a #JsonArray. If the
@@ -1518,6 +1847,40 @@
<return></return>
</function>
+<function name="clutter_behaviour_scale_set_boundsx">
+<description>
+Fixed point version of clutter_behaviour_scale_set_bounds().
+
+Sets the bounds used by scale behaviour.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="scale">
+<parameter_description> a #ClutterBehaviourScale
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="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></return>
+</function>
+
<function name="clutter_exp_inc_func">
<description>
Convenience alpha function for a 2^x curve. You can use this function as the
@@ -1541,22 +1904,22 @@
</return>
</function>
-<function name="clutter_actor_get_rxangx">
+<function name="clutter_media_set_filename">
<description>
-Gets the angle of rotation around the X axis.
-
+Sets the filename of the media source.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="media">
+<parameter_description> A #ClutterMedia object
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> A filename to media file.
</parameter_description>
</parameter>
</parameters>
-<return> the angle or rotation, as a fixed point value
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_get_direction">
@@ -1577,6 +1940,32 @@
</return>
</function>
+<function name="clutter_model_filter_iter">
+<description>
+Checks whether the row pointer by @iter should be filtered or not using
+the filtering function set on @model.
+
+This function should be used only by subclasses of #ClutterModel.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> the row to filter
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the row should be displayed,
+%FALSE otherwise
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_init_with_args">
<description>
This function does the same work as clutter_init(). Additionally,
@@ -1681,6 +2070,27 @@
<return></return>
</function>
+<function name="clutter_actor_set_anchor_point_from_gravity">
+<description>
+Sets an anchor point the actor based on the given gravity (this is a
+convenience function wrapping clutter_actor_set_anchor_point()).
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="gravity">
+<parameter_description> #ClutterGravity.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_unrealize">
<description>
Frees up any underlying graphics resources needed by the actor to be
@@ -1696,20 +2106,51 @@
<return></return>
</function>
-<function name="clutter_util_next_p2">
+<function name="clutter_actor_set_rotation">
<description>
-Calculates the next power greater than @a.
+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;
+
+The rotation coordinates are relative to the anchor point of the
+actor, set using clutter_actor_set_anchor_point(). If no anchor
+point is set, the upper left corner is assumed as the origin.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="a">
-<parameter_description> Value to get the next power
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the rotation center
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the rotation center
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> Z coordinate of the rotation center
</parameter_description>
</parameter>
</parameters>
-<return> The next power after @a.
-</return>
+<return></return>
</function>
<function name="clutter_entry_get_position">
@@ -1751,26 +2192,20 @@
<return></return>
</function>
-<function name="clutter_actor_rotate_xx">
+<function name="CLUTTER_ACTOR_UNSET_FLAGS">
<description>
-Rotates actor around the X axis.
+Unsets flags on the given #ClutterActor
+
+Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y co-ord to rotate actor around ( relative to actor position )
+<parameter name="e">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z co-ord to rotate actor around ( relative to actor position )
+<parameter name="f">
+<parameter_description> the flags to unset
</parameter_description>
</parameter>
</parameters>
@@ -1798,7 +2233,10 @@
<function name="clutter_score_set_loop">
<description>
-Sets whether @score should loop.
+Sets whether @score should loop. A looping #ClutterScore will start
+from its initial state after the ::complete signal has been fired.
+
+Since: 0.6
</description>
<parameters>
@@ -1814,67 +2252,65 @@
<return></return>
</function>
-<function name="clutter_actor_get_name">
+<function name="clutter_shader_bind">
<description>
-Retrieves the name of @self.
+FIXME
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> pointer to textual tag for the actor. The
-returned string is owned by the actor and should not
-be modified or freed.
+<return> FIXME
+
+Since: 0.6
</return>
</function>
-<function name="clutter_script_get_object">
+<function name="clutter_grab_keyboard">
<description>
-Retrieves the object bound to @name. This function does not increment
-the reference count of the returned object.
+Grabs keyboard events, after the grab is done keyboard events ("key-press-event"
+and "key-release-event") are delivered to this actor directly. The source
+set in the event will be the actor that would have received the event if the
+keyboard grab was not in effect.
+Since: 0.6
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the object to retrieve
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the named object, or %NULL if no object with the
-given name was available
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_sini">
+<function name="clutter_actor_set_widthu">
<description>
-Very fast fixed point implementation of sine function.
-
-ClutterAngle is an integer such that 1024 represents
-full circle.
+Requests a new width for actor
+since: 0.6
</description>
<parameters>
-<parameter name="angle">
-<parameter_description> a #ClutterAngle
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Requested new width for actor in #ClutterUnit
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterFixed sine value.
-
-Since: 0.2
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_newx">
@@ -1909,8 +2345,8 @@
<parameter_description> #ClutterRotateDirection of rotation
</parameter_description>
</parameter>
-<parameter name="begin">
-<parameter_description> #ClutterFixed angle in degrees at which movement begins
+<parameter name="start">
+<parameter_description> #ClutterFixed angle in degrees at which movement starts
</parameter_description>
</parameter>
<parameter name="end">
@@ -1951,7 +2387,7 @@
<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="angle_begin">
+<parameter name="angle_start">
<parameter_description> return value for the initial angle
</parameter_description>
</parameter>
@@ -1979,14 +2415,67 @@
</return>
</function>
-<function name="ClutterBehaviourDepth">
+<function name="clutter_timeline_set_direction">
<description>
-End depth level to apply to the actors.
+Sets the direction of @timeline, either %CLUTTER_TIMELINE_FORWARD or
+%CLUTTER_TIMELINE_BACKWARD.
-Since: 0.4
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="direction">
+<parameter_description> the direction of the timeline
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_apply_shader">
+<description>
+Sets the #ClutterShader to be applied on @self.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="shader">
+<parameter_description> a #ClutterShader or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the shader was successfully applied
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_stage_set_key_focus">
+<description>
+Sets the key focus on @actor. An actor with key focus will receive
+all the key events. If @actor is %NULL, the stage will receive
+focus.
+
+Since: 0.6
</description>
<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> the actor to set key focus to, or %NULL
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -1994,8 +2483,11 @@
<function name="clutter_behaviour_ellipse_new">
<description>
Creates a behaviour that drives actors along an elliptical path with
-given center, width and height; the movement begins at @angle_begin
-degrees (with 0 corresponding to 12 o'clock) and ends at @angle_end degrees;
+given center, width and height; the movement starts at @angle_start
+degrees (with 0 corresponding to 12 o'clock) and ends at @angle_end
+degrees. Angles &gt;= 360 degrees get clamped to the canonical interval
+&lt;0, 360), if start == end, the behaviour will rotate by exacly 360 degrees.
+
</description>
<parameters>
@@ -2023,12 +2515,12 @@
<parameter_description> #ClutterRotateDirection of rotation
</parameter_description>
</parameter>
-<parameter name="begin">
-<parameter_description> angle in degrees at which movement begins
+<parameter name="start">
+<parameter_description> angle in degrees at which movement starts, between 0 and 360
</parameter_description>
</parameter>
<parameter name="end">
-<parameter_description> angle in degrees at which movement ends
+<parameter_description> angle in degrees at which movement ends, between 0 and 360
</parameter_description>
</parameter>
</parameters>
@@ -2038,6 +2530,30 @@
</return>
</function>
+<function name="clutter_model_foreach">
+<description>
+Calls @func for each row in the model.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterModelForeachFunc
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @func
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_array_get_elements">
<description>
Gets the elements of a #JsonArray as a list of #JsonNode&lt;!-- --&gt;s.
@@ -2077,6 +2593,30 @@
<return></return>
</function>
+<function name="clutter_shader_set_uniform_1f">
+<description>
+FIXME
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_ellipse_set_tilt">
<description>
Sets the angles at which the ellipse should be tilted around it's center.
@@ -2121,24 +2661,6 @@
</return>
</function>
-<function name="clutter_layout_get_layout_flags">
-<description>
-Retrieves the supported layout types from the #ClutterLayout
-
-
-</description>
-<parameters>
-<parameter name="layout">
-<parameter_description> a #ClutterLayout
-</parameter_description>
-</parameter>
-</parameters>
-<return> bitwise or of #ClutterLayoutFlags
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_sine_inc_func">
<description>
Convenience alpha function for a sine wave over interval [0, pi / 2].
@@ -2193,12 +2715,14 @@
<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> initial angle, in fixed point notation
+<parameter name="angle_start">
+<parameter_description> initial angle, in fixed point notation in degrees, between 0
+and 360.
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> final angle, in fixed point notation
+<parameter_description> final angle, in fixed point notation in degress, between 0 and
+360.
</parameter_description>
</parameter>
</parameters>
@@ -2222,20 +2746,6 @@
<return></return>
</function>
-<function name="clutter_eglx_get_default_screen">
-<description>
-FIXME
-
-
-</description>
-<parameters>
-</parameters>
-<return> FIXME
-
-Since: 0.4
-</return>
-</function>
-
<function name="json_node_set_double">
<description>
Sets @value as the double content of the @node, replacing any existing
@@ -2255,21 +2765,24 @@
<return></return>
</function>
-<function name="clutter_entry_get_visibility">
+<function name="clutter_actor_set_yu">
<description>
-Return value: TRUE if the contents of the entry are displayed as plaintext.
+Sets the actor's y position relative to its parent.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the actors position on the Y axis in #ClutterUnit
</parameter_description>
</parameter>
</parameters>
-<return> TRUE if the contents of the entry are displayed as plaintext.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_container_add_actor">
@@ -2322,6 +2835,55 @@
<return></return>
</function>
+<function name="clutter_actor_get_positionu">
+<description>
+Retrieves the position of an actor in #ClutterUnit&lt;!-- --&gt;s.
+
+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_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_opacity_set_bounds">
+<description>
+Sets the initial and final levels of the opacity applied by @behaviour
+on each actor it controls.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="behaviour">
+<parameter_description> a #ClutterBehaviourOpacity
+</parameter_description>
+</parameter>
+<parameter name="opacity_start">
+<parameter_description> minimum level of opacity
+</parameter_description>
+</parameter>
+<parameter name="opacity_end">
+<parameter_description> maximum level of opacity
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_get_bounds">
<description>
Retrieves the rotation boundaries of the rotate behaviour.
@@ -2334,7 +2896,7 @@
<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="angle_begin">
+<parameter name="angle_start">
<parameter_description> return value for the initial angle
</parameter_description>
</parameter>
@@ -2387,7 +2949,8 @@
<function name="clutter_behaviour_ellipse_set_angle_endx">
<description>
-Sets the angle at which movement ends.
+Sets the angle at which movement ends; angles &gt;= 360 degress get clamped
+to the canonical interval &lt;0, 360).
Since: 0.4
@@ -2398,34 +2961,50 @@
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> #ClutterAngle at which movement ends
+<parameter_description> angle, as #ClutterFixed, at which movement ends, in degrees,
+between 0 and 360.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_object_add_member">
+<function name="clutter_actor_get_rotation">
<description>
-Adds a member named @member_name and containing @node into a #JsonObject.
-The object will take ownership of the #JsonNode.
+Retrieves the angle and center of rotation on the given axis,
+set using clutter_actor_set_angle().
+
+The coordinates of the center returned by this function depend on
+the axis passed.
+
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="axis">
+<parameter_description> the axis of rotation
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the value of the member
+<parameter name="x">
+<parameter_description> return value for the X coordinate of the center of rotation
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> return value for the Y coordinate of the center of rotation
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> return value for the Z coordinate of the center of rotation
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the angle of rotation.
+
+Since: 0.6
+</return>
</function>
<function name="json_node_get_boolean">
@@ -2444,6 +3023,27 @@
</return>
</function>
+<function name="clutter_stage_set_fogx">
+<description>
+Sets the depth cueing settings for the @stage. This is the fixed point
+version of clutter_stage_set_fog().
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="fog">
+<parameter_description> a #ClutterFog structure
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_redraw">
<description>
Forces a redraw of the entire stage. Applications should never use this
@@ -2481,10 +3081,35 @@
<return></return>
</function>
+<function name="clutter_actor_move_byu">
+<description>
+Moves an actor by specified distance relative to the current position.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="dx">
+<parameter_description> Distance to move Actor on X axis, in #ClutterUnit&lt;!-- --&gt;s.
+</parameter_description>
+</parameter>
+<parameter name="dy">
+<parameter_description> Distance to move Actor on Y axis, in #ClutterUnit&lt;!-- --&gt;s.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_score_stop">
<description>
Stops and rewinds a playing #ClutterScore instance.
+Since: 0.6
</description>
<parameters>
@@ -2572,6 +3197,30 @@
<return></return>
</function>
+<function name="clutter_set_motion_events_frequency">
+<description>
+Sets the motion events frequency. Setting this to a non-zero value
+will override the default setting, so it should be rarely used.
+
+Motion events are delivered from the default backend to the stage
+and are used to generate the enter/leave events pair. This might lead
+to a performance penalty due to the way the actors are identified.
+Using this function is possible to reduce the frequency of the motion
+events delivery to the stage.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="frequency">
+<parameter_description> the number of motion events per second, or 0 for the
+default value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_stage_get_color">
<description>
Retrieves the stage color.
@@ -2593,7 +3242,7 @@
<function name="clutter_behaviour_path_append_knots">
<description>
Adds a NULL-terminated list of knots to a path. This function is
-equivalent to calling clutter_behaviour_path_append_knot() for each
+equivalent to calling clutter_behaviour_path_append_knot() for each
member of the list.
Since: 0.2
@@ -2616,16 +3265,134 @@
<return></return>
</function>
-<function name="clutter_actor_get_vertices">
+<function name="clutter_model_iter_next">
<description>
-Calculates the tranformed screen coordinaces of the four corners of
-the actor; the returned vertices relate to the ClutterActoBox
-coordinances as follows:
+Updates the @iter to point at the next position in the model.
+The model implementation should take into account the presence of
+a filter function.
-v[0] contains (x1, y1)
-v[1] contains (x2, y1)
-v[2] contains (x1, y2)
-v[3] contains (x2, y2)
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> The passed iterator, updated to point at the next
+row in the model.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_model_filter_row">
+<description>
+Checks whether @row should be filtered or not using the
+filtering function set on @model.
+
+This function should be used only by subclasses of #ClutterModel.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> the row to filter
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the row should be displayed,
+%FALSE otherwise
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_get_script_id">
+<description>
+Retrieves the Clutter script id, if any.
+
+
+</description>
+<parameters>
+<parameter name="gobject">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+</parameters>
+<return> the script id, or %NULL if @object was not defined inside
+a UI definition file. The returned string is owned by the object and
+should never be modified or freed.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="json_object_add_member">
+<description>
+Adds a member named @member_name and containing @node into a #JsonObject.
+The object will take ownership of the #JsonNode.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #JsonObject
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> the name of the member
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> the value of the member
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_model_set_filter">
+<description>
+Filters the @model using the given filtering function.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterModelFilterFunc, or #NULL
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @func, or #NULL
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> destroy notifier of @user_data, or #NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_vertices">
+<description>
+Calculates the tranformed screen coordinates of the four corners of
+the actor; the returned vertices relate to the ClutterActorBox
+coordinates as follows:
+
+v[0] contains (x1, y1)
+v[1] contains (x2, y1)
+v[2] contains (x1, y2)
+v[3] contains (x2, y2)
Since: 0.4
@@ -2644,11 +3411,44 @@
<return></return>
</function>
-<function name="clutter_eglx_trap_x_errors">
+<function name="clutter_behaviour_scale_set_bounds">
<description>
-FIXME
+Sets the bounds used by scale behaviour.
-Since: 0.4
+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_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="ClutterScript">
+<description>
+The path of the currently parsed file. If ClutterScript:filename-set
+is %FALSE then the value of this property is undefined.
+
+Since: 0.6
</description>
<parameters>
@@ -2730,6 +3530,35 @@
</return>
</function>
+<function name="clutter_model_prependv">
+<description>
+Creates and prepends a new row to the #ClutterModel, setting the row
+values for the given @columns upon creation.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> the number of columns and values to set
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> a vector containing the columns to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> a vector containing the values for the cells
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_apply_transform_to_point">
<description>
Transforms point in coordinates relative to the actor
@@ -2840,20 +3669,6 @@
</return>
</function>
-<function name="clutter_eglx_untrap_x_errors">
-<description>
-FIXME
-
-
-</description>
-<parameters>
-</parameters>
-<return> FIXME
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_actor_get_scale">
<description>
Retrieves an actors scale in floating point.
@@ -2886,6 +3701,9 @@
When you destroy a container its children will be destroyed as well.
+Note: you cannot destroy the #ClutterStage returned by
+clutter_stage_get_default().
+
</description>
<parameters>
<parameter name="self">
@@ -2935,44 +3753,47 @@
<return></return>
</function>
-<function name="json_object_get_members">
+<function name="clutter_fixed_qmulx">
<description>
-Retrieves all the names of the members of a #JsonObject. You can
-obtain the value for each member using json_object_get_member().
+Multiplies two fixed values using 64bit arithmetic; this provides
+significantly better precission than the #CLUTTER_FIXED_MUL macro,
+but at performance cost (about 2.7 times slowdown on ARMv5e, and 2 times
+on x86).
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="op1">
+<parameter_description> #ClutterFixed
+</parameter_description>
+</parameter>
+<parameter name="op2">
+<parameter_description> #ClutterFixed
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of member names. The content of the list
-is owned by the #JsonObject and should never be modified or
-freed. When you have finished using the returned list, use
-g_list_free() to free the resources it has allocated.
+<return> the result of the operation
+
+Since: 0.4
</return>
</function>
-<function name="clutter_box_get_color">
+<function name="clutter_actor_get_depthu">
<description>
-Gets the background color of the box set with clutter_box_set_color().
+Retrieves the depth of @self.
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> return location for the color
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the depth of a #ClutterActor in #ClutterUnit
+
+Since: 0.6
+</return>
</function>
<function name="clutter_stage_event">
@@ -3016,20 +3837,68 @@
</return>
</function>
-<function name="clutter_eglx_set_stage_foreign">
+<function name="clutter_model_set_sort">
<description>
-FIXME
+Sorts @model using the given sorting function.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="window">
-<parameter_description> FIXME
+<parameter name="column">
+<parameter_description> the column to sort on
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterModelSortFunc, or #NULL
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @func, or #NULL
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> destroy notifier of @user_data, or #NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_effect_template_construct">
+<description>
+Constructs a #ClutterEffectTemplate, to be used with the effects API.
+
+This function can only be called once after the creation of @template_
+and is only useful for language bindings.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="template_">
+<parameter_description> a #ClutterEffectTemplate
+</parameter_description>
+</parameter>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="alpha_func">
+<parameter_description> an alpha function to use for the template
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to be passed to the alpha function, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to be called when disposing the alpha function's use
+data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -3061,7 +3930,8 @@
<function name="clutter_behaviour_rotate_set_bounds">
<description>
-Sets the initial and final angles of a rotation behaviour.
+Sets the initial and final angles of a rotation behaviour; angles &gt;= 360
+degrees get clamped to the canonical interval &lt;0, 360).
Since: 0.4
@@ -3071,12 +3941,12 @@
<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> initial angle
+<parameter name="angle_start">
+<parameter_description> initial angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> final angle
+<parameter_description> final angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
@@ -3124,36 +3994,20 @@
<return></return>
</function>
-<function name="clutter_group_find_child_by_id">
-<description>
-Finds a child actor of a group by its unique ID. Search recurses
-into any child groups.
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="id">
-<parameter_description> A unique #Clutteractor ID
-</parameter_description>
-</parameter>
-</parameters>
-<return> the #ClutterActor if found, or NULL.
-
-Deprecated: 0.6: Use clutter_container_find_child_by_id() instead.
-</return>
-</function>
-
<function name="clutter_actor_request_coords">
<description>
-Requests new untransformed co-ordinates for the #ClutterActor
-ralative to any parent.
-
-This function should not be called directly by applications instead
-the various position/geometry methods should be used.
+Requests new untransformed coordinates for the bounding box of
+a #ClutterActor. The coordinates must be relative to the current
+parent of the actor.
+
+This function should not be called directly by applications;
+instead, the various position/geometry methods should be used.
+
+Note: Actors overriding the ClutterActor::request_coords() virtual
+function should always chain up to the parent class request_coords()
+method. Actors should override this function only if they need to
+recompute some internal state or need to reposition their evental
+children.
</description>
<parameters>
@@ -3162,7 +4016,7 @@
</parameter_description>
</parameter>
<parameter name="box">
-<parameter_description> A #ClutterActorBox with requested new co-ordinates in ClutterUnits
+<parameter_description> A #ClutterActorBox with the new coordinates, in ClutterUnits
</parameter_description>
</parameter>
</parameters>
@@ -3171,8 +4025,22 @@
<function name="clutter_script_get_objects">
<description>
-Retrieves a list of objects for the given names. This function does
-not increment the reference count of the returned objects.
+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.
</description>
@@ -3186,12 +4054,12 @@
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> a %NULL-terminated list of names
+<parameter_description> return location for a #GObject, then additional names, ending
+with %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GList containing the found objects,
-or %NULL. Use g_list_free() when done using it.
+<return> the number of objects returned.
Since: 0.6
</return>
@@ -3257,65 +4125,62 @@
<return></return>
</function>
-<function name="clutter_powx">
+<function name="clutter_model_resort">
<description>
-Calculates x to y power. (Note, if x is a constant it will be faster to
-calculate the power as clutter_pow2x (CLUTTER_FIXED_MUL(y, log2 (x)))
+Force a resort on the @model. This function should only be
+used by subclasses of #ClutterModel.
+Since: 0.6
</description>
<parameters>
-<parameter name="x">
-<parameter_description> base
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> #ClutterFixed exponent
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return> x in y power.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_actor_is_reactive">
+<function name="clutter_powx">
<description>
-Checks whether @actor is marked as reactive.
+Calculates x to y power. (Note, if x is a constant it will be faster to
+calculate the power as clutter_pow2x (CLUTTER_FIXED_MUL(y, log2 (x)))
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="x">
+<parameter_description> base
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> #ClutterFixed exponent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor is reactive
+<return> x in y power.
-Since: 0.6
+Since: 0.4
</return>
</function>
-<function name="clutter_box_set_color">
+<function name="clutter_x11_get_stage_window">
<description>
-Sets the background color of the box.
+Gets the stages X Window.
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> the background color of the box
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> An XID for the stage window.
+
+Since: 0.4
+</return>
</function>
<function name="clutter_entry_get_alignment">
@@ -3335,26 +4200,14 @@
</return>
</function>
-<function name="clutter_layout_width_for_height">
+<function name="CLUTTER_ALPHA_SINE_DEC">
<description>
-Queries a #ClutterLayout actor for its width with a known height.
+Convenience symbol for clutter_sine_dec_func().
-Since: 0.4
+Since: 0.2
</description>
<parameters>
-<parameter name="layout">
-<parameter_description> a #ClutterLayout
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> return location for the width
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> height allocated by the parent
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -3414,15 +4267,15 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt_x">
-<parameter_description> #ClutterAngle tilt of the elipse around the center in X axis
+<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in X axis
</parameter_description>
</parameter>
<parameter name="angle_tilt_y">
-<parameter_description> #ClutterAngle tilt of the elipse around the center in Y axis
+<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in Y axis
</parameter_description>
</parameter>
<parameter name="angle_tilt_z">
-<parameter_description> #ClutterAngle tilt of the elipse around the center in Z axis
+<parameter_description> tilt of the elipse in degrees, as #ClutterFixed, around the center in Z axis
</parameter_description>
</parameter>
</parameters>
@@ -3516,47 +4369,35 @@
<return></return>
</function>
-<function name="json_node_set_object">
+<function name="clutter_script_ensure_objects">
<description>
-Sets @objects inside @node. The reference count of @object is increased.
+Ensure that every object defined inside @script is correctly
+constructed. You should rarely need to use this function.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
-</parameter_description>
-</parameter>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_rotate_set_center">
+<function name="json_node_set_object">
<description>
-Sets the center of rotation. The coordinates are relative to the plane
-normal to the rotation axis set with clutter_behaviour_rotate_set_axis().
-
-Since: 0.4
+Sets @objects inside @node. The reference count of @object is increased.
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X axis center of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y axis center of rotation
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z axis center of rotation
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
</parameters>
@@ -3566,8 +4407,10 @@
<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_begin and
- angle_end
+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
+single rotation of 360 degrees.
</description>
@@ -3584,12 +4427,12 @@
<parameter_description> the rotation direction
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> the starting angle
+<parameter name="angle_start">
+<parameter_description> the starting angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> the final angle
+<parameter_description> the final angle in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
@@ -3641,6 +4484,26 @@
</return>
</function>
+<function name="clutter_x11_add_filter">
+<description>
+Adds an event filter function.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="func">
+<parameter_description> a filter function
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to be passed to the filter function, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_set_reactive">
<description>
Sets @actor as reactive. Reactive actors will receive events.
@@ -3653,37 +4516,47 @@
<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
+<parameter name="reactive">
+<parameter_description> whether the actor should be reactive to events
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="json_array_get_length">
+<function name="clutter_x11_remove_filter">
<description>
-Retrieves the length of a #JsonArray
+Removes the given filter function.
+Since: 0.6
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="func">
+<parameter_description> a filter function
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to be passed to the filter function, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the length of the array
-</return>
+<return></return>
</function>
-<function name="clutter_eglx_get_default_root_window">
+<function name="json_array_get_length">
<description>
-FIXME
+Retrieves the length of a #JsonArray
</description>
<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
</parameters>
-<return> FIXME
-
-Since: 0.4
+<return> the length of the array
</return>
</function>
@@ -3701,7 +4574,7 @@
</parameter_description>
</parameter>
<parameter name="offset">
-<parameter_description> position in path to insert knot.
+<parameter_description> position in path to insert knot.
</parameter_description>
</parameter>
<parameter name="knot">
@@ -3769,6 +4642,18 @@
</return>
</function>
+<function name="clutter_x11_trap_x_errors">
+<description>
+Traps every X error until clutter_x11_untrap_x_errors() is called.
+
+Since: 0.6
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_threads_add_idle_full">
<description>
Adds a function to be called whenever there are no higher priority
@@ -3858,6 +4743,24 @@
</return>
</function>
+<function name="clutter_actor_get_heightu">
+<description>
+Retrieves the actors height ignoring any scaling factors.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> The actor height in #ClutterUnit
+
+since: 0.6
+</return>
+</function>
+
<function name="json_object_has_member">
<description>
Checks whether @object has a member named @member_name.
@@ -3892,6 +4795,24 @@
</return>
</function>
+<function name="clutter_model_get_sorting_column">
+<description>
+Retrieves the number of column used for sorting the @model.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> a column number, or -1 if the model is not sorted
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_entry_set_alignment">
<description>
Sets text alignment of the entry.
@@ -3939,24 +4860,24 @@
<return></return>
</function>
-<function name="ClutterBox">
+<function name="clutter_x11_untrap_x_errors">
<description>
-The background color of a #ClutterBox.
+Removes the X error trap and returns the current status.
-Since: 0.4
</description>
<parameters>
</parameters>
-<return></return>
+<return> the trapped error code, or 0 for success
+
+Since: 0.4
+</return>
</function>
-<function name="clutter_actor_set_scale_with_gravity">
+<function name="clutter_actor_get_gid">
<description>
-Scales the actor by scale_x, scale_y taking into consideration the
-required gravity.
+Retrieves the unique id for @self.
-Since: 0.4
</description>
<parameters>
@@ -3964,25 +4885,18 @@
<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="scale_x">
-<parameter_description> scaling factor for x axis
-</parameter_description>
-</parameter>
-<parameter name="scale_y">
-<parameter_description> scaling factor for y axis
-</parameter_description>
-</parameter>
-<parameter name="gravity">
-<parameter_description> #ClutterGravity to apply to scaling.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> Globally unique value for object instance.
+
+Since: 0.6
+</return>
</function>
<function name="clutter_score_rewind">
<description>
-Rewinds a #ClutterScore to inital timeline.
+Rewinds a #ClutterScore to its initial state.
+
+Since: 0.6
</description>
<parameters>
@@ -3994,24 +4908,56 @@
<return></return>
</function>
-<function name="clutter_media_set_filename">
+<function name="clutter_color_darken">
<description>
-Sets the filename of the media source.
+Darkens @src by a fixed amount, and saves the changed color
+in @dest.
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="src">
+<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> A filename to media file.
+<parameter name="dest">
+<parameter_description> return location for the darker color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="CLUTTER_ALPHA_SQUARE">
+<description>
+Convenience symbol for clutter_square_func().
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_get_actor_by_gid">
+<description>
+Retrieves the #ClutterActor with @id.
+
+
+</description>
+<parameters>
+<parameter name="id">
+<parameter_description> a #ClutterActor ID.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the actor with the passed id or %NULL. The returned
+actor does not have its reference count increased.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_event_get_coords">
<description>
Retrieves the coordinates of @event and puts them into @x and @y.
@@ -4057,6 +5003,26 @@
<return></return>
</function>
+<function name="clutter_group_get_children">
+<description>
+Get a list containing all actors contained in the group.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterGroup
+</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>
+</function>
+
<function name="clutter_actor_lower_bottom">
<description>
Lowers @self to the bottom.
@@ -4073,13 +5039,17 @@
<function name="clutter_score_new">
<description>
-Create a new #ClutterScore instance.
+Creates a new #ClutterScore. A #ClutterScore is an object that can
+hold multiple #ClutterTimeline&lt;!-- --&gt;s in a sequential order.
</description>
<parameters>
</parameters>
-<return> a new #ClutterScore
+<return> the newly created #ClutterScore. Use g_object_unref()
+when done.
+
+Since: 0.6
</return>
</function>
@@ -4106,9 +5076,11 @@
<description>
Very fast fixed point implementation of square root for integers.
-This function is about 10x faster than clib sqrt() on x86, and (this is
-not a typo!) more than 800x faster on ARM without FPU. It's error is &lt; 5%
-for arguments &lt; 132 and &lt; 10% for arguments &lt; 5591.
+This function is at least 6x faster than clib sqrt() on x86, and (this is
+not a typo!) about 500x faster on ARM without FPU. It's error is &lt; 5%
+for arguments &lt; #CLUTTER_SQRTI_ARG_5_PERCENT and &lt; 10% for arguments &lt;
+#CLUTTER_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
+this function is CLUTTER_SQRTI_ARG_MAX.
</description>
@@ -4158,25 +5130,10 @@
</return>
</function>
-<function name="clutter_actor_hide">
+<function name="clutter_sqrtx">
<description>
-Flags a clutter actor to be hidden. An actor not shown will not
-appear on the display.
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_sqrtx">
-<description>
-A fixed point implementation of squre root
-
+A fixed point implementation of squre root
+
</description>
<parameters>
@@ -4227,39 +5184,6 @@
<return></return>
</function>
-<function name="clutter_layout_tune_request">
-<description>
-Iteratively queries a #ClutterLayout actor until it finds
-its desired size, given a width and height tuple.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="layout">
-<parameter_description> a #ClutterLayout
-</parameter_description>
-</parameter>
-<parameter name="given_width">
-<parameter_description> width allocated by the parent
-</parameter_description>
-</parameter>
-<parameter name="given_height">
-<parameter_description> height allocated by the parent
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> return location for the new width
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> return location for the new height
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_texture_has_generated_tiles">
<description>
Checks if #ClutterTexture has generated underlying GL texture tiles.
@@ -4281,12 +5205,26 @@
<function name="SECTION">
<description>
-Various misc utilility functions.
+#ClutterModelIter is an object used for iterating through all the rows
+of a #ClutterModel. It allows setting and getting values on the row
+which is currently pointing at.
+
+A #ClutterModelIter represents a position between two elements
+of the sequence. For example, the iterator returned by
+clutter_model_get_first_iter() represents the gap immediately before
+the first row of the #ClutterModel, and the iterator returned by
+clutter_model_get_last_iter() represents the gap immediately after the
+last row.
+
+A #ClutterModelIter can only be created by a #ClutterModel implementation
+and it is valid as long as the model does not change.
+
+#ClutterModelIter is available since Clutter 0.6
</description>
<parameters>
<parameter name="short_description">
-<parameter_description> Misc utility functions.
+<parameter_description> Iterates through a model
</parameter_description>
</parameter>
</parameters>
@@ -4376,6 +5314,30 @@
<return></return>
</function>
+<function name="clutter_actor_get_anchor_point">
+<description>
+Gets the current anchor point of the @actor in pixels.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="anchor_x">
+<parameter_description> return location for the X coordinate of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> return location for the y coordinate of the anchor point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_set_direction">
<description>
Sets the rotation direction used by the rotate behaviour.
@@ -4487,51 +5449,59 @@
</return>
</function>
-<function name="clutter_script_ensure_object">
+<function name="clutter_event_put">
<description>
-Ensure that every object defined inside @script is correctly
-constructed. You should rarely need to use this function.
+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="script">
-<parameter_description> a #ClutterScript
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_event_put">
+<function name="clutter_egl_display">
<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.
+Gets the current EGLDisplay.
-Since: 0.6
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> an EGLDisplay
+
+Since: 0.4
+</return>
</function>
-<function name="clutter_egl_display">
+<function name="clutter_model_get_column_type">
<description>
-Gets the current EGLDisplay.
+Retrieves the type of the @column.
</description>
<parameters>
+<parameter name="model">
+<parameter_description> #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column number
+</parameter_description>
+</parameter>
</parameters>
-<return> an EGLDisplay
+<return> the type of the column.
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -4551,7 +5521,8 @@
<function name="clutter_behaviour_ellipse_set_angle_end">
<description>
-Sets the angle at which movement ends.
+Sets the angle at which movement ends; angles &gt;= 360 degress get clamped
+to the canonical interval &lt;0, 360).
Since: 0.4
@@ -4562,60 +5533,76 @@
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> angle at which movement ends in degrees.
+<parameter_description> angle at which movement ends in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_array_sized_new">
+<function name="clutter_shader_release_all">
<description>
-Creates a new #JsonArray with @n_elements slots already allocated.
+FIXME
+Since: 0.6
</description>
<parameters>
-<parameter name="n_elements">
-<parameter_description> number of slots to pre-allocate
+</parameters>
+<return></return>
+</function>
+
+<function name="json_node_type_name">
+<description>
+Retrieves the user readable name of the data type contained by @node.
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #JsonArray
+<return> a string containing the name of the type. The returned string
+is owned by the node and should never be modified or freed
</return>
</function>
-<function name="ClutterBehaviourPath">
+<function name="clutter_model_get_first_iter">
<description>
-This signal is emitted each time a node defined inside the path
-is reached.
+Retrieves a #ClutterModelIter representing the first row in @model.
-Since: 0.2
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> the object which received the signal
-</parameter_description>
-</parameter>
-<parameter name="knot">
-<parameter_description> the #ClutterKnot reached
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A new #ClutterModelIter. Call g_object_unref() when
+done using it
+
+Since: 0.6
+</return>
</function>
-<function name="clutter_actor_unset_reactive">
+<function name="ClutterBehaviourPath">
<description>
-Sets @actor as not reactive.
+This signal is emitted each time a node defined inside the path
+is reached.
-Since: 0.6
+Since: 0.2
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="pathb">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="knot">
+<parameter_description> the #ClutterKnot reached
</parameter_description>
</parameter>
</parameters>
@@ -4650,23 +5637,76 @@
<return></return>
</function>
-<function name="clutter_scriptable_get_name">
+<function name="clutter_grab_pointer">
<description>
-Retrieves the name of @scriptable set using clutter_scriptable_set_name().
+Grabs pointer events, after the grab is done all pointer related events
+(press, motion, release, enter, leave and scroll) are delivered to this
+actor directly. The source set in the event will be the actor that would
+have received the event if the pointer grab was not in effect.
+Since: 0.6
</description>
<parameters>
-<parameter name="scriptable">
-<parameter_description> a #ClutterScriptable
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the name of the object. The returned string is owned by
-the scriptable object and should never be modified of freed
+<return></return>
+</function>
+
+<function name="clutter_actor_set_depthu">
+<description>
+Sets the Z co-ordinate of @self to @depth in #ClutterUnit, the Units of
+which are dependant on the perspective setup.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="depth">
+<parameter_description> Z co-ord in #ClutterUnit
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_stage_set_fog">
+<description>
+Sets the GL fog settings used to create the depth cueing effect
+on the @stage.
+
+If the actors are all near the view point you will need a higher @density
+and a smaller interval between @z_near and @z_far. On the other hand, if
+actors are placed far away from the view point you will need a lower
+ density but a bigger interval between @z_near and @z_far.
Since: 0.6
-</return>
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="density">
+<parameter_description> density of the intensity dampening
+</parameter_description>
+</parameter>
+<parameter name="z_near">
+<parameter_description> starting point of the depth cueing
+</parameter_description>
+</parameter>
+<parameter name="z_far">
+<parameter_description> ending point of the depth cueing
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_color_free">
@@ -4685,20 +5725,62 @@
<return></return>
</function>
-<function name="clutter_perspective_free">
+<function name="clutter_texture_set_area_from_rgb_data">
<description>
-Frees a perspective structure created with clutter_perspective_copy().
+Updates a subregion of the pixel data in a #ClutterTexture.
-Since: 0.4
</description>
<parameters>
-<parameter name="perspective">
-<parameter_description> a #ClutterPerspective
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Image data in RGB type colorspace.
+</parameter_description>
+</parameter>
+<parameter name="has_alpha">
+<parameter_description> Set to TRUE if image data has a alpha channel.
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of upper left corner of region to update.
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of upper left corner of region to update.
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width in pixels of region to update.
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height in pixels of region to update.
+</parameter_description>
+</parameter>
+<parameter name="rowstride">
+<parameter_description> Distance in bytes between row starts.
+</parameter_description>
+</parameter>
+<parameter name="bpp">
+<parameter_description> bytes per pixel ( Currently only 4 supported )
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #ClutterTextureFlags
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success, %FALSE on failure.
+
+Since 0.6.
+</return>
</function>
<function name="clutter_media_get_volume">
@@ -4731,6 +5813,26 @@
</return>
</function>
+<function name="clutter_shader_set_is_enabled">
+<description>
+FIXME
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_effect_scale">
<description>
Simple effect for scaling a single #ClutterActor.
@@ -4746,24 +5848,24 @@
<parameter_description> A #ClutterActor to apply the effect to.
</parameter_description>
</parameter>
-<parameter name="scale_begin">
-<parameter_description> Initial scale factor to apply to actor
+<parameter name="x_scale_end">
+<parameter_description> Final X axis scale factor to apply to actor
</parameter_description>
</parameter>
-<parameter name="scale_end">
-<parameter_description> Final scale factor to apply to actor
+<parameter name="y_scale_end">
+<parameter_description> Final Y axis scale factor to apply to actor
</parameter_description>
</parameter>
<parameter name="gravity">
<parameter_description> A #ClutterGravity for the scale.
</parameter_description>
</parameter>
-<parameter name="completed_func">
+<parameter name="func">
<parameter_description> A #ClutterEffectCompleteFunc to call on effect
completion or NULL
</parameter_description>
</parameter>
-<parameter name="completed_data">
+<parameter name="data">
<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
or NULL
</parameter_description>
@@ -4772,29 +5874,69 @@
<return> a #ClutterTimeline for the effect. Will be unreferenced by
the effect when completed.
-Since: 0.4
+Since: 0.6
</return>
</function>
-<function name="clutter_actor_get_width">
+<function name="CLUTTER_ACTOR_SET_FLAGS">
<description>
-Retrieves the actors width ignoring any scaling factors.
+Sets flags on the given #ClutterActor
+Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="e">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="f">
+<parameter_description> the flags to set
</parameter_description>
</parameter>
</parameters>
-<return> The actor width in pixels
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_angle_endx">
+<function name="clutter_model_remove">
<description>
-Gets the angle at which movements ends.
+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>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_width">
+<description>
+Retrieves the actors width ignoring any scaling factors.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> The actor width in pixels
+</return>
+</function>
+
+<function name="clutter_behaviour_ellipse_get_angle_endx">
+<description>
+Gets the angle at which movements ends.
</description>
@@ -4804,7 +5946,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterAngle
+<return> angle, as #ClutterFixed, in degrees
Since: 0.4
</return>
@@ -4905,6 +6047,36 @@
</return>
</function>
+<function name="clutter_model_prepend">
+<description>
+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;
+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;
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> pairs of column number and value, terminated with -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_set_axis">
<description>
Sets the axis used by the rotate behaviour.
@@ -5021,6 +6193,64 @@
</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).
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
+</parameter_description>
+</parameter>
+<parameter name="angle_start">
+<parameter_description> An angle, as #ClutterFixed, at which movement starts, in
+degrees, between 0 and 360.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_shader_get_vertex_source">
+<description>
+FIXME
+
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+</parameters>
+<return> the source of the vertex shader for this ClutterShader object
+or %NULL. The returned string is owned by the shader object and should never
+be modified or freed
+
+Since: 0.6
+</return>
+</function>
+
+<function name="json_array_sized_new">
+<description>
+Creates a new #JsonArray with @n_elements slots already allocated.
+
+
+</description>
+<parameters>
+<parameter name="n_elements">
+<parameter_description> number of slots to pre-allocate
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #JsonArray
+</return>
+</function>
+
<function name="clutter_timeline_rewind">
<description>
Rewinds #ClutterTimeline to frame 0.
@@ -5088,6 +6318,25 @@
</return>
</function>
+<function name="clutter_model_get_n_rows">
+<description>
+Retrieves the number of rows inside @model.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> The length of the @model. If there is a filter set, then
+the length of the filtered @model is returned.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_behaviour_bspline_set_origin">
<description>
Sets the origin of the bezier to the point represented by knot. (Initially
@@ -5110,94 +6359,104 @@
<return></return>
</function>
-<function name="clutter_actor_get_geometry">
+<function name="clutter_actor_get_clipu">
<description>
-Gets the actors untransformed geometry in pixels relative to any
-parent actor.
+Unit-based variant of clutter_actor_get_clip().
+
+Gets the clip area for @self, in #ClutterUnit&lt;!-- --&gt;s.
+
+Since: 0.6
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="geometry">
-<parameter_description> A location to store actors #ClutterGeometry
+<parameter name="xoff">
+<parameter_description> return location for the X offset of the clip rectangle, or %NULL
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="ClutterActor">
-<description>
-The ::captured-event signal is emitted when an event is captured
-by Clutter.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="actor">
-<parameter_description> the actor which the pointer has left
+<parameter name="yoff">
+<parameter_description> return location for the Y offset of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the width of the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the height of the clip rectangle, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_feature_available">
+<function name="clutter_behaviour_ellipse_get_angle_startx">
<description>
-Checks whether @feature is available. @feature can be a logical
-OR of #ClutterFeatureFlags.
+Gets the angle at which movements starts.
</description>
<parameters>
-<parameter name="feature">
-<parameter_description> a #ClutterFeatureFlags
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a feature is available
+<return> angle, as #ClutterFixed, in degrees.
-Since: 0.1.1
+Since: 0.6
</return>
</function>
-<function name="clutter_stage_get_user_resizable">
+<function name="clutter_actor_get_geometry">
<description>
-Retrieves the value set with clutter_stage_set_user_resizable().
-
+Gets the actors untransformed geometry in pixels relative to any
+parent actor.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="geometry">
+<parameter_description> A location to store actors #ClutterGeometry
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE is the stage is resizable by the user.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_container_sort_depth_order">
+<function name="ClutterActor">
<description>
-Sorts a container children using their depth. This function should not
-be normally used by applications.
+The ::captured-event signal is emitted when an event is captured
+by Clutter. This signal will be emitted starting from the top-level
+container (the #ClutterStage) to the actor which received the event
+going down the hierarchy. This signal can be used to intercept every
+event before the specialized events (like
+ClutterActor::button-press-event or ::key-released-event) are
+emitted.
-Since: 0.6
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="actor">
+<parameter_description> the actor which received the signal
+</parameter_description>
+</parameter>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the event has been handled by the actor,
+or %FALSE to continue the emission.
+
+Since: 0.6
+</return>
</function>
<function name="clutter_behaviour_ellipse_set_width">
@@ -5220,17 +6479,39 @@
<return></return>
</function>
-<function name="clutter_actor_pop_transform_child">
+<function name="clutter_stage_get_key_focus">
<description>
-Cancels the effects of a previous clutter_actor_push_transform_child()
-call.
+Retrieves the actor that is currently under key focus.
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> the actor with key focus, or the stage
Since: 0.6
+</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></return>
+<return> the number of motion events per second
+
+Since: 0.6
+</return>
</function>
<function name="clutter_sine_half_func">
@@ -5257,6 +6538,34 @@
</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> an array of #GType types
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_backend_set_resolution">
<description>
Sets the resolution for font handling on the screen. This is a
@@ -5307,6 +6616,24 @@
<return></return>
</function>
+<function name="clutter_actor_get_widthu">
+<description>
+Retrieves the actors width ignoring any scaling factors.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> The actor width in #ClutterUnit
+
+since: 0.6
+</return>
+</function>
+
<function name="json_node_take_array">
<description>
Sets @array into @node without increasing the #JsonArray reference count.
@@ -5449,20 +6776,14 @@
<return></return>
</function>
-<function name="clutter_stage_set_perspectivex">
+<function name="CLUTTER_ALPHA_SMOOTHSTEP_DEC">
<description>
-Set the stage perspective.
+Convenience symbol for clutter_smoothstep_dec_func().
+
+Since: 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="perspective">
-<parameter_description> A #ClutterPerspective
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -5491,7 +6812,7 @@
<function name="ClutterBehaviourRotate">
<description>
-The z center of rotation.
+The z center of rotation.
Since: 0.4
@@ -5501,50 +6822,68 @@
<return></return>
</function>
-<function name="clutter_actor_set_width">
+<function name="clutter_model_iter_get_valist">
<description>
-Requests a new width for actor
+See clutter_model_iter_get(). This version takes a va_list for language
+bindings.
-since: 2.0
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> Requested new width for actor
+<parameter name="args">
+<parameter_description> a list of column/return location pairs, terminated by -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_rotate_yx">
+<function name="clutter_actor_set_width">
<description>
-Rotates actor around the X axis.
+Requests a new width for actor
+
+since: 0.2
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
+<parameter name="width">
+<parameter_description> Requested new width for actor
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> X co-ord to rotate actor around ( relative to actor position )
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_model_get_column_name">
+<description>
+Retrieves the name of the @column
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> #ClutterModel
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z co-ord to rotate actor around ( relative to actor position )
+<parameter name="column">
+<parameter_description> the column number
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the name of the column. The model holds the returned
+string, and it should not be modified or freed
+
+Since: 0.6
+</return>
</function>
<function name="clutter_do_event">
@@ -5594,6 +6933,8 @@
</parameter>
</parameters>
<return> %TRUE if the score is looping
+
+Since: 0.6
</return>
</function>
@@ -5616,6 +6957,31 @@
</return>
</function>
+<function name="clutter_actor_get_sizeu">
+<description>
+Gets the size of an actor in #ClutterUnit&lt;!-- --&gt;s ignoring any scaling
+factors.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Location to store width if non NULL.
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Location to store height if non NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="pango_clutter_font_map_create_context">
<description>
Create a #PangoContext for the given fontmap.
@@ -5674,6 +7040,24 @@
</return>
</function>
+<function name="clutter_model_iter_get_model">
+<description>
+Retrieves a pointer to the #ClutterModel that this iter is part of.
+
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to a #ClutterModel.
+
+Since: 0.6
+</return>
+</function>
+
<function name="pango_clutter_font_map_substitute_changed">
<description>
Call this function any time the results of the
@@ -5786,25 +7170,37 @@
<return></return>
</function>
-<function name="clutter_group_add">
+<function name="clutter_behaviour_bspline_clear">
<description>
-Adds a new child #ClutterActor to the #ClutterGroup.
+Empties a bspline.
- Deprecated: 0.4: This function is obsolete, use
-clutter_container_add_actor() instead.
+Since: 0.4
</description>
<parameters>
-<parameter name="group">
-<parameter_description> A #ClutterGroup
+<parameter name="bs">
+<parameter_description> a #ClutterBehaviourBspline
</parameter_description>
</parameter>
-<parameter name="actor">
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_yu">
+<description>
+Retrieves the actors y position relative to any parent, in #ClutterUnit
+
+
+</description>
+<parameters>
+<parameter name="self">
<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The actor y position in #ClutterUnit ignoring any tranforms
+(i.e scaling, rotation).
+</return>
</function>
<function name="clutter_behaviour_path_get_knots">
@@ -5824,6 +7220,30 @@
</return>
</function>
+<function name="clutter_actor_get_position">
+<description>
+Retrieves the position of an actor.
+
+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_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_node_set_value">
<description>
Sets @value inside @node. The passed #GValue is copied into the #JsonNode
@@ -5866,6 +7286,8 @@
<description>
Retrieves the stage perspective.
+Since: 0.4
+
</description>
<parameters>
<parameter name="stage">
@@ -5873,43 +7295,65 @@
</parameter_description>
</parameter>
<parameter name="fovy">
-<parameter_description> FIXME
+<parameter_description> return location for the field of view, in degrees, or %NULL
</parameter_description>
</parameter>
<parameter name="aspect">
-<parameter_description> FIXME
+<parameter_description> return location for the aspect ratio, or %NULL
</parameter_description>
</parameter>
<parameter name="z_near">
-<parameter_description> FIXME
+<parameter_description> return location for the distance of the viewer from the
+near clipping plane, or %NULL
</parameter_description>
</parameter>
<parameter name="z_far">
-<parameter_description> FIXME
+<parameter_description> return location for the distance of the viewer from the
+far clipping plane, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_eglx_get_stage_window">
+<function name="clutter_get_default_frame_rate">
<description>
-FIXME
+Retrieves the default frame rate used when creating #ClutterTimeline&lt;!--
+--&gt;s.
+
+This value is also used to compute the default frequency of motion
+events.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
-</parameter_description>
-</parameter>
</parameters>
-<return> FIXME
+<return> the default frame rate
-Since: 0.4
+Since: 0.6
</return>
</function>
+<function name="clutter_actor_set_xu">
+<description>
+Sets the actor's x position relative to its parent.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the actors position on the X axis in #ClutterUnit
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_main_quit">
<description>
Terminates the Clutter mainloop.
@@ -5982,6 +7426,37 @@
</return>
</function>
+<function name="CLUTTER_ALPHA_SMOOTHSTEP_INC">
+<description>
+Convenience symbol for clutter_smoothstep_inc_func().
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_stage_get_resolution">
+<description>
+Retrieves the resolution (in DPI) of the stage from the default
+backend.
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> the resolution of the stage
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_behaviour_scale_get_bounds">
<description>
Retrieves the bounds used by scale behaviour.
@@ -5994,12 +7469,24 @@
<parameter_description> a #ClutterBehaviourScale
</parameter_description>
</parameter>
-<parameter name="scale_begin">
-<parameter_description> return location for the initial scale factor
+<parameter name="x_scale_start">
+<parameter_description> return location for the initial scale factor on the X
+axis, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> return location for the initial scale factor on the Y
+axis, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="x_scale_end">
+<parameter_description> return location for the final scale factor on the X axis,
+or %NULL
</parameter_description>
</parameter>
-<parameter name="scale_end">
-<parameter_description> return location for the final scale factor
+<parameter name="y_scale_end">
+<parameter_description> return location for the final scale factor on the Y axis,
+or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6108,29 +7595,28 @@
</return>
</function>
-<function name="clutter_glx_add_filter">
+<function name="clutter_model_get_iter_at_row">
<description>
-Adds @func to the list of event filters. Filter functions
-receive the raw events and must return %CLUTTER_GLX_FILTER_CONTINUE
-if the event should be processed by Clutter, %CLUTTER_GLX_FILTER_TRANSLATE
-if the event has been translated by the function and it's ready
-to be sent to the stage, or %CLUTTER_GLX_FILTER_REMOVE if the event should
-not be sent to the stage.
+Retrieves a #ClutterModelIter representing the row at the given index.
-Since: 0.4
</description>
<parameters>
-<parameter name="func">
-<parameter_description> an event filter function
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> user data to pass to the function, or %NULL
+<parameter name="row">
+<parameter_description> position of the row to retrieve
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A new #ClutterModelIter, or %NULL if @row was out of bounds.
+When done using the iterator object, call g_object_unref() to deallocate
+its resources
+
+Since: 0.6
+</return>
</function>
<function name="clutter_event_copy">
@@ -6161,6 +7647,25 @@
</return>
</function>
+<function name="clutter_model_get_last_iter">
+<description>
+Retrieves a #ClutterModelIter representing the last row in @model.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> A new #ClutterModelIter. Call g_object_unref() when
+done using it
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_container_remove_actor">
<description>
Removes @actor from @container. The actor should be unparented, so
@@ -6184,47 +7689,71 @@
<return></return>
</function>
-<function name="clutter_timeline_set_duration">
+<function name="clutter_shader_set_fragment_source">
<description>
-Sets the duration of the timeline, in milliseconds. The speed
-of the timeline depends on the ClutterTimeline:fps setting.
+FIXME
+
Since: 0.6
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
-<parameter name="msecs">
-<parameter_description> duration of the timeline in milliseconds
+<parameter name="data">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> FIXME (currently ignored)
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_glx_untrap_x_errors">
+<function name="clutter_get_motion_events_enabled">
<description>
-FIXME
+Gets whether the per-actor motion events are enabled.
</description>
<parameters>
</parameters>
-<return> FIXME
+<return> %TRUE if the motion events are enabled
-Since: 0.4
+Since: 0.6
</return>
</function>
+<function name="clutter_timeline_set_duration">
+<description>
+Sets the duration of the timeline, in milliseconds. The speed
+of the timeline depends on the ClutterTimeline:fps setting.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="msecs">
+<parameter_description> duration of the timeline in milliseconds
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_event_get_source">
<description>
Retrieves the source #ClutterActor the event originated from, or
NULL if the event has no source.
-Since: 0.6
</description>
<parameters>
@@ -6233,7 +7762,10 @@
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterActor
+
+Since: 0.6
+</return>
</function>
<function name="clutter_behaviour_path_remove_knot">
@@ -6309,22 +7841,17 @@
</return>
</function>
-<function name="clutter_perspective_copy">
+<function name="clutter_x11_get_default_display">
<description>
-Makes a copy of the perspective structure. The result must be
-freed using clutter_perspective_free().
+Retrieves the pointer to the default display.
</description>
<parameters>
-<parameter name="perspective">
-<parameter_description> a #ClutterPerspective
-</parameter_description>
-</parameter>
</parameters>
-<return> an allocated copy of @perspective.
+<return> the default display
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -6353,6 +7880,34 @@
<return></return>
</function>
+<function name="clutter_model_iter_set">
+<description>
+Sets the value of one or more cells in the row referenced by @iter. The
+variable argument list should contain integer column numbers, each column
+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;
+clutter_model_iter_set (iter, 0, "foo", -1);
+&lt;/programlisting&gt;&lt;/informalexample&gt;
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of column/return location pairs, terminated by -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_entry_new_with_text">
<description>
Creates a new #ClutterEntry displaying @text using @font_name.
@@ -6375,23 +7930,45 @@
</return>
</function>
-<function name="clutter_behaviour_scale_newx">
+<function name="clutter_x11_get_default_screen">
<description>
-A fixed point implementation of clutter_behaviour_scale_new()
+Gets the number of the default X Screen object.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+</parameters>
+<return> the number of the default screen
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_behaviour_scale_newx">
+<description>
+A fixed point implementation of clutter_behaviour_scale_new()
+
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> initial scale factor on the Y axis
</parameter_description>
</parameter>
-<parameter name="scale_begin">
-<parameter_description> initial scale factor
+<parameter name="x_scale_end">
+<parameter_description> final scale factor on the X axis
</parameter_description>
</parameter>
-<parameter name="scale_end">
-<parameter_description> final scale factor
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
<parameter name="gravity">
@@ -6405,6 +7982,24 @@
</return>
</function>
+<function name="clutter_shader_is_bound">
+<description>
+FIXME
+
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+</parameters>
+<return> FIXME
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_timeline_stop">
<description>
Stops the #ClutterTimeline and moves to frame 0
@@ -6558,44 +8153,39 @@
<return></return>
</function>
-<function name="clutter_media_set_volume">
+<function name="clutter_behaviour_ellipse_set_angle_start">
<description>
-Sets the playback volume of @media to @volume.
+Sets the angle at which movement starts; angles &gt;= 360 degress get clamped
+to the canonical interval &lt;0, 360).
+
+Since: 0.6
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="volume">
-<parameter_description> The volume as a double between 0.0 and 1.0
+<parameter name="angle_start">
+<parameter_description> angle at which movement starts in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_rotate_x">
+<function name="clutter_media_set_volume">
<description>
-Rotates actor around the X axis.
+Sets the playback volume of @media to @volume.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y co-ord to rotate actor around ( relative to actor position )
+<parameter name="media">
+<parameter_description> A #ClutterMedia object
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z co-ord to rotate actor around ( relative to actor position )
+<parameter name="volume">
+<parameter_description> The volume as a double between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
@@ -6650,20 +8240,16 @@
<parameter_description> A #ClutterActor to apply the effect to.
</parameter_description>
</parameter>
-<parameter name="start_opacity">
-<parameter_description> Initial opacity value to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="end_opacity">
+<parameter name="opacity_end">
<parameter_description> Final opacity value to apply to actor
</parameter_description>
</parameter>
-<parameter name="completed_func">
+<parameter name="func">
<parameter_description> A #ClutterEffectCompleteFunc to call on effect
completion or %NULL
</parameter_description>
</parameter>
-<parameter name="completed_data">
+<parameter name="data">
<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
or %NULL
</parameter_description>
@@ -6672,7 +8258,7 @@
<return> a #ClutterTimeline for the effect. Will be unrefed by
the effect when completed.
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -6730,61 +8316,74 @@
</return>
</function>
-<function name="clutter_behaviour_ellipse_get_tilt">
+<function name="clutter_effect_move">
<description>
-Gets the tilt of the ellipse around the center in Y axis.
+Simple effect for moving a single #ClutterActor along to a
+destination point.
-Since: 0.4
-
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="template_">
+<parameter_description> A #ClutterEffectTemplate
</parameter_description>
</parameter>
-<parameter name="angle_tilt_x">
-<parameter_description> location for tilt of the elipse around the center in X axis in
-degrees, or NULL.
+<parameter name="actor">
+<parameter_description> A #ClutterActor to apply the effect to.
</parameter_description>
</parameter>
-<parameter name="angle_tilt_y">
-<parameter_description> location for tilt of the elipse around the center in Y axis in
-degrees, or NULL.
+<parameter name="x">
+<parameter_description> X coordinate of the destination
</parameter_description>
</parameter>
-<parameter name="angle_tilt_z">
-<parameter_description> location for tilt of the elipse around the center in Z axis in
-degrees, or NULL.
+<parameter name="y">
+<parameter_description> Y coordinate of the destination
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> A #ClutterEffectCompleteFunc to call on effect
+completion or %NULL
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
+or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterTimeline for the effect. Will be unreferenced by
+the effect when completed.
+
+Since: 0.6
+</return>
</function>
-<function name="clutter_fixed_qmulx">
+<function name="clutter_behaviour_ellipse_get_tilt">
<description>
+Gets the tilt of the ellipse around the center in Y axis.
+
+Since: 0.4
</description>
<parameters>
-<parameter name="op1">
-<parameter_description> #ClutterFixed
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="op2">
-<parameter_description> #ClutterFixed
+<parameter name="angle_tilt_x">
+<parameter_description> return location for tilt angle on the X axis, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="angle_tilt_y">
+<parameter_description> return location for tilt angle on the Y axis, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="angle_tilt_z">
+<parameter_description> return location for tilt angle on the Z axis, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #ClutterFixed.
-
-Multiplies two fixed values using 64bit arithmetic; this provides
-significantly better precission than the #CLUTTER_FIXED_MUL macro,
-but at performance cost (about 2.7 times slowdown on ARMv5e, and 2 times
-on x86).
-
-Since: 0.3
-</return>
+<return></return>
</function>
<function name="clutter_stage_get_perspectivex">
@@ -6852,6 +8451,25 @@
<return></return>
</function>
+<function name="clutter_actor_get_xu">
+<description>
+Retrieves the actors x position relative to any parent, in #ClutterUnit
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> The actor x position in #ClutterUnit ignoring any tranforms
+(i.e scaling, rotation).
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_color_from_pixel">
<description>
Converts @pixel from the packed representation of a four 8 bit channel
@@ -6904,20 +8522,29 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_angle_begin">
+<function name="clutter_model_appendv">
<description>
-Sets the angle at which movement begins.
+Creates and appends a new row to the #ClutterModel, setting the row
+values for the given @columns upon creation.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> the number of columns and values
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> a vector with the columns to set
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> angle at which movement begins in degrees
+<parameter name="values">
+<parameter_description> a vector with the values
</parameter_description>
</parameter>
</parameters>
@@ -6939,20 +8566,16 @@
<parameter_description> A #ClutterActor to apply the effect to.
</parameter_description>
</parameter>
-<parameter name="start_depth">
-<parameter_description> Initial depth value to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="end_depth">
+<parameter name="depth_end">
<parameter_description> Final depth value to apply to actor
</parameter_description>
</parameter>
-<parameter name="completed_func">
+<parameter name="func">
<parameter_description> A #ClutterEffectCompleteFunc to call on effect
completion or %NULL
</parameter_description>
</parameter>
-<parameter name="completed_data">
+<parameter name="data">
<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
or %NULL
</parameter_description>
@@ -6961,7 +8584,7 @@
<return> a #ClutterTimeline for the effect. Will be unrefed by
the effect when completed.
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -7008,6 +8631,23 @@
<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
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="frames_per_sec">
+<parameter_description> the new default frame rate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_scale_new">
<description>
Creates a new #ClutterBehaviourScale instance.
@@ -7019,12 +8659,20 @@
<parameter_description> a #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="scale_begin">
-<parameter_description> initial scale factor
+<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="scale_end">
-<parameter_description> final scale factor
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
<parameter name="gravity">
@@ -7103,54 +8751,19 @@
</return>
</function>
-<function name="clutter_effect_rotate_z">
+<function name="clutter_stage_get_user_resizable">
<description>
-Simple effect for rotating a single #ClutterActor about z axis.
+Retrieves the value set with clutter_stage_set_user_resizable().
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="angle_begin">
-<parameter_description> Initial angle to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="angle_end">
-<parameter_description> Final angle to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="center_x">
-<parameter_description> Position on X axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="center_y">
-<parameter_description> Position on Y axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="direction">
-<parameter_description> A #ClutterRotateDirection for the rotation.
-</parameter_description>
-</parameter>
-<parameter name="completed_func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or NULL
-</parameter_description>
-</parameter>
-<parameter name="completed_data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or NULL
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
+<return> %TRUE is the stage is resizable by the user.
Since: 0.4
</return>
@@ -7220,14 +8833,38 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt">
-<parameter_description> #ClutterAngle tilt of the elipse around the center in the given
-axis
+<parameter_description> tilt, as #ClutterFixed, of the elipse around the center in the given
+axis in degrees.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_fixed_qdivx">
+<description>
+
+</description>
+<parameters>
+<parameter name="op1">
+<parameter_description> #ClutterFixed
+</parameter_description>
+</parameter>
+<parameter name="op2">
+<parameter_description> #ClutterFixed
+</parameter_description>
+</parameter>
+</parameters>
+<return> #ClutterFixed.
+
+Divides two fixed values using 64bit arithmetic; this provides
+significantly better precission than the #CLUTTER_FIXED_DIV macro,
+but at performance cost.
+
+Since: 0.4
+</return>
+</function>
+
<function name="clutter_behaviour_rotate_get_direction">
<description>
Retrieves the #ClutterRotateDirection used by the rotate behaviour.
@@ -7246,75 +8883,50 @@
</return>
</function>
-<function name="clutter_effect_rotate_x">
+<function name="clutter_score_remove_all">
<description>
-Simple effect for rotating a single #ClutterActor about y axis.
+Removes all the timelines inside @score.
+Since: 0.6
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="angle_begin">
-<parameter_description> Initial angle to apply to actor
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
-<parameter name="angle_end">
-<parameter_description> Final angle to apply to actor
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_ellipse_set_direction">
+<description>
+Sets the rotation direction used by the ellipse behaviour.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="center_y">
-<parameter_description> Position on Y axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="center_z">
-<parameter_description> Position on Z axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="direction">
-<parameter_description> A #ClutterRotateDirection for the rotation.
-</parameter_description>
-</parameter>
-<parameter name="completed_func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or NULL
-</parameter_description>
-</parameter>
-<parameter name="completed_data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or NULL
+<parameter name="direction">
+<parameter_description> the rotation direction
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_direction">
+<function name="clutter_ungrab_keyboard">
<description>
-Sets the rotation direction used by the ellipse behaviour.
+Removes an existing grab of the keyboard.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-<parameter name="direction">
-<parameter_description> the rotation direction
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -7337,40 +8949,68 @@
</return>
</function>
-<function name="clutter_actor_get_ryang">
+<function name="clutter_model_set_sorting_column">
<description>
-Gets the angle of rotation around the Y axis.
+Sets the model to sort by @column. If @column is a negative value
+the sorting column will be unset.
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column of the @model to sort, or -1
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation
+<return></return>
+</function>
-Since: 0.4
+<function name="clutter_ungrab_pointer">
+<description>
+Removes an existing grab of the pointer.
+
+Since: 0.6
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_get_pointer_grab">
+<description>
+Queries the current pointer grab of clutter.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the actor currently holding the pointer grab, or NULL if there is no grab.
+
+Since: 0.6
</return>
</function>
-<function name="clutter_entry_get_max_length">
+<function name="clutter_behaviour_ellipse_get_angle_start">
<description>
-Gets the maximum length of text that can be set into @entry.
-See clutter_entry_set_max_length().
+Gets the angle at which movements starts.
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
</parameters>
-<return> the maximum number of characters.
+<return> angle in degrees
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -7411,6 +9051,47 @@
<return></return>
</function>
+<function name="clutter_effect_path">
+<description>
+Simple effect for moving a single #ClutterActor along a path.
+
+
+</description>
+<parameters>
+<parameter name="template_">
+<parameter_description> A #ClutterEffectTemplate
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> A #ClutterActor to apply the effect to.
+</parameter_description>
+</parameter>
+<parameter name="knots">
+<parameter_description> An array of #ClutterKnots representing path for the actor
+</parameter_description>
+</parameter>
+<parameter name="n_knots">
+<parameter_description> Number of #ClutterKnots in passed array.
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> A #ClutterEffectCompleteFunc to call on effect
+completion or %NULL
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
+or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterTimeline for the effect. Will be unreferenced by
+the effect when completed.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_actor_get_depth">
<description>
Retrieves the depth of @self.
@@ -7447,6 +9128,33 @@
<return></return>
</function>
+<function name="clutter_actor_set_anchor_point">
+<description>
+Sets an anchor point for the @actor. The anchor point is a point in the
+coordinate space of an actor to which the actor position within its
+parent is relative; the default is (0, 0), i.e. the top-left corner of
+the actor.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="anchor_x">
+<parameter_description> X coordinate of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> Y coordinate of the anchor point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_media_get_can_seek">
<description>
Retrieves whether @media is seekable or not.
@@ -7463,29 +9171,21 @@
</return>
</function>
-<function name="clutter_box_query_child">
+<function name="clutter_actor_get_name">
<description>
-Queries @box for the packing data of @actor.
+Retrieves the name of @self.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> child to query
-</parameter_description>
-</parameter>
-<parameter name="child">
-<parameter_description> return location for a #ClutterBoxChild or %NULL
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @actor is a child of @box
-
-Since: 0.4
+<return> pointer to textual tag for the actor. The
+returned string is owned by the actor and should not
+be modified or freed.
</return>
</function>
@@ -7547,18 +9247,48 @@
<return></return>
</function>
-<function name="clutter_glx_trap_x_errors">
+<function name="clutter_model_set_names">
<description>
-FIXME
+Assigns a name to the columns of a #ClutterModel.
-Since: 0.4
+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> the number of column names
+</parameter_description>
+</parameter>
+<parameter name="names">
+<parameter_description> an array of strings
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_x11_get_root_window">
+<description>
+Retrieves the root window.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the id of the root window
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_actor_event">
<description>
This function is used to emit an event on the main stage.
@@ -7623,69 +9353,52 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_angle_begin">
+<function name="json_object_get_members">
<description>
-Gets the angle at which movements begins.
+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="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
</parameters>
-<return> angle in degrees
-
-Since: 0.4
+<return> a #GList of member names. The content of the list
+is owned by the #JsonObject and should never be modified or
+freed. When you have finished using the returned list, use
+g_list_free() to free the resources it has allocated.
</return>
</function>
-<function name="clutter_entry_set_max_length">
+<function name="clutter_stage_get_resolutionx">
<description>
-Sets the maximum allowed length of the contents of the actor. If the
-current contents are longer than the given length, then they will be
-truncated to fit.
+Fixed point version of clutter_stage_get_resolution().
-Since: 0.4
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #ClutterEntry
-</parameter_description>
-</parameter>
-<parameter name="max">
-<parameter_description> the maximum number of characters allowed in the entry, or -1
-to disable
+<parameter name="stage">
+<parameter_description> the #ClutterStage
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the resolution of the stage
+
+Since: 0.6
+</return>
</function>
-<function name="clutter_actor_rotate_zx">
+<function name="CLUTTER_ALPHA_EXP_DEC">
<description>
-Rotates actor around the Z axis.
+Convenience symbold for clutter_exp_dec_func().
+
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X co-ord to rotate actor around ( relative to actor position )
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y co-ord to rotate actor around ( relative to actor position )
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -7713,6 +9426,22 @@
<return></return>
</function>
+<function name="CLUTTER_ACTOR_IS_MAPPED">
+<description>
+Evaluates to %TRUE if the %CLUTTER_ACTOR_MAPPED flag is set.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="e">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_ellipse_get_center">
<description>
Gets the center of the elliptical path path.
@@ -7757,24 +9486,6 @@
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_angle_beginx">
-<description>
-Gets the angle at which movements begins.
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #ClutterAngle
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_label_set_line_wrap_mode">
<description>
If line wrapping is on (see clutter_label_set_line_wrap()) this controls how
@@ -7799,8 +9510,10 @@
<function name="ClutterScore">
<description>
-The ::new-timeline signal is emitted each time a new timeline in the
-score is reached.
+The ::paused signal is emitted each time a #ClutterScore
+is paused.
+
+Since: 0.6
</description>
<parameters>
@@ -7808,10 +9521,6 @@
<parameter_description> the score which received the signal
</parameter_description>
</parameter>
-<parameter name="timeline">
-<parameter_description> the current timeline
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -7852,30 +9561,115 @@
</return>
</function>
-<function name="clutter_score_add">
+<function name="clutter_model_append">
<description>
-Adds a new initial timeline to start when the score is started.
+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;
+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;
+Since: 0.6
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="Varargs">
+<parameter_description> pairs of column number and value, terminated with -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_parser_new">
+<function name="clutter_stage_set_perspectivex">
<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.
+Set the stage perspective.
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> A #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="perspective">
+<parameter_description> A #ClutterPerspective
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_script_get_object">
+<description>
+Retrieves the object bound to @name. This function does not increment
+the reference count of the returned object.
+
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the object to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> the named object, or %NULL if no object with the
+given name was available
+
+Since: 0.6
+</return>
+</function>
+
+<function name="CLUTTER_ACTOR_IS_VISIBLE">
+<description>
+Evaluates to %TRUE if the actor is both realized and mapped.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="e">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_util_next_p2">
+<description>
+Calculates the next power greater than @a.
+
+
+</description>
+<parameters>
+<parameter name="a">
+<parameter_description> Value to get the next power
+</parameter_description>
+</parameter>
+</parameters>
+<return> The next power after @a.
+</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>
@@ -7886,6 +9680,30 @@
</return>
</function>
+<function name="clutter_group_lower">
+<description>
+FIXME
+
+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_actor_get_size">
<description>
Gets the size of an actor in pixels ignoring any scaling factors.
@@ -7971,6 +9789,31 @@
<return></return>
</function>
+<function name="clutter_model_iter_get_value">
+<description>
+Sets an initializes @value to that at @column. When done with @value,
+g_value_unset() needs to be called to free any allocated memory.
+
+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> an empty #GValue to set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_alpha_get_timeline">
<description>
Gets the #ClutterTimeline bound to @alpha.
@@ -8007,6 +9850,20 @@
<return></return>
</function>
+<function name="clutter_shader_new">
+<description>
+FIXME
+
+
+</description>
+<parameters>
+</parameters>
+<return> FIXME
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_media_get_uri">
<description>
Retrieves the URI from @media.
@@ -8065,6 +9922,33 @@
<return></return>
</function>
+<function name="clutter_actor_set_anchor_pointu">
+<description>
+Sets an anchor point for the @self. The anchor point is a point in the
+coordinate space of an actor to which the actor position within its
+parent is relative; the default is (0, 0), i.e. the top-left corner
+of the actor.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="anchor_x">
+<parameter_description> X coordinate of the anchor point, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> Y coordinate of the anchor point, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_bspline_join">
<description>
Joins a copy of bezier spline bs2 onto the end of bezier spline bs1; bs2 is
@@ -8090,6 +9974,8 @@
<description>
Sets #ClutterTexture image data.
+Note: This function is likely to change in future versions.
+
</description>
<parameters>
@@ -8126,13 +10012,13 @@
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> FIXME.
+<parameter_description> return location for a #GError, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> TRUE on success, FALSE on failure.
+<return> %TRUE on success, %FALSE on failure.
-Since 0.4. This function is likely to change in future versions.
+Since: 0.4.
</return>
</function>
@@ -8163,6 +10049,33 @@
<return></return>
</function>
+<function name="clutter_stage_set_use_fog">
+<description>
+Sets whether the depth cueing effect on the stage should be enabled
+or not.
+
+Depth cueing is a 3D effect that makes actors farther away from the
+viewing point less opaque, by fading them with the stage color.
+
+The parameters of the GL fog used can be changed using the
+clutter_stage_set_fog() function.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> the #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="fog">
+<parameter_description> %TRUE for enabling the depth cueing effect
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_node_dup_object">
<description>
Retrieves the #JsonObject inside @node. The reference count of
@@ -8180,108 +10093,114 @@
</return>
</function>
-<function name="clutter_actor_rotate_z">
+<function name="clutter_behaviour_ellipse_get_angle_tiltx">
<description>
-Rotates actor around the Z axis.
+Gets the tilt of the ellipse around the center in the given axis.
+
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> X co-ord to rotate actor around ( relative to actor position )
+<parameter name="axis">
+<parameter_description> a #ClutterRotateAxis
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> Y co-ord to rotate actor around ( relative to actor position )
+</parameters>
+<return> angle, as #ClutterFixed, in degrees
+
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_label_get_use_markup">
+<description>
+Return value: %TRUE if the label's text will be parsed for markup.
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #ClutterLabel
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the label's text will be parsed for markup.
+</return>
</function>
-<function name="clutter_behaviour_ellipse_get_angle_tiltx">
+<function name="clutter_event_new">
<description>
-Gets the tilt of the ellipse around the center in the given axis.
+Creates a new #ClutterEvent of the specified type.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> a #ClutterRotateAxis
+<parameter name="type">
+<parameter_description> The type of event.
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterAngle
-
-Since: 0.4
+<return> A newly allocated #ClutterEvent.
</return>
</function>
-<function name="clutter_actor_rotate_y">
+<function name="clutter_actor_get_rotationx">
<description>
-Rotates actor around the X axis.
+Retrieves the angle and center of rotation on the given axis,
+set using clutter_actor_set_rotation().
+
+This function is the fixed point variant of clutter_actor_get_rotation().
+
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="angle">
-<parameter_description> Angle of rotation
+<parameter name="axis">
+<parameter_description> the axis of rotation
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> X co-ord to rotate actor around ( relative to actor position )
+<parameter_description> return value for the X coordinate of the center of rotation
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z co-ord to rotate actor around ( relative to actor position )
+<parameter name="y">
+<parameter_description> return value for the Y coordinate of the center of rotation
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_label_get_use_markup">
-<description>
-Return value: %TRUE if the label's text will be parsed for markup.
-
-</description>
-<parameters>
-<parameter name="label">
-<parameter_description> a #ClutterLabel
+<parameter name="z">
+<parameter_description> return value for the Z coordinate of the center of rotation
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the label's text will be parsed for markup.
+<return> the angle of rotation as a fixed point value.
+
+Since: 0.6
</return>
</function>
-<function name="clutter_event_new">
+<function name="clutter_score_list_timelines">
<description>
-Creates a new #ClutterEvent of the specified type.
+Retrieves a list of all the #ClutterTimelines managed by @score.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> The type of event.
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #ClutterEvent.
+<return> a #GSList containing all the timelines in the score.
+This function does not increase the reference count of the
+returned timelines. Use g_slist_free() on the returned list to
+deallocate its resources.
+
+Since: 0.6
</return>
</function>
@@ -8303,28 +10222,30 @@
</return>
</function>
-<function name="clutter_container_find_child_by_id">
+<function name="clutter_behaviour_bspline_append_knots">
<description>
-Finds a child actor of a container by its unique ID. Search recurses
-into any child container.
+Appends a bezier spline defined by the last control point of bezier spline
+bs and the array of #ClutterKnot control points to the orginal bezier spline
+bs.
+Since: 0.6
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="bs">
+<parameter_description> a #ClutterBehaviourBspline
+</parameter_description>
+</parameter>
+<parameter name="first_knot">
+<parameter_description> first #ClutterKnot
</parameter_description>
</parameter>
-<parameter name="child_id">
-<parameter_description> the unique id of an actor
+<parameter name="VarArgs">
+<parameter_description> a NULL-terminated array of #ClutterKnot control points.
</parameter_description>
</parameter>
</parameters>
-<return> The child actor with the requested id, or %NULL if no
-actor with that id was found
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_ellipse_get_angle_tilt">
@@ -8383,57 +10304,36 @@
<return></return>
</function>
-<function name="clutter_eglx_get_default_xdisplay">
+<function name="CLUTTER_ALPHA_SINE">
<description>
-Return value: A Display pointer
+Convenience symbol for clutter_sine_func().
+
+Since: 0.2
</description>
<parameters>
</parameters>
-<return> A Display pointer
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_effect_move">
+<function name="clutter_model_iter_prev">
<description>
-Simple effect for moving a single #ClutterActor along a path.
+Sets the @iter to point at the previous position in the model.
+The model implementation should take into account the presence of
+a filter function.
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="knots">
-<parameter_description> An array of #ClutterKnots representing path for the actor
-</parameter_description>
-</parameter>
-<parameter name="n_knots">
-<parameter_description> Number of #ClutterKnots in passed array.
-</parameter_description>
-</parameter>
-<parameter name="completed_func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or %NULL
-</parameter_description>
-</parameter>
-<parameter name="completed_data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or %NULL
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
+<return> The passed iterator, updated to point at the previous
+row in the model.
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -8456,7 +10356,7 @@
<description>
Requests a new height for actor
-since: 2.0
+since: 0.2
</description>
<parameters>
@@ -8506,6 +10406,24 @@
</return>
</function>
+<function name="clutter_label_get_justify">
+<description>
+Retrieves whether the label should justify the text on both margins.
+
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #ClutterLabel
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the text should be justified
+
+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.
@@ -8519,18 +10437,18 @@
</parameter_description>
</parameter>
<parameter name="angle_tilt_x">
-<parameter_description> #ClutterAngle location for tilt of the elipse around the
-center in X axis, or NULL.
+<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
+center in X axis in degrees, or NULL.
</parameter_description>
</parameter>
<parameter name="angle_tilt_y">
-<parameter_description> #ClutterAngle location for tilt of the elipse around the
-center in Y axis, or NULL.
+<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
+center in Y axis in degress, or NULL.
</parameter_description>
</parameter>
<parameter name="angle_tilt_z">
-<parameter_description> #ClutterAngle location for tilt of the elipse around the
-center in Z axis, or NULL.
+<parameter_description> location for tilt of the elipse, as #ClutterFixed, around the
+center in Z axis in degrees, or NULL.
</parameter_description>
</parameter>
</parameters>
@@ -8557,6 +10475,54 @@
<return></return>
</function>
+<function name="clutter_stage_get_fog">
+<description>
+Retrieves the settings used by the GL fog to create the
+depth cueing effect on the @stage.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="density">
+<parameter_description> return location for the intensity dampening
+</parameter_description>
+</parameter>
+<parameter name="z_near">
+<parameter_description> return location for the starting point of the depth cueing
+</parameter_description>
+</parameter>
+<parameter name="z_far">
+<parameter_description> return location for the ending point of the depth cueing
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_model_iter_is_first">
+<description>
+Gets whether the current iterator is at the beginning of the model
+to which it belongs.
+
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE if @iter is the first iter in the filtered model
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_entry_set_font_name">
<description>
Sets @font_name as the font used by @entry.
@@ -8581,24 +10547,22 @@
<return></return>
</function>
-<function name="clutter_group_lower">
+<function name="clutter_label_set_justify">
<description>
-FIXME
+Sets whether the text of the @label actor should be justified
+on both margins. This setting is ignored if Clutter is compiled
+against Pango &gt; 1.18.
-Deprecated: 0.6: Use clutter_container_lower_child() instead
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="label">
+<parameter_description> a #ClutterLabel
</parameter_description>
</parameter>
-<parameter name="sibling">
-<parameter_description> a #ClutterActor
+<parameter name="justify">
+<parameter_description> whether the text should be justified
</parameter_description>
</parameter>
</parameters>
@@ -8702,7 +10666,9 @@
<function name="clutter_actor_set_clip">
<description>
-Sets clip area in pixels for @self.
+Sets clip area in pixels for @self. The clip area is always computed
+from the upper left corner of the actor, even if the anchor point is
+set otherwise.
</description>
<parameters>
@@ -8711,19 +10677,49 @@
</parameter_description>
</parameter>
<parameter name="xoff">
-<parameter_description> X offset of the clip rectangle
+<parameter_description> X offset of the clip rectangle, in pixels
</parameter_description>
</parameter>
<parameter name="yoff">
-<parameter_description> Y offset of the clip rectangle
+<parameter_description> Y offset of the clip rectangle, in pixels
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> Width of the clip rectangle
+<parameter_description> Width of the clip rectangle, in pixels
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> Height of the clip rectangle
+<parameter_description> Height of the clip rectangle, in pixels
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_script_connect_signals">
+<description>
+Connects all the signals defined into a UI definition file to their
+handlers.
+
+This method is a simpler variation of clutter_script_connect_signals_full().
+It uses #GModule's introspective features (by opening the module %NULL)
+to look at the application's symbol table. From here it tries to match
+the signal handler names given in the interface description with
+symbols in the application and connects the signals.
+
+Note that this function will not work correctly if #GModule is not
+supported on the platform.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to be passed to the signal handlers, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -8777,6 +10773,18 @@
</return>
</function>
+<function name="CLUTTER_ALPHA_SINE_INC">
+<description>
+Convenience symbol for clutter_sine_inc_func().
+
+Since: 0.2
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_timeline_set_loop">
<description>
Sets whether @timeline should loop.
@@ -8831,6 +10839,31 @@
<return></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_timeout_pool_remove">
<description>
Removes a timeout function with @id from the timeout pool. The id
@@ -8853,6 +10886,48 @@
<return></return>
</function>
+<function name="clutter_x11_get_stage_visual">
+<description>
+Return value: The XVisualInfo for the stage.
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> The XVisualInfo for the stage.
+
+Since: 0.4
+</return>
+</function>
+
+<function name="clutter_scriptable_set_id">
+<description>
+Sets @id as the unique Clutter script it for this instance of
+#ClutterScriptableIface.
+
+This name can be used by user interface designer applications to
+define a unique name for an object constructable using the UI
+definition language parsed by #ClutterScript.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="scriptable">
+<parameter_description> a #ClutterScriptable
+</parameter_description>
+</parameter>
+<parameter name="id">
+<parameter_description> the #ClutterScript id of the object
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_texture_get_n_tiles">
<description>
Retreives internal tile dimentioning.
@@ -8901,38 +10976,60 @@
<return></return>
</function>
-<function name="clutter_box_set_default_padding">
+<function name="clutter_effect_rotate">
<description>
-Sets the default padding for children, which will be used when
-packing actors with clutter_box_pack_defaults(). The padding is
-given in pixels.
+Simple effect for rotating a single #ClutterActor.
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
+<parameter name="template_">
+<parameter_description> a #ClutterEffectTemplate
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor to apply the effect to.
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> final angle to apply to actor
+</parameter_description>
+</parameter>
+<parameter name="center_x">
+<parameter_description> position on X axis to rotate about.
+</parameter_description>
+</parameter>
+<parameter name="center_y">
+<parameter_description> position on Y axis to rotate about.
</parameter_description>
</parameter>
-<parameter name="padding_top">
-<parameter_description> top padding, in pixels
+<parameter name="center_z">
+<parameter_description> position on Z axis to rotate about.
</parameter_description>
</parameter>
-<parameter name="padding_right">
-<parameter_description> right padding, in pixels
+<parameter name="direction">
+<parameter_description> a #ClutterRotateDirection for the rotation.
</parameter_description>
</parameter>
-<parameter name="padding_bottom">
-<parameter_description> bottom padding, in pixels
+<parameter name="func">
+<parameter_description> a #ClutterEffectCompleteFunc to call on effect
+completion or %NULL
</parameter_description>
</parameter>
-<parameter name="padding_left">
-<parameter_description> left padding, in pixels
+<parameter name="data">
+<parameter_description> user data to pass to supplied @func or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterTimeline for the effect. Will be unreferenced by
+the effect when completed.
+
+Since: 0.6
+</return>
</function>
<function name="clutter_timeline_new_for_duration">
@@ -8955,24 +11052,56 @@
</return>
</function>
-<function name="clutter_behaviour_ellipse_set_angle_beginx">
+<function name="clutter_model_iter_get_row">
<description>
-Sets the angle at which movement begins.
+Retrieves the position of the row that the @iter points to.
-Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> the position of the @iter in the model
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_effect_template_new_for_duration">
+<description>
+Creates a new #ClutterEffectTemplate, to be used with the effects API.
+
+A #ClutterEffectTemplate binds a timeline and an alpha function and can
+be used as a template for multiple calls of clutter_effect_fade(),
+clutter_effect_move() and clutter_effect_scale().
+
+This API is intended for simple animations involving a single actor;
+for more complex animations, you should see #ClutterBehaviour and the
+derived classes.
+
+This function creates a #ClutterTimeline with a duration of @msecs
+milliseconds and transfers ownership of the timeline object to the
+returned #ClutterEffectTemplate.
+
+
+</description>
+<parameters>
+<parameter name="msecs">
+<parameter_description> the duration of the effects, in milliseconds
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> #ClutterAngle at which movement begins
+<parameter name="alpha_func">
+<parameter_description> an alpha function to use for the template
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterEffectTemplate object
+
+Since: 0.6
+</return>
</function>
<function name="ClutterEffectTemplate">
@@ -9075,6 +11204,28 @@
</return>
</function>
+<function name="clutter_score_remove">
+<description>
+Removes the #ClutterTimeline with the given id inside @score. If
+the timeline has other timelines attached to it, those are removed
+as well.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="score">
+<parameter_description> a #ClutterScore
+</parameter_description>
+</parameter>
+<parameter name="id">
+<parameter_description> the id of the timeline to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_ramp_dec_func">
<description>
Convenience alpha function for a monotonic decreasing ramp. You
@@ -9179,6 +11330,26 @@
</return>
</function>
+<function name="clutter_behaviour_scale_set_gravity">
+<description>
+Sets the #ClutterGravity applied by the scale behaviour.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="scale">
+<parameter_description> a #ClutterBehaviourScale
+</parameter_description>
+</parameter>
+<parameter name="gravity">
+<parameter_description> the gravity of the scaling
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_container_lower_child">
<description>
Lowers @actor at @sibling level, in the depth ordering.
@@ -9234,6 +11405,27 @@
<return></return>
</function>
+<function name="clutter_model_iter_set_valist">
+<description>
+See clutter_model_iter_set(); this version takes a va_list for language
+bindings.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> va_list of column/value pairs, terminiated by -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_newx">
<description>
Creates a new #ClutterBehaviourRotate. This is the fixed point version
@@ -9254,12 +11446,14 @@
<parameter_description> the rotation direction
</parameter_description>
</parameter>
-<parameter name="angle_begin">
-<parameter_description> the starting angle, in fixed point notation
+<parameter name="angle_start">
+<parameter_description> the starting angle, in fixed point notation in degrees,
+between 0 and 360.
</parameter_description>
</parameter>
<parameter name="angle_end">
-<parameter_description> the final angle, in fixed point notation
+<parameter_description> the final angle, in fixed point notation in degrees, between 0
+and 360.
</parameter_description>
</parameter>
</parameters>
@@ -9323,19 +11517,22 @@
</parameter_description>
</parameter>
<parameter name="fovy">
-<parameter_description> FIXME
+<parameter_description> the field of view angle, in degrees, in the y direction
</parameter_description>
</parameter>
<parameter name="aspect">
-<parameter_description> FIXME
+<parameter_description> the aspect ratio that determines the field of view in the x
+direction. The aspect ratio is the ratio of x (width) to y (height)
</parameter_description>
</parameter>
<parameter name="z_near">
-<parameter_description> FIXME
+<parameter_description> the distance from the viewer to the near clipping
+plane (always positive)
</parameter_description>
</parameter>
<parameter name="z_far">
-<parameter_description> FIXME
+<parameter_description> the distance from the viewer to the far clipping
+plane (always positive)
</parameter_description>
</parameter>
</parameters>
@@ -9538,24 +11735,53 @@
</return>
</function>
-<function name="clutter_layout_height_for_width">
+<function name="clutter_score_is_playing">
<description>
-Queries a #ClutterLayout actor for its height with a known width.
+Query state of a #ClutterScore instance.
-Since: 0.4
</description>
<parameters>
-<parameter name="layout">
-<parameter_description> a #ClutterLayout
+<parameter name="score">
+<parameter_description> A #ClutterScore
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> width allocated by the parent
+</parameters>
+<return> %TRUE if score is currently playing
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_model_insert">
+<description>
+Inserts a new row to the #ClutterModel at @row, setting the row
+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;
+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;
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> return location for the height
+<parameter name="row">
+<parameter_description> the position to insert the new row
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> pairs of column number and value, terminated with -1
</parameter_description>
</parameter>
</parameters>
@@ -9615,22 +11841,34 @@
<return></return>
</function>
-<function name="clutter_event_get_state">
+<function name="clutter_alpha_set_func">
<description>
-Retrieves the modifier state of the event.
+Sets the #ClutterAlphaFunc function used to compute
+the alpha value at each frame of the #ClutterTimeline
+bound to @alpha.
+Since: 0.2
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> A #ClutterAlphaAlphaFunc
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to be passed to the alpha function, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> notify function used when disposing the alpha function
</parameter_description>
</parameter>
</parameters>
-<return> the modifier state parameter, or 0
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_timeline_skip">
@@ -9669,38 +11907,48 @@
</return>
</function>
-<function name="clutter_box_get_margin">
+<function name="clutter_actor_set_opacity">
<description>
-Gets the value set using clutter_box_set_margin().
-
-Since: 0.4
+Sets the actors opacity, with zero being completely transparent and
+255 (0xff) as fully opaque.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="margin">
-<parameter_description> return location for a #ClutterMargin
+<parameter name="opacity">
+<parameter_description> New opacity value for actor.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_set_opacity">
+<function name="clutter_script_connect_signals_full">
<description>
-Sets the actors opacity, with zero being completely transparent.
+Connects all the signals defined into a UI definition file to their
+handlers.
+
+This function is similar to clutter_script_connect_signals() but it
+does not require GModule to be supported. It is mainly targeted at
+interpreted languages for controlling the signal connection.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="opacity">
-<parameter_description> New opacity value for actor.
+<parameter name="func">
+<parameter_description> signal connection function
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to be passed to the signal handlers, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -9923,36 +12171,83 @@
</return>
</function>
-<function name="clutter_actor_get_ryangx">
+<function name="clutter_actor_set_rotationx">
<description>
-Gets the angle of rotation around the Y axis.
+Sets the rotation angle of @self around the given axis.
+
+This function is the fixed point variant of clutter_actor_set_rotation().
+Since: 0.6
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the rotation center
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the rotation center
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> Z coordinate of the rotation center
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation, as a fixed point value
+<return></return>
+</function>
+
+<function name="clutter_behaviour_rotate_set_center">
+<description>
+Sets the center of rotation. The coordinates are relative to the plane
+normal to the rotation axis set with clutter_behaviour_rotate_set_axis().
Since: 0.4
-</return>
+
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X axis center of rotation
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y axis center of rotation
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> Z axis center of rotation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="clutter_glx_get_root_window">
+<function name="ClutterShader">
<description>
FIXME
+Since: 0.6
</description>
<parameters>
</parameters>
-<return> FIXME
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_texture_new_from_pixbuf">
@@ -10004,27 +12299,6 @@
<return></return>
</function>
-<function name="clutter_box_set_margin">
-<description>
-Sets the margin, in #ClutterUnit&lt;!-- --&gt;s, between the inner border
-of the box and the children of the box.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="margin">
-<parameter_description> a #ClutterMargin, or %NULL to unset the margin
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="ClutterRectangle">
<description>
Whether the #ClutterRectangle should be displayed with a border.
@@ -10065,7 +12339,7 @@
Bspline is defined by 3n + 1 points, n &gt;=1; any trailing points passed
into this function are stored internally and used during any subsequent
-clutter_behaviour_bspline_append() operations.
+clutter_behaviour_bspline_append_* operations.
</description>
@@ -10089,6 +12363,69 @@
</return>
</function>
+<function name="clutter_actor_transform_stage_point">
+<description>
+The function translates point with screen coordinates (@x, @y) to
+coordinates relative to the actor, i.e. it can be used to translate
+screen events from global screen coordinates into local coordinates.
+
+The conversion can fail, notably if the transform stack results in the
+actor being projected on the screen as a mere line.
+
+The conversion should not be expected to be pixel-perfect due to the
+nature of the operation. In general the error grows when the skewing
+of the actor rectangle on screen increases.
+
+Note: This function is fairly computationally intensive.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> x screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y screen coordinate of the point to unproject, in #ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="x_out">
+<parameter_description> return location for the unprojected x coordinance, in
+#ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+<parameter name="y_out">
+<parameter_description> return location for the unprojected y coordinance, in
+#ClutterUnit&lt;!-- --&gt;s
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if conversion was successful.
+
+Since: 0.6
+</return>
+</function>
+
+<function name="ClutterModel">
+<description>
+The ::filter-changed signal is emitted when a new filter has been applied
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the #ClutterModel on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_script_get_type_from_name">
<description>
Looks up a type by name, using the virtual function that
@@ -10114,6 +12451,31 @@
</return>
</function>
+<function name="clutter_actor_set_positionu">
+<description>
+Sets the actors position in #ClutterUnit relative to any
+parent actor.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> New left position of actor in #ClutterUnit
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> New top position of actor in #ClutterUnit
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="ClutterTimeline">
<description>
The ::paused signal is emitted when clutter_timeline_pause() is invoked.
@@ -10128,6 +12490,46 @@
<return></return>
</function>
+<function name="clutter_actor_set_x">
+<description>
+Sets the actor's x position relative to its parent.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the actors position on the X axis
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_y">
+<description>
+Sets the actor's y position relative to its parent.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the actors position on the Y axis
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_depth_new">
<description>
Creates a new #ClutterBehaviourDepth which can be used to control
@@ -10140,11 +12542,11 @@
<parameter_description> a #ClutterAlpha or %NULL
</parameter_description>
</parameter>
-<parameter name="start_depth">
+<parameter name="depth_start">
<parameter_description> start depth
</parameter_description>
</parameter>
-<parameter name="end_depth">
+<parameter name="depth_end">
<parameter_description> end depth
</parameter_description>
</parameter>
@@ -10155,36 +12557,22 @@
</return>
</function>
-<function name="clutter_box_get_default_padding">
+<function name="clutter_model_get_n_columns">
<description>
-Gets the default padding set with clutter_box_set_default_padding().
+Retrieves the number of columns inside @model.
-Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="padding_top">
-<parameter_description> return location for the top padding, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="padding_right">
-<parameter_description> return location for the right padding, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="padding_bottom">
-<parameter_description> return location for the bottom padding, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="padding_left">
-<parameter_description> return location for the left padding, or %NULL
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the number of columns
+
+Since: 0.6
+</return>
</function>
<function name="json_node_get_array">
@@ -10220,10 +12608,30 @@
</return>
</function>
+<function name="clutter_model_iter_is_last">
+<description>
+Gets whether the iterator is at the end of the model to which it
+belongs.
+
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE if @iter is the last iter in the filtered model.
+
+Since: 0.6
+</return>
+</function>
+
<function name="clutter_score_start">
<description>
-Query state of a #ClutterScore instance.
+Starts the score.
+Since: 0.6
</description>
<parameters>
@@ -10232,8 +12640,7 @@
</parameter_description>
</parameter>
</parameters>
-<return> TRUE if score is currently playing, FALSE if not.
-</return>
+<return></return>
</function>
<function name="clutter_actor_get_scalex">
@@ -10446,39 +12853,21 @@
</return>
</function>
-<function name="clutter_glx_remove_filter">
+<function name="clutter_actor_get_reactive">
<description>
-Removes @func from the list of filter functions installed
+Checks whether @actor is marked as reactive.
-Since: 0.4
</description>
<parameters>
-<parameter name="func">
-<parameter_description> the filter function to remove
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> user data of the filter function, or %NULL
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_actor_get_id">
-<description>
-Retrieves the unique id for @self.
-
+<return> %TRUE if the actor is reactive
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return> Globally unique value for object instance.
+Since: 0.6
</return>
</function>
@@ -10630,22 +13019,29 @@
</return>
</function>
-<function name="clutter_actor_get_rzangx">
+<function name="clutter_behaviour_opacity_get_bounds">
<description>
-Gets the angle of rotation around x axis in degrees.
+Gets the initial and final levels of the opacity applied by @behaviour
+on each actor it controls.
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="behaviour">
+<parameter_description> a #ClutterBehaviourOpacity
+</parameter_description>
+</parameter>
+<parameter name="opacity_start">
+<parameter_description> return location for the minimum level of opacity, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="opacity_end">
+<parameter_description> return location for the maximum level of opacity, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the angle of rotation, as a fixed point value
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_actor_get_abs_size">
@@ -10671,6 +13067,18 @@
<return></return>
</function>
+<function name="CLUTTER_ALPHA_RAMP_DEC">
+<description>
+Convenience symbol for clutter_ramp_dec_func().
+
+Since: 0.2
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_threads_enter">
<description>
Locks the Clutter thread lock.
@@ -10717,34 +13125,6 @@
</return>
</function>
-<function name="clutter_box_pack">
-<description>
-Packs @actor into @box.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor to pack into the box
-</parameter_description>
-</parameter>
-<parameter name="pack_type">
-<parameter_description> Type of packing to use
-</parameter_description>
-</parameter>
-<parameter name="padding">
-<parameter_description> padding to use on the actor
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_container_remove_valist">
<description>
Alternative va_list version of clutter_container_remove().
@@ -10771,7 +13151,8 @@
<function name="clutter_actor_set_size">
<description>
-Sets the actors size in pixels.
+Sets the actors size in pixels. If @width and/or @height are -1 the
+actor will assume the same size of its bounding box.
</description>
<parameters>
@@ -10780,67 +13161,62 @@
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> New width of actor in pixels
+<parameter_description> New width of actor in pixels, or -1
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> New height of actor in pixels
+<parameter_description> New height of actor in pixels, or -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_effect_rotate_y">
+<function name="clutter_model_insert_value">
<description>
-Simple effect for rotating a single #ClutterActor about y axis.
+Sets the data in the cell specified by @iter and @column. The type of
+ value must be convertable to the type of the column. If the row does
+not exist then it is created.
+Since: 0.6
</description>
<parameters>
-<parameter name="template_">
-<parameter_description> A #ClutterEffectTemplate
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> A #ClutterActor to apply the effect to.
-</parameter_description>
-</parameter>
-<parameter name="angle_begin">
-<parameter_description> Initial angle to apply to actor
-</parameter_description>
-</parameter>
-<parameter name="angle_end">
-<parameter_description> Final angle to apply to actor
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="center_x">
-<parameter_description> Position on X axis to rotate about.
-</parameter_description>
-</parameter>
-<parameter name="center_z">
-<parameter_description> Position on Z axis to rotate about.
+<parameter name="row">
+<parameter_description> position of the row to modify
</parameter_description>
</parameter>
-<parameter name="direction">
-<parameter_description> A #ClutterRotateDirection for the rotation.
+<parameter name="column">
+<parameter_description> column to modify
</parameter_description>
</parameter>
-<parameter name="completed_func">
-<parameter_description> A #ClutterEffectCompleteFunc to call on effect
-completion or NULL
+<parameter name="value">
+<parameter_description> new value for the cell
</parameter_description>
</parameter>
-<parameter name="completed_data">
-<parameter_description> Data to pass to supplied #ClutterEffectCompleteFunc
-or NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_shader_get_is_enabled">
+<description>
+FIXME
+
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return> a #ClutterTimeline for the effect. Will be unreferenced by
-the effect when completed.
+<return> FIXME
-Since: 0.4
+Since: 0.6
</return>
</function>
@@ -10877,6 +13253,37 @@
</return>
</function>
+<function name="clutter_model_iter_get">
+<description>
+Gets the value of one or more cells in the row referenced by @iter. The
+variable argument list should contain integer column numbers, each column
+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;
+clutter_model_iter_get (iter, 0, &place_string_here, -1);
+&lt;/programlisting&gt;&lt;/informalexample&gt;
+
+where place_string_here is a gchar* to be filled with the string. If
+appropriate, the returned values have to be freed or unreferenced.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of column/return location pairs, terminated by -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_rectangle_new">
<description>
Creates a new #ClutterActor with a rectangular shape.
@@ -10997,94 +13404,19 @@
<return></return>
</function>
-<function name="clutter_glx_set_stage_foreign">
-<description>
-Target the #ClutterStage to use an existing external X Window
-
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="xwindow">
-<parameter_description> an existing X Window id
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if foreign window is valid
-
-Since: 0.4
-</return>
-</function>
-
-<function name="clutter_alpha_set_func">
-<description>
-Sets the #ClutterAlphaFunc function used to compute
-the alpha value at each frame of the #ClutterTimeline
-bound to @alpha.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterAlphaAlphaFunc
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> user data to be passed to the alpha function, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="destroy">
-<parameter_description> notify function used when disposing the alpha function
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_box_query_nth_child">
+<function name="clutter_event_get_state">
<description>
-Queries the child of @box at @index_ and puts the packing informations
-inside @child.
+Retrieves the modifier state of the event.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterBox
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> position of the child
-</parameter_description>
-</parameter>
-<parameter name="child">
-<parameter_description> return value for a #ClutterBoxChild, or %NULL
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if an actor was found at @index_
-
-Since: 0.4
-</return>
-</function>
-
-<function name="clutter_glx_get_default_display">
-<description>
-FIXME
-
-
-</description>
-<parameters>
-</parameters>
-<return> FIXME
+<return> the modifier state parameter, or 0
Since: 0.4
</return>
@@ -11118,24 +13450,10 @@
<return></return>
</function>
-<function name="clutter_get_actor_by_id">
-<description>
-FIXME.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="id">
-<parameter_description> a #ClutterActor ID.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_scale_get_boundsx">
<description>
+Fixed point version of clutter_behaviour_scale_get_bounds().
+
Retrieves the bounds used by scale behaviour.
Since: 0.4
@@ -11146,12 +13464,24 @@
<parameter_description> a #ClutterBehaviourScale
</parameter_description>
</parameter>
-<parameter name="scale_begin">
-<parameter_description> return location for the initial scale factor
+<parameter name="x_scale_start">
+<parameter_description> return location for the initial scale factor on the X
+axis, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> return location for the initial scale factor on the Y
+axis, or %NULL
</parameter_description>
</parameter>
-<parameter name="scale_end">
-<parameter_description> return location for the final scale factor
+<parameter name="x_scale_end">
+<parameter_description> return location for the final scale factor on the X axis,
+or %NULL
+</parameter_description>
+</parameter>
+<parameter name="y_scale_end">
+<parameter_description> return location for the final scale factor on the Y axis,
+or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -11217,6 +13547,58 @@
<return></return>
</function>
+<function name="clutter_timeline_get_delta">
+<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.
+
+
+</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
+
+Since: 0.6
+</return>
+</function>
+
+<function name="clutter_actor_get_anchor_pointu">
+<description>
+Gets the current anchor point of the @actor in #ClutterUnit&lt;!-- --&gt;s.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="anchor_x">
+<parameter_description> return location for the X coordinace of the anchor point
+</parameter_description>
+</parameter>
+<parameter name="anchor_y">
+<parameter_description> return location for the X coordinace of the anchor point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="ClutterBehaviour">
<description>
The ::removed signal is emitted each time a behaviour is not applied
@@ -11272,4 +13654,37 @@
</return>
</function>
+<function name="CLUTTER_ALPHA_EXP_INC">
+<description>
+Convenience symbol for clutter_exp_inc_func()
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_sini">
+<description>
+Very fast fixed point implementation of sine function.
+
+ClutterAngle is an integer such that 1024 represents
+full circle.
+
+
+</description>
+<parameters>
+<parameter name="angle">
+<parameter_description> a #ClutterAngle
+</parameter_description>
+</parameter>
+</parameters>
+<return> #ClutterFixed sine value.
+
+Since: 0.2
+</return>
+</function>
+
</root>
Modified: cluttermm/trunk/clutter/src/stage.hg
==============================================================================
--- cluttermm/trunk/clutter/src/stage.hg (original)
+++ cluttermm/trunk/clutter/src/stage.hg Sun Jan 20 04:33:51 2008
@@ -69,8 +69,11 @@
_WRAP_METHOD(void set_use_fog(bool fog), clutter_stage_set_use_fog)
_WRAP_METHOD(void set_fog(double density, double z_near, double z_far), clutter_stage_set_fog)
_WRAP_METHOD(void get_fog(double& density, double& z_near, double& z_far) const, clutter_stage_get_fog)
- //_WRAP_METHOD(void set_fogx(const Fog& fog), clutter_stage_set_fogx)
- //_WRAP_METHOD(void get_fogx(Fog& fog) const, clutter_stage_get_fogx)
+#m4 _CONVERSION(`const Fog&',`ClutterFog*',`const_cast<ClutterFog*>(&($3))')
+ _WRAP_METHOD(void set_fogx(const Fog& fog), clutter_stage_set_fogx)
+ _WRAP_METHOD(void get_fogx(Fog& fog) const, clutter_stage_get_fogx)
+ _WRAP_METHOD(double get_resolution() const, clutter_stage_get_resolution)
+ _WRAP_METHOD(Fixed get_resolutionx() const, clutter_stage_get_resolutionx)
_WRAP_METHOD(void stage_event(Event* event), clutter_stage_event);
Modified: cluttermm/trunk/clutter/src/timeline.hg
==============================================================================
--- cluttermm/trunk/clutter/src/timeline.hg (original)
+++ cluttermm/trunk/clutter/src/timeline.hg Sun Jan 20 04:33:51 2008
@@ -54,7 +54,8 @@
_WRAP_METHOD(bool get_loop() const, clutter_timeline_get_loop)
_WRAP_METHOD(void skip(guint n_frames), clutter_timeline_skip)
_WRAP_METHOD(void advance(guint frame_num), clutter_timeline_advance)
- _WRAP_METHOD(gint get_current_frame() const, clutter_timeline_get_current_frame)
+ _WRAP_METHOD(int get_current_frame() const, clutter_timeline_get_current_frame)
+ _WRAP_METHOD(guint get_delta(guint& msecs) const, clutter_timeline_get_delta)
_WRAP_METHOD(void set_n_frames(guint n_frames), clutter_timeline_set_n_frames)
_WRAP_METHOD(guint get_n_frames() const, clutter_timeline_get_n_frames)
_WRAP_METHOD(bool is_playing() const, clutter_timeline_is_playing)
Modified: cluttermm/trunk/tools/m4/convert_cluttermm.m4
==============================================================================
--- cluttermm/trunk/tools/m4/convert_cluttermm.m4 (original)
+++ cluttermm/trunk/tools/m4/convert_cluttermm.m4 Sun Jan 20 04:33:51 2008
@@ -46,7 +46,6 @@
_CONVERSION(`Angle&',`ClutterAngle*',`&($3)')
_EQUAL(ClutterFog,Fog)
_CONVERSION(`Fog&',`ClutterFog*',`&($3)')
-_CONVERSION(`const Fog&',`ClutterFog*',`&($3)')
_EQUAL(ClutterEvent*,Event*)
_EQUAL(ClutterButtonEvent*,ButtonEvent*)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
