[cluttermm] Regenerated .defs files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [cluttermm] Regenerated .defs files.
- Date: Sun, 18 Apr 2010 13:24:51 +0000 (UTC)
commit 473493086d4e210af5a5fe10f762ca7af6bb3fef
Author: Murray Cumming <murrayc murrayc com>
Date: Sun Apr 18 15:21:06 2010 +0200
Regenerated .defs files.
* clutter/src/clutter_methods.defs: Regenerate with h2defs.py, against
clutter-1.2.
* clutter/src/clutter_enums.defs: Regenerate with enums.pl
* clutter/src/clutter_signals.defs: Regenerated with extra_defs_gen.
* clutter/src/clutter_docs.xml: Regenerate with docextract_to_xml.py.
ChangeLog | 12 +-
clutter/src/clutter_docs.xml |13790 +++++++++++++++++++++++---------------
clutter/src/clutter_methods.defs | 1443 ++++-
clutter/src/clutter_signals.defs | 818 ++-
4 files changed, 10305 insertions(+), 5758 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 18d0d20..5329e8d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2010-04-18 Murray Cumming <murrayc murray com>
+
+ Regenerated .defs files.
+
+ * clutter/src/clutter_methods.defs: Regenerate with h2defs.py, against
+ clutter-1.2.
+ * clutter/src/clutter_enums.defs: Regenerate with enums.pl
+ * clutter/src/clutter_signals.defs: Regenerated with extra_defs_gen.
+ * clutter/src/clutter_docs.xml: Regenerate with docextract_to_xml.py.
+
2010-04-16 Murray Cumming <murrayc murrayc com>
Remove deprecated function (we are not API stable).
@@ -6,7 +16,7 @@
* clutter/filelist.am
* clutter/cluttermm/utility.[h|cc]: Remove the utility.h API because
it only wraps one function that is now deprecated in clutter 1.2.
-
+
0.9.5:
2009-10-03 Daniel Elstner <daniel kitta gmail com>
diff --git a/clutter/src/clutter_docs.xml b/clutter/src/clutter_docs.xml
index 38829ea..d3d4173 100644
--- a/clutter/src/clutter_docs.xml
+++ b/clutter/src/clutter_docs.xml
@@ -15,35 +15,36 @@ Since: 0.4
<return></return>
</function>
-<function name="CLUTTER_ACTOR_IS_REALIZED">
+<function name="clutter_alpha_register_func">
<description>
-Evaluates to %TRUE if the %CLUTTER_ACTOR_REALIZED flag is set.
-
-Whether GL resources such as textures are allocated;
-if an actor is mapped it must also be realized, but an actor
-can be realized and unmapped (this is so hiding an actor temporarily
-doesn't do an expensive unrealize/realize).
+Registers a global alpha function and returns its logical id
+to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
-To be realized an actor must be inside a stage, and all its parents
-must be realized. The stage is required so the actor knows the
-correct GL context and window system resources to use.
+The logical id is always greater than %CLUTTER_ANIMATION_LAST.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="a">
-<parameter_description> a #ClutterActor
+<parameter name="func">
+<parameter_description> a #ClutterAlphaFunc
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to pass to @func, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the logical id of the alpha function
+
+</return>
</function>
<function name="cogl_pango_font_map_create_context">
<description>
Creates a new #PangoContext from the passed font map.
+Since: 1.0
</description>
<parameters>
@@ -54,10 +55,25 @@ Creates a new #PangoContext from the passed font map.
</parameters>
<return> the newly created #PangoContext
-Since: 1.0
</return>
</function>
+<function name="clutter_knot_free">
+<description>
+Frees the memory of an allocated knot.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="knot">
+<parameter_description> a #ClutterKnot
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_animate_with_timeline">
<description>
Animates the given list of properties of @actor between the current
@@ -69,6 +85,7 @@ See clutter_actor_animate() for further details.
This function is useful if you want to use an existing timeline
to animate @actor.
+Since: 1.0
</description>
<parameters>
@@ -94,11 +111,10 @@ property values
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is
+<return> a #ClutterAnimation object. The object is
owned by the #ClutterActor and should not be unreferenced with
g_object_unref()
-Since: 1.0
</return>
</function>
@@ -107,13 +123,13 @@ Since: 1.0
Pops an event off the event queue. Applications should not need to call
this.
+Since: 0.4
</description>
<parameters>
</parameters>
<return> A #ClutterEvent or NULL if queue empty
-Since: 0.4
</return>
</function>
@@ -127,6 +143,7 @@ clutter_score_start() is called.
#ClutterScore will take a reference on @timeline.
+Since: 0.6
</description>
<parameters>
@@ -147,91 +164,97 @@ clutter_score_start() is called.
0 on failure. The returned id can be used with clutter_score_remove()
or clutter_score_get_timeline().
-Since: 0.6
</return>
</function>
-<function name="ClutterModelIter">
+<function name="clutter_actor_get_shader">
<description>
-The row number to which this iter points to.
+Queries the currently set #ClutterShader on @self.
Since: 0.6
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> The currently set #ClutterShader
+or %NULL if no shader is set.
+
+</return>
</function>
-<function name="clutter_timeline_start">
+<function name="clutter_animator_new">
<description>
-Starts the #ClutterTimeline playing.
+Creates a new #ClutterAnimator instance
+
+Since: 1.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a new #ClutterAnimator.
+
+</return>
</function>
-<function name="json_array_get_element">
+<function name="clutter_animator_key_get_mode">
<description>
-Retrieves the #JsonNode containing the value of the element at @index_
-inside a #JsonArray.
+Retrieves the mode of a #ClutterAnimator key, for the first key of a
+property for an object this represents the whether the animation is
+open ended and or curved for the remainding keys for the property it
+represents the easing mode.
+Since: 1.2
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the #JsonNode at the requested index
+<return> the mode of a #ClutterAnimatorKey
+
</return>
</function>
-<function name="clutter_media_set_audio_volume">
+<function name="clutter_path_to_cairo_path">
<description>
-Sets the playback volume of @media to @volume.
+Add the nodes of the ClutterPath to the path in the Cairo context.
Since: 1.0
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="volume">
-<parameter_description> the volume as a double between 0.0 and 1.0
+<parameter name="cr">
+<parameter_description> a Cairo context
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_path_to_cairo_path">
+<function name="clutter_units_from_mm">
<description>
-Add the nodes of the ClutterPath to the path in the Cairo context.
+Stores a value in millimiters inside @units
Since: 1.0
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
+<parameter name="units">
+<parameter_description> a #ClutterUnits
</parameter_description>
</parameter>
-<parameter name="cr">
-<parameter_description> a Cairo context
+<parameter name="mm">
+<parameter_description> millimeters
</parameter_description>
</parameter>
</parameters>
@@ -285,79 +308,86 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_actor_raise">
+<function name="clutter_timeline_remove_marker">
<description>
-Puts @self above @below.
-
-Both actors must have the same parent.
+Removes @marker_name, if found, from @timeline.
-This function is the equivalent of clutter_container_raise_child().
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="below">
-<parameter_description> (allow-none): A #ClutterActor to raise above.
+<parameter name="marker_name">
+<parameter_description> the name of the marker to remove
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_rotate_get_direction">
+<function name="clutter_actor_get_scale_gravity">
<description>
-Retrieves the #ClutterRotateDirection used by the rotate behaviour.
+Retrieves the scale center as a compass direction. If the scale
+center was specified in pixels or units this will return
+%CLUTTER_GRAVITY_NONE.
+Since: 1.0
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the rotation direction
+<return> the scale gravity
-Since: 0.4
</return>
</function>
-<function name="clutter_backend_get_double_click_time">
+<function name="clutter_glx_texture_pixmap_new_with_window">
<description>
-Gets the maximum time between two button press events, as set
-by clutter_backend_set_double_click_time().
+Creates a new #ClutterGLXTexturePixmap for @window
+Since: 0.8
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
+<parameter name="window">
+<parameter_description> the X window to which this texture should be bound
</parameter_description>
</parameter>
</parameters>
-<return> a time in milliseconds
+<return> A new #ClutterGLXTexturePixmap bound to the given X window
-Since: 0.4
</return>
</function>
-<function name="clutter_glx_texture_pixmap_new_with_window">
+<function name="clutter_box_layout_set_easing_duration">
<description>
+Sets the duration of the animations used by @layout when animating changes
+in the layout properties
+
+Use clutter_box_layout_set_use_animations() to enable and disable the
+animations
+
+Since: 1.2
</description>
<parameters>
-<parameter name="window">
-<parameter_description> the X window to which this texture should be bound
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="msecs">
+<parameter_description> the duration of the animations, in milliseconds
</parameter_description>
</parameter>
</parameters>
-<return> A new #ClutterGLXTexturePixmap bound to the given X window
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="cogl_pango_font_map_clear_glyph_cache">
@@ -376,36 +406,76 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_stage_get_actor_at_pos">
+<function name="clutter_animator_property_get_ease_in">
<description>
-Checks the scene at the coordinates @x and @y and returns a pointer
-to the #ClutterActor at those coordinates.
-
-By using @pick_mode it is possible to control which actors will be
-painted and thus available.
+Checks if a property value is to be eased into the animation.
+Since: 1.2
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="animator">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
-<parameter name="pick_mode">
-<parameter_description> how the scene graph should be painted
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> X coordinate to check
+<parameter name="property_name">
+<parameter_description> the name of a property on object
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate to check
+</parameters>
+<return> %TRUE if the property is eased in
+
+</return>
+</function>
+
+<function name="clutter_animator_key_get_value">
+<description>
+Retrieves a copy of the value for a #ClutterAnimatorKey.
+
+The passed in #GValue needs to be already initialized for the value
+type of the key or to a type that allow transformation from the value
+type of the key.
+
+Use g_value_unset() when done.
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue initialized with the correct type for the animator key
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the actor at the specified coordinates,
-if any
+<return> %TRUE if the passed #GValue was successfully set, and
+%FALSE otherwise
+
+</return>
+</function>
+
+<function name="clutter_event_get_flags">
+<description>
+Retrieves the #ClutterEventFlags of @event
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return> the event flags
+
</return>
</function>
@@ -440,22 +510,23 @@ of error, @error is set accordingly and %FALSE is returned
</return>
</function>
-<function name="clutter_text_get_line_alignment">
+<function name="clutter_container_get_children">
<description>
-Retrieves the alignment of a #ClutterText, as set by
-clutter_text_set_line_alignment().
+Retrieves all the children of @container.
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
</parameters>
-<return> a #PangoAlignment
+<return> a list
+of #ClutterActor<!-- -->s. Use g_list_free() on the returned
+list when done.
-Since 1.0
</return>
</function>
@@ -463,6 +534,7 @@ Since 1.0
<description>
Gets whether the depth cueing effect is enabled on @stage.
+Since: 0.6
</description>
<parameters>
@@ -473,36 +545,71 @@ Gets whether the depth cueing effect is enabled on @stage.
</parameters>
<return> %TRUE if the the depth cueing effect is enabled
-Since: 0.6
</return>
</function>
-<function name="clutter_binding_pool_find_action">
+<function name="clutter_flow_layout_set_homogeneous">
<description>
-Retrieves the name of the action matching the given key symbol
-and modifiers bitmask.
+Sets whether the @layout should allocate the same space for
+each child
+Since: 1.2
</description>
<parameters>
-<parameter name="pool">
-<parameter_description> a #ClutterBindingPool
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
-<parameter name="key_val">
-<parameter_description> a key symbol
+<parameter name="homogeneous">
+<parameter_description> whether the layout should be homogeneous or not
</parameter_description>
</parameter>
-<parameter name="modifiers">
-<parameter_description> a bitmask for the modifiers
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_layout_manager_find_child_property">
+<description>
+Retrieves the #GParamSpec for the layout property @name inside
+the #ClutterLayoutMeta sub-class used by @manager
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the property
</parameter_description>
</parameter>
</parameters>
-<return> the name of the action, if found, or %NULL. The
-returned string is owned by the binding pool and should never
-be modified or freed
+<return> a #GParamSpec describing the property,
+or %NULL if no property with that name exists. The returned
+#GParamSpec is owned by the layout manager and should not be
+modified or freed
+
+</return>
+</function>
+
+<function name="clutter_box_layout_get_spacing">
+<description>
+Retrieves the spacing set using clutter_box_layout_set_spacing()
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+</parameters>
+<return> the spacing between children of the #ClutterBoxLayout
-Since: 1.0
</return>
</function>
@@ -526,22 +633,24 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_text_set_ellipsize">
+<function name="clutter_path_replace_node">
<description>
-Sets the mode used to ellipsize (add an ellipsis: "...") to the
-text if there is not enough space to render the entire contents
-of a #ClutterText actor
+Replaces the node at offset @index_ with @node.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> a #PangoEllipsizeMode
+<parameter name="index_">
+<parameter_description> index to the existing node
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> the replacement node
</parameter_description>
</parameter>
</parameters>
@@ -552,6 +661,7 @@ Since: 1.0
<description>
Creates a new #ClutterActor which clones @source/
+Since: 1.0
</description>
<parameters>
@@ -562,7 +672,6 @@ Creates a new #ClutterActor which clones @source/
</parameters>
<return> the newly created #ClutterClone
-Since: 1.0
</return>
</function>
@@ -600,22 +709,6 @@ Since: 0.8
<return></return>
</function>
-<function name="_clutter_stage_do_update">
-<description>
-Handles per-frame layout and repaint for the stage.
-
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the stage was updated
-</return>
-</function>
-
<function name="clutter_path_new">
<description>
Creates a new #ClutterPath instance with no nodes.
@@ -623,52 +716,13 @@ Creates a new #ClutterPath instance with no nodes.
The object has a floating reference so if you add it to a
#ClutterBehaviourPath then you do not need to unref it.
-
-</description>
-<parameters>
-</parameters>
-<return> the newly created #ClutterPath
-
Since: 1.0
-</return>
-</function>
-
-<function name="clutter_actor_animate_with_alpha">
-<description>
-Animates the given list of properties of @actor between the current
-value for each property and a new final value. The animation has a
-definite behaviour given by the passed @alpha.
-
-See clutter_actor_animate() for further details.
-
-This function is useful if you want to use an existing #ClutterAlpha
-to animate @actor.
-
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of a property
-</parameter_description>
-</parameter>
-<parameter name="VarArgs">
-<parameter_description> a %NULL terminated list of property names and
-property values
-</parameter_description>
-</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is owned by the
-#ClutterActor and should not be unreferenced with g_object_unref()
+<return> the newly created #ClutterPath
-Since: 1.0
</return>
</function>
@@ -676,13 +730,13 @@ Since: 1.0
<description>
Queries the current keyboard grab of clutter.
+Since: 0.6
</description>
<parameters>
</parameters>
-<return> (transfer none): the actor currently holding the keyboard grab, or NULL if there is no grab.
+<return> the actor currently holding the keyboard grab, or NULL if there is no grab.
-Since: 0.6
</return>
</function>
@@ -696,12 +750,7 @@ loop and runs every timeout function inside it. The timeout pool is
always sorted, so that the extraction of the next timeout function is
a constant time operation.
-Inside Clutter, every #ClutterTimeline share the same timeout pool, unless
-the CLUTTER_TIMELINE=no-pool environment variable is set.
-
-#ClutterTimeoutPool is part of the #ClutterTimeline implementation
-and should not be used by application developers.
-
+Since: 0.4
</description>
<parameters>
@@ -716,7 +765,6 @@ is owned by the GLib default context and will be automatically
destroyed when the context is destroyed. It is possible to force
the destruction of the timeout pool using g_source_destroy()
-Since: 0.4
</return>
</function>
@@ -766,39 +814,74 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_model_get_sorting_column">
+<function name="clutter_x11_get_visual_info">
<description>
-Retrieves the number of column used for sorting the @model.
+Retrieves the <structname>XVisualInfo</structname> used by the Clutter X11
+backend.
+Since: 1.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+</parameters>
+<return> a <structname>XVisualInfo</structname>, or
+<varname>None</varname>. The returned value should be freed using XFree()
+when done
+
+</return>
+</function>
+
+<function name="clutter_input_device_get_device_type">
+<description>
+Retrieves the type of @device
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice
</parameter_description>
</parameter>
</parameters>
-<return> a column number, or -1 if the model is not sorted
+<return> the type of the device
-Since: 0.6
</return>
</function>
-<function name="clutter_text_get_single_line_mode">
+<function name="clutter_behaviour_ellipse_get_height">
<description>
-Retrieves whether the #ClutterText actor is in single line mode.
+Gets the height of the elliptical path.
+Since: 0.4
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #ClutterText actor is in single line mode
+<return> the height of the path
+
+</return>
+</function>
+
+<function name="clutter_actor_box_get_x">
+<description>
+Retrieves the X coordinate of the origin of @box
Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the X coordinate of the origin
+
</return>
</function>
@@ -812,61 +895,110 @@ using clutter_alpha_set_timeline().
You should use the newly created #ClutterAlpha instance inside
a #ClutterBehaviour object.
+Since: 0.2
</description>
<parameters>
</parameters>
<return> the newly created empty #ClutterAlpha instance.
-Since: 0.2
</return>
</function>
-<function name="json_object_set_double_member">
+<function name="clutter_threads_add_repaint_func">
<description>
-Convenience function for setting a floating point @value
-of @member_name inside @object.
+Adds a function to be called whenever Clutter is repainting a Stage.
+If the function returns %FALSE it is automatically removed from the
+list of repaint functions and will not be called again.
-See also: json_object_set_member()
+This function is guaranteed to be called from within the same thread
+that called clutter_main(), and while the Clutter lock is being held.
-Since: 0.8
+A repaint function is useful to ensure that an update of the scenegraph
+is performed before the scenegraph is repainted; for instance, uploading
+a frame from a video into a #ClutterTexture.
+
+When the repaint function is removed (either because it returned %FALSE
+or because clutter_threads_remove_repaint_func() has been called) the
+ notify function will be called, if any is set.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="func">
+<parameter_description> the function to be called within the paint cycle
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="data">
+<parameter_description> data to be passed to the function, or %NULL
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value of the member
+<parameter name="notify">
+<parameter_description> function to be called when removing the repaint
+function, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ID (greater than 0) of the repaint function. You
+can use the returned integer to remove the repaint function by
+calling clutter_threads_remove_repaint_func().
+
+</return>
</function>
-<function name="clutter_path_node_copy">
+<function name="clutter_check_version">
<description>
-Makes an allocated copy of a node.
+Run-time version check, to check the version the Clutter library
+that an application is currently linked against
+
+This is the run-time equivalent of the compile-time %CLUTTER_CHECK_VERSION
+pre-processor macro
+Since: 1.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #ClutterPathNode
+<parameter name="major">
+<parameter_description> major version, like 1 in 1.2.3
+</parameter_description>
+</parameter>
+<parameter name="minor">
+<parameter_description> minor version, like 2 in 1.2.3
+</parameter_description>
+</parameter>
+<parameter name="micro">
+<parameter_description> micro version, like 3 in 1.2.3
</parameter_description>
</parameter>
</parameters>
-<return> the copied node.
+<return> %TRUE if the version of the Clutter library is
+greater than (@major, @minor, @micro), and %FALSE otherwise
-Since: 1.0
</return>
</function>
+<function name="clutter_box_layout_set_vertical">
+<description>
+Sets whether @layout should arrange its children vertically alongside
+the Y axis, instead of horizontally alongside the X axis
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="vertical">
+<parameter_description> %TRUE if the layout should be vertical
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_set_scale">
<description>
Scales an actor with the given factors. The scaling is relative to
@@ -893,39 +1025,70 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_text_get_ellipsize">
+<function name="json_node_free">
<description>
-Return value: #PangoEllipsizeMode
+Frees the resources allocated by @node.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return> #PangoEllipsizeMode
+<return></return>
+</function>
-Since: 1.0
-</return>
+<function name="clutter_layout_manager_child_set">
+<description>
+Sets a list of properties and their values on the #ClutterLayoutMeta
+associated by @manager to a child of @container
+
+Languages bindings should use clutter_layout_manager_child_set_property()
+instead
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @container
+</parameter_description>
+</parameter>
+<parameter name="first_property">
+<parameter_description> the first property name
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and value pairs
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="clutter_actor_set_parent">
+<function name="clutter_x11_add_filter">
<description>
-Sets the parent of @self to @parent. The opposite function is
-clutter_actor_unparent().
+Adds an event filter function.
-This function should not be used by applications, but by custom
-container actor subclasses.
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="func">
+<parameter_description> a filter function
</parameter_description>
</parameter>
-<parameter name="parent">
-<parameter_description> A new #ClutterActor parent
+<parameter name="data">
+<parameter_description> user data to be passed to the filter function, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -950,6 +1113,27 @@ Sets @object inside @node. The reference count of @object is not increased.
<return></return>
</function>
+<function name="json_array_get_element">
+<description>
+Retrieves the #JsonNode containing the value of the element at @index_
+inside a #JsonArray.
+
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the #JsonNode at the requested index
+</return>
+</function>
+
<function name="clutter_interval_get_final_value">
<description>
Retrieves the final value of @interval and copies
@@ -974,29 +1158,51 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_text_get_selection_bound">
+<function name="clutter_box_pack_before">
<description>
-Retrieves the other end of the selection of a #ClutterText actor,
-in characters from the current cursor position.
+Adds @actor to @box, placing it before @sibling, and sets layout
+properties at the same time, if the #ClutterLayoutManager used by
+ box supports them
+
+If @sibling is %NULL then @actor is placed at the beginning of the
+list of children, to be allocated and painted below every other child
+This function is a wrapper around clutter_container_add_actor(),
+clutter_container_lower_child() and clutter_layout_manager_child_set()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="box">
+<parameter_description> a #ClutterBox
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> a #ClutterActor or %NULL
+</parameter_description>
+</parameter>
+<parameter name="first_property">
+<parameter_description> the name of the first property to set, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and value pairs, terminated by %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the position of the other end of the selection
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_scriptable_get_id">
<description>
Retrieves the id of @scriptable set using clutter_scriptable_set_id().
+Since: 0.6
</description>
<parameters>
@@ -1008,7 +1214,6 @@ Retrieves the id of @scriptable set using clutter_scriptable_set_id().
<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>
@@ -1028,6 +1233,18 @@ Since: 0.4
<return></return>
</function>
+<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_set_font_flags">
<description>
Sets the font quality options for subsequent text rendering
@@ -1051,62 +1268,92 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_actor_box_free">
+<function name="clutter_event_peek">
<description>
-Frees a #ClutterActorBox allocated using clutter_actor_box_new()
-or clutter_actor_box_copy()
+Returns a pointer to the first event from the event queue but
+does not remove it.
-Since: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+</parameters>
+<return> A #ClutterEvent or NULL if queue empty.
+
+</return>
+</function>
+
+<function name="clutter_layout_manager_child_get_property">
+<description>
+Gets a property on the #ClutterLayoutMeta created by @manager and
+attached to a child of @container
+
+The #GValue must already be initialized to the type of the property
+and has to be unset with g_value_unset() after extracting the real
+value out of it
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @container
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the name of the property to get
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue with the value of the property to get
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_shader_get_fragment_source">
+<function name="clutter_vertex_equal">
<description>
-Query the current GLSL fragment source set on @shader.
+Compares @vertex_a and @vertex_b for equality
+Since: 1.0
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="vertex_a">
+<parameter_description> a #ClutterVertex
+</parameter_description>
+</parameter>
+<parameter name="vertex_b">
+<parameter_description> a #ClutterVertex
</parameter_description>
</parameter>
</parameters>
-<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
+<return> %TRUE if the passed #ClutterVertex are equal
-Since: 0.6
</return>
</function>
-<function name="clutter_actor_hide">
+<function name="clutter_fixed_layout_new">
<description>
-Flags an actor to be hidden. A hidden actor will not be
-rendered on the stage.
+Creates a new #ClutterFixedLayout
-Actors are visible by default.
-
-If this function is called on an actor without a parent, the
-#ClutterActor:show-on-set-parent property will be set to %FALSE
-as a side-effect.
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterFixedLayout
+
+</return>
</function>
<function name="clutter_actor_get_allocation_vertices">
@@ -1135,12 +1382,12 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="ancestor">
-<parameter_description> A #ClutterActor to calculate the vertices against, or %NULL
-to use the default #ClutterStage
+<parameter_description> A #ClutterActor to calculate the vertices
+against, or %NULL to use the default #ClutterStage
</parameter_description>
</parameter>
<parameter name="verts">
-<parameter_description> (out) (array fixed-size=4): return location for an array of
+<parameter_description> return location for an array of
4 #ClutterVertex in which to store the result.
</parameter_description>
</parameter>
@@ -1148,23 +1395,46 @@ to use the default #ClutterStage
<return></return>
</function>
-<function name="clutter_timeline_get_duration">
+<function name="clutter_path_add_curve_to">
<description>
-Retrieves the duration of a #ClutterTimeline in milliseconds.
-See clutter_timeline_set_duration().
+Adds a %CLUTTER_PATH_CURVE_TO type node to the path. This causes
+the actor to follow a bezier from the last node to (@x_3, @y_3) using
+(@x_1, @y_1) and (@x_2,@y_2) as control points.
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="x_1">
+<parameter_description> the x coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="y_1">
+<parameter_description> the y coordinate of the first control point
+</parameter_description>
+</parameter>
+<parameter name="x_2">
+<parameter_description> the x coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="y_2">
+<parameter_description> the y coordinate of the second control point
+</parameter_description>
+</parameter>
+<parameter name="x_3">
+<parameter_description> the x coordinate of the third control point
+</parameter_description>
+</parameter>
+<parameter name="y_3">
+<parameter_description> the y coordinate of the third control point
</parameter_description>
</parameter>
</parameters>
-<return> the duration of the timeline, in milliseconds.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_text_set_editable">
@@ -1241,6 +1511,7 @@ Since: 1.0
<description>
Retrieves the type of the @column.
+Since: 0.6
</description>
<parameters>
@@ -1255,52 +1526,59 @@ Retrieves the type of the @column.
</parameters>
<return> the type of the column.
-Since: 0.6
</return>
</function>
-<function name="clutter_stage_set_user_resizable">
+<function name="clutter_path_node_equal">
<description>
-Sets if the stage is resizable by user interaction (e.g. via
-window manager controls)
+Compares two nodes and checks if they are the same type with the
+same coordinates.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="node_a">
+<parameter_description> First node
</parameter_description>
</parameter>
-<parameter name="resizable">
-<parameter_description> whether the stage should be user resizable.
+<parameter name="node_b">
+<parameter_description> Second node
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the nodes are the same.
+
+</return>
</function>
-<function name="clutter_path_node_equal">
+<function name="clutter_actor_set_text_direction">
<description>
-Compares two nodes and checks if they are the same type with the
-same coordinates.
+Sets the #ClutterTextDirection for an actor
+
+The passed text direction must not be %CLUTTER_TEXT_DIRECTION_DEFAULT
+
+If @self implements #ClutterContainer then this function will recurse
+inside all the children of @self (including the internal ones).
+Composite actors not implementing #ClutterContainer, or actors requiring
+special handling when the text direction changes, should connect to
+the #GObject::notify signal for the #ClutterActor:text-direction property
+
+Since: 1.2
</description>
<parameters>
-<parameter name="node_a">
-<parameter_description> First node
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="node_b">
-<parameter_description> Second node
+<parameter name="text_dir">
+<parameter_description> the text direction for @self
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the nodes are the same.
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="json_parser_get_current_pos">
@@ -1320,6 +1598,50 @@ from 0.
</return>
</function>
+<function name="clutter_actor_has_clip">
+<description>
+Determines whether the actor has a clip area set or not.
+
+Since: 0.1.1
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the actor has a clip area set.
+
+</return>
+</function>
+
+<function name="clutter_animation_set_loop">
+<description>
+Sets whether @animation should loop over itself once finished.
+
+A looping #ClutterAnimation will not emit the #ClutterAnimation::completed
+signal when finished.
+
+This function will set #ClutterAnimation:alpha and
+#ClutterAnimation:timeline if needed.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="loop">
+<parameter_description> %TRUE if the animation should loop
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_path_new">
<description>
Creates a new path behaviour. You can use this behaviour to drive
@@ -1328,6 +1650,7 @@ actors along the nodes of a path, described by @path.
This will claim the floating reference on the #ClutterPath so you
do not need to unref if it.
+Since: 0.2
</description>
<parameters>
@@ -1342,88 +1665,113 @@ do not need to unref if it.
</parameters>
<return> a #ClutterBehaviour
-Since: 0.2
</return>
</function>
-<function name="clutter_actor_get_clip">
+<function name="clutter_color_from_string">
<description>
-Gets the clip area for @self, if any is set
+Parses a string definition of a color, filling the
+<structfield>red</structfield>, <structfield>green</structfield>,
+<structfield>blue</structfield> and <structfield>alpha</structfield>
+channels of @color. If alpha is not specified it will be set full opaque.
-Since: 0.6
+The @color is not allocated.
+
+The color may be defined by any of the formats understood by
+pango_color_from_string(); these include literal color names, like
+<literal>Red</literal> or <literal>DarkSlateGray</literal>, or
+hexadecimal specifications like <literal>3050b2</literal> or
+<literal>333</literal>.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="xoff">
-<parameter_description> (out): return location for the X offset of the clip rectangle, or %NULL
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
-<parameter name="yoff">
-<parameter_description> (out): return location for the Y offset of the clip rectangle, or %NULL
+<parameter name="str">
+<parameter_description> a string specifiying a color (named color or #RRGGBBAA)
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> (out): return location for the width of the clip rectangle, or %NULL
+</parameters>
+<return> %TRUE if parsing succeeded.
+
+</return>
+</function>
+
+<function name="clutter_actor_allocate_preferred_size">
+<description>
+Allocates the natural size of @self.
+
+This function is a utility call for #ClutterActor implementations
+that allocates the actor's preferred natural size. It can be used
+by fixed layout managers (like #ClutterGroup or so called
+'composite actors') inside the ClutterActor::allocate
+implementation to give each child exactly how much space it
+requires.
+
+This function is not meant to be used by applications. It is also
+not meant to be used outside the implementation of the
+ClutterActor::allocate virtual function.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> (out): return location for the height of the clip rectangle, or %NULL
+<parameter name="flags">
+<parameter_description> flags controlling the allocation
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_depth_get_bounds">
+<function name="clutter_model_iter_get_value">
<description>
-Gets the boundaries of the @behaviour
+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="behaviour">
-<parameter_description> a #ClutterBehaviourDepth
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
-<parameter name="depth_start">
-<parameter_description> return location for the initial depth value, or %NULL
+<parameter name="column">
+<parameter_description> column number to retrieve the value from
</parameter_description>
</parameter>
-<parameter name="depth_end">
-<parameter_description> return location for the final depth value, or %NULL
+<parameter name="value">
+<parameter_description> an empty #GValue to set
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_alpha_register_func">
+<function name="clutter_animator_key_get_property_name">
<description>
-Registers a global alpha function and returns its logical id
-to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
-
-The logical id is always greater than %CLUTTER_ANIMATION_LAST.
+Retrieves the name of the property a key applies to.
+Since: 1.2
</description>
<parameters>
-<parameter name="func">
-<parameter_description> a #ClutterAlphaFunc
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
</parameters>
-<return> the logical id of the alpha function
+<return> the name of the property an animator_key exist for.
-Since: 1.0
</return>
</function>
@@ -1432,6 +1780,7 @@ Since: 1.0
Checks whether @feature is available. @feature can be a logical
OR of #ClutterFeatureFlags.
+Since: 0.1.1
</description>
<parameters>
@@ -1442,32 +1791,31 @@ OR of #ClutterFeatureFlags.
</parameters>
<return> %TRUE if a feature is available
-Since: 0.1.1
</return>
</function>
-<function name="clutter_input_device_get_device_id">
+<function name="clutter_container_sort_depth_order">
<description>
-Retrieves the unique identifier of @device
+Sorts a container's children using their depth. This function should not
+be normally used by applications.
+Since: 0.6
</description>
<parameters>
-<parameter name="device">
-<parameter_description> a #ClutterInputDevice
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
</parameters>
-<return> the identifier of the device
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_knot_copy">
<description>
Makes an allocated copy of a knot.
+Since: 0.2
</description>
<parameters>
@@ -1478,48 +1826,48 @@ Makes an allocated copy of a knot.
</parameters>
<return> the copied knot.
-Since: 0.2
</return>
</function>
-<function name="clutter_knot_equal">
+<function name="clutter_timeline_clone">
<description>
-Compares to knot and checks if the point to the same location.
+Create a new #ClutterTimeline instance which has property values
+matching that of supplied timeline. The cloned timeline will not
+be started and will not be positioned to the current position of
+ timeline: you will have to start it with clutter_timeline_start().
+Since: 0.4
</description>
<parameters>
-<parameter name="knot_a">
-<parameter_description> First knot
-</parameter_description>
-</parameter>
-<parameter name="knot_b">
-<parameter_description> Second knot
+<parameter name="timeline">
+<parameter_description> #ClutterTimeline to duplicate.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the knots point to the same location.
+<return> a new #ClutterTimeline, cloned from @timeline
-Since: 0.2
</return>
</function>
-<function name="ClutterContainer">
+<function name="clutter_container_raise_child">
<description>
-The ::child-notify signal is emitted each time a property is
-being set through the clutter_container_child_set() and
-clutter_container_child_set_property() calls.
+Raises @actor to @sibling level, in the depth ordering.
-Since: 0.8
+Since: 0.6
</description>
<parameters>
<parameter name="container">
-<parameter_description> the container which received the signal
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
<parameter name="actor">
-<parameter_description> the child that has had a property set.
+<parameter_description> the actor to raise
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> the sibling to raise to, or %NULL to raise to the top
</parameter_description>
</parameter>
</parameters>
@@ -1533,6 +1881,7 @@ stored in @member_name of @object is null
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -1547,70 +1896,70 @@ See also: json_object_get_member()
</parameters>
<return> %TRUE if the value is null
-Since: 0.8
</return>
</function>
-<function name="clutter_container_foreach_with_internals">
+<function name="clutter_get_input_device_for_id">
<description>
-Calls @callback for each child of @container, including "internal"
-children built in to the container itself that were never added
-by the application.
+Retrieves the #ClutterInputDevice from its @id. This is a convenience
+wrapper for clutter_device_manager_get_device() and it is functionally
+equivalent to:
-Since: 1.0
+|[
+ClutterDeviceManager *manager;
+ClutterInputDevice *device;
+
+manager = clutter_device_manager_get_default ();
+device = clutter_device_manager_get_device (manager, id);
+]|
+
+Since: 0.8
</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 name="id">
+<parameter_description> the unique id for a device
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterInputDevice, or %NULL
+
+</return>
</function>
-<function name="clutter_actor_unparent">
+<function name="clutter_actor_get_animation">
<description>
-Removes the parent of @self.
-
-This function should not be used in applications. It should be called by
-implementations of container actors, to dissociate a child from the
-container.
+Retrieves the #ClutterAnimation used by @actor, if clutter_actor_animate()
+has been called on @actor.
-Since: 0.1.1
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
+<parameter name="actor">
<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterAnimation, or %NULL
+
+</return>
</function>
-<function name="clutter_timeline_remove_marker">
+<function name="clutter_media_set_uri">
<description>
-Removes @marker_name, if found, from @timeline.
+Sets the URI of @media to @uri.
-Since: 0.8
+Since: 0.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
-<parameter name="marker_name">
-<parameter_description> the name of the marker to remove
+<parameter name="uri">
+<parameter_description> the URI of the media stream
</parameter_description>
</parameter>
</parameters>
@@ -1625,7 +1974,7 @@ at which point the timeout is automatically destroyed and the function
won't be called again. If @notify is not %NULL, the @notify function
will be called. The first call to @func will be at the end of @interval.
-Since version 0.8 this will try to compensate for delays. For
+Since Clutter 0.8 this will try to compensate for delays. For
example, if @func takes half the interval time to execute then the
function will be called again half the interval time after it
finished. Before version 0.8 it would not fire until a full
@@ -1634,6 +1983,7 @@ would be @interval * 1.5. This function does not however try to
invoke the function multiple times to catch up missing frames if
@func takes more than @interval ms to execute.
+Since: 0.4
</description>
<parameters>
@@ -1661,10 +2011,64 @@ invoke the function multiple times to catch up missing frames if
<return> the ID (greater than 0) of the timeout inside the pool.
Use clutter_timeout_pool_remove() to stop the timeout.
-Since: 0.4
</return>
</function>
+<function name="clutter_actor_animate_with_alpha">
+<description>
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite behaviour given by the passed @alpha.
+
+See clutter_actor_animate() for further details.
+
+This function is useful if you want to use an existing #ClutterAlpha
+to animate @actor.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of a property
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> a %NULL terminated list of property names and
+property values
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterAnimation object. The object is owned by the
+#ClutterActor and should not be unreferenced with g_object_unref()
+
+</return>
+</function>
+
+<function name="clutter_shader_release">
+<description>
+Frees up any GL context resources held by the shader.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_list_model_new">
<description>
Creates a new default model with @n_columns columns with the types
@@ -1686,6 +2090,7 @@ 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.6
</description>
<parameters>
@@ -1700,10 +2105,47 @@ the title.
</parameters>
<return> a new #ClutterListModel
-Since: 0.6
</return>
</function>
+<function name="clutter_box_pack_at">
+<description>
+Adds @actor to @box, placing it at @position, and sets layout
+properties at the same time, if the #ClutterLayoutManager used by
+ box supports them
+
+If @position is a negative number, or is larger than the number of
+children of @box, the new child is added at the end of the list of
+children
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterBox
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position to insert the @actor at
+</parameter_description>
+</parameter>
+<parameter name="first_property">
+<parameter_description> the name of the first property to set, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and value pairs, terminated by %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_text_set_line_wrap_mode">
<description>
If line wrapping is enabled (see clutter_text_set_line_wrap()) this
@@ -1726,27 +2168,56 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_script_lookup_filename">
+<function name="clutter_actor_raise">
<description>
-Looks up @filename inside the search paths of @script. If @filename
-is found, its full path will be returned .
+Puts @self above @below.
+Both actors must have the same parent, and the parent must implement
+the #ClutterContainer interface
+
+This function is the equivalent of clutter_container_raise_child().
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> the name of the file to lookup
+<parameter name="below">
+<parameter_description> A #ClutterActor to raise above.
</parameter_description>
</parameter>
</parameters>
-<return> the full path of @filename or %NULL if no path was
-found.
+<return></return>
+</function>
+
+<function name="clutter_device_manager_get_default">
+<description>
+Retrieves the device manager singleton
+
+Since: 1.2
+
+</description>
+<parameters>
+</parameters>
+<return> the #ClutterDeviceManager singleton.
+The returned instance is owned by Clutter and it should not be
+modified or freed
+
+</return>
+</function>
+
+<function name="clutter_x11_get_use_argb_visual">
+<description>
+Retrieves whether the Clutter X11 backend is using ARGB visuals by default
+
+Since: 1.2
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if ARGB visuals are queried by default
-Since: 0.8
</return>
</function>
@@ -1757,6 +2228,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -1771,44 +2243,69 @@ See also: json_object_get_member()
</parameters>
<return> the object inside the object's member
-Since: 0.8
</return>
</function>
-<function name="clutter_actor_set_position">
+<function name="clutter_container_create_child_meta">
<description>
-Sets the actor's fixed position in pixels relative to any parent
-actor.
+Creates the #ClutterChildMeta wrapping @actor inside the
+ container, if the #ClutterContainerIface::child_meta_type
+class member is not set to %G_TYPE_INVALID.
-If a layout manager is in use, this position will override the
-layout manager and force a fixed position.
+This function is only useful when adding a #ClutterActor to
+a #ClutterContainer implementation outside of the
+#ClutterContainer::add() virtual function implementation.
+
+Applications should not call this function.
+
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> New left position of actor in pixels.
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> New top position of actor in pixels.
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_path_node_copy">
+<description>
+Makes an allocated copy of a node.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #ClutterPathNode
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the copied node.
+
+</return>
</function>
<function name="clutter_stage_get_default">
<description>
-Return value: (transfer none): the main #ClutterStage. You should never
+Returns the main stage. The default #ClutterStage is a singleton,
+so the stage will be created the first time this function is
+called (typically, inside clutter_init()); all the subsequent
+calls to clutter_stage_get_default() will return the same instance.
+
+Clutter guarantess the existence of the default stage.
+
</description>
<parameters>
</parameters>
-<return> (transfer none): the main #ClutterStage. You should never
+<return> the main #ClutterStage. You should never
destroy or unref the returned actor.
</return>
</function>
@@ -1845,6 +2342,7 @@ Since: 0.4
Non-vararg version of clutter_list_model_new(). This function is
useful for language bindings.
+Since: 0.6
</description>
<parameters>
@@ -1863,26 +2361,23 @@ useful for language bindings.
</parameters>
<return> a new default #ClutterModel
-Since: 0.6
</return>
</function>
-<function name="clutter_timeline_get_delay">
+<function name="clutter_score_pause">
<description>
-Retrieves the delay set using clutter_timeline_set_delay().
+Pauses a playing score @score.
+Since: 0.6
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="score">
+<parameter_description> a #ClutterScore
</parameter_description>
</parameter>
</parameters>
-<return> the delay in milliseconds.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_text_get_max_length">
@@ -1891,6 +2386,7 @@ Gets the maximum length of text that can be set into a text actor.
See clutter_text_set_max_length().
+Since: 1.0
</description>
<parameters>
@@ -1901,7 +2397,6 @@ See clutter_text_set_max_length().
</parameters>
<return> the maximum number of characters.
-Since: 1.0
</return>
</function>
@@ -1930,25 +2425,34 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_animation_update_interval">
+<function name="clutter_bin_layout_set_alignment">
<description>
-Changes the @interval for @property_name. The #ClutterAnimation
-will take ownership of the passed #ClutterInterval.
+Sets the horizontal and vertical alignment policies to be applied
+to a @child of @self
-Since: 1.0
+If @child is %NULL then the @x_align and @y_align values will
+be set as the default alignment policies
+
+Since: 1.2
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="self">
+<parameter_description> a #ClutterBinLayout
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> name of the property
+<parameter name="child">
+<parameter_description> a child of @container
</parameter_description>
</parameter>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="x_align">
+<parameter_description> the horizontal alignment policy to be used for the @child
+inside @container
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> the vertical aligment policy to be used on the @child
+inside @container
</parameter_description>
</parameter>
</parameters>
@@ -1980,27 +2484,63 @@ or a negative value to indicate that no width is defined
</parameter_description>
</parameter>
<parameter name="min_height_p">
-<parameter_description> (out): return location for minimum height, or %NULL
+<parameter_description> return location for minimum height,
+or %NULL
</parameter_description>
</parameter>
<parameter name="natural_height_p">
-<parameter_description> (out): return location for natural height, or %NULL
+<parameter_description> return location for natural
+height, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="ClutterBehaviourOpacity">
+<function name="json_parser_load_from_file">
<description>
-Final opacity level of the behaviour.
+Loads a JSON stream from the content of @filename and parses it. See
+json_parser_load_from_data().
-Since: 0.2
</description>
<parameters>
+<parameter name="parser">
+<parameter_description> a #JsonParser
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> the path for the file to parse
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file was successfully loaded and parsed.
+In case of error, @error is set accordingly and %FALSE is returned
+</return>
+</function>
+
+<function name="clutter_stage_manager_list_stages">
+<description>
+Lists all currently used stages.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="stage_manager">
+<parameter_description> a #ClutterStageManager
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> a newly
+allocated list of #ClutterStage objects. Use g_slist_free() to
+deallocate it when done.
+
+</return>
</function>
<function name="clutter_container_add_valist">
@@ -2027,22 +2567,22 @@ Since: 0.4
<return></return>
</function>
-<function name="CLUTTER_ACTOR_IS_REACTIVE">
+<function name="clutter_keysym_to_unicode">
<description>
-Evaluates to %TRUE if the %CLUTTER_ACTOR_REACTIVE flag is set.
-
-Only reactive actors will receive event-related signals.
+Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode)
+character.
-Since: 0.6
</description>
<parameters>
-<parameter name="a">
-<parameter_description> a #ClutterActor
+<parameter name="keyval">
+<parameter_description> a key symbol
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a Unicode character, or 0 if there is no corresponding
+character.
+</return>
</function>
<function name="clutter_model_insertv">
@@ -2067,77 +2607,69 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="columns">
-<parameter_description> (array length=n_columns): a vector containing the columns to set
+<parameter_description> a vector containing the columns to set
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> (array length=n_columns): a vector containing the values for the cells
+<parameter_description> a vector containing the values for the cells
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_cairo_texture_set_surface_size">
+<function name="clutter_vertex_new">
<description>
-Resizes the Cairo surface used by @self to @width and @height.
+Creates a new #ClutterVertex for the point in 3D space
+identified by the 3 coordinates @x, @y, @z
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterCairoTexture
+<parameter name="x">
+<parameter_description> X coordinate
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> the new width of the surface
+<parameter name="y">
+<parameter_description> Y coordinate
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> the new height of the surface
+<parameter name="z">
+<parameter_description> Z coordinate
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_shader_release">
-<description>
-Frees up any GL context resources held by the shader.
-
-Since: 0.6
+<return> the newly allocate #ClutterVertex. Use
+clutter_vertex_free() to free the resources
-</description>
-<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
+</return>
</function>
-<function name="clutter_x11_set_stage_foreign">
+<function name="clutter_texture_set_load_async">
<description>
-Target the #ClutterStage to use an existing external X Window
+Sets whether @texture should use a worker thread to load the data
+from disk asynchronously. Setting @load_async to %TRUE will make
+clutter_texture_set_from_file() return immediately.
+See the #ClutterTexture:load-async property documentation, and
+clutter_texture_set_load_data_async().
+
+Since: 1.0
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="texture">
+<parameter_description> a #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="xwindow">
-<parameter_description> an existing X Window id
+<parameter name="load_async">
+<parameter_description> %TRUE if the texture should asynchronously load data
+from a filename
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if foreign window is valid
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_get_default_backend">
@@ -2145,15 +2677,15 @@ Since: 0.4
Retrieves the default #ClutterBackend used by Clutter. The
#ClutterBackend holds backend-specific configuration options.
+Since: 0.4
</description>
<parameters>
</parameters>
-<return> (transfer none): the default backend. You should
+<return> the default backend. You should
not ref or unref the returned object. Applications should rarely
need to use this.
-Since: 0.4
</return>
</function>
@@ -2161,6 +2693,7 @@ Since: 0.4
<description>
Retrieves the #ClutterTimeline for @id inside @score.
+Since: 0.6
</description>
<parameters>
@@ -2173,39 +2706,41 @@ Retrieves the #ClutterTimeline for @id inside @score.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the requested timeline, or %NULL. This
+<return> the requested timeline, or %NULL. This
function does not increase the reference count on the returned
#ClutterTimeline
-Since: 0.6
</return>
</function>
-<function name="clutter_vertex_new">
+<function name="json_node_get_node_type">
<description>
-Creates a new #ClutterVertex for the point in 3D space
-identified by the 3 coordinates @x, @y, @z
+Retrieves the #JsonNodeType of @node
+Since: 0.8
</description>
<parameters>
-<parameter name="x">
-<parameter_description> X coordinate
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate
-</parameter_description>
-</parameter>
-<parameter name="z">
-<parameter_description> Z coordinate
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return> the newly allocate #ClutterVertex. Use
-clutter_vertex_free() to free the resources
+<return> the type of the node
-Since: 1.0
+</return>
+</function>
+
+<function name="clutter_x11_has_composite_extension">
+<description>
+Retrieves whether Clutter is running on an X11 server with the
+XComposite extension
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if the XComposite extension is available
</return>
</function>
@@ -2216,6 +2751,7 @@ inside @array
See also: json_array_get_element(), json_node_get_boolean()
+Since: 0.8
</description>
<parameters>
@@ -2230,7 +2766,6 @@ See also: json_array_get_element(), json_node_get_boolean()
</parameters>
<return> the integer value
-Since: 0.8
</return>
</function>
@@ -2238,6 +2773,7 @@ Since: 0.8
<description>
Gets the at which movements ends.
+Since: 0.4
</description>
<parameters>
@@ -2248,58 +2784,44 @@ Gets the at which movements ends.
</parameters>
<return> angle in degrees
-Since: 0.4
</return>
</function>
-<function name="clutter_actor_pick">
+<function name="clutter_interval_peek_final_value">
<description>
-Renders a silhouette of the actor using the supplied color. Used
-internally for mapping pointer events to actors.
-
-This function should never be called directly by applications.
-
-Subclasses overiding the ClutterActor::pick() method should call
-clutter_actor_should_pick_paint() to decide whether to render their
-silhouette. Containers should always recursively call pick for
-each child.
-
-This function will emit the #ClutterActor::pick signal.
+Gets the pointer to the final value of @interval
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> A #ClutterColor
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the final value of the interval.
+The value is owned by the #ClutterInterval and it should not be
+modified or freed
+
+</return>
</function>
-<function name="clutter_text_delete_selection">
+<function name="clutter_group_get_n_children">
<description>
-Deletes the currently selected text
-
-This function is only useful in subclasses of #ClutterText
+Gets the number of actors held in the group.
+Since: 0.2
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter_description> A #ClutterGroup
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if text was deleted or if the text actor
-is empty, and %FALSE otherwise
+<return> The number of child actors held in the group.
-Since: 1.0
</return>
</function>
@@ -2365,6 +2887,7 @@ Since: 0.8
<description>
Retrieves the duration of the media stream that @media represents.
+Since: 0.2
</description>
<parameters>
@@ -2375,36 +2898,43 @@ Retrieves the duration of the media stream that @media represents.
</parameters>
<return> the duration of the media stream, in seconds
-Since: 0.2
</return>
</function>
-<function name="clutter_backend_set_font_options">
+<function name="clutter_actor_get_gid">
<description>
-Sets the new font options for @backend. The #ClutterBackend will
-copy the #cairo_font_options_t.
-
-If @options is %NULL, the first following call to
-clutter_backend_get_font_options() will return the default font
-options for @backend.
-
-This function is intended for actors creating a Pango layout
-using the PangoCairo API.
+Retrieves the unique id for @self.
-Since: 0.8
+Since: 0.6
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="options">
-<parameter_description> Cairo font options for the backend, or %NULL
+</parameters>
+<return> Globally unique value for this object instance.
+
+</return>
+</function>
+
+<function name="clutter_animation_get_timeline">
+<description>
+Retrieves the #ClutterTimeline used by @animation
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the timeline used by the animation
+
+</return>
</function>
<function name="clutter_shader_is_compiled">
@@ -2412,6 +2942,7 @@ Since: 0.8
Checks whether @shader is is currently compiled, linked and bound
to the GL context.
+Since: 0.8
</description>
<parameters>
@@ -2422,59 +2953,77 @@ to the GL context.
</parameters>
<return> %TRUE if the shader is compiled, linked and ready for use.
-Since: 0.8
</return>
</function>
-<function name="clutter_threads_add_timeout">
+<function name="clutter_container_class_find_child_property">
<description>
-Simple wrapper around clutter_threads_add_timeout_full().
+Looks up the #GParamSpec for a child property of @klass.
+Since: 0.8
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> the time between calls to the function, in milliseconds
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
+<parameter name="klass">
+<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="property_name">
+<parameter_description> a property name.
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
+<return> The #GParamSpec for the property or %NULL
+if no such property exist.
-Since: 0.4
</return>
</function>
-<function name="clutter_interval_peek_initial_value">
+<function name="clutter_actor_should_pick_paint">
<description>
-Gets the pointer to the initial value of @interval
+Should be called inside the implementation of the
+#ClutterActor::pick virtual function in order to check whether
+the actor should paint itself in pick mode or not.
+
+This function should never be called directly by applications.
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the initial value of the interval.
-The value is owned by the #ClutterInterval and it should not be
-modified or freed
-
-Since: 1.0
+<return> %TRUE if the actor should paint its silhouette,
+%FALSE otherwise
</return>
</function>
+<function name="clutter_x11_texture_pixmap_set_automatic">
+<description>
+Enables or disables the automatic updates ot @texture in case the backing
+pixmap or window is damaged
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="texture">
+<parameter_description> a #ClutterX11TexturePixmap
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE to enable automatic updates
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_path_add_move_to">
<description>
-Adds a #CLUTTER_PATH_MOVE_TO type node to the path. This is usually
+Adds a %CLUTTER_PATH_MOVE_TO type node to the path. This is usually
used as the first node in a path. It can also be used in the middle
of the path to cause the actor to jump to the new coordinate.
@@ -2502,6 +3051,7 @@ Since: 1.0
<description>
Retrieves the key symbol of @event
+Since: 1.0
</description>
<parameters>
@@ -2513,7 +3063,6 @@ of type %CLUTTER_KEY_RELEASE
</parameters>
<return> the key symbol representing the key
-Since: 1.0
</return>
</function>
@@ -2528,6 +3077,7 @@ type of @initial_value and @final_value.
All implementation of the #ClutterAnimatable interface must
implement this function.
+Since: 1.0
</description>
<parameters>
@@ -2563,7 +3113,6 @@ implement this function.
<return> %TRUE if the value has been validated and can
be applied to the #ClutterAnimatable, and %FALSE otherwise
-Since: 1.0
</return>
</function>
@@ -2592,12 +3141,11 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_units_em">
+<function name="clutter_units_from_cm">
<description>
-Stores a value in em inside @units, using the default font
-name as returned by clutter_backend_get_font_name()
+Stores a value in centimeters inside @units
-Since: 1.0
+Since: 1.2
</description>
<parameters>
@@ -2605,8 +3153,8 @@ Since: 1.0
<parameter_description> a #ClutterUnits
</parameter_description>
</parameter>
-<parameter name="em">
-<parameter_description> em
+<parameter name="cm">
+<parameter_description> centimeters
</parameter_description>
</parameter>
</parameters>
@@ -2635,6 +3183,7 @@ The value in @progress represents a position along the path where
0.0 is the beginning and 1.0 is the end of the path. An
interpolated position is then stored in @position.
+Since: 1.0
</description>
<parameters>
@@ -2653,7 +3202,6 @@ interpolated position is then stored in @position.
</parameters>
<return> index of the node used to calculate the position.
-Since: 1.0
</return>
</function>
@@ -2661,6 +3209,7 @@ Since: 1.0
<description>
Gets the #ClutterUnit<!-- -->s contained in @value.
+Since: 0.8
</description>
<parameters>
@@ -2671,41 +3220,9 @@ Gets the #ClutterUnit<!-- -->s contained in @value.
</parameters>
<return> the units inside the passed #GValue
-Since: 0.8
</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:
-<informalexample><programlisting>
-clutter_model_iter_get (iter, 0, &place_string_here, -1);
-</programlisting></informalexample>
-
-where place_string_here is a gchar* to be filled with the string. If
-appropriate, the returned values have to be freed or unreferenced.
-
-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_actor_animate_with_timelinev">
<description>
Animates the given list of properties of @actor between the current
@@ -2723,6 +3240,7 @@ useful for language bindings.
<warning>Unlike clutter_actor_animate_with_timeline(), this function
will not allow you to specify "signal::" names and callbacks.</warning>
+Since: 1.0
</description>
<parameters>
@@ -2743,21 +3261,20 @@ will not allow you to specify "signal::" names and callbacks.</warn
</parameter_description>
</parameter>
<parameter name="properties">
-<parameter_description> (array length=n_properties) (element-type utf8): a vector
+<parameter_description> a vector
containing the property names to set
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> (array length=n_properies): a vector containing the
+<parameter_description> a vector containing the
property values to set
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is
+<return> a #ClutterAnimation object. The object is
owned by the #ClutterActor and should not be unreferenced with
g_object_unref()
-Since: 1.0
</return>
</function>
@@ -2766,6 +3283,7 @@ Since: 1.0
Retrieves the direction of the timeline set with
clutter_timeline_set_direction().
+Since: 0.6
</description>
<parameters>
@@ -2776,60 +3294,56 @@ clutter_timeline_set_direction().
</parameters>
<return> the direction of the timeline
-Since: 0.6
</return>
</function>
-<function name="clutter_timeline_list_markers">
+<function name="clutter_text_get_password_char">
<description>
-Retrieves the list of markers at time @msecs. If @frame_num is a
-negative integer, all the markers attached to @timeline will be
-returned.
+Retrieves the character to use in place of the actual text
+as set by clutter_text_set_password_char().
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="msecs">
-<parameter_description> the time to check, or -1
-</parameter_description>
-</parameter>
-<parameter name="n_markers">
-<parameter_description> the number of markers returned
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> (array zero-terminated=1 length=n_markers): a newly
-allocated, %NULL terminated string array containing the names of
-the markers. Use g_strfreev() when done.
+<return> a Unicode character or 0 if the password
+character is not set
-Since: 0.8
</return>
</function>
-<function name="json_array_unref">
+<function name="clutter_get_option_group_without_init">
<description>
-Decreases by one the reference count of a #JsonArray. If the
-reference count reaches zero, the array is destroyed and all
-its allocated resources are freed.
+Returns a #GOptionGroup for the command line arguments recognized
+by Clutter. You should add this group to your #GOptionContext with
+g_option_context_add_group(), if you are using g_option_context_parse()
+to parse your commandline arguments. Unlike clutter_get_option_group(),
+calling g_option_context_parse() with the #GOptionGroup returned by this
+function requires a subsequent explicit call to clutter_init(); use this
+function when needing to set foreign display connection with
+clutter_x11_set_display(), or with gtk_clutter_init().
+
+Since: 0.8.2
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+</return>
</function>
<function name="clutter_text_get_font_name">
<description>
Retrieves the font name as set by clutter_text_set_font_name().
+Since: 1.0
</description>
<parameters>
@@ -2842,45 +3356,24 @@ Retrieves the font name as set by clutter_text_set_font_name().
string is owned by the #ClutterText actor and should not be
modified or freed
-Since: 1.0
</return>
</function>
-<function name="clutter_media_set_filename">
-<description>
-Sets the source of @media using a file path.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
-</parameter_description>
-</parameter>
-<parameter name="filename">
-<parameter_description> A filename
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_behaviour_get_n_actors">
+<function name="clutter_behaviour_ellipse_get_direction">
<description>
-Gets the number of actors this behaviour is applied too.
+Retrieves the #ClutterRotateDirection used by the ellipse behaviour.
+Since: 0.4
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
</parameters>
-<return> The number of applied actors
+<return> the rotation direction
-Since: 0.2
</return>
</function>
@@ -2914,15 +3407,17 @@ out the help output. Also note that, in case of error, the
error message will be placed inside @error instead of being
printed on the display.
+Since: 0.2
</description>
<parameters>
<parameter name="argc">
-<parameter_description> (inout): a pointer to the number of command line arguments
+<parameter_description> a pointer to the number of command line arguments
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> (array length=argc) (inout): a pointer to the array of command line arguments
+<parameter_description> a pointer to the array
+of command line arguments
</parameter_description>
</parameter>
<parameter name="parameter_string">
@@ -2937,9 +3432,9 @@ describing the options of your program
</parameter_description>
</parameter>
<parameter name="translation_domain">
-<parameter_description> a translation domain to use for translating
-the <option>--help</option> output for the options in @entries
-with gettext(), or %NULL
+<parameter_description> a translation domain to use for
+translating the <option>--help</option> output for the options in
+ entries with gettext(), or %NULL
</parameter_description>
</parameter>
<parameter name="error">
@@ -2951,7 +3446,6 @@ with gettext(), or %NULL
initialised, or other values or #ClutterInitError in case of
error.
-Since: 0.2
</return>
</function>
@@ -3007,18 +3501,6 @@ Since: 0.2
<return></return>
</function>
-<function name="ClutterChildMeta">
-<description>
-The #ClutterActor being wrapped by this #ClutterChildMeta
-
-Since: 0.8
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_actor_unrealize">
<description>
Frees up any underlying graphics resources needed by the actor to
@@ -3059,29 +3541,69 @@ code that recreates your resources directly (outside Clutter).
<return></return>
</function>
-<function name="clutter_get_actor_by_gid">
+<function name="clutter_actor_push_internal">
<description>
-Retrieves the #ClutterActor with @id.
+Should be used by actors implementing the #ClutterContainer and with
+internal children added through clutter_actor_set_parent(), for instance:
+
+|[
+static void
+my_actor_init (MyActor *self)
+{
+self->priv = SELF_ACTOR_GET_PRIVATE (self);
+
+clutter_actor_push_internal (CLUTTER_ACTOR (self));
+
+/ * calling clutter_actor_set_parent() now will result in
+* the internal flag being set on a child of MyActor
+* /
+
+/ * internal child: a background texture * /
+self->priv->background_tex = clutter_texture_new ();
+clutter_actor_set_parent (self->priv->background_tex,
+CLUTTER_ACTOR (self));
+
+/ * internal child: a label * /
+self->priv->label = clutter_text_new ();
+clutter_actor_set_parent (self->priv->label,
+CLUTTER_ACTOR (self));
+
+clutter_actor_pop_internal (CLUTTER_ACTOR (self));
+/ * calling clutter_actor_set_parent() now will not result in
+* the internal flag being set on a child of MyActor
+* /
+}
+]|
+
+This function will be used by Clutter to toggle an "internal child"
+flag whenever clutter_actor_set_parent() is called; internal children
+are handled differently by Clutter, specifically when destroying their
+parent.
+
+Call clutter_actor_pop_internal() when you finished adding internal
+children.
+
+Nested calls to clutter_actor_push_internal() are allowed, but each
+one must by followed by a clutter_actor_pop_internal() call.
+
+Since: 1.2
</description>
<parameters>
-<parameter name="id">
-<parameter_description> a #ClutterActor ID.
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the actor with the passed id or %NULL.
-The returned actor does not have its reference count increased.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_units_to_pixels">
<description>
Converts a value in #ClutterUnits to pixels
+Since: 1.0
</description>
<parameters>
@@ -3092,14 +3614,37 @@ Converts a value in #ClutterUnits to pixels
</parameters>
<return> the value in pixels
-Since: 1.0
</return>
</function>
+<function name="json_array_add_array_element">
+<description>
+Conveniently adds an array into @array. The @array takes ownership
+of the newly added #JsonArray
+
+See also: json_array_add_element(), json_node_take_array()
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_util_next_p2">
<description>
Calculates the nearest power of two, greater than or equal to @a.
+Deprecated: 1.2
</description>
<parameters>
@@ -3109,39 +3654,49 @@ Calculates the nearest power of two, greater than or equal to @a.
</parameter>
</parameters>
<return> The nearest power of two, greater or equal to @a.
+
</return>
</function>
-<function name="clutter_text_new_full">
+<function name="clutter_box_layout_pack">
<description>
-Creates a new #ClutterText actor, using @font_name as the font
-description; @text will be used to set the contents of the actor;
-and @color will be used as the color to render @text.
-
-This function is equivalent to calling clutter_text_new(),
-clutter_text_set_font_name(), clutter_text_set_text() and
-clutter_text_set_color().
+Packs @actor inside the #ClutterContainer associated to @layout
+and sets the layout properties
+Since: 1.2
</description>
<parameters>
-<parameter name="font_name">
-<parameter_description> a string with a font description
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="text">
-<parameter_description> the contents of the actor
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> the color to be used to render @text
+<parameter name="expand">
+<parameter_description> whether the @actor should expand
+</parameter_description>
+</parameter>
+<parameter name="x_fill">
+<parameter_description> whether the @actor should fill horizontally
+</parameter_description>
+</parameter>
+<parameter name="y_fill">
+<parameter_description> whether the @actor should fill vertically
+</parameter_description>
+</parameter>
+<parameter name="x_align">
+<parameter_description> the horizontal alignment policy for @actor
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> the vertical alignment policy for @actor
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterText actor
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="json_array_add_object_element">
@@ -3174,6 +3729,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -3188,7 +3744,6 @@ See also: json_object_get_member()
</parameters>
<return> the array inside the object's member
-Since: 0.8
</return>
</function>
@@ -3228,6 +3783,25 @@ Since: 0.8
<return></return>
</function>
+<function name="clutter_actor_set_opacity">
+<description>
+Sets the actor's opacity, with zero being completely transparent and
+255 (0xff) being fully opaque.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="opacity">
+<parameter_description> New opacity value for the actor.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_actor_get_paint_opacity">
<description>
Retrieves the absolute opacity of the actor, as it appears on the stage.
@@ -3238,6 +3812,7 @@ the actor with that of its parents.
This function is intended for subclasses to use in the paint virtual
function, to paint themselves with the correct opacity.
+Since: 0.8
</description>
<parameters>
@@ -3248,7 +3823,6 @@ function, to paint themselves with the correct opacity.
</parameters>
<return> The actor opacity value.
-Since: 0.8
</return>
</function>
@@ -3260,6 +3834,7 @@ description; @text will be used to set the contents of the actor.
This function is equivalent to calling clutter_text_new(),
clutter_text_set_font_name(), and clutter_text_set_text().
+Since: 1.0
</description>
<parameters>
@@ -3274,13 +3849,32 @@ clutter_text_set_font_name(), and clutter_text_set_text().
</parameters>
<return> the newly created #ClutterText actor
-Since: 1.0
+</return>
+</function>
+
+<function name="clutter_input_device_get_pointer_actor">
+<description>
+Retrieves the #ClutterActor underneath the pointer of @device
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice of type %CLUTTER_POINTER_DEVICE
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the #ClutterActor or %NULL
+
</return>
</function>
<function name="json_node_get_value_type">
<description>
-Return value: a #GType for the payload.
+Returns the #GType of the payload of the node.
+
+Since: 0.4
</description>
<parameters>
@@ -3291,10 +3885,41 @@ Return value: a #GType for the payload.
</parameters>
<return> a #GType for the payload.
-Since: 0.4
</return>
</function>
+<function name="clutter_actor_raise_top">
+<description>
+Raises @self to the top.
+
+This function calls clutter_actor_raise() internally.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_vertex_free">
+<description>
+Frees a #ClutterVertex allocated using clutter_vertex_copy()
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="vertex">
+<parameter_description> a #ClutterVertex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_score_set_loop">
<description>
Sets whether @score should loop. A looping #ClutterScore will start
@@ -3340,28 +3965,81 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_timeline_get_delta">
+<function name="clutter_flow_layout_set_orientation">
<description>
-Retrieves the amount of time elapsed since the last
-ClutterTimeline::new-frame signal.
+Sets the orientation of the flow layout
-This function is only useful inside handlers for the ::new-frame
-signal, and its behaviour is undefined if the timeline is not
-playing.
+The orientation controls the direction used to allocate
+the children: either horizontally or vertically. The
+orientation also controls the direction of the overflowing
+Since: 1.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
+</parameter_description>
+</parameter>
+<parameter name="orientation">
+<parameter_description> the orientation of the layout
</parameter_description>
</parameter>
</parameters>
-<return> the amount of time in milliseconds elapsed since the
-last frame
+<return></return>
+</function>
+
+<function name="clutter_actor_get_anchor_point">
+<description>
+Gets the current anchor point of the @actor in pixels.
Since: 0.6
-</return>
+
+</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_box_layout_set_alignment">
+<description>
+Sets the horizontal and vertical alignment policies for @actor
+inside @layout
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
+</parameter_description>
+</parameter>
+<parameter name="x_align">
+<parameter_description> Horizontal alignment policy for @actor
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> Vertical alignment policy for @actor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_grab_keyboard">
@@ -3390,25 +4068,39 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_actor_get_shader">
+<function name="clutter_model_get_filter_set">
<description>
-Queries the currently set #ClutterShader on @self.
+Returns whether the @model has a filter in place, set
+using clutter_model_set_filter()
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The currently set #ClutterShader or %NULL if no
-shader is set.
+<return> %TRUE if a filter is set
-Since: 0.6
</return>
</function>
+<function name="clutter_timeline_start">
+<description>
+Starts the #ClutterTimeline playing.
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_object_get_double_member">
<description>
Convenience function that retrieves the floating point value
@@ -3416,6 +4108,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -3430,25 +4123,77 @@ See also: json_object_get_member()
</parameters>
<return> the floating point value of the object's member
-Since: 0.8
</return>
</function>
-<function name="clutter_event_get_flags">
+<function name="clutter_media_set_subtitle_uri">
<description>
-Retrieves the #ClutterEventFlags of @event
+Sets the location of a subtitle file to display while playing @media.
+Since: 1.2
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> the URI of a subtitle file
</parameter_description>
</parameter>
</parameters>
-<return> the event flags
+<return></return>
+</function>
+
+<function name="clutter_stage_get_actor_at_pos">
+<description>
+Checks the scene at the coordinates @x and @y and returns a pointer
+to the #ClutterActor at those coordinates.
+
+By using @pick_mode it is possible to control which actors will be
+painted and thus available.
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="pick_mode">
+<parameter_description> how the scene graph should be painted
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate to check
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> the actor at the specified coordinates,
+if any
+</return>
+</function>
+
+<function name="clutter_animation_get_object">
+<description>
+Retrieves the #GObject attached to @animation.
Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GObject
+
</return>
</function>
@@ -3487,45 +4232,62 @@ Since: 1.0
</parameter_description>
</parameter>
<parameter name="verts">
-<parameter_description> (array fixed-size=4): array of four #ClutterVertex
+<parameter_description> array of four #ClutterVertex
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_path_replace_node">
+<function name="clutter_text_set_ellipsize">
<description>
-Replaces the node at offset @index_ with @node.
+Sets the mode used to ellipsize (add an ellipsis: "...") to the
+text if there is not enough space to render the entire contents
+of a #ClutterText actor
Since: 1.0
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> index to the existing node
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the replacement node
+<parameter name="mode">
+<parameter_description> a #PangoEllipsizeMode
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="ClutterBehaviourDepth">
+<function name="clutter_interval_set_interval">
<description>
-End depth level to apply to the actors.
+Variable arguments wrapper for clutter_interval_set_initial_value()
+and clutter_interval_set_final_value() that avoids using the
+#GValue arguments:
-Since: 0.4
+|[
+clutter_interval_set_interval (interval, 0, 50);
+clutter_interval_set_interval (interval, 1.0, 0.0);
+clutter_interval_set_interval (interval, FALSE, TRUE);
+]|
+
+This function is meant for the convenience of the C API; bindings
+should reimplement this function using the #GValue-based API.
+
+Since: 1.0
</description>
<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the initial and final values of the interval
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -3552,6 +4314,34 @@ Since: 0.6
<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_behaviour_ellipse_new">
<description>
Creates a behaviour that drives actors along an elliptical path with
@@ -3561,6 +4351,7 @@ degrees. Angles greated than 360 degrees get clamped to the canonical
interval <0, 360); if @start is equal to @end, the behaviour will
rotate by exacly 360 degrees.
+Since: 0.4
</description>
<parameters>
@@ -3599,26 +4390,23 @@ rotate by exacly 360 degrees.
</parameters>
<return> the newly created #ClutterBehaviourEllipse
-Since: 0.4
</return>
</function>
-<function name="clutter_actor_set_flags">
+<function name="clutter_stage_ensure_redraw">
<description>
-Sets @flags on @self
+Ensures that @stage is redrawn
-This function will emit notifications for the changed properties
+This function should not be called by applications: it is
+used when embedding a #ClutterStage into a toolkit with
+another windowing system, like GTK+.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> the flags to set
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
</parameters>
@@ -3644,62 +4432,172 @@ done using it
</return>
</function>
-<function name="clutter_units_pixels">
+<function name="json_array_get_double_element">
<description>
-Stores a value in pixels inside @units
+Conveniently retrieves the floating point value of the element at
+ index_ inside @array
-Since: 1.0
+See also: json_array_get_element(), json_node_get_double()
+
+Since: 0.8
</description>
<parameters>
-<parameter name="units">
-<parameter_description> a #ClutterUnits
+<parameter name="array">
+<parameter_description> a #JsonArray
</parameter_description>
</parameter>
-<parameter name="px">
-<parameter_description> pixels
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the floating point value
+
+</return>
</function>
-<function name="clutter_alpha_set_timeline">
+<function name="clutter_actor_set_clip">
<description>
-Binds @alpha to @timeline.
+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.2
+Since: 0.6
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="xoff">
+<parameter_description> X offset of the clip rectangle
+</parameter_description>
+</parameter>
+<parameter name="yoff">
+<parameter_description> Y offset of the clip rectangle
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width of the clip rectangle
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height of the clip rectangle
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_stage_hide_cursor">
+<function name="clutter_actor_hide">
<description>
-Makes the cursor invisible on the stage window
+Flags an actor to be hidden. A hidden actor will not be
+rendered on the stage.
-Since: 0.4
+Actors are visible by default.
+
+If this function is called on an actor without a parent, the
+#ClutterActor:show-on-set-parent property will be set to %FALSE
+as a side-effect.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_threads_remove_repaint_func">
+<description>
+Removes the repaint function with @handle_id as its id
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="handle_id">
+<parameter_description> an unsigned integer greater than zero
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_binding_pool_find_action">
+<description>
+Retrieves the name of the action matching the given key symbol
+and modifiers bitmask.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> a key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> a bitmask for the modifiers
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the action, if found, or %NULL. The
+returned string is owned by the binding pool and should never
+be modified or freed
+
+</return>
+</function>
+
+<function name="clutter_alpha_get_mode">
+<description>
+Retrieves the #ClutterAnimationMode used by @alpha.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+</parameters>
+<return> the animation mode
+
+</return>
+</function>
+
+<function name="clutter_path_new_with_description">
+<description>
+Creates a new #ClutterPath instance with the nodes described in
+ desc See clutter_path_add_string() for details of the format of
+the string.
+
+The object has a floating reference so if you add it to a
+#ClutterBehaviourPath then you do not need to unref it.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="desc">
+<parameter_description> a string describing the path
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterPath
+
+</return>
+</function>
+
<function name="clutter_behaviour_ellipse_set_tilt">
<description>
Sets the angles at which the ellipse should be tilted around it's center.
@@ -3728,42 +4626,79 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_media_set_progress">
+<function name="clutter_box_layout_get_use_animations">
<description>
-Sets the playback progress of @media. The @progress is
-a normalized value between 0.0 (begin) and 1.0 (end).
+Retrieves whether @layout should animate changes in the layout properties
-Since: 1.0
+Since clutter_box_layout_set_use_animations()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="progress">
-<parameter_description> the progress of the playback, between 0.0 and 1.0
+</parameters>
+<return> %TRUE if the animations should be used, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="clutter_actor_lower_bottom">
+<description>
+Lowers @self to the bottom.
+
+This function calls clutter_actor_lower() internally.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_group_get_n_children">
+<function name="clutter_text_delete_selection">
<description>
-Gets the number of actors held in the group.
+Deletes the currently selected text
+This function is only useful in subclasses of #ClutterText
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterGroup
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> The number of child actors held in the group.
+<return> %TRUE if text was deleted or if the text actor
+is empty, and %FALSE otherwise
+
+</return>
+</function>
+
+<function name="clutter_stage_get_throttle_motion_events">
+<description>
+Retrieves the value set with clutter_stage_set_throttle_motion_events()
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the motion events are being throttled,
+and %FALSE otherwise
-Since: 0.2
</return>
</function>
@@ -3833,16 +4768,23 @@ content.
<return></return>
</function>
-<function name="clutter_threads_remove_repaint_func">
+<function name="clutter_container_add_actor">
<description>
-Removes the repaint function with @handle_id as its id
+Adds a #ClutterActor to @container. This function will emit the
+"actor-added" signal. The actor should be parented to
+ container You cannot add a #ClutterActor to more than one
+#ClutterContainer.
-Since: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="handle_id">
-<parameter_description> an unsigned integer greater than zero
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> the first #ClutterActor to add
</parameter_description>
</parameter>
</parameters>
@@ -3855,6 +4797,7 @@ Retrieves the list of floating point values stored inside
the passed #GValue. @value must have been initialized with
%CLUTTER_TYPE_SHADER_FLOAT.
+Since: 0.8
</description>
<parameters>
@@ -3872,7 +4815,6 @@ point values, or %NULL
The returned value is owned by the #GValue and should never
be modified or freed.
-Since: 0.8
</return>
</function>
@@ -3897,48 +4839,74 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_backend_get_font_options">
+<function name="clutter_model_set_names">
<description>
-Retrieves the font options for @backend.
+Assigns a name to the columns of 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="backend">
-<parameter_description> a #ClutterBackend
+<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> (transfer none): the font options of the #ClutterBackend.
-The returned #cairo_font_options_t is owned by the backend and should
-not be modified or freed
+<return></return>
+</function>
+
+<function name="clutter_events_pending">
+<description>
+Checks if events are pending in the event queue.
+
+Since: 0.4
+
+</description>
+<parameters>
+</parameters>
+<return> TRUE if there are pending events, FALSE otherwise.
-Since: 0.8
</return>
</function>
-<function name="clutter_texture_new_from_file">
+<function name="clutter_layout_manager_get_child_meta">
<description>
-Creates a new ClutterTexture actor to display the image contained a
-file. If the image failed to load then NULL is returned and @error
-is set.
+Retrieves the #ClutterLayoutMeta that the layout @manager associated
+to the @actor child of @container, eventually by creating one if the
+#ClutterLayoutManager supports layout properties
+Since: 1.0
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> The name of an image file to load.
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return locatoin for an error.
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @container
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #ClutterTexture object or NULL on
-error.
+<return> a #ClutterLayoutMeta, or %NULL if the #ClutterLayoutManager
+does not have layout properties
-Since: 0.8
</return>
</function>
@@ -3967,30 +4935,6 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_behaviour_rotate_get_bounds">
-<description>
-Retrieves the rotation boundaries of the rotate behaviour.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="angle_start">
-<parameter_description> return value for the initial angle
-</parameter_description>
-</parameter>
-<parameter name="angle_end">
-<parameter_description> return value for the final angle
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_timeline_get_loop">
<description>
Gets whether @timeline is looping
@@ -4007,105 +4951,80 @@ Gets whether @timeline is looping
</return>
</function>
-<function name="json_object_add_member">
+<function name="clutter_actor_set_flags">
<description>
-Adds a member named @member_name and containing @node into a #JsonObject.
-The object will take ownership of the #JsonNode.
+Sets @flags on @self
-This function will return if the @object already contains a member
- member_name
+This function will emit notifications for the changed properties
-Deprecated: 0.8: Use json_object_set_member() instead
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
-</parameter_description>
-</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the value of the member
+<parameter name="flags">
+<parameter_description> the flags to set
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_set_scale_full">
+<function name="clutter_behaviour_scale_get_bounds">
<description>
-Scales an actor with the given factors around the given center
-point. The center point is specified in pixels relative to the
-anchor point (usually the top left corner of the actor).
+Retrieves the bounds used by scale behaviour.
-Since: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="scale">
+<parameter_description> a #ClutterBehaviourScale
</parameter_description>
</parameter>
-<parameter name="scale_x">
-<parameter_description> double factor to scale actor by horizontally.
+<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="scale_y">
-<parameter_description> double factor to scale actor by vertically.
+<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="center_x">
-<parameter_description> X coordinate of the center of the scale.
+<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="center_y">
-<parameter_description> Y coordinate of the center of the scale
+<parameter name="y_scale_end">
+<parameter_description> return location for the final scale factor on the Y axis,
+or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_node_get_boolean">
+<function name="clutter_input_device_get_device_id">
<description>
-Gets the boolean value stored inside a #JsonNode
+Retrieves the unique identifier of @device
+Since: 1.0
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice
</parameter_description>
</parameter>
</parameters>
-<return> a boolean value.
-</return>
-</function>
-
-<function name="clutter_container_add_actor">
-<description>
-Adds a #ClutterActor to @container. This function will emit the
-"actor-added" signal. The actor should be parented to
- container You cannot add a #ClutterActor to more than one
-#ClutterContainer.
-
-Since: 0.4
+<return> the identifier of the device
-</description>
-<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> the first #ClutterActor to add
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
+</return>
</function>
<function name="clutter_redraw">
@@ -4122,32 +5041,34 @@ within another toolkit.
<return></return>
</function>
-<function name="ClutterBehaviourScale">
+<function name="cogl_pango_render_layout_line">
<description>
-The final scaling factor on the Y axis for the actors.
+Renders @line at the given coordinates using the given color.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
+<parameter name="line">
+<parameter_description> a #PangoLayoutLine
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate to render the line at
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate to render the line at
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the line
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_get_option_group_without_init">
-<description>
-Return value: (transfer full): a #GOptionGroup for the commandline arguments
-
-</description>
-<parameters>
-</parameters>
-<return> (transfer full): a #GOptionGroup for the commandline arguments
-recognized by Clutter
-
-Since: 0.8.2
-</return>
-</function>
-
<function name="clutter_texture_set_cogl_texture">
<description>
Replaces the underlying COGL texture drawn by this actor with
@@ -4176,26 +5097,29 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_raise_top">
+<function name="clutter_box_get_layout_manager">
<description>
-Raises @self to the top.
+Retrieves the #ClutterLayoutManager instance used by @box
-This function calls clutter_actor_raise() internally.
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="box">
+<parameter_description> a #ClutterBox
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterLayoutManager
+
+</return>
</function>
<function name="clutter_win32_get_stage_from_window">
<description>
Gets the stage for a particular window.
+Since: 0.8
</description>
<parameters>
@@ -4207,7 +5131,6 @@ Gets the stage for a particular window.
<return> The stage or NULL if a stage does not exist for the
window.
-Since: 0.8
</return>
</function>
@@ -4231,9 +5154,148 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_alpha_new_with_func">
+<description>
+Creates a new #ClutterAlpha instances and sets the timeline
+and the alpha function.
+
+This function will not register @func as a global alpha function.
+
+See also clutter_alpha_set_timeline() and clutter_alpha_set_func().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterAlphaFunc
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> function to call when removing the alpha function, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterAlpha
+
+</return>
+</function>
+
+<function name="clutter_units_from_pixels">
+<description>
+Stores a value in pixels inside @units
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="units">
+<parameter_description> a #ClutterUnits
+</parameter_description>
+</parameter>
+<parameter name="px">
+<parameter_description> pixels
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_preferred_size">
+<description>
+Computes the preferred minimum and natural size of an actor, taking into
+account the actor's geometry management (either height-for-width
+or width-for-height).
+
+The width and height used to compute the preferred height and preferred
+width are the actor's natural ones.
+
+If you need to control the height for the preferred width, or the width for
+the preferred height, you should use clutter_actor_get_preferred_width()
+and clutter_actor_get_preferred_height(), and check the actor's preferred
+geometry management using the #ClutterActor:request-mode property.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="min_width_p">
+<parameter_description> return location for the minimum
+width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="min_height_p">
+<parameter_description> return location for the minimum
+height, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="natural_width_p">
+<parameter_description> return location for the natural
+width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="natural_height_p">
+<parameter_description> return location for the natural
+height, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_flow_layout_get_column_width">
+<description>
+Retrieves the minimum and maximum column widths
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
+</parameter_description>
+</parameter>
+<parameter name="min_width">
+<parameter_description> return location for the minimum column width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="max_width">
+<parameter_description> return location for the maximum column width, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_x11_get_root_window">
+<description>
+Retrieves the root window.
+
+Since: 0.6
+
+</description>
+<parameters>
+</parameters>
+<return> the id of the root window
+
+</return>
+</function>
+
<function name="clutter_path_add_line_to">
<description>
-Adds a #CLUTTER_PATH_LINE_TO type node to the path. This causes the
+Adds a %CLUTTER_PATH_LINE_TO type node to the path. This causes the
actor to move to the new coordinates in a straight line.
Since: 1.0
@@ -4256,16 +5318,44 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_score_stop">
+<function name="clutter_text_get_selection_color">
<description>
-Stops and rewinds a playing #ClutterScore instance.
+Retrieves the color of the selection of a #ClutterText actor.
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_rotate_get_bounds">
+<description>
+Retrieves the rotation boundaries of the rotate behaviour.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="angle_start">
+<parameter_description> return value for the initial angle
+</parameter_description>
+</parameter>
+<parameter name="angle_end">
+<parameter_description> return value for the final angle
</parameter_description>
</parameter>
</parameters>
@@ -4279,6 +5369,7 @@ inside @array
See also: json_array_get_element(), json_node_get_object()
+Since: 0.8
</description>
<parameters>
@@ -4293,107 +5384,117 @@ See also: json_array_get_element(), json_node_get_object()
</parameters>
<return> the object
-Since: 0.8
</return>
</function>
-<function name="JsonParser">
+<function name="clutter_stage_is_default">
<description>
-The ::error signal is emitted each time a #JsonParser encounters
-an error in a JSON stream.
+Checks if @stage is the default stage, or an instance created using
+clutter_stage_new() but internally using the same implementation.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="parser">
-<parameter_description> the parser instance that received the signal
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to the #GError
+</parameters>
+<return> %TRUE if the passed stage is the default one
+
+</return>
+</function>
+
+<function name="clutter_timeline_is_playing">
+<description>
+Queries state of a #ClutterTimeline.
+
+
+</description>
+<parameters>
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if timeline is currently playing
+</return>
</function>
-<function name="clutter_score_rewind">
+<function name="clutter_color_darken">
<description>
-Rewinds a #ClutterScore to its initial state.
-
-Since: 0.6
+Darkens @color by a fixed amount, and saves the changed color
+in @result.
</description>
<parameters>
-<parameter name="score">
-<parameter_description> A #ClutterScore
+<parameter name="color">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> return location for the darker color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_box_copy">
+<function name="clutter_actor_get_parent">
<description>
-Copies @box
+Retrieves the parent of @self.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated copy of #ClutterActorBox. Use
-clutter_actor_box_free() to free the allocated resources
-
-Since: 1.0
+<return> The #ClutterActor parent, or %NULL
+if no parent is set
</return>
</function>
-<function name="clutter_text_set_justify">
+<function name="clutter_stage_set_use_alpha">
<description>
-Sets whether the text of the #ClutterText actor should be justified
-on both margins. This setting is ignored if Clutter is compiled
-against Pango < 1.18.
+Sets whether the @stage should honour the #ClutterActor:opacity and
+the alpha channel of the #ClutterStage:color
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
-<parameter name="justify">
-<parameter_description> whether the text should be justified
+<parameter name="use_alpha">
+<parameter_description> whether the stage should honour the opacity or the
+alpha channel of the stage color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_interval_validate">
+<function name="clutter_actor_box_free">
<description>
-Validates the initial and final values of @interval against
-a #GParamSpec.
+Frees a #ClutterActorBox allocated using clutter_actor_box_new()
+or clutter_actor_box_copy()
+Since: 1.0
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
-</parameter_description>
-</parameter>
-<parameter name="pspec">
-<parameter_description> a #GParamSpec
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #ClutterInterval is valid, %FALSE otherwise
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_stage_get_color">
@@ -4445,6 +5546,7 @@ 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.
+Since: 0.6
</description>
<parameters>
@@ -4453,10 +5555,9 @@ a filter function.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The passed iterator, updated to point at the next
+<return> The passed iterator, updated to point at the next
row in the model.
-Since: 0.6
</return>
</function>
@@ -4467,6 +5568,7 @@ filtering function set on @model.
This function should be used only by subclasses of #ClutterModel.
+Since: 0.6
</description>
<parameters>
@@ -4482,72 +5584,117 @@ This function should be used only by subclasses of #ClutterModel.
<return> %TRUE if the row should be displayed,
%FALSE otherwise
-Since: 0.6
</return>
</function>
-<function name="cogl_pango_font_map_new">
+<function name="clutter_path_get_node">
<description>
-Creates a new font map.
+Retrieves the node of the path indexed by @index.
+Since: 1.0
</description>
<parameters>
+<parameter name="path">
+<parameter_description> a #ClutterPath
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the node number to retrieve
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> a location to store a copy of the node
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #PangoFontMap
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_x11_texture_pixmap_new">
<description>
+Creates a new #ClutterX11TexturePixmap which can be used to display the
+contents of an X11 Pixmap inside a Clutter scene graph
+
+Since: 0.8
</description>
<parameters>
</parameters>
<return> A new #ClutterX11TexturePixmap
-Since: 0.8
</return>
</function>
-<function name="clutter_value_get_fixed">
+<function name="clutter_actor_unset_flags">
<description>
-Gets the fixed point value stored inside @value.
+Unsets @flags on @self
+
+This function will emit notifications for the changed properties
+Since: 1.0
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to %COGL_TYPE_FIXED
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the flags to unset
</parameter_description>
</parameter>
</parameters>
-<return> the value inside the passed #GValue
-
-Since: 0.8
-</return>
+<return></return>
</function>
-<function name="clutter_get_default_frame_rate">
+<function name="clutter_text_new">
<description>
-Retrieves the default frame rate. See clutter_set_default_frame_rate().
+Creates a new #ClutterText actor. This actor can be used to
+display and edit text.
+Since: 1.0
</description>
<parameters>
</parameters>
-<return> the default frame rate
+<return> the newly created #ClutterText actor
-Since: 0.6
</return>
</function>
+<function name="json_object_set_string_member">
+<description>
+Convenience function for setting a string @value of
+ member_name inside @object.
+
+See also: json_object_set_member()
+
+Since: 0.8
+
+</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="value">
+<parameter_description> the value of the member
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_get_script_id">
<description>
Retrieves the Clutter script id, if any.
+Since: 0.6
</description>
<parameters>
@@ -4560,7 +5707,6 @@ Retrieves the Clutter script id, if any.
a UI definition file. The returned string is owned by the object and
should never be modified or freed.
-Since: 0.6
</return>
</function>
@@ -4568,6 +5714,7 @@ Since: 0.6
<description>
Simple wrapper around clutter_frame_source_add_full().
+Since: 0.8
</description>
<parameters>
@@ -4586,67 +5733,31 @@ Simple wrapper around clutter_frame_source_add_full().
</parameters>
<return> the ID (greater than 0) of the event source.
-Since: 0.8
</return>
</function>
-<function name="clutter_actor_get_rotation">
+<function name="json_object_add_member">
<description>
-Retrieves the angle and center of rotation on the given axis,
-set using clutter_actor_set_rotation().
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> (out): return value for the X coordinate of the center of rotation
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> (out): return value for the Y coordinate of the center of rotation
-</parameter_description>
-</parameter>
-<parameter name="z">
-<parameter_description> (out): return value for the Z coordinate of the center of rotation
-</parameter_description>
-</parameter>
-</parameters>
-<return> the angle of rotation
-
-Since: 0.8
-</return>
-</function>
+Adds a member named @member_name and containing @node into a #JsonObject.
+The object will take ownership of the #JsonNode.
-<function name="clutter_model_set_filter">
-<description>
-Filters the @model using the given filtering function.
+This function will return if the @object already contains a member
+ member_name
-Since: 0.6
+Deprecated: 0.8: Use json_object_set_member() instead
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #ClutterModelFilterFunc, or #NULL
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to @func, or #NULL
+<parameter name="member_name">
+<parameter_description> the name of the member
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> destroy notifier of @user_data, or #NULL
+<parameter name="node">
+<parameter_description> the value of the member
</parameter_description>
</parameter>
</parameters>
@@ -4658,6 +5769,7 @@ Since: 0.6
Retrieves whether the #ClutterText actor should justify its contents
on both margins.
+Since: 0.6
</description>
<parameters>
@@ -4668,7 +5780,6 @@ on both margins.
</parameters>
<return> %TRUE if the text should be justified
-Since: 0.6
</return>
</function>
@@ -4692,22 +5803,48 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_event_get_click_count">
+<function name="clutter_actor_is_in_clone_paint">
<description>
-Retrieves the number of clicks of @event
+Checks whether @self is being currently painted by a #ClutterClone
+This function is useful only inside the ::paint virtual function
+implementations or within handlers for the #ClutterActor::paint
+signal
+
+This function should not be used by applications
+
+Since: 1.0
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent of type %CLUTTER_BUTTON_PRESS or
-of type %CLUTTER_BUTTON_RELEASE
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the click count
+<return> %TRUE if the #ClutterActor is currently being painted
+by a #ClutterClone, and %FALSE otherwise
+
+</return>
+</function>
+
+<function name="clutter_box_layout_get_vertical">
+<description>
+Retrieves the orientation of the @layout as set using the
+clutter_box_layout_set_vertical() function
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the #ClutterBoxLayout is arranging its children
+vertically, and %FALSE otherwise
-Since: 1.0
</return>
</function>
@@ -4750,6 +5887,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -4764,7 +5902,48 @@ See also: json_object_get_member()
</parameters>
<return> the boolean value of the object's member
-Since: 0.8
+</return>
+</function>
+
+<function name="clutter_actor_box_get_origin">
+<description>
+Retrieves the origin of @box
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
+</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_clone_get_source">
+<description>
+Retrieves the source #ClutterActor being cloned by @clone
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="clone">
+<parameter_description> a #ClutterClone
+</parameter_description>
+</parameter>
+</parameters>
+<return> the actor source for the clone
+
</return>
</function>
@@ -4772,6 +5951,7 @@ Since: 0.8
<description>
Simple wrapper around clutter_threads_add_frame_source_full().
+Since: 0.8
</description>
<parameters>
@@ -4790,13 +5970,18 @@ Simple wrapper around clutter_threads_add_frame_source_full().
</parameters>
<return> the ID (greater than 0) of the event source.
-Since: 0.8
</return>
</function>
<function name="clutter_path_get_nodes">
<description>
-Return value: (transfer container) (element-type ClutterPathNode): a list of nodes in the path.
+Returns a #GSList of #ClutterPathNode<!-- -->s. The list should be
+freed with g_slist_free(). The nodes are owned by the path and
+should not be freed. Altering the path may cause the nodes in the
+list to become invalid so you should copy them if you want to keep
+the list.
+
+Since: 1.0
</description>
<parameters>
@@ -4805,25 +5990,11 @@ Return value: (transfer container) (element-type ClutterPathNode): a list of nod
</parameter_description>
</parameter>
</parameters>
-<return> (transfer container) (element-type ClutterPathNode): a list of nodes in the path.
+<return> a list of nodes in the path.
-Since: 1.0
</return>
</function>
-<function name="ClutterScript">
-<description>
-The path of the currently parsed file. If ClutterScript:filename-set
-is %FALSE then the value of this property is undefined.
-
-Since: 0.6
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="json_array_get_int_element">
<description>
Conveniently retrieves the integer value of the element at @index_
@@ -4831,6 +6002,7 @@ inside @array
See also: json_array_get_element(), json_node_get_int()
+Since: 0.8
</description>
<parameters>
@@ -4845,7 +6017,6 @@ See also: json_array_get_element(), json_node_get_int()
</parameters>
<return> the integer value
-Since: 0.8
</return>
</function>
@@ -4856,6 +6027,7 @@ visible parents.
This is by definition the same as CLUTTER_ACTOR_IS_MAPPED().
+Since: 0.8.4
</description>
<parameters>
@@ -4866,7 +6038,6 @@ This is by definition the same as CLUTTER_ACTOR_IS_MAPPED().
</parameters>
<return> TRUE if the actor is visibile and will be painted.
-Since: 0.8.4
</return>
</function>
@@ -4891,18 +6062,23 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_actor_get_allocation_geometry">
+<function name="clutter_actor_get_x">
<description>
-Gets the layout box an actor has been assigned. The allocation can
-only be assumed valid inside a paint() method; anywhere else, it
-may be out-of-date.
+Retrieves the X coordinate of a #ClutterActor.
-An allocation does not incorporate the actor's scale or anchor point;
-those transformations do not affect layout, only rendering.
+This function tries to "do what you mean", by returning the
+correct value depending on the actor's state.
-The returned rectangle is in pixels.
+If the actor has a valid allocation, this function will return
+the X coordinate of the origin of the allocation box.
+
+If the actor has any fixed coordinate set using clutter_actor_set_x(),
+clutter_actor_set_position() or clutter_actor_set_geometry(), this
+function will return that coordinate.
+
+If both the allocation and a fixed position are missing, this function
+will return 0.
-Since: 0.8
</description>
<parameters>
@@ -4910,48 +6086,110 @@ Since: 0.8
<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="geom">
-<parameter_description> (out): allocation geometry in pixels
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the X coordinate, in pixels, ignoring any
+transformation (i.e. scaling, rotation)
+</return>
</function>
-<function name="clutter_actor_get_x">
+<function name="clutter_actor_get_y">
<description>
-Retrieves the X coordinate of the origin of @box
+Retrieves the Y coordinate of a #ClutterActor.
+
+This function tries to "do what you mean", by returning the
+correct value depending on the actor's state.
+
+If the actor has a valid allocation, this function will return
+the Y coordinate of the origin of the allocation box.
+
+If the actor has any fixed coordinate set using clutter_actor_set_y(),
+clutter_actor_set_position() or clutter_actor_set_geometry(), this
+function will return that coordinate.
+
+If both the allocation and a fixed position are missing, this function
+will return 0.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the X coordinate of the origin
-
-Since: 1.0
+<return> the Y coordinate, in pixels, ignoring any
+transformation (i.e. scaling, rotation)
</return>
</function>
-<function name="clutter_actor_get_y">
+<function name="json_node_get_boolean">
<description>
-Retrieves the Y coordinate of the origin of @box
+Gets the boolean value stored inside a #JsonNode
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
</parameter_description>
</parameter>
</parameters>
-<return> the Y coordinate of the origin
+<return> a boolean value.
+</return>
+</function>
+
+<function name="clutter_interval_register_progress_func">
+<description>
+Sets the progress function for a given @value_type, like:
+
+|[
+clutter_interval_register_progress_func (MY_TYPE_FOO,
+my_foo_progress);
+]|
+
+Whenever a #ClutterInterval instance using the default
+#ClutterInterval::compute_value implementation is set as an
+interval between two #GValue of type @value_type, it will call
+ func to establish the value depending on the given progress,
+for instance:
+
+|[
+static gboolean
+my_int_progress (const GValue *a,
+const GValue *b,
+gdouble progress,
+GValue *retval)
+{
+gint ia = g_value_get_int (a);
+gint ib = g_value_get_int (b);
+gint res = factor * (ib - ia) + ia;
+
+g_value_set_int (retval, res);
+
+return TRUE;
+}
+
+clutter_interval_register_progress_func (G_TYPE_INT, my_int_progress);
+]|
+
+To unset a previously set progress function of a #GType, pass %NULL
+for @func.
Since: 1.0
-</return>
+
+</description>
+<parameters>
+<parameter name="value_type">
+<parameter_description> a #GType
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #ClutterProgressFunc, or %NULL to unset a previously
+set progress function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_text_delete_chars">
@@ -4975,33 +6213,45 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_model_prependv">
+<function name="clutter_device_manager_peek_devices">
<description>
-Creates and prepends a new row to the #ClutterModel, setting the row
-values for the given @columns upon creation.
+Lists all currently registered input devices
-Since: 0.6
+Since: 1.2
</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 name="device_manager">
+<parameter_description> a #ClutterDeviceManager
</parameter_description>
</parameter>
-<parameter name="columns">
-<parameter_description> (array length=n_columns): a vector containing the columns to set
-</parameter_description>
-</parameter>
-<parameter name="values">
-<parameter_description> (array length=n_columns): a vector containing the values for the cells
+</parameters>
+<return>
+a pointer to the internal list of #ClutterInputDevice objects. The
+returned list is owned by the #ClutterDeviceManager and should never
+be modified or freed
+
+</return>
+</function>
+
+<function name="clutter_actor_has_pointer">
+<description>
+Checks whether an actor contains the the pointer of a
+#ClutterInputDevice
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the actor contains the pointer, and
+%FALSE otherwise
+
+</return>
</function>
<function name="clutter_path_add_rel_curve_to">
@@ -5071,39 +6321,68 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_init">
+<function name="clutter_alpha_get_alpha">
<description>
-It will initialise everything needed to operate with Clutter and
-parses some standard command line options. @argc and @argv are
-adjusted accordingly so your own code will never see those standard
-arguments.
+Query the current alpha value.
+Since: 0.2
</description>
<parameters>
-<parameter name="argc">
-<parameter_description> (inout): The number of arguments in @argv
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="argv">
-<parameter_description> (array length=argc) (inout): A pointer to an array of arguments.
+</parameters>
+<return> The current alpha value for the alpha
+
+</return>
+</function>
+
+<function name="clutter_actor_box_get_area">
+<description>
+Retrieves the area of @box
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
</parameter_description>
</parameter>
</parameters>
-<return> 1 on success, < 0 on failure.
+<return> the area of a #ClutterActorBox, in pixels
+
</return>
</function>
-<function name="json_array_new">
+<function name="clutter_model_iter_set">
<description>
-Creates a new #JsonArray.
+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:
+<informalexample><programlisting>
+clutter_model_iter_set (iter, 0, "foo", -1);
+</programlisting></informalexample>
+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> the newly created #JsonArray
-</return>
+<return></return>
</function>
<function name="clutter_color_from_hls">
@@ -5114,7 +6393,7 @@ values into a #ClutterColor.
</description>
<parameters>
<parameter name="color">
-<parameter_description> (out): return location for a #ClutterColor
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
<parameter name="hue">
@@ -5133,76 +6412,123 @@ values into a #ClutterColor.
<return></return>
</function>
-<function name="clutter_actor_set_name">
+<function name="clutter_text_get_color">
<description>
-Sets the given name to @self. The name can be used to identify
-a #ClutterActor.
+Retrieves the text color as set by clutter_text_set_color().
+
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> Textual tag to apply to actor
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="ClutterInterval">
+<function name="clutter_main_level">
<description>
-The type of the values in the interval.
+Retrieves the depth of the Clutter mainloop.
-Since: 1.0
</description>
<parameters>
</parameters>
-<return></return>
+<return> The level of the mainloop.
+</return>
</function>
-<function name="clutter_actor_get_scale">
+<function name="clutter_script_get_objects">
<description>
-Retrieves an actors scale in floating point.
+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:
-Since: 0.2
+<informalexample><programlisting>
+GObject *my_label, *a_button, *main_timeline;
+
+clutter_script_get_objects (script,
+"my-label", &my_label,
+"a-button", &a_button,
+"main-timeline", &main_timeline,
+NULL);
+</programlisting></informalexample>
+
+Note: This function does not increment the reference count of the
+returned objects.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="scale_x">
-<parameter_description> (out): Location to store horizonal float scale factor, or %NULL.
+<parameter name="first_name">
+<parameter_description> the name of the first object to retrieve
</parameter_description>
</parameter>
-<parameter name="scale_y">
-<parameter_description> (out): Location to store vertical float scale factor, or %NULL.
+<parameter name="Varargs">
+<parameter_description> return location for a #GObject, then additional names, ending
+with %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the number of objects returned.
+
+</return>
</function>
-<function name="clutter_actor_destroy">
+<function name="clutter_animation_update">
<description>
-Destroys an actor. When an actor is destroyed, it will break any
-references it holds to other objects. If the actor is inside a
-container, the actor will be removed.
+Updates the @final value of the interval for @property_name
-When you destroy a container, its children will be destroyed as well.
+Since: 1.0
-Note: you cannot destroy the #ClutterStage returned by
-clutter_stage_get_default().
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
+</parameter_description>
+</parameter>
+<parameter name="final">
+<parameter_description> The final value of the property
+</parameter_description>
+</parameter>
+</parameters>
+<return> The animation itself.
+
+</return>
+</function>
+
+<function name="clutter_box_get_color">
+<description>
+Retrieves the background color of @box
+
+If the #ClutterBox:color-set property is set to %FALSE the
+returned #ClutterColor is undefined
+
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="box">
+<parameter_description> a #ClutterBox
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
</parameters>
@@ -5216,6 +6542,7 @@ This function is used to emit an event on the main stage.
You should rarely need to use this function, except for
synthetised events.
+Since: 0.4
</description>
<parameters>
@@ -5230,7 +6557,6 @@ synthetised events.
</parameters>
<return> the return value from the signal emission
-Since: 0.4
</return>
</function>
@@ -5266,10 +6592,77 @@ Since: 0.6
<return></return>
</function>
+<function name="clutter_flow_layout_get_row_spacing">
+<description>
+Retrieves the spacing between rows
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
+</parameter_description>
+</parameter>
+</parameters>
+<return> the spacing between rows of the #ClutterFlowLayout,
+in pixels
+
+</return>
+</function>
+
+<function name="clutter_actor_set_rotation">
+<description>
+Sets the rotation angle of @self around the given axis.
+
+The rotation center coordinates used depend on the value of @axis:
+<itemizedlist>
+<listitem><para>%CLUTTER_X_AXIS requires @y and @z</para></listitem>
+<listitem><para>%CLUTTER_Y_AXIS requires @x and @z</para></listitem>
+<listitem><para>%CLUTTER_Z_AXIS requires @x and @y</para></listitem>
+</itemizedlist>
+
+The rotation coordinates are relative to the anchor point of the
+actor, set using clutter_actor_set_anchor_point(). If no anchor
+point is set, the upper left corner is assumed as the origin.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_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></return>
+</function>
+
<function name="clutter_texture_get_sync_size">
<description>
Retrieves the value set with clutter_texture_get_sync_size()
+Since: 1.0
</description>
<parameters>
@@ -5281,7 +6674,6 @@ Retrieves the value set with clutter_texture_get_sync_size()
<return> %TRUE if the #ClutterTexture should have the same
preferred size of the underlying image data
-Since: 1.0
</return>
</function>
@@ -5291,6 +6683,7 @@ Retrieves a matrix of floating point values stored inside
the passed #GValue. @value must have been initialized with
%CLUTTER_TYPE_SHADER_MATRIX.
+Since: 0.8
</description>
<parameters>
@@ -5299,57 +6692,87 @@ the passed #GValue. @value must have been initialized with
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> (out): return location for the number of returned floating
+<parameter_description> return location for the number of returned floating
point values, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> (array length=length) (transfer none): the pointer to a matrix
+<return> the pointer to a matrix
of floating point values. The returned value is owned by the #GValue and
should never be modified or freed.
-Since: 0.8
</return>
</function>
+<function name="clutter_text_set_font_description">
+<description>
+Sets @font_desc as the font description for a #ClutterText
+
+The #PangoFontDescription is copied by the #ClutterText actor
+so you can safely call pango_font_description_free() on it after
+calling this function.
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="font_desc">
+<parameter_description> a #PangoFontDescription
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_get_pointer_grab">
<description>
Queries the current pointer grab of clutter.
+Since: 0.6
</description>
<parameters>
</parameters>
-<return> (transfer none): the actor currently holding the pointer grab, or NULL if there is no grab.
+<return> the actor currently holding the pointer grab, or NULL if there is no grab.
-Since: 0.6
</return>
</function>
-<function name="ClutterMedia">
+<function name="clutter_layout_manager_list_child_properties">
<description>
-The ::error signal is emitted each time an error occurred.
+Retrieves all the #GParamSpec<!-- -->s for the layout properties
+stored inside the #ClutterLayoutMeta sub-class used by @manager
-Since: 0.2
+Since: 1.2
</description>
<parameters>
-<parameter name="media">
-<parameter_description> the #ClutterMedia instance that received the signal
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> the #GError
+<parameter name="n_pspecs">
+<parameter_description> return location for the number of returned
+#GParamSpec<!-- -->s
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly-allocated, %NULL-terminated
+array of #GParamSpec<!-- -->s. Use g_free() to free the resources
+allocated for the array
+
+</return>
</function>
<function name="clutter_units_copy">
<description>
Copies @units
+Since: 1.0
</description>
<parameters>
@@ -5361,7 +6784,6 @@ Copies @units
<return> the newly created copy of a #ClutterUnits structure.
Use clutter_units_free() to free the allocated resources
-Since: 1.0
</return>
</function>
@@ -5369,9 +6791,10 @@ Since: 1.0
<description>
Sets up a suitable pixmap for the window, using the composite and damage
extensions if possible, and then calls
-clutter_x11_texture_pixmap_set_pixmap(). If you want a window in a texture,
-you probably want this function, or its older sister,
-clutter_glx_texture_pixmap_set_window().
+clutter_x11_texture_pixmap_set_pixmap().
+
+If you want to display a window in a #ClutterTexture, you probably want
+this function, or its older sister, clutter_glx_texture_pixmap_set_window()
Since: 0.8
@@ -5386,7 +6809,7 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="automatic">
-<parameter_description> TRUE is automatic window updates, FALSE for manual.
+<parameter_description> %TRUE for automatic window updates, %FALSE for manual.
</parameter_description>
</parameter>
</parameters>
@@ -5409,83 +6832,93 @@ Gets the integer value stored inside a #JsonNode
</return>
</function>
-<function name="clutter_stage_read_pixels">
+<function name="clutter_behaviour_ellipse_set_center">
<description>
-Makes a screenshot of the stage in RGBA 8bit data, returns a
-linear buffer with @width * 4 as rowstride.
-
-The alpha data contained in the returned buffer is driver-dependent,
-and not guaranteed to hold any sensible value.
+Sets the center of the elliptical path to the point represented by knot.
+Since: 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> x coordinate of the first pixel that is read from stage
+<parameter_description> x coordinace of centre
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> y coordinate of the first pixel that is read from stage
+<parameter_description> y coordinace of centre
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> Width dimention of pixels to be read, or -1 for the
-entire stage width
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_layout_manager_set_container">
+<description>
+If the #ClutterLayoutManager sub-class allows it, allow
+adding a weak reference of the @container using @manager
+from within the layout manager
+
+The layout manager should not increase the reference
+count of the @container
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> Height dimention of pixels to be read, or -1 for the
-entire stage height
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to newly allocated memory with the buffer
-or %NULL if the read failed. Use g_free() on the returned data
-to release the resources it has allocated.
-</return>
+<return></return>
</function>
-<function name="ClutterCairoTexture">
+<function name="clutter_box_layout_new">
<description>
-The height of the Cairo surface used by the #ClutterCairoTexture
-actor, in pixels.
+Creates a new #ClutterBoxLayout layout manager
-Since: 1.0
+Since: 1.2
</description>
<parameters>
</parameters>
-<return></return>
+<return> the newly created #ClutterBoxLayout
+
+</return>
</function>
-<function name="clutter_actor_get_scale_gravity">
+<function name="clutter_text_get_font_description">
<description>
-Retrieves the scale center as a compass direction. If the scale
-center was specified in pixels or units this will return
-%CLUTTER_GRAVITY_NONE.
+Retrieves the #PangoFontDescription used by @self
+Since: 1.2
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the scale gravity
+<return> a #PangoFontDescription. The returned value is owned
+by the #ClutterText actor and it should not be modified or freed
-Since: 1.0
</return>
</function>
<function name="clutter_x11_get_stage_window">
<description>
-Gets the stages X Window.
+Gets the stages X Window.
+Since: 0.4
</description>
<parameters>
@@ -5496,43 +6929,78 @@ Gets the stages X Window.
</parameters>
<return> An XID for the stage window.
-Since: 0.4
</return>
</function>
+<function name="clutter_cairo_texture_get_surface_size">
+<description>
+Retrieves the surface width and height for @self.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the surface width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the surface height, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_get_font_flags">
<description>
Gets the current font flags for rendering text. See
clutter_set_font_flags().
+Since: 1.0
</description>
<parameters>
</parameters>
<return> The font flags
-Since: 1.0
</return>
</function>
-<function name="clutter_cairo_texture_get_surface_size">
+<function name="clutter_box_set_color">
<description>
-Retrieves the surface width and height for @self.
+Sets (or unsets) the background color for @box
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterCairoTexture
+<parameter name="box">
+<parameter_description> a #ClutterBox
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> return location for the surface width, or %NULL
+<parameter name="color">
+<parameter_description> the background color, or %NULL to unset
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> return location for the surface height, or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_ungrab_pointer_for_device">
+<description>
+Removes an existing grab of the pointer events for device @id.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="id">
+<parameter_description> a device id
</parameter_description>
</parameter>
</parameters>
@@ -5561,6 +7029,28 @@ Since: 0.8
<return></return>
</function>
+<function name="json_object_get_member">
+<description>
+Retrieves the #JsonNode containing the value of @member_name inside
+a #JsonObject.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #JsonObject
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> the name of the JSON object member to access
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the node for the requested object
+member, or %NULL
+</return>
+</function>
+
<function name="json_array_add_null_element">
<description>
Conveniently adds a null element into @array
@@ -5579,23 +7069,20 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_animation_set_alpha">
+<function name="clutter_event_put">
<description>
-Sets @alpha as the #ClutterAlpha used by @animation.
-
-If @alpha is not %NULL, the #ClutterAnimation will take ownership
-of the #ClutterAlpha instance.
+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
+its ancestors. If the source is not set it will be generated by picking
+or use the actor that currently has keyboard focus
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
-</parameter_description>
-</parameter>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha, or %NULL to unset the current #ClutterAlpha
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
@@ -5606,6 +7093,7 @@ Since: 1.0
<description>
Creates a #GParamSpec for properties using #CoglFixed values
+Since: 0.8
</description>
<parameters>
@@ -5640,7 +7128,6 @@ Creates a #GParamSpec for properties using #CoglFixed values
</parameters>
<return> the newly created #GParamSpec
-Since: 0.8
</return>
</function>
@@ -5651,6 +7138,7 @@ Compares two #ClutterColor<!-- -->s and checks if they are the same.
This function can be passed to g_hash_table_new() as the @key_equal_func
parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
+Since: 0.2
</description>
<parameters>
@@ -5665,14 +7153,40 @@ parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
</parameters>
<return> %TRUE if the two colors are the same.
-Since: 0.2
</return>
</function>
+<function name="clutter_shader_set_uniform">
+<description>
+Sets a user configurable variable in the GLSL shader programs attached to
+a #ClutterShader.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> name of uniform in GLSL shader program to set.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #ClutterShaderFloat, #ClutterShaderInt or #ClutterShaderMatrix
+#GValue.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_get_axis">
<description>
Retrieves the #ClutterRotateAxis used by the rotate behaviour.
+Since: 0.4
</description>
<parameters>
@@ -5683,37 +7197,38 @@ Retrieves the #ClutterRotateAxis used by the rotate behaviour.
</parameters>
<return> the rotation axis
-Since: 0.4
</return>
</function>
-<function name="clutter_glx_texture_pixmap_new">
+<function name="clutter_actor_get_request_mode">
<description>
+Retrieves the geometry request mode of @self
+
+Since: 1.2
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return> A new #ClutterGLXTexturePixmap
+<return> the request mode for the actor
-Since: 0.8
</return>
</function>
-<function name="clutter_animation_get_alpha">
+<function name="clutter_glx_texture_pixmap_new">
<description>
-Retrieves the #ClutterAlpha used by @animation.
+Creates a new, empty #ClutterGLXTexturePixmap
+Since: 0.8
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
-</parameter_description>
-</parameter>
</parameters>
-<return> (transfer none): the alpha object used by the animation
+<return> A new #ClutterGLXTexturePixmap
-Since: 1.0
</return>
</function>
@@ -5738,6 +7253,7 @@ and of the given @color.
<description>
Target the #ClutterStage to use an existing external window handle.
+Since: 0.8
</description>
<parameters>
@@ -5752,7 +7268,6 @@ Target the #ClutterStage to use an existing external window handle.
</parameters>
<return> %TRUE if foreign window is valid
-Since: 0.8
</return>
</function>
@@ -5784,6 +7299,62 @@ Since: 0.4
<return></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.
+
+This function will not register @func as a global alpha function.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> A #ClutterAlphaFunc
+</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_actor_box_get_size">
+<description>
+Retrieves the size of @box
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the height, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_path_new_with_knots">
<description>
Creates a new path behaviour that will make the actors visit all of
@@ -5793,6 +7364,7 @@ A path will be created where the first knot is used in a
%CLUTTER_PATH_MOVE_TO and the subsequent knots are used in
%CLUTTER_PATH_LINE_TO<!-- -->s.
+Since: 1.0
</description>
<parameters>
@@ -5811,7 +7383,6 @@ A path will be created where the first knot is used in a
</parameters>
<return> a #ClutterBehaviour
-Since: 1.0
</return>
</function>
@@ -5850,6 +7421,42 @@ Sets @objects inside @node. The reference count of @object is increased.
<return></return>
</function>
+<function name="clutter_actor_get_clip">
+<description>
+Gets the clip area for @self, if any is set
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="xoff">
+<parameter_description> return location for the X offset of
+the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="yoff">
+<parameter_description> return location for the Y offset of
+the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> return location for the width of
+the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> return location for the height of
+the clip rectangle, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_new">
<description>
Creates a new #ClutterBehaviourRotate. This behaviour will rotate actors
@@ -5858,6 +7465,7 @@ bound to it on @axis, following @direction, between @angle_start and
<0, 360), if angle_start == angle_end, the behaviour will carry out a
single rotation of 360 degrees.
+Since: 0.4
</description>
<parameters>
@@ -5884,48 +7492,52 @@ single rotation of 360 degrees.
</parameters>
<return> the newly created #ClutterBehaviourRotate.
-Since: 0.4
</return>
</function>
-<function name="clutter_x11_add_filter">
+<function name="clutter_actor_set_parent">
<description>
-Adds an event filter function.
+Sets the parent of @self to @parent. The opposite function is
+clutter_actor_unparent().
-Since: 0.6
+This function should not be used by applications, but by custom
+container actor subclasses.
</description>
<parameters>
-<parameter name="func">
-<parameter_description> a filter function
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> user data to be passed to the filter function, or %NULL
+<parameter name="parent">
+<parameter_description> A new #ClutterActor parent
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_node_is_null">
+<function name="clutter_text_set_cursor_color">
<description>
-Checks whether @node is a %JSON_NODE_NULL
+Sets the color of the cursor of a #ClutterText actor.
-<note>A null node is not the same as a %NULL #JsonNode</note>
+If @color is %NULL, the cursor color will be the same as the
+text color.
+Since: 1.0
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> the color of the cursor, or %NULL to unset it
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the node is null
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_texture_set_load_data_async">
@@ -5955,10 +7567,44 @@ from a filename
<return></return>
</function>
+<function name="clutter_layout_manager_child_set_property">
+<description>
+Sets a property on the #ClutterLayoutMeta created by @manager and
+attached to a child of @container
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @container
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the name of the property to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue with the value of the property to set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_win32_get_stage_window">
<description>
Gets the stage's window handle
+Since: 0.8
</description>
<parameters>
@@ -5969,36 +7615,37 @@ Gets the stage's window handle
</parameters>
<return> An HWND for the stage window.
-Since: 0.8
</return>
</function>
-<function name="clutter_behaviour_is_applied">
+<function name="clutter_actor_lower">
<description>
-Check if @behave applied to @actor.
+Puts @self below @above.
+Both actors must have the same parent, and the parent must implement
+the #ClutterContainer interface.
+
+This function is the equivalent of clutter_container_lower_child().
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="above">
+<parameter_description> A #ClutterActor to lower below
</parameter_description>
</parameter>
</parameters>
-<return> TRUE if actor has behaviour. FALSE otherwise.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_text_get_layout">
<description>
Retrieves the current #PangoLayout used by a #ClutterText actor.
+Since: 1.0
</description>
<parameters>
@@ -6007,10 +7654,9 @@ Retrieves the current #PangoLayout used by a #ClutterText actor.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #PangoLayout. The returned object is owned by
+<return> a #PangoLayout. The returned object is owned by
the #ClutterText actor and should not be modified or freed
-Since: 1.0
</return>
</function>
@@ -6082,60 +7728,57 @@ Retrieves the length of a #JsonArray
</return>
</function>
-<function name="clutter_text_get_selection_color">
+<function name="clutter_score_stop">
<description>
-Retrieves the color of the selection of a #ClutterText actor.
+Stops and rewinds a playing #ClutterScore instance.
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> return location for a #ClutterColor
+<parameter name="score">
+<parameter_description> A #ClutterScore
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_scale_get_bounds">
+<function name="clutter_text_get_selection_bound">
<description>
-Retrieves the bounds used by scale behaviour.
+Retrieves the other end of the selection of a #ClutterText actor,
+in characters from the current cursor position.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="scale">
-<parameter_description> a #ClutterBehaviourScale
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> return location for the initial scale factor on the X
-axis, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> return location for the initial scale factor on the Y
-axis, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="x_scale_end">
-<parameter_description> return location for the final scale factor on the X axis,
-or %NULL
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="y_scale_end">
-<parameter_description> return location for the final scale factor on the Y axis,
-or %NULL
+</parameters>
+<return> the position of the other end of the selection
+
+</return>
+</function>
+
+<function name="clutter_x11_get_stage_from_window">
+<description>
+Gets the stage for a particular X window.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="win">
+<parameter_description> an X Window ID
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The stage or NULL if a stage does not exist for the window.
+
+</return>
</function>
<function name="clutter_timeline_get_elapsed_time">
@@ -6159,6 +7802,7 @@ Request the current time position of the timeline.
Retrieves the default font name as set by
clutter_backend_set_font_name().
+Since: 1.0
</description>
<parameters>
@@ -6170,36 +7814,36 @@ clutter_backend_set_font_name().
<return> the font name for the backend. The returned string is
owned by the #ClutterBackend and should never be modified or freed
-Since: 1.0
</return>
</function>
-<function name="clutter_keysym_to_unicode">
+<function name="clutter_x11_trap_x_errors">
<description>
-Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode)
-character.
+Traps every X error until clutter_x11_untrap_x_errors() is called.
+Since: 0.6
</description>
<parameters>
-<parameter name="keyval">
-<parameter_description> a key symbol
-</parameter_description>
-</parameter>
</parameters>
-<return> a Unicode character, or 0 if there is no corresponding
-character.
-</return>
+<return></return>
</function>
-<function name="clutter_x11_trap_x_errors">
+<function name="json_generator_set_root">
<description>
-Traps every X error until clutter_x11_untrap_x_errors() is called.
-
-Since: 0.6
+Sets @node as the root of the JSON data stream to be serialized by
+the #JsonGenerator.
</description>
<parameters>
+<parameter name="generator">
+<parameter_description> a #JsonGenerator
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -6208,6 +7852,7 @@ Since: 0.6
<description>
Retrieves the coordinates of the given @position.
+Since: 1.0
</description>
<parameters>
@@ -6234,27 +7879,25 @@ Retrieves the coordinates of the given @position.
</parameters>
<return> %TRUE if the conversion was successful
-Since: 1.0
</return>
</function>
-<function name="clutter_container_get_children">
+<function name="clutter_text_get_line_alignment">
<description>
-Retrieves all the children of @container.
+Retrieves the alignment of a #ClutterText, as set by
+clutter_text_set_line_alignment().
+Since: 1.0
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> (element-type Actor) (transfer container): a list
-of #ClutterActor<!-- -->s. Use g_list_free() on the returned
-list when done.
+<return> a #PangoAlignment
-Since: 0.4
</return>
</function>
@@ -6270,6 +7913,7 @@ for language bindings.
<warning>Unlike clutter_actor_animate(), this function will not
allow you to specify "signal::" names and callbacks.</warning>
+Since: 1.0
</description>
<parameters>
@@ -6290,21 +7934,60 @@ allow you to specify "signal::" names and callbacks.</warning>
</parameter_description>
</parameter>
<parameter name="properties">
-<parameter_description> (array length=n_properties) (element-type utf8): a vector
+<parameter_description> a vector
containing the property names to set
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> (array length=n_properies): a vector containing the
+<parameter_description> a vector containing the
property values to set
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is
+<return> a #ClutterAnimation object. The object is
owned by the #ClutterActor and should not be unreferenced with
g_object_unref()
-Since: 1.0
+</return>
+</function>
+
+<function name="clutter_behaviour_rotate_set_direction">
+<description>
+Sets the rotation direction used by the rotate behaviour.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="direction">
+<parameter_description> the rotation direction
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_stage_get_title">
+<description>
+Gets the stage title.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> A #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> pointer to the title string for the stage. The
+returned string is owned by the actor and should not
+be modified or freed.
+
</return>
</function>
@@ -6328,35 +8011,44 @@ Checks whether @object has a member named @member_name.
</return>
</function>
-<function name="clutter_get_option_group">
+<function name="clutter_timeline_has_marker">
<description>
-Return value: (transfer full): a #GOptionGroup for the commandline arguments
+Checks whether @timeline has a marker set with the given name.
+
+Since: 0.8
</description>
<parameters>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="marker_name">
+<parameter_description> the name of the marker
+</parameter_description>
+</parameter>
</parameters>
-<return> (transfer full): a #GOptionGroup for the commandline arguments
-recognized by Clutter
+<return> %TRUE if the marker was found
-Since: 0.2
</return>
</function>
-<function name="clutter_input_device_get_device_type">
+<function name="clutter_texture_get_load_async">
<description>
-Retrieves the type of @device
+Retrieves the value set using clutter_texture_get_load_async()
+Since: 1.0
</description>
<parameters>
-<parameter name="device">
-<parameter_description> a #ClutterInputDevice
+<parameter name="texture">
+<parameter_description> a #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return> the type of the device
+<return> %TRUE if the #ClutterTexture should load the data from
+disk asynchronously
-Since: 1.0
</return>
</function>
@@ -6382,6 +8074,42 @@ Since: 0.8
<return></return>
</function>
+<function name="clutter_animator_get_keys">
+<description>
+Returns a list of pointers to opaque structures with accessor functions
+that describe the keys added to an animator.
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator instance
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject to search for, or %NULL for all objects
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> a specific property name to query for,
+or %NULL for all properties
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> a specific progress to search for, or a negative value for all
+progresses
+</parameter_description>
+</parameter>
+</parameters>
+<return> a
+list of #ClutterAnimatorKey<!-- -->s; the contents of the list are owned
+by the #ClutterAnimator, but you should free the returned list when done,
+using g_list_free()
+
+</return>
+</function>
+
<function name="clutter_color_to_hls">
<description>
Converts @color to the HLS format.
@@ -6440,58 +8168,100 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_x11_untrap_x_errors">
+<function name="clutter_interval_set_initial_value">
<description>
-Removes the X error trap and returns the current status.
+Sets the initial value of @interval to @value. The value is copied
+inside the #ClutterInterval.
+Since: 1.0
</description>
<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GValue
+</parameter_description>
+</parameter>
</parameters>
-<return> the trapped error code, or 0 for success
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_interval_peek_final_value">
+<function name="clutter_stage_set_minimum_size">
<description>
-Gets the pointer to the final value of @interval
+Sets the minimum size for a stage window, if the default backend
+uses #ClutterStage inside a window
+
+This is a convenience function, and it is equivalent to setting the
+#ClutterActor:min-width and #ClutterActor:min-height on @stage
+If the current size of @stage is smaller than the minimum size, the
+ stage will be resized to the new @width and @height
+
+This function has no effect if @stage is fullscreen
+
+Since: 1.2
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> width, in pixels
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> height, in pixels
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the final value of the interval.
-The value is owned by the #ClutterInterval and it should not be
-modified or freed
-
-Since: 1.0
-</return>
+<return></return>
</function>
-<function name="ClutterAnimation">
+<function name="clutter_layout_manager_layout_changed">
<description>
-The ::completed signal is emitted once the animation has
-been completed.
+Emits the #ClutterLayoutManager::layout-changed signal on @manager
+
+This function should only be called by implementations of the
+#ClutterLayoutManager class
-The @animation instance is guaranteed to be valid for the entire
-duration of the signal emission chain.
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_has_property">
+<description>
+Checks whether @animation is controlling @property_name.
Since: 1.0
</description>
<parameters>
<parameter name="animation">
-<parameter_description> the animation that emitted the signal
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the property is animated by the
+#ClutterAnimation, %FALSE otherwise
+
+</return>
</function>
<function name="clutter_model_remove">
@@ -6518,6 +8288,7 @@ Since: 0.6
<description>
Retrieves the playback progress of @media.
+Since: 1.0
</description>
<parameters>
@@ -6528,26 +8299,24 @@ Retrieves the playback progress of @media.
</parameters>
<return> the playback progress, between 0.0 and 1.0
-Since: 1.0
</return>
</function>
-<function name="clutter_stage_is_default">
+<function name="clutter_value_get_color">
<description>
-Checks if @stage is the default stage, or an instance created using
-clutter_stage_new() but internally using the same implementation.
+Gets the #ClutterColor contained in @value.
+Since: 0.8.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="value">
+<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the passed stage is the default one
+<return> the colors inside the passed #GValue
-Since: 0.8
</return>
</function>
@@ -6589,6 +8358,7 @@ direction.
Retrieves whether the #CoglPangoRenderer used by @fm will
use mipmapping when rendering the glyphs.
+Since: 1.0
</description>
<parameters>
@@ -6599,157 +8369,153 @@ use mipmapping when rendering the glyphs.
</parameters>
<return> %TRUE if mipmapping is used, %FALSE otherwise.
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_get_gid">
+<function name="clutter_flow_layout_set_row_height">
<description>
-Retrieves the unique id for @self.
+Sets the minimum and maximum heights that a row can have
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
+</parameter_description>
+</parameter>
+<parameter name="min_height">
+<parameter_description> the minimum height of a row
+</parameter_description>
+</parameter>
+<parameter name="max_height">
+<parameter_description> the maximum height of a row
</parameter_description>
</parameter>
</parameters>
-<return> Globally unique value for this object instance.
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_timeline_is_playing">
+<function name="clutter_actor_reparent">
<description>
-Queries state of a #ClutterTimeline.
+This function resets the parent actor of @self. It is
+logically equivalent to calling clutter_actor_unparent()
+and clutter_actor_set_parent(), but more efficiently
+implemented, ensures the child is not finalized
+when unparented, and emits the parent-set signal only
+one time.
+Since: 0.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="new_parent">
+<parameter_description> the new #ClutterActor parent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if timeline is currently playing
-</return>
+<return></return>
</function>
-<function name="clutter_actor_map">
+<function name="clutter_interval_new">
<description>
-Sets the #CLUTTER_ACTOR_MAPPED flag on the actor and possibly maps
-and realizes its children if they are visible. Does nothing if the
-actor is not visible.
+Creates a new #ClutterInterval holding values of type @gtype.
-Calling this is allowed in only one case: you are implementing the
-#ClutterActor::map virtual function in an actor and you need to map
-the children of that actor. It is not necessary to call this
-if you implement #ClutterContainer because the default implementation
-will automatically map children of containers.
+This function avoids using a #GValue for the initial and final values
+of the interval:
-When overriding map, it is mandatory to chain up to the parent
-implementation.
+|[
+interval = clutter_interval_new (G_TYPE_FLOAT, 0.0, 1.0);
+interval = clutter_interval_new (G_TYPE_BOOLEAN, FALSE, TRUE);
+interval = clutter_interval_new (G_TYPE_INT, 0, 360);
+]|
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="gtype">
+<parameter_description> the type of the values in the interval
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_stage_manager_list_stage">
-<description>
-Lists all currently used stages.
-
-
-</description>
-<parameters>
-<parameter name="stage_manager">
-<parameter_description> a #ClutterStageManager
+<parameter name="Varargs">
+<parameter_description> the initial value and the final value of the interval
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none) (element-type ClutterStage): a pointer
-to the internal list of #ClutterStage objects. The returned list
-is owned by the #ClutterStageManager and should never be modified
-or freed
+<return> the newly created #ClutterInterval
-Since: 1.0
</return>
</function>
-<function name="clutter_event_peek">
+<function name="clutter_media_set_filename">
<description>
-Return value: (transfer none): A #ClutterEvent or NULL if queue empty.
+Sets the source of @media using a file path.
+
+Since: 0.2
</description>
<parameters>
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> A filename
+</parameter_description>
+</parameter>
</parameters>
-<return> (transfer none): A #ClutterEvent or NULL if queue empty.
-
-Since: 0.4
-</return>
+<return></return>
</function>
-<function name="clutter_event_get_coords">
+<function name="clutter_get_actor_by_gid">
<description>
-Retrieves the coordinates of @event and puts them into @x and @y.
+Retrieves the #ClutterActor with @id.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> return location for the X coordinate
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> return location for the Y coordinate
+<parameter name="id">
+<parameter_description> a #ClutterActor ID.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the actor with the passed id or %NULL.
+The returned actor does not have its reference count increased.
+
+</return>
</function>
-<function name="clutter_behaviour_actors_foreach">
+<function name="clutter_shader_get_fragment_source">
<description>
-Calls @func for every actor driven by @behave.
+Query the current GLSL fragment source set on @shader.
-Since: 0.2
+Since: 0.6
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a function called for each actor
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> optional data to be passed to the function, or %NULL
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<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
+
+</return>
</function>
<function name="clutter_animation_get_loop">
<description>
Retrieves whether @animation is looping.
+Since: 1.0
</description>
<parameters>
@@ -6760,20 +8526,24 @@ Retrieves whether @animation is looping.
</parameters>
<return> %TRUE if the animation is looping
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_lower_bottom">
+<function name="clutter_media_set_progress">
<description>
-Lowers @self to the bottom.
+Sets the playback progress of @media. The @progress is
+a normalized value between 0.0 (begin) and 1.0 (end).
-This function calls clutter_actor_lower() internally.
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> the progress of the playback, between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
@@ -6785,6 +8555,7 @@ This function calls clutter_actor_lower() internally.
Creates a new #ClutterScore. A #ClutterScore is an object that can
hold multiple #ClutterTimeline<!-- -->s in a sequential order.
+Since: 0.6
</description>
<parameters>
@@ -6792,117 +8563,6 @@ hold multiple #ClutterTimeline<!-- -->s in a sequential order.
<return> the newly created #ClutterScore. Use g_object_unref()
when done.
-Since: 0.6
-</return>
-</function>
-
-<function name="clutter_threads_add_idle_full">
-<description>
-Adds a function to be called whenever there are no higher priority
-events pending. If the function returns %FALSE it is automatically
-removed from the list of event sources and will not be called again.
-
-This function can be considered a thread-safe variant of g_idle_add_full():
-it will call @function while holding the Clutter lock. It is logically
-equivalent to the following implementation:
-
-|[
-static gboolean
-idle_safe_callback (gpointer data)
-{
-SafeClosure *closure = data;
-gboolean res = FALSE;
-
-/* mark the critical section */
-
-clutter_threads_enter();
-
-/* the callback does not need to acquire the Clutter
-* lock itself, as it is held by the this proxy handler
-*/
-res = closure->callback (closure->data);
-
-clutter_threads_leave();
-
-return res;
-}
-static gulong
-add_safe_idle (GSourceFunc callback,
-gpointer data)
-{
-SafeClosure *closure = g_new0 (SafeClosure, 1);
-
-closure->callback = callback;
-closure->data = data;
-
-return g_add_idle_full (G_PRIORITY_DEFAULT_IDLE,
-idle_safe_callback,
-closure,
-g_free)
-}
-]|
-
-This function should be used by threaded applications to make sure
-that @func is emitted under the Clutter threads lock and invoked
-from the same thread that started the Clutter main loop. For instance,
-it can be used to update the UI using the results from a worker
-thread:
-
-|[
-static gboolean
-update_ui (gpointer data)
-{
-SomeClosure *closure = data;
-
-/* it is safe to call Clutter API from this function because
-* it is invoked from the same thread that started the main
-* loop and under the Clutter thread lock
-*/
-clutter_label_set_text (CLUTTER_LABEL (closure->label),
-closure->text);
-
-g_object_unref (closure->label);
-g_free (closure);
-
-return FALSE;
-}
-
-/* within another thread */
-closure = g_new0 (SomeClosure, 1);
-/* always take a reference on GObject instances */
-closure->label = g_object_ref (my_application->label);
-closure->text = g_strdup (processed_text_to_update_the_label);
-
-clutter_threads_add_idle_full (G_PRIORITY_HIGH_IDLE,
-update_ui,
-closure,
-NULL);
-]|
-
-
-</description>
-<parameters>
-<parameter name="priority">
-<parameter_description> the priority of the timeout source. Typically this will be in the
-range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
-</parameter_description>
-</parameter>
-<parameter name="notify">
-<parameter_description> functio to call when the idle source is removed
-</parameter_description>
-</parameter>
-</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.4
</return>
</function>
@@ -6927,6 +8587,7 @@ increased by one.
<description>
Retrieves the actor wrapped by @data
+Since: 0.8
</description>
<parameters>
@@ -6935,9 +8596,8 @@ Retrieves the actor wrapped by @data
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterActor
+<return> a #ClutterActor
-Since: 0.8
</return>
</function>
@@ -6953,29 +8613,62 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_text_set_color">
+<function name="clutter_interval_validate">
<description>
-Sets the color of the contents of a #ClutterText actor.
-
-The overall opacity of the #ClutterText actor will be the
-result of the alpha value of @color and the composited
-opacity of the actor itself on the scenegraph, as returned
-by clutter_actor_get_paint_opacity().
+Validates the initial and final values of @interval against
+a #GParamSpec.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> a #ClutterColor
+<parameter name="pspec">
+<parameter_description> a #GParamSpec
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the #ClutterInterval is valid, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="json_parser_new">
+<description>
+Creates a new #JsonParser instance. You can use the #JsonParser to
+load a JSON stream from either a file or a buffer and then walk the
+hierarchy using the data types API.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #JsonParser. Use g_object_unref()
+to release all the memory it allocates.
+</return>
+</function>
+
+<function name="clutter_interval_peek_initial_value">
+<description>
+Gets the pointer to the initial value of @interval
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return> the initial value of the interval.
+The value is owned by the #ClutterInterval and it should not be
+modified or freed
+
+</return>
</function>
<function name="clutter_container_child_get">
@@ -7011,51 +8704,91 @@ pairs terminated with NULL.
<return></return>
</function>
-<function name="ClutterStage">
+<function name="clutter_behaviour_opacity_get_bounds">
<description>
-The ::activate signal is emitted when the stage loses key focus
-from the underlying window system.
+Gets the initial and final levels of the opacity applied by @behaviour
+on each actor it controls.
Since: 0.6
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> the stage which was deactivated
+<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></return>
</function>
-<function name="SECTION">
+<function name="clutter_behaviour_rotate_set_axis">
<description>
-#ClutterAnimatable is an interface that allows a #GObject class
-to control how a #ClutterAnimation will animate a property.
+Sets the axis used by the rotate behaviour.
-Each #ClutterAnimatable should implement the animate_property()
-virtual function of the interface to compute the animation state
-between two values of an interval depending on a progress factor,
-expressed as a floating point value.
+Since: 0.4
-If a #ClutterAnimatable is animated by a #ClutterAnimation
-instance, the #ClutterAnimation will call
-clutter_animatable_animate_property() passing the name of the
-currently animated property; the initial and final values of
-the animation interval; the progress factor. The #ClutterAnimatable
-implementation should return the computed value for the animated
-property.
+</description>
+<parameters>
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
+</parameter_description>
+</parameter>
+<parameter name="axis">
+<parameter_description> a #ClutterRotateAxis
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animator_set_key">
+<description>
+Sets a single key in the #ClutterAnimator for the @property_name of
+ object at @progress.
-#ClutterAnimatable is available since Clutter 1.0
+See also: clutter_animator_set()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="short_description">
-<parameter_description> Interface for animatable classes
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the property to specify a key for
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> the id of the alpha function to use
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> the normalized range at which stage of the animation this
+value applies
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value property_name should have at progress.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The animator instance
+
+</return>
</function>
<function name="json_object_foreach_member">
@@ -7091,6 +8824,7 @@ Since: 0.8
<description>
Retrieves the keycode of the key that caused @event
+Since: 1.0
</description>
<parameters>
@@ -7102,14 +8836,34 @@ of type %CLUTTER_KEY_RELEASE
</parameters>
<return> The keycode representing the key
-Since: 1.0
</return>
</function>
+<function name="clutter_actor_unparent">
+<description>
+Removes the parent of @self.
+
+This function should not be used in applications. It should be called by
+implementations of container actors, to dissociate a child from the
+container.
+
+Since: 0.1.1
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_rectangle_get_border_width">
<description>
Gets the width (in pixels) of the border used by @rectangle
+Since: 0.2
</description>
<parameters>
@@ -7120,128 +8874,140 @@ Gets the width (in pixels) of the border used by @rectangle
</parameters>
<return> the border's width
-Since: 0.2
</return>
</function>
-<function name="clutter_actor_lower">
+<function name="clutter_text_activate">
<description>
-Puts @self below @above.
+Emits the #ClutterText::activate signal, if @self has been set
+as activatable using clutter_text_set_activatable().
-Both actors must have the same parent.
+This function can be used to emit the ::activate signal inside
+a #ClutterActor::captured-event or #ClutterActor::key-press-event
+signal handlers before the default signal handler for the
+#ClutterText is invoked.
-This function is the equivalent of clutter_container_lower_child().
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="above">
-<parameter_description> (allow-none): A #ClutterActor to lower below
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the ::activate signal has been emitted,
+and %FALSE otherwise
+
+</return>
</function>
-<function name="clutter_actor_get_anchor_point">
+<function name="clutter_rectangle_get_border_color">
<description>
-Gets the current anchor point of the @actor in pixels.
+Gets the color of the border used by @rectangle and places
+it into @color.
-Since: 0.6
+Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="anchor_x">
-<parameter_description> (out): return location for the X coordinate of the anchor point
+<parameter name="rectangle">
+<parameter_description> a #ClutterRectangle
</parameter_description>
</parameter>
-<parameter name="anchor_y">
-<parameter_description> (out): return location for the Y coordinate of the anchor point
+<parameter name="color">
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_get_z_rotation_gravity">
+<function name="json_node_get_string">
<description>
-Retrieves the center for the rotation around the Z axis as a
-compass direction. If the center was specified in pixels or units
-this will return %CLUTTER_GRAVITY_NONE.
+Gets the string value stored inside a #JsonNode
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
</parameter_description>
</parameter>
</parameters>
-<return> the Z rotation center
-
-Since: 1.0
+<return> a string value.
</return>
</function>
-<function name="clutter_behaviour_rotate_set_direction">
+<function name="clutter_actor_set_scale_full">
<description>
-Sets the rotation direction used by the rotate behaviour.
+Scales an actor with the given factors around the given center
+point. The center point is specified in pixels relative to the
+anchor point (usually the top left corner of the actor).
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="direction">
-<parameter_description> the rotation direction
+<parameter name="scale_x">
+<parameter_description> double factor to scale actor by horizontally.
+</parameter_description>
+</parameter>
+<parameter name="scale_y">
+<parameter_description> double factor to scale actor by vertically.
+</parameter_description>
+</parameter>
+<parameter name="center_x">
+<parameter_description> X coordinate of the center of the scale.
+</parameter_description>
+</parameter>
+<parameter name="center_y">
+<parameter_description> Y coordinate of the center of the scale
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_node_get_string">
+<function name="clutter_color_copy">
<description>
-Gets the string value stored inside a #JsonNode
+Makes a copy of the color structure. The result must be
+freed using clutter_color_free().
+Since: 0.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="color">
+<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
</parameters>
-<return> a string value.
+<return> an allocated copy of @color.
+
</return>
</function>
-<function name="clutter_color_copy">
+<function name="clutter_box_new">
<description>
-Makes a copy of the color structure. The result must be
-freed using clutter_color_free().
+Creates a new #ClutterBox. The children of the box will be layed
+out by the passed @manager
+Since: 1.0
</description>
<parameters>
-<parameter name="color">
-<parameter_description> a #ClutterColor
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
</parameters>
-<return> an allocated copy of @color.
+<return> the newly created #ClutterBox actor
-Since: 0.2
</return>
</function>
@@ -7279,68 +9045,135 @@ Since: 0.8
<return></return>
</function>
-<function name="json_generator_set_root">
+<function name="clutter_threads_add_idle_full">
<description>
-Sets @node as the root of the JSON data stream to be serialized by
-the #JsonGenerator.
+Adds a function to be called whenever there are no higher priority
+events pending. If the function returns %FALSE it is automatically
+removed from the list of event sources and will not be called again.
-</description>
-<parameters>
-<parameter name="generator">
-<parameter_description> a #JsonGenerator
-</parameter_description>
-</parameter>
-<parameter name="node">
-<parameter_description> a #JsonNode
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+This function can be considered a thread-safe variant of g_idle_add_full():
+it will call @function while holding the Clutter lock. It is logically
+equivalent to the following implementation:
-<function name="clutter_path_get_node">
-<description>
-Retrieves the node of the path indexed by @index.
+|[
+static gboolean
+idle_safe_callback (gpointer data)
+{
+SafeClosure *closure = data;
+gboolean res = FALSE;
-Since: 1.0
+/ * mark the critical section * /
+
+clutter_threads_enter();
+
+/ * the callback does not need to acquire the Clutter
+* lock itself, as it is held by the this proxy handler
+* /
+res = closure->callback (closure->data);
+
+clutter_threads_leave();
+
+return res;
+}
+static gulong
+add_safe_idle (GSourceFunc callback,
+gpointer data)
+{
+SafeClosure *closure = g_new0 (SafeClosure, 1);
+
+closure->callback = callback;
+closure->data = data;
+
+return g_add_idle_full (G_PRIORITY_DEFAULT_IDLE,
+idle_safe_callback,
+closure,
+g_free)
+}
+]|
+
+This function should be used by threaded applications to make sure
+that @func is emitted under the Clutter threads lock and invoked
+from the same thread that started the Clutter main loop. For instance,
+it can be used to update the UI using the results from a worker
+thread:
+
+|[
+static gboolean
+update_ui (gpointer data)
+{
+SomeClosure *closure = data;
+
+/ * it is safe to call Clutter API from this function because
+* it is invoked from the same thread that started the main
+* loop and under the Clutter thread lock
+* /
+clutter_label_set_text (CLUTTER_LABEL (closure->label),
+closure->text);
+
+g_object_unref (closure->label);
+g_free (closure);
+
+return FALSE;
+}
+
+/ * within another thread * /
+closure = g_new0 (SomeClosure, 1);
+/ * always take a reference on GObject instances * /
+closure->label = g_object_ref (my_application->label);
+closure->text = g_strdup (processed_text_to_update_the_label);
+
+clutter_threads_add_idle_full (G_PRIORITY_HIGH_IDLE,
+update_ui,
+closure,
+NULL);
+]|
+
+Since: 0.4
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
+<parameter name="priority">
+<parameter_description> the priority of the timeout source. Typically this will be in the
+range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the node number to retrieve
+<parameter name="func">
+<parameter_description> function to call
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> a location to store a copy of the node
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> functio to call when the idle source is removed
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ID (greater than 0) of the event source.
+
+</return>
</function>
-<function name="_clutter_process_event">
+<function name="cogl_pango_font_map_new">
<description>
-Does the actual work of processing an event that was queued earlier
-out of clutter_do_event().
+Creates a new font map.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the newly created #PangoFontMap
+
+</return>
</function>
<function name="clutter_animation_get_duration">
<description>
Retrieves the duration of @animation, in milliseconds.
+Since: 1.0
</description>
<parameters>
@@ -7351,49 +9184,31 @@ Retrieves the duration of @animation, in milliseconds.
</parameters>
<return> the duration of the animation
-Since: 1.0
</return>
</function>
-<function name="clutter_event_put">
+<function name="json_array_new">
<description>
-Puts a copy of the event on the back of the event queue. The event will
-have the %CLUTTER_EVENT_FLAG_SYNTHETIC flag set. If the source is set
-event signals will be emitted for this source and capture/bubbling for
-its ancestors. If the source is not set it will be generated by picking
-or use the actor that currently has keyboard focus
+Creates a new #JsonArray.
-Since: 0.6
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the newly created #JsonArray
+</return>
</function>
-<function name="clutter_timeline_set_duration">
+<function name="clutter_egl_display">
<description>
-Sets the duration of the timeline, in milliseconds. The speed
-of the timeline depends on the ClutterTimeline:fps setting.
+Retrieves the <structname>EGLDisplay</structname> used by Clutter
-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>
+<return> the EGL display
+</return>
</function>
<function name="clutter_actor_transform_stage_point">
@@ -7414,6 +9229,7 @@ Note: This function is fairly computationally intensive.
Note: This function only works when the allocation is up-to-date,
i.e. inside of paint()
+Since: 0.6
</description>
<parameters>
@@ -7422,25 +9238,24 @@ i.e. inside of paint()
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> (in): x screen coordinate of the point to unproject
+<parameter_description> x screen coordinate of the point to unproject
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> (in): y screen coordinate of the point to unproject
+<parameter_description> y screen coordinate of the point to unproject
</parameter_description>
</parameter>
<parameter name="x_out">
-<parameter_description> (out): return location for the unprojected x coordinance
+<parameter_description> return location for the unprojected x coordinance
</parameter_description>
</parameter>
<parameter name="y_out">
-<parameter_description> (out): return location for the unprojected y coordinance
+<parameter_description> return location for the unprojected y coordinance
</parameter_description>
</parameter>
</parameters>
<return> %TRUE if conversion was successful.
-Since: 0.6
</return>
</function>
@@ -7449,6 +9264,7 @@ Since: 0.6
Checks whether an actor has a fixed position set (and will thus be
unaffected by any layout manager).
+Since: 0.8
</description>
<parameters>
@@ -7459,7 +9275,6 @@ unaffected by any layout manager).
</parameters>
<return> %TRUE if the fixed position is set on the actor
-Since: 0.8
</return>
</function>
@@ -7473,6 +9288,7 @@ about animations, see clutter_actor_animate().
If you need to update the interval instance use
clutter_animation_update_property() instead.
+Since: 1.0
</description>
<parameters>
@@ -7485,12 +9301,11 @@ clutter_animation_update_property() instead.
</parameter_description>
</parameter>
<parameter name="interval">
-<parameter_description> (transfer full): a #ClutterInterval
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The animation itself.
-Since: 1.0
+<return> The animation itself.
</return>
</function>
@@ -7498,6 +9313,7 @@ Since: 1.0
<description>
Retrieves the unit type of the value stored inside @units
+Since: 1.0
</description>
<parameters>
@@ -7508,18 +9324,27 @@ Retrieves the unit type of the value stored inside @units
</parameters>
<return> a unit type
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_remove_clip">
+<function name="clutter_box_layout_set_use_animations">
<description>
-Removes clip area from @self.
+Sets whether @layout should animate changes in the layout properties
+
+The duration of the animations is controlled by
+clutter_box_layout_set_easing_duration(); the easing mode to be used
+by the animations is controlled by clutter_box_layout_set_easing_mode()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="animate">
+<parameter_description> %TRUE if the @layout should use animations
</parameter_description>
</parameter>
</parameters>
@@ -7547,20 +9372,25 @@ Since: 0.4
<return></return>
</function>
-<function name="json_array_sized_new">
+<function name="clutter_stage_set_user_resizable">
<description>
-Creates a new #JsonArray with @n_elements slots already allocated.
+Sets if the stage is resizable by user interaction (e.g. via
+window manager controls)
+Since: 0.4
</description>
<parameters>
-<parameter name="n_elements">
-<parameter_description> number of slots to pre-allocate
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="resizable">
+<parameter_description> whether the stage should be user resizable.
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #JsonArray
-</return>
+<return></return>
</function>
<function name="clutter_model_get_first_iter">
@@ -7568,6 +9398,7 @@ Creates a new #JsonArray with @n_elements slots already allocated.
Retrieves a #ClutterModelIter representing the first non-filtered
row in @model.
+Since: 0.6
</description>
<parameters>
@@ -7576,43 +9407,89 @@ row in @model.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full): A new #ClutterModelIter.
+<return> A new #ClutterModelIter.
Call g_object_unref() when done using it
-Since: 0.6
</return>
</function>
-<function name="ClutterModel">
+<function name="clutter_group_get_nth_child">
<description>
-The ::filter-changed signal is emitted when a new filter has been applied
+Gets a groups child held at @index_ in stack.
-Since: 0.6
+Since: 0.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> the #ClutterModel on which the signal is emitted
+<parameter name="self">
+<parameter_description> A #ClutterGroup
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the position of the requested actor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A Clutter actor, or %NULL if
+ index_ is invalid.
+
+</return>
+</function>
+
+<function name="clutter_text_insert_unichar">
+<description>
+Inserts @wc at the current cursor position of a
+#ClutterText actor.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="wc">
+<parameter_description> a Unicode character
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_path_get_description">
+<function name="clutter_actor_remove_clip">
<description>
-Return value: a string description of the path. Free with g_free().
+Removes clip area from @self.
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> a string description of the path. Free with g_free().
+<return></return>
+</function>
+
+<function name="clutter_layout_manager_get_animation_progress">
+<description>
+Retrieves the progress of the animation, if one has been started by
+clutter_layout_manager_begin_animation()
+
+The returned value has the same semantics of the #ClutterAlpha:alpha
+value
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+</parameters>
+<return> the progress of the animation
-Since: 1.0
</return>
</function>
@@ -7670,7 +9547,39 @@ depends solely on the distance from the viewer. The cogl_set_fog()
function in COGL exposes more of the underlying implementation,
and allows changing the for progression function. It can be directly
used by disabling the #ClutterStage:use-fog property and connecting
-a signal handler to the #ClutterActor::paint signal on the @stage.
+a signal handler to the #ClutterActor::paint signal on the @stage,
+like:
+
+|[
+clutter_stage_set_use_fog (stage, FALSE);
+g_signal_connect (stage, "paint", G_CALLBACK (on_stage_paint), NULL);
+]|
+
+The paint signal handler will call cogl_set_fog() with the
+desired settings:
+
+|[
+static void
+on_stage_paint (ClutterActor *actor)
+{
+ClutterColor stage_color = { 0, };
+CoglColor fog_color = { 0, };
+
+/ * set the fog color to the stage background color * /
+clutter_stage_get_color (CLUTTER_STAGE (actor), &stage_color);
+cogl_color_set_from_4ub (&fog_color,
+stage_color.red,
+stage_color.green,
+stage_color.blue,
+stage_color.alpha);
+
+/ * enable fog * /
+cogl_set_fog (&fog_color,
+COGL_FOG_MODE_EXPONENTIAL, / * mode * /
+0.5, / * density * /
+5.0, 30.0); / * z_near and z_far * /
+}
+]|
Note: The fogging functions only work correctly when the visible actors use
unmultiplied alpha colors. By default Cogl will premultiply textures
@@ -7714,93 +9623,64 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_vertext_free">
+<function name="clutter_value_get_fixed">
<description>
-Frees a #ClutterVertex allocated using clutter_vertex_copy()
+Gets the fixed point value stored inside @value.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="vertex">
-<parameter_description> a #ClutterVertex
+<parameter name="value">
+<parameter_description> a #GValue initialized to %COGL_TYPE_FIXED
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_text_new">
-<description>
-Creates a new #ClutterText actor. This actor can be used to
-display and edit text.
-
-
-</description>
-<parameters>
-</parameters>
-<return> the newly created #ClutterText actor
+<return> the value inside the passed #GValue
-Since: 1.0
</return>
</function>
-<function name="clutter_texture_set_area_from_rgb_data">
+<function name="clutter_flow_layout_set_column_width">
<description>
-Updates a sub-region of the pixel data in a #ClutterTexture.
+Sets the minimum and maximum widths that a column can have
+Since: 1.2
</description>
<parameters>
-<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 an 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 name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
-<parameter name="rowstride">
-<parameter_description> Distance in bytes between row starts on source buffer.
+<parameter name="min_width">
+<parameter_description> minimum width of a column
</parameter_description>
</parameter>
-<parameter name="bpp">
-<parameter_description> bytes per pixel (Currently only 3 and 4 supported,
-depending on @has_alpha)
+<parameter name="max_width">
+<parameter_description> maximum width of a column
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> #ClutterTextureFlags
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_event_get_stage">
+<description>
+Retrieves the source #ClutterStage the event originated for, or
+%NULL if the event has no stage.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure.
+<return> a #ClutterStage
-Since: 0.6
</return>
</function>
@@ -7818,26 +9698,68 @@ JSON data stream starting from a data object model composed by
</return>
</function>
-<function name="clutter_stage_ensure_redraw">
+<function name="clutter_backend_set_font_options">
<description>
-Ensures that @stage is redrawn
+Sets the new font options for @backend. The #ClutterBackend will
+copy the #cairo_font_options_t.
-This function should not be called by applications: it is
-used when embedding a #ClutterStage into a toolkit with
-another windowing system, like GTK+.
+If @options is %NULL, the first following call to
+clutter_backend_get_font_options() will return the default font
+options for @backend.
-Since: 1.0
+This function is intended for actors creating a Pango layout
+using the PangoCairo API.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> a #ClutterStage
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
+</parameter_description>
+</parameter>
+<parameter name="options">
+<parameter_description> Cairo font options for the backend, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_layout_manager_begin_animation">
+<description>
+Begins an animation of @duration milliseconds, using the provided
+easing @mode
+
+The easing mode can be specified either as a #ClutterAnimationMode
+or as a logical id returned by clutter_alpha_register_func()
+
+The result of this function depends on the @manager implementation
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> the duration of the animation, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> the easing mode of the animation
+</parameter_description>
+</parameter>
+</parameters>
+<return> The #ClutterAlpha created by the
+layout manager; the returned instance is owned by the layout
+manager and should not be unreferenced
+
+</return>
+</function>
+
<function name="clutter_shader_set_is_enabled">
<description>
Enables a shader. This function will attempt to compile and link
@@ -7864,6 +9786,12 @@ Since: 0.6
<function name="clutter_glx_texture_pixmap_using_extension">
<description>
+Checks whether @texture is using the GLX_EXT_texture_from_pixmap
+extension; this extension can be optionally (though it is strongly
+encouraged) implemented as a zero-copy between a GLX pixmap and
+a GL texture.
+
+Since: 0.8
</description>
<parameters>
@@ -7872,36 +9800,10 @@ Since: 0.6
</parameter_description>
</parameter>
</parameters>
-<return> A boolean indicating if the texture is using the
-GLX_EXT_texture_from_pixmap OpenGL extension or falling back to
+<return> %TRUE if the texture is using the
+GLX_EXT_texture_from_pixmap OpenGL extension or falling back to the
slower software mechanism.
-Since: 0.8
-</return>
-</function>
-
-<function name="clutter_container_get_child_meta">
-<description>
-Retrieves the #ClutterChildMeta which contains the data about the
- container specific state for @actor.
-
-
-</description>
-<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> a #ClutterActor that is a child of @container.
-</parameter_description>
-</parameter>
-</parameters>
-<return> (transfer none): the #ClutterChildMeta for the @actor child
-of @container or %NULL if the specifiec actor does not exist or the
-container is not configured to provide #ClutterChildMeta<!-- -->s
-
-Since: 0.8
</return>
</function>
@@ -7909,6 +9811,7 @@ Since: 0.8
<description>
Retrieves the value set using clutter_texture_get_keep_aspect_ratio()
+Since: 1.0
</description>
<parameters>
@@ -7920,111 +9823,60 @@ Retrieves the value set using clutter_texture_get_keep_aspect_ratio()
<return> %TRUE if the #ClutterTexture should maintain the
aspect ratio of the underlying image
-Since: 1.0
</return>
</function>
-<function name="clutter_text_set_max_length">
+<function name="clutter_actor_destroy">
<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.
+Destroys an actor. When an actor is destroyed, it will break any
+references it holds to other objects. If the actor is inside a
+container, the actor will be removed.
-Since: 1.0
+When you destroy a container, its children will be destroyed as well.
+
+Note: you cannot destroy the #ClutterStage returned by
+clutter_stage_get_default().
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="max">
-<parameter_description> the maximum number of characters allowed in the text actor; 0
-to disable or -1 to set the length of the current string
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_alpha_set_func">
+<function name="clutter_actor_get_width">
<description>
-Sets the #ClutterAlphaFunc function used to compute
-the alpha value at each frame of the #ClutterTimeline
-bound to @alpha.
-
-This function will not register @func as a global alpha function.
-
-Since: 0.2
+Retrieves the width of a #ClutterActor.
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> A #ClutterAlphaFunc
-</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>
+If the actor has a valid allocation, this function will return the
+width of the allocated area given to the actor.
-<function name="clutter_actor_allocate_preferred_size">
-<description>
-Allocates the natural size of @self.
+If the actor does not have a valid allocation, this function will
+return the actor's natural width, that is the preferred width of
+the actor.
-This function is a utility call for #ClutterActor implementations
-that allocates the actor's preferred natural size. It can be used
-by fixed layout managers (like #ClutterGroup or so called
-'composite actors') inside the ClutterActor::allocate
-implementation to give each child exactly how much space it
-requires.
+If you care whether you get the preferred width or the width that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_box() to retrieve the
+allocated size or clutter_actor_get_preferred_width() to retrieve the
+preferred width.
-This function is not meant to be used by applications. It is also
-not meant to be used outside the implementation of the
-ClutterActor::allocate virtual function.
+If an actor has a fixed width, for instance a width that has been
+assigned using clutter_actor_set_width(), the width returned will
+be the same value.
-Since: 0.8
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags controlling the allocation
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_actor_get_width">
-<description>
-Retrieves the width of the @box
-
-
-</description>
-<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the width of the box
-
-Since: 1.0
+<return> the width of the actor, in pixels
</return>
</function>
@@ -8052,32 +9904,6 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_shader_set_uniform">
-<description>
-Sets a user configurable variable in the GLSL shader programs attached to
-a #ClutterShader.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> name of uniform in GLSL shader program to set.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #ClutterShaderFloat, #ClutterShaderInt or #ClutterShaderMatrix
-#GValue.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_units_free">
<description>
Frees the resources allocated by @units
@@ -8097,24 +9923,21 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_height">
+<function name="json_node_type_name">
<description>
-Sets the height of the elliptical path.
+Retrieves the user readable name of the data type contained by @node.
-Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> height of the ellipse
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a string containing the name of the type. The returned string
+is owned by the node and should never be modified or freed
+</return>
</function>
<function name="clutter_path_foreach">
@@ -8175,6 +9998,7 @@ Since: 0.4
Loads the definitions from @filename into @script and merges with
the currently loaded ones, if any.
+Since: 0.6
</description>
<parameters>
@@ -8195,7 +10019,6 @@ the currently loaded ones, if any.
accordingly. On success, the merge id for the UI definitions is
returned. You can use the merge id with clutter_script_unmerge().
-Since: 0.6
</return>
</function>
@@ -8229,177 +10052,160 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_behaviour_rotate_set_axis">
+<function name="clutter_x11_untrap_x_errors">
<description>
-Sets the axis used by the rotate behaviour.
+Removes the X error trap and returns the current status.
Since: 0.4
</description>
<parameters>
-<parameter name="rotate">
-<parameter_description> a #ClutterBehaviourRotate
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> a #ClutterRotateAxis
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the trapped error code, or 0 for success
+
+</return>
</function>
-<function name="clutter_clone_set_source">
+<function name="clutter_animator_set">
<description>
-Sets @source as the source actor to be cloned by @clone.
+Adds multiple keys to a #ClutterAnimator, specifying the value a given
+property should have at a given progress of the animation. The mode
+specified is the mode used when going to this key from the previous key of
+the @property_name
-Since: 1.0
+If a given (object, property, progress) tuple already exist the mode and
+value will be replaced with the new values.
+
+Since: 1.2
</description>
<parameters>
-<parameter name="clone">
-<parameter_description> a #ClutterClone
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
-<parameter name="source">
-<parameter_description> a #ClutterActor, or %NULL
+<parameter name="first_object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the property to specify a key for
+</parameter_description>
+</parameter>
+<parameter name="first_mode">
+<parameter_description> the id of the alpha function to use
+</parameter_description>
+</parameter>
+<parameter name="first_progress">
+<parameter_description> at which stage of the animation this value applies; the
+range is a normalized floating point value between 0 and 1
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> the value first_property_name should have for first_object
+at first_progress, followed by more (object, property_name, mode,
+progress, value) tuples, followed by %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_unset_flags">
+<function name="clutter_media_get_subtitle_font_name">
<description>
-Unsets @flags on @self
+Retrieves the font name currently used.
-This function will emit notifications for the changed properties
-
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> the flags to unset
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a string containing the font name. Use g_free()
+to free the returned string
+
+</return>
</function>
-<function name="clutter_actor_get_allocation_box">
+<function name="clutter_animator_remove_key">
<description>
-Gets the layout box an actor has been assigned. The allocation can
-only be assumed valid inside a paint() method; anywhere else, it
-may be out-of-date.
+Removes all keys matching the conditions specificed in the arguments.
-An allocation does not incorporate the actor's scale or anchor point;
-those transformations do not affect layout, only rendering.
-
-<note>Do not call any of the clutter_actor_get_allocation_*() family
-of functions inside the implementation of the get_preferred_width()
-or get_preferred_height() virtual functions.</note>
-
-Since: 0.8
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
-<parameter name="box">
-<parameter_description> (out): the function fills this in with the actor's allocation
+<parameter name="object">
+<parameter_description> a #GObject to search for, or %NULL for all
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> a specific property name to query for,
+or %NULL for all
+</parameter_description>
+</parameter>
+<parameter name="progress">
+<parameter_description> a specific progress to search for or a negative value
+for all
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_unrealize_not_hiding">
+<function name="clutter_units_from_em">
<description>
-Frees up any underlying graphics resources needed by the actor to
-be displayed.
-
-Unrealization means the actor is now independent of any specific
-rendering context (is not attached to a specific toplevel stage).
-
-Because mapped actors must be realized, actors may not be
-unrealized if they are mapped. You must hide the actor or one of
-its parents before attempting to unrealize.
-
-This function is separate from clutter_actor_unrealize() because it
-does not automatically hide the actor.
-Actors need not be hidden to be unrealized, they just need to
-be unmapped. In fact we don't want to mess up the application's
-setting of the "visible" flag, so hiding is very undesirable.
+Stores a value in em inside @units, using the default font
+name as returned by clutter_backend_get_font_name()
-clutter_actor_unrealize() does a clutter_actor_hide() just for
-backward compatibility.
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="units">
+<parameter_description> a #ClutterUnits
+</parameter_description>
+</parameter>
+<parameter name="em">
+<parameter_description> em
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_threads_add_frame_source_full">
+<function name="clutter_x11_set_use_argb_visual">
<description>
-Sets a function to be called at regular intervals holding the Clutter
-threads lock, with the given priority. The function is called repeatedly
-until it returns %FALSE, at which point the timeout is automatically
-removed and the function will not be called again. The @notify function
-is called when the timeout is removed.
+Sets whether the Clutter X11 backend should request ARGB visuals by default
+or not.
-This function is similar to clutter_threads_add_timeout_full()
-except that it will try to compensate for delays. For example, if
- func takes half the interval time to execute then the function
-will be called again half the interval time after it finished. In
-contrast clutter_threads_add_timeout_full() would not fire until a
-full interval after the function completes so the delay between
-calls would be @interval * 1.5. This function does not however try
-to invoke the function multiple times to catch up missing frames if
- func takes more than @interval ms to execute.
+By default, Clutter requests RGB visuals.
-See also clutter_threads_add_idle_full().
+<note>If no ARGB visuals are found, the X11 backend will fall back to
+requesting a RGB visual instead.</note>
+
+ARGB visuals are required for the #ClutterStage:use-alpha property to work.
+
+<note>This function can only be called once, and before clutter_init() is
+called.</note>
+Since: 1.2
</description>
<parameters>
-<parameter name="priority">
-<parameter_description> the priority of the frame source. Typically this will be in the
-range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
-</parameter_description>
-</parameter>
-<parameter name="fps">
-<parameter_description> the number of times per second to call the function
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
-</parameter_description>
-</parameter>
-<parameter name="notify">
-<parameter_description> function to call when the timeout source is removed
+<parameter name="use_argb">
+<parameter_description> %TRUE if ARGB visuals should be requested by default
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_event_type">
@@ -8435,82 +10241,57 @@ increased by one.
</return>
</function>
-<function name="clutter_texture_set_from_file">
+<function name="clutter_shader_get_vertex_source">
<description>
-Sets the #ClutterTexture image data from an image file. In case of
-failure, %FALSE is returned and @error is set.
-
-If #ClutterTexture:load-async is set to %TRUE, this function
-will return as soon as possible, and the actual image loading
-from disk will be performed asynchronously. #ClutterTexture::size-change
-will be emitten when the size of the texture is available and
-#ClutterTexture::load-finished will be emitted when the image has been
-loaded or if an error occurred.
+Query the current GLSL vertex source set on @shader.
+Since: 0.6
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
-</parameter_description>
-</parameter>
-<parameter name="filename">
-<parameter_description> The filename of the image in GLib file name encoding
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for a #GError, or %NULL
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the image was successfully loaded and set
+<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.8
</return>
</function>
-<function name="clutter_interval_compute_value">
+<function name="clutter_text_get_editable">
<description>
-Computes the value between the @interval boundaries given the
-progress @factor and puts it into @value.
+Retrieves whether a #ClutterText is editable or not.
+Since: 1.0
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
-</parameter_description>
-</parameter>
-<parameter name="factor">
-<parameter_description> the progress factor, between 0 and 1
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> return location for an initialized #GValue
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation was successful
+<return> %TRUE if the actor is editable
-Since: 1.0
</return>
</function>
-<function name="clutter_text_get_editable">
+<function name="json_array_sized_new">
<description>
-Retrieves whether a #ClutterText is editable or not.
+Creates a new #JsonArray with @n_elements slots already allocated.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="n_elements">
+<parameter_description> number of slots to pre-allocate
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor is editable
-
-Since: 1.0
+<return> the newly created #JsonArray
</return>
</function>
@@ -8538,6 +10319,7 @@ or behavioural elements, like behaviours and timelines. The
definitions must be encoded using the JavaScript Object Notation (JSON)
language.
+Since: 0.6
</description>
<parameters>
@@ -8545,62 +10327,54 @@ language.
<return> the newly created #ClutterScript instance. Use
g_object_unref() when done.
-Since: 0.6
</return>
</function>
-<function name="clutter_text_get_color">
+<function name="clutter_behaviour_depth_get_bounds">
<description>
-Retrieves the text color as set by clutter_text_get_color().
+Gets the boundaries of the @behaviour
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="behaviour">
+<parameter_description> a #ClutterBehaviourDepth
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> return location for a #ClutterColor
+<parameter name="depth_start">
+<parameter_description> return location for the initial depth value, or %NULL
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_model_get_n_rows">
-<description>
-Retrieves the number of rows inside @model, eventually taking
-into account any filtering function set using clutter_model_set_filter().
-
-
-</description>
-<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="depth_end">
+<parameter_description> return location for the final depth value, or %NULL
</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>
+<return></return>
</function>
-<function name="ClutterText">
+<function name="clutter_stage_set_throttle_motion_events">
<description>
-The ::activate signal is emitted each time the actor is 'activated'
-by the user, normally by pressing the 'Enter' key. The signal is
-emitted only if #ClutterText:activatable is set to %TRUE.
+Sets whether motion events received between redraws should
+be throttled or not. If motion events are throttled, those
+events received by the windowing system between redraws will
+be compressed so that only the last event will be propagated
+to the @stage and its actors.
+
+This function should only be used if you want to have all
+the motion events delivered to your application code.
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> the #ClutterText that emitted the signal
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="throttle">
+<parameter_description> %TRUE to throttle motion events
</parameter_description>
</parameter>
</parameters>
@@ -8624,6 +10398,7 @@ clutter_binding_pool_find() with the class type name:
pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (instance));
]|
+Since: 1.0
</description>
<parameters>
@@ -8632,17 +10407,18 @@ pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (instance));
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the binding pool for the given class.
+<return> the binding pool for the given class.
The returned #ClutterBindingPool is owned by Clutter and should not
be freed directly
-Since: 1.0
</return>
</function>
<function name="clutter_container_class_list_child_properties">
<description>
-Return value: (array length=n_properties) (transfer container): an array
+Returns an array of #GParamSpec for all child properties.
+
+Since: 0.8
</description>
<parameters>
@@ -8655,47 +10431,112 @@ Return value: (array length=n_properties) (transfer container): an array
</parameter_description>
</parameter>
</parameters>
-<return> (array length=n_properties) (transfer container): an array
+<return> an array
of #GParamSpec<!-- -->s which should be freed after use.
-Since: 0.8
</return>
</function>
-<function name="clutter_media_get_uri">
+<function name="clutter_layout_manager_get_preferred_height">
<description>
-Retrieves the URI from @media.
+Computes the minimum and natural heights of the @container according
+to @manager.
+See also clutter_actor_get_preferred_height()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+<parameter name="container">
+<parameter_description> the #ClutterContainer using @manager
+</parameter_description>
+</parameter>
+<parameter name="for_width">
+<parameter_description> the width for which the height should be computed, or -1
+</parameter_description>
+</parameter>
+<parameter name="min_height_p">
+<parameter_description> return location for the minimum height
+of the layout, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="nat_height_p">
+<parameter_description> return location for the natural height
+of the layout, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the URI of the media stream. Use g_free()
-to free the returned string
+<return></return>
+</function>
+
+<function name="clutter_actor_box_get_width">
+<description>
+Retrieves the width of the @box
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the width of the box
-Since: 0.2
</return>
</function>
-<function name="clutter_actor_get_geometry">
+<function name="clutter_binding_pool_install_action">
<description>
-Gets the size and position of an actor relative to its parent
-actor. This is the same as calling clutter_actor_get_position() and
-clutter_actor_get_size(). It tries to "do what you mean" and get the
-requested size and position if the actor's allocation is invalid.
+Installs a new action inside a #ClutterBindingPool. The action
+is bound to @key_val and @modifiers.
+
+The same action name can be used for multiple @key_val, @modifiers
+pairs.
+
+When an action has been activated using clutter_binding_pool_activate()
+the passed @callback will be invoked (with @data).
+
+Actions can be blocked with clutter_binding_pool_block_action()
+and then unblocked using clutter_binding_pool_unblock_action().
+
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="pool">
+<parameter_description> a #ClutterBindingPool
</parameter_description>
</parameter>
-<parameter name="geometry">
-<parameter_description> (out): A location to store actors #ClutterGeometry
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="key_val">
+<parameter_description> key symbol
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description> bitmask of modifiers
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> function to be called when the action is activated
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to be passed to @callback
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to be called when the action is removed
+from the pool
</parameter_description>
</parameter>
</parameters>
@@ -8706,6 +10547,7 @@ requested size and position if the actor's allocation is invalid.
<description>
Retrieves a list of all the #ClutterTimelines managed by @score.
+Since: 0.6
</description>
<parameters>
@@ -8714,80 +10556,111 @@ Retrieves a list of all the #ClutterTimelines managed by @score.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer container) (element-type ClutterTimeline): a #GSList
+<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>
-<function name="clutter_animation_has_property">
+<function name="clutter_event_get_click_count">
<description>
-Checks whether @animation is controlling @property_name.
+Retrieves the number of clicks of @event
+Since: 1.0
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="event">
+<parameter_description> a #ClutterEvent of type %CLUTTER_BUTTON_PRESS or
+of type %CLUTTER_BUTTON_RELEASE
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> name of the property
+</parameters>
+<return> the click count
+
+</return>
+</function>
+
+<function name="clutter_layout_meta_get_manager">
+<description>
+Retrieves the actor wrapped by @data
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> a #ClutterLayoutMeta
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the property is animated by the
-#ClutterAnimation, %FALSE otherwise
+<return> a #ClutterLayoutManager
-Since: 1.0
</return>
</function>
-<function name="ClutterBehaviourPath">
+<function name="clutter_path_get_description">
<description>
-This signal is emitted each time a node defined inside the path
-is reached.
+Returns a newly allocated string describing the path in the same
+format as used by clutter_path_add_string().
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> the object which received the signal
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="knot_num">
-<parameter_description> the index of the #ClutterPathKnot reached
+</parameters>
+<return> a string description of the path. Free with g_free().
+
+</return>
+</function>
+
+<function name="clutter_actor_get_stage">
+<description>
+Retrieves the #ClutterStage where @actor is contained.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the stage containing the actor, or %NULL
+
+</return>
</function>
-<function name="clutter_container_sort_depth_order">
+<function name="clutter_flow_layout_get_homogeneous">
<description>
-Sorts a container's children using their depth. This function should not
-be normally used by applications.
+Retrieves whether the @layout is homogeneous
-Since: 0.6
+Since: 1.2
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the #ClutterFlowLayout is homogeneous
+
+</return>
</function>
<function name="clutter_param_spec_units">
<description>
Creates a #GParamSpec for properties using #ClutterUnits.
+Since: 1.0
</description>
<parameters>
@@ -8826,7 +10699,6 @@ Creates a #GParamSpec for properties using #ClutterUnits.
</parameters>
<return> the newly created #GParamSpec
-Since: 1.0
</return>
</function>
@@ -8834,61 +10706,34 @@ Since: 1.0
<description>
Queries the X11 backend to check if event collection has been disabled.
+Since: 0.8
</description>
<parameters>
</parameters>
<return> TRUE if event retrival has been disabled. FALSE otherwise.
-Since: 0.8
-</return>
-</function>
-
-<function name="clutter_texture_get_cogl_material">
-<description>
-Return value: COGL material handle
-
-</description>
-<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
-</parameter_description>
-</parameter>
-</parameters>
-<return> COGL material handle
</return>
</function>
-<function name="clutter_color_from_string">
+<function name="clutter_event_get_device">
<description>
-Parses a string definition of a color, filling the
-<structfield>red</structfield>, <structfield>green</structfield>,
-<structfield>blue</structfield> and <structfield>alpha</structfield>
-channels of @color. If alpha is not specified it will be set full opaque.
-
-The @color is not allocated.
+Retrieves the #ClutterInputDevice for the event.
-The color may be defined by any of the formats understood by
-pango_color_from_string(); these include literal color names, like
-<literal>Red</literal> or <literal>DarkSlateGray</literal>, or
-hexadecimal specifications like <literal>#3050b2</literal> or
-<literal>#333</literal>.
+The #ClutterInputDevice structure is completely opaque and should
+be cast to the platform-specific implementation.
+Since: 1.0
</description>
<parameters>
-<parameter name="color">
-<parameter_description> (out): return location for a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="str">
-<parameter_description> a string specifiying a color (named color or #RRGGBBAA)
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if parsing succeeded.
+<return> the #ClutterInputDevice or %NULL
-Since: 1.0
</return>
</function>
@@ -8919,13 +10764,13 @@ Clutter. This might be different from the timestamp returned
by clutter_get_current_event_time(), as Clutter may synthesize
or throttle events.
+Since: 1.0
</description>
<parameters>
</parameters>
<return> a timestamp, in milliseconds
-Since: 1.0
</return>
</function>
@@ -8933,6 +10778,7 @@ Since: 1.0
<description>
Retrieves the actor that is currently under key focus.
+Since: 0.6
</description>
<parameters>
@@ -8941,9 +10787,8 @@ Retrieves the actor that is currently under key focus.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the actor with key focus, or the stage
+<return> the actor with key focus, or the stage
-Since: 0.6
</return>
</function>
@@ -8984,6 +10829,7 @@ copy = clutter_text_get_chars (text, 0, -1);
Which will return a newly allocated string.
+Since: 1.0
</description>
<parameters>
@@ -8996,7 +10842,6 @@ Which will return a newly allocated string.
is owned by the #ClutterText actor and should never be
modified or freed
-Since: 1.0
</return>
</function>
@@ -9005,6 +10850,7 @@ Since: 1.0
Creates a new path behaviour using the path described by @desc. See
clutter_path_add_string() for a description of the format.
+Since: 1.0
</description>
<parameters>
@@ -9019,34 +10865,44 @@ clutter_path_add_string() for a description of the format.
</parameters>
<return> a #ClutterBehaviour
-Since: 1.0
</return>
</function>
-<function name="clutter_animation_set_mode">
+<function name="json_node_set_int">
<description>
-Sets the animation @mode of @animation. The animation @mode is
-a logical id, either coming from the #ClutterAnimationMode enumeration
-or the return value of clutter_alpha_register_func().
-
-This function will also set #ClutterAnimation:alpha if needed.
-
-Since: 1.0
+Sets @value as the integer content of the @node, replacing any existing
+content.
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> an animation mode logical id
+<parameter name="value">
+<parameter_description> an integer value
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="json_node_get_array">
+<description>
+Retrieves the #JsonArray stored inside a #JsonNode
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #JsonArray
+</return>
+</function>
+
<function name="clutter_model_set_types">
<description>
Sets the types of the columns inside a #ClutterModel.
@@ -9068,19 +10924,42 @@ Since: 0.6
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> (array length=n_columns): an array of #GType types
+<parameter_description> an array of #GType types
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_knot_equal">
+<description>
+Compares to knot and checks if the point to the same location.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="knot_a">
+<parameter_description> First knot
+</parameter_description>
+</parameter>
+<parameter name="knot_b">
+<parameter_description> Second knot
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the knots point to the same location.
+
+</return>
+</function>
+
<function name="clutter_shader_compile">
<description>
Compiles and links GLSL sources set for vertex and fragment shaders for
a #ClutterShader. If the compilation fails and a #GError return location is
provided the error will contain the errors from the compiler, if any.
+Since: 0.8
</description>
<parameters>
@@ -9095,7 +10974,6 @@ provided the error will contain the errors from the compiler, if any.
</parameters>
<return> returns TRUE if the shader was succesfully compiled.
-Since: 0.8
</return>
</function>
@@ -9125,217 +11003,116 @@ actually involved; the terminology is conventional).
<return></return>
</function>
-<function name="clutter_backend_set_font_name">
+<function name="clutter_layout_manager_allocate">
<description>
-Sets the default font to be used by Clutter. The @font_name string
-must either be %NULL, which means that the font name from the
-default #ClutterBackend will be used; or be something that can
-be parsed by the pango_font_description_from_string() function.
+Allocates the children of @container given an area
-Since: 1.0
+See also clutter_actor_allocate()
-</description>
-<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
-</parameter_description>
-</parameter>
-<parameter name="font_name">
-<parameter_description> the name of the font
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_container_raise_child">
-<description>
-Raises @actor to @sibling level, in the depth ordering.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="actor">
-<parameter_description> the actor to raise
-</parameter_description>
-</parameter>
-<parameter name="sibling">
-<parameter_description> the sibling to raise to, or %NULL to raise to the top
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_animation_set_loop">
-<description>
-Sets whether @animation should loop over itself once finished.
-
-A looping #ClutterAnimation will not emit the #ClutterAnimation::completed
-signal when finished.
-
-This function will set #ClutterAnimation:alpha and
-#ClutterAnimation:timeline if needed.
-
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-<parameter name="loop">
-<parameter_description> %TRUE if the animation should loop
+<parameter name="container">
+<parameter_description> the #ClutterContainer using @manager
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="json_node_take_array">
-<description>
-Sets @array into @node without increasing the #JsonArray reference count.
-
-</description>
-<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="allocation">
+<parameter_description> the #ClutterActorBox containing the allocated area
+of @container
</parameter_description>
</parameter>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="flags">
+<parameter_description> the allocation flags
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_interval_set_initial_value">
+<function name="clutter_actor_get_preferred_width">
<description>
-Sets the initial value of @interval to @value. The value is copied
-inside the #ClutterInterval.
-
-Since: 1.0
+Computes the requested minimum and natural widths for an actor,
+optionally depending on the specified height, or if they are
+already computed, returns the cached values.
-</description>
-<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #GValue
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+An actor may not get its request - depending on the layout
+manager that's in effect.
-<function name="clutter_scriptable_set_custom_property">
-<description>
-Overrides the common properties setting. The underlying virtual
-function should be used when implementing custom properties.
+A request should not incorporate the actor's scale or anchor point;
+those transformations do not affect layout, only rendering.
-Since: 0.6
+Since: 0.8
</description>
<parameters>
-<parameter name="scriptable">
-<parameter_description> a #ClutterScriptable
-</parameter_description>
-</parameter>
-<parameter name="script">
-<parameter_description> the #ClutterScript creating the scriptable instance
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the property
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value of the property
+<parameter name="for_height">
+<parameter_description> available height when computing the preferred width,
+or a negative value to indicate that no height is defined
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_alpha_set_closure">
-<description>
-Sets the #GClosure used to compute the alpha value at each
-frame of the #ClutterTimeline bound to @alpha.
-
-Since: 0.8
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
+<parameter name="min_width_p">
+<parameter_description> return location for minimum width,
+or %NULL
</parameter_description>
</parameter>
-<parameter name="closure">
-<parameter_description> A #GClosure
+<parameter name="natural_width_p">
+<parameter_description> return location for the natural
+width, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_color_hash">
+<function name="clutter_box_layout_get_easing_duration">
<description>
-Converts a #ClutterColor to a hash value.
-
-This function can be passed to g_hash_table_new() as the @hash_func
-parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
+Retrieves the duration set using clutter_box_layout_set_easing_duration()
+Since: 1.2
</description>
<parameters>
-<parameter name="v">
-<parameter_description> a #ClutterColor
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
</parameters>
-<return> a hash value corresponding to the color
+<return> the duration of the animations, in milliseconds
-Since: 1.0
</return>
</function>
-<function name="clutter_interval_new">
+<function name="clutter_script_get_type_from_name">
<description>
-Creates a new #ClutterInterval holding values of type @gtype.
-
-This function avoids using a #GValue for the initial and final values
-of the interval:
-
-|[
-interval = clutter_interval_new (G_TYPE_FLOAT, 0.0, 1.0);
-interval = clutter_interval_new (G_TYPE_BOOLEAN, FALSE, TRUE);
-interval = clutter_interval_new (G_TYPE_INT, 0, 360);
-]|
+Looks up a type by name, using the virtual function that
+#ClutterScript has for that purpose. This function should
+rarely be used.
+Since: 0.6
</description>
<parameters>
-<parameter name="gtype">
-<parameter_description> the type of the values in the interval
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the initial value and the final value of the interval
+<parameter name="type_name">
+<parameter_description> name of the type to look up
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterInterval
+<return> the type for the requested type name, or
+%G_TYPE_INVALID if not corresponding type was found.
-Since: 1.0
</return>
</function>
@@ -9350,38 +11127,65 @@ Gets the size in pixels of the untransformed underlying image
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> (out): return location for the width, or %NULL
+<parameter_description> return location for the width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> (out): return location for the height, or %NULL
+<parameter_description> return location for the height, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_text_set_selection_bound">
+<function name="clutter_frame_source_add_full">
<description>
-Sets the other end of the selection, starting from the current
-cursor position.
+Sets a function to be called at regular intervals with the given
+priority. The function is called repeatedly until it returns
+%FALSE, at which point the timeout is automatically destroyed and
+the function will not be called again. The @notify function is
+called when the timeout is destroyed. The first call to the
+function will be at the end of the first @interval.
-If @selection_bound is -1, the selection unset.
+This function is similar to g_timeout_add_full() except that it
+will try to compensate for delays. For example, if @func takes half
+the interval time to execute then the function will be called again
+half the interval time after it finished. In contrast
+g_timeout_add_full() would not fire until a full interval after the
+function completes so the delay between calls would be 1.0 / @fps *
+1.5. This function does not however try to invoke the function
+multiple times to catch up missing frames if @func takes more than
+ interval ms to execute.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="priority">
+<parameter_description> the priority of the frame source. Typically this will be in the
+range between %G_PRIORITY_DEFAULT and %G_PRIORITY_HIGH.
</parameter_description>
</parameter>
-<parameter name="selection_bound">
-<parameter_description> the position of the end of the selection, in characters
+<parameter name="fps">
+<parameter_description> the number of times per second to call the function
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to call when the timeout source is removed
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ID (greater than 0) of the event source.
+
+</return>
</function>
<function name="clutter_backend_get_resolution">
@@ -9389,6 +11193,7 @@ Since: 1.0
Gets the resolution for font handling on the screen; see
clutter_backend_set_resolution() for full details.
+Since: 0.4
</description>
<parameters>
@@ -9400,7 +11205,6 @@ clutter_backend_set_resolution() for full details.
<return> the current resolution, or -1 if no resolution
has been set.
-Since: 0.4
</return>
</function>
@@ -9423,60 +11227,52 @@ Appends @node inside @array. The array will take ownership of the
<return></return>
</function>
-<function name="clutter_units_em_for_font">
+<function name="clutter_script_lookup_filename">
<description>
-Stores a value in em inside @units using @font_name
+Looks up @filename inside the search paths of @script. If @filename
+is found, its full path will be returned .
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="units">
-<parameter_description> a #ClutterUnits
-</parameter_description>
-</parameter>
-<parameter name="font_name">
-<parameter_description> the font name and size
+<parameter name="script">
+<parameter_description> a #ClutterScript
</parameter_description>
</parameter>
-<parameter name="em">
-<parameter_description> em
+<parameter name="filename">
+<parameter_description> the name of the file to lookup
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the full path of @filename or %NULL if no path was
+found.
+
+</return>
</function>
-<function name="clutter_behaviour_get_nth_actor">
+<function name="clutter_container_foreach_with_internals">
<description>
-Gets an actor the behaviour was applied to referenced by index num.
+Calls @callback for each child of @container, including "internal"
+children built in to the container itself that were never added
+by the application.
+Since: 1.0
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of an actor this behaviour is applied too.
+<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> (transfer none): A Clutter actor or NULL if @index_ is invalid.
-
-Since: 0.2
-</return>
-</function>
-
-<function name="ClutterBehaviourRotate">
-<description>
-The z center of rotation.
-
-Since: 0.4
-
-</description>
-<parameters>
</parameters>
<return></return>
</function>
@@ -9502,130 +11298,91 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_text_set_line_alignment">
+<function name="clutter_container_add">
<description>
-Sets the way that the lines of a wrapped label are aligned with
-respect to each other. This does not affect the overall alignment
-of the label within its allocated or specified width.
-
-To align a #ClutterText actor you should add it to a container
-that supports alignment, or use the anchor point.
+Adds a list of #ClutterActor<!-- -->s to @container. Each time and
+actor is added, the "actor-added" signal is emitted. Each actor should
+be parented to @container, which takes a reference on the actor. You
+cannot add a #ClutterActor to more than one #ClutterContainer.
-Since: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="alignment">
-<parameter_description> A #PangoAlignment
+<parameter name="first_actor">
+<parameter_description> the first #ClutterActor to add
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> %NULL terminated list of actors to add
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_set_width">
+<function name="clutter_path_get_length">
<description>
-Forces a width on an actor, causing the actor's preferred width
-and height (if any) to be ignored.
-
-This function sets both the minimum and natural size of the actor.
+Retrieves an approximation of the total length of the path.
-since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> Requested new width for the actor, in pixels
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the length of the path.
+
+</return>
</function>
-<function name="clutter_model_get_column_name">
+<function name="clutter_text_get_line_wrap">
<description>
-Retrieves the name of the @column
+Retrieves the value set using clutter_text_set_line_wrap().
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="column">
-<parameter_description> the column number
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the name of the column. The model holds the returned
-string, and it should not be modified or freed
+<return> %TRUE if the #ClutterText actor should wrap
+its contents
-Since: 0.6
</return>
</function>
-<function name="clutter_interval_set_interval">
+<function name="clutter_animation_set_object">
<description>
-Variable arguments wrapper for clutter_interval_set_initial_value()
-and clutter_interval_set_final_value() that avoids using the
-#GValue arguments:
-
-|[
-clutter_interval_set_interval (interval, 0, 50);
-clutter_interval_set_interval (interval, 1.0, 0.0);
-clutter_interval_set_interval (interval, FALSE, TRUE);
-]|
-
-This function is meant for the convenience of the C API; bindings
-should reimplement this function using the #GValue-based API.
+Attaches @animation to @object. The #ClutterAnimation will take a
+reference on @object.
Since: 1.0
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the initial and final values of the interval
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_units_to_string">
-<description>
-Converts @units into a string
-
-See clutter_units_from_string() for the units syntax and for
-examples of outputs
-
-
-</description>
-<parameters>
-<parameter name="units">
-<parameter_description> a #ClutterUnits
-</parameter_description>
-</parameter>
-</parameters>
-<return> a newly allocated string containing the encoded
-#ClutterUnits value. Use g_free() to free the string
-
-Since: 1.0
-</return>
-</function>
-
<function name="json_node_set_array">
<description>
Sets @array inside @node and increases the #JsonArray reference count
@@ -9644,28 +11401,58 @@ Sets @array inside @node and increases the #JsonArray reference count
<return></return>
</function>
-<function name="clutter_get_input_device_for_id">
+<function name="clutter_actor_box_get_height">
<description>
-Retrieves the #ClutterInputDevice from its id.
+Retrieves the height of the @box
+Since: 1.0
</description>
<parameters>
-<parameter name="id">
-<parameter_description> a device id
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterInputDevice, or %NULL
+<return> the height of the box
-Since: 0.8
</return>
</function>
+<function name="json_object_set_object_member">
+<description>
+Convenience function for setting an object @value of
+ member_name inside @object.
+
+The @object will take ownership of the passed #JsonObject
+
+See also: json_object_set_member()
+
+Since: 0.8
+
+</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="value">
+<parameter_description> the value of the member
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_score_get_loop">
<description>
Gets whether @score is looping
+Since: 0.6
</description>
<parameters>
@@ -9676,56 +11463,51 @@ Gets whether @score is looping
</parameters>
<return> %TRUE if the score is looping
-Since: 0.6
</return>
</function>
-<function name="clutter_threads_add_repaint_func">
+<function name="clutter_backend_get_double_click_time">
<description>
-Adds a function to be called whenever Clutter is repainting a Stage.
-If the function returns %FALSE it is automatically removed from the
-list of repaint functions and will not be called again.
+Gets the maximum time between two button press events, as set
+by clutter_backend_set_double_click_time().
-This function is guaranteed to be called from within the same thread
-that called clutter_main(), and while the Clutter lock is being held.
+Since: 0.4
-A repaint function is useful to ensure that an update of the scenegraph
-is performed before the scenegraph is repainted; for instance, uploading
-a frame from a video into a #ClutterTexture.
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> a time in milliseconds
-When the repaint function is removed (either because it returned %FALSE
-or because clutter_threads_remove_repaint_func() has been called) the
- notify function will be called, if any is set.
+</return>
+</function>
+<function name="json_node_take_array">
+<description>
+Sets @array into @node without increasing the #JsonArray reference count.
</description>
<parameters>
-<parameter name="func">
-<parameter_description> the function to be called within the paint cycle
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to be passed to the function, or %NULL
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> function to be called when removing the repaint
-function, or %NULL
+<parameter name="array">
+<parameter_description> a #JsonArray
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the repaint function. You
-can use the returned integer to remove the repaint function by
-calling clutter_threads_remove_repaint_func().
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_text_get_cursor_position">
<description>
Retrieves the cursor position.
+Since: 1.0
</description>
<parameters>
@@ -9736,52 +11518,48 @@ Retrieves the cursor position.
</parameters>
<return> the cursor position, in characters
-Since: 1.0
</return>
</function>
-<function name="clutter_animation_set_object">
+<function name="clutter_container_find_child_by_name">
<description>
-Attaches @animation to @object. The #ClutterAnimation will take a
-reference on @object.
+Finds a child actor of a container by its name. Search recurses
+into any child container.
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="object">
-<parameter_description> a #GObject
+<parameter name="child_name">
+<parameter_description> the name of the requested child.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The child actor with the requested name,
+or %NULL if no actor with that name was found.
+
+</return>
</function>
-<function name="clutter_container_find_child_by_name">
+<function name="clutter_model_iter_get_model">
<description>
-Finds a child actor of a container by its name. Search recurses
-into any child container.
+Retrieves a pointer to the #ClutterModel that this iter is part of.
+Since: 0.6
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="child_name">
-<parameter_description> the name of the requested child.
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The child actor with the requested name,
-or %NULL if no actor with that name was found.
+<return> a pointer to a #ClutterModel.
-Since: 0.6
</return>
</function>
@@ -9807,6 +11585,31 @@ Since: 0.8
<return></return>
</function>
+<function name="clutter_animation_update_interval">
+<description>
+Changes the @interval for @property_name. The #ClutterAnimation
+will take ownership of the passed #ClutterInterval.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
+</parameter_description>
+</parameter>
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_text_set_font_name">
<description>
Sets the font used by a #ClutterText. The @font_name string
@@ -9853,35 +11656,133 @@ Since: 1.0
</parameter_description>
</parameter>
<parameter name="center_x">
-<parameter_description> (out): Location to store the X position of the scale center, or %NULL.
+<parameter_description> Location to store the X position
+of the scale center, or %NULL.
</parameter_description>
</parameter>
<parameter name="center_y">
-<parameter_description> (out): Location to store the Y position of the scale center, or %NULL.
+<parameter_description> Location to store the Y position
+of the scale center, or %NULL.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_timeline_clone">
+<function name="json_node_get_object">
<description>
-Create a new #ClutterTimeline instance which has property values
-matching that of supplied timeline. The cloned timeline will not
-be started and will not be positioned to the current position of
- timeline: you will have to start it with clutter_timeline_start().
+Retrieves the #JsonObject stored inside a #JsonNode
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> #ClutterTimeline to duplicate.
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return> a new #ClutterTimeline, cloned from @timeline
+<return> the #JsonObject
+</return>
+</function>
+
+<function name="clutter_model_get_n_rows">
+<description>
+Retrieves the number of rows inside @model, eventually taking
+into account any filtering function set using clutter_model_set_filter().
+
+Since: 0.6
+
+</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.
+
+</return>
+</function>
+
+<function name="clutter_text_set_justify">
+<description>
+Sets whether the text of the #ClutterText actor should be justified
+on both margins. This setting is ignored if Clutter is compiled
+against Pango < 1.18.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="justify">
+<parameter_description> whether the text should be justified
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_texture_set_area_from_rgb_data">
+<description>
+Updates a sub-region of the pixel data in a #ClutterTexture.
+
+Since: 0.6
+
+</description>
+<parameters>
+<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 an 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 on source buffer.
+</parameter_description>
+</parameter>
+<parameter name="bpp">
+<parameter_description> bytes per pixel (Currently only 3 and 4 supported,
+depending on @has_alpha)
+</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> %TRUE on success, %FALSE on failure.
-Since: 0.4
</return>
</function>
@@ -9889,6 +11790,7 @@ Since: 0.4
<description>
Retrieves the underlying #CoglHandle for the fragment shader.
+Since: 1.0
</description>
<parameters>
@@ -9899,13 +11801,14 @@ Retrieves the underlying #CoglHandle for the fragment shader.
</parameters>
<return> A #CoglHandle for the fragment shader, or %NULL
-Since: 1.0
</return>
</function>
<function name="clutter_stage_manager_get_default_stage">
<description>
-Return value: (transfer none): the default stage. The returned object
+Returns the default #ClutterStage.
+
+Since: 0.8
</description>
<parameters>
@@ -9914,10 +11817,9 @@ Return value: (transfer none): the default stage. The returned object
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the default stage. The returned object
+<return> the default stage. The returned object
is owned by Clutter and you should never reference or unreference it
-Since: 0.8
</return>
</function>
@@ -9931,6 +11833,7 @@ clutter_score_append().
The #ClutterScore will take a reference on @timeline.
+Since: 0.8
</description>
<parameters>
@@ -9955,7 +11858,6 @@ The #ClutterScore will take a reference on @timeline.
0 on failure. The returned id can be used with clutter_score_remove()
or clutter_score_get_timeline().
-Since: 0.8
</return>
</function>
@@ -9987,24 +11889,21 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_model_foreach">
+<function name="clutter_actor_set_depth">
<description>
-Calls @func for each row in the model.
+Sets the Z coordinate of @self to @depth.
-Since: 0.6
+The unit used by @depth is dependant on the perspective setup. See
+also clutter_stage_set_perspective().
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #ClutterModelForeachFunc
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to @func
+<parameter name="depth">
+<parameter_description> Z co-ord
</parameter_description>
</parameter>
</parameters>
@@ -10042,28 +11941,76 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_vertex_equal">
+<function name="json_node_set_string">
<description>
-Compares @vertex_a and @vertex_b for equality
-
+Sets @value as the string content of the @node, replacing any existing
+content.
</description>
<parameters>
-<parameter name="vertex_a">
-<parameter_description> a #ClutterVertex
+<parameter name="node">
+<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
</parameter_description>
</parameter>
-<parameter name="vertex_b">
-<parameter_description> a #ClutterVertex
+<parameter name="value">
+<parameter_description> a string value
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the passed #ClutterVertex are equal
+<return></return>
+</function>
-Since: 1.0
+<function name="json_node_dup_object">
+<description>
+Retrieves the #JsonObject inside @node. The reference count of
+the returned object is increased.
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> a #JsonNode
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #JsonObject
</return>
</function>
+<function name="clutter_bin_layout_add">
+<description>
+Adds a #ClutterActor to the container using @self and
+sets the alignment policies for it
+
+This function is equivalent to clutter_container_add_actor()
+and clutter_layout_manager_child_set_property() but it does not
+require a pointer to the #ClutterContainer associated to the
+#ClutterBinLayout
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterBinLayout
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="x_align">
+<parameter_description> horizontal alignment policy for @child
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> vertical alignment policy for @child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_path_node_free">
<description>
Frees the memory of an allocated node.
@@ -10080,36 +12027,34 @@ Since: 1.0
<return></return>
</function>
-<function name="cogl_pango_render_layout">
+<function name="clutter_timeline_list_markers">
<description>
-Renders @layout.
+Retrieves the list of markers at time @msecs. If @frame_num is a
+negative integer, all the markers attached to @timeline will be
+returned.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="layout">
-<parameter_description> a #PangoLayout
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X coordinate to render the layout at
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate to render the layout at
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> color to use when rendering the layout
+<parameter name="msecs">
+<parameter_description> the time to check, or -1
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags to pass to the renderer
+<parameter name="n_markers">
+<parameter_description> the number of markers returned
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a newly
+allocated, %NULL terminated string array containing the names of
+the markers. Use g_strfreev() when done.
+
+</return>
</function>
<function name="clutter_actor_set_anchor_point_from_gravity">
@@ -10139,53 +12084,22 @@ Since: 0.6
<return></return>
</function>
-<function name="cogl_pango_render_layout_subpixel">
+<function name="clutter_flow_layout_get_column_spacing">
<description>
-FIXME
+Retrieves the spacing between columns
-Since: 1.0
+Since: 1.2
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #PangoLayout
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> FIXME
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> FIXME
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> color to use when rendering the layout
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags to pass to the renderer
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_backend_get_double_click_distance">
-<description>
-Retrieves the distance used to verify a double click event
-
+<return> the spacing between columns of the #ClutterFlowLayout,
+in pixels
-</description>
-<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
-</parameter_description>
-</parameter>
-</parameters>
-<return> a distance, in pixels.
-
-Since: 0.4
</return>
</function>
@@ -10206,36 +12120,6 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_get_position">
-<description>
-This function tries to "do what you mean" and tell you where the
-actor is, prior to any transformations. Retrieves the fixed
-position of an actor in pixels, if one has been set; otherwise, if
-the allocation is valid, returns the actor's allocated position;
-otherwise, returns 0,0.
-
-The returned position is in pixels.
-
-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
@@ -10330,6 +12214,7 @@ Retrieves all the objects created by @script.
Note: this function does not increment the reference count of the
objects it returns.
+Since: 0.8.2
</description>
<parameters>
@@ -10338,43 +12223,35 @@ objects it returns.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer container) (element-type GObject): a list of #GObject<!-- -->s,
+<return> a list of #GObject<!-- -->s,
or %NULL. The objects are owned by the #ClutterScript instance. Use g_list_free() on the
returned value when done.
-Since: 0.8.2
</return>
</function>
-<function name="clutter_actor_box_new">
+<function name="clutter_texture_new_from_file">
<description>
-Allocates a new #ClutterActorBox using the passed coordinates
-for the top left and bottom right points
+Creates a new ClutterTexture actor to display the image contained a
+file. If the image failed to load then NULL is returned and @error
+is set.
+Since: 0.8
</description>
<parameters>
-<parameter name="x_1">
-<parameter_description> X coordinate of the top left point
-</parameter_description>
-</parameter>
-<parameter name="y_1">
-<parameter_description> Y coordinate of the top left point
-</parameter_description>
-</parameter>
-<parameter name="x_2">
-<parameter_description> X coordinate of the bottom right point
+<parameter name="filename">
+<parameter_description> The name of an image file to load.
</parameter_description>
</parameter>
-<parameter name="y_2">
-<parameter_description> Y coordinate of the bottom right point
+<parameter name="error">
+<parameter_description> Return locatoin for an error.
</parameter_description>
</parameter>
</parameters>
-<return> the newly allocated #ClutterActorBox. Use
-clutter_actor_box_free() to free the resources
+<return> A newly created #ClutterTexture object or NULL on
+error.
-Since: 1.0
</return>
</function>
@@ -10382,6 +12259,7 @@ Since: 1.0
<description>
Gets the filter quality used when scaling a texture.
+Since: 0.8
</description>
<parameters>
@@ -10392,14 +12270,56 @@ Gets the filter quality used when scaling a texture.
</parameters>
<return> The filter quality value.
-Since: 0.8
</return>
</function>
+<function name="clutter_layout_manager_end_animation">
+<description>
+Ends an animation started by clutter_layout_manager_begin_animation()
+
+The result of this call depends on the @manager implementation
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_input_device_get_device_coords">
+<description>
+Retrieves the latest coordinates of the pointer of @device
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice of type %CLUTTER_POINTER_DEVICE
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> return location for the X coordinate
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> return location for the Y coordinate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_path_get_n_nodes">
<description>
Retrieves the number of nodes in the path.
+Since: 1.0
</description>
<parameters>
@@ -10410,7 +12330,6 @@ Retrieves the number of nodes in the path.
</parameters>
<return> the number of nodes.
-Since: 1.0
</return>
</function>
@@ -10437,6 +12356,7 @@ Retrieves the stage perspective.
This function processes a single X event; it can be used to hook
into external X event retrieval (for example that done by GDK).
+Since: 0.8
</description>
<parameters>
@@ -10453,41 +12373,78 @@ or has used the event to update internal state without taking
any exclusive action. %CLUTTER_X11_FILTER_TRANSLATE will not
occur.
-Since: 0.8
</return>
</function>
-<function name="json_object_set_string_member">
+<function name="clutter_get_default_frame_rate">
<description>
-Convenience function for setting a string @value of
- member_name inside @object.
+Retrieves the default frame rate. See clutter_set_default_frame_rate().
-See also: json_object_set_member()
+Since: 0.6
-Since: 0.8
+</description>
+<parameters>
+</parameters>
+<return> the default frame rate
+
+</return>
+</function>
+
+<function name="clutter_actor_animate_with_alphav">
+<description>
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite behaviour given by the passed @alpha.
+
+See clutter_actor_animate() for further details.
+
+This function is useful if you want to use an existing #ClutterAlpha
+to animate @actor.
+
+This is the vector-based variant of clutter_actor_animate_with_alpha(),
+useful for language bindings.
+
+<warning>Unlike clutter_actor_animate_with_alpha(), this function will
+not allow you to specify "signal::" names and callbacks.</warning>
+
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value of the member
+<parameter name="n_properties">
+<parameter_description> number of property names and values
+</parameter_description>
+</parameter>
+<parameter name="properties">
+<parameter_description> a vector
+containing the property names to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> a vector containing the
+property values to set
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterAnimation object. The object is owned by the
+#ClutterActor and should not be unreferenced with g_object_unref()
+
+</return>
</function>
<function name="clutter_actor_is_scaled">
<description>
Checks whether the actor is scaled in either dimension.
+Since: 0.6
</description>
<parameters>
@@ -10498,43 +12455,41 @@ Checks whether the actor is scaled in either dimension.
</parameters>
<return> %TRUE if the actor is scaled.
-Since: 0.6
</return>
</function>
-<function name="clutter_alpha_new_with_func">
+<function name="clutter_layout_manager_child_get">
<description>
-Creates a new #ClutterAlpha instances and sets the timeline
-and the alpha function.
-
-This function will not register @func as a global alpha function.
-
-See also clutter_alpha_set_timeline() and clutter_alpha_set_func().
+Retrieves the values for a list of properties out of the
+#ClutterLayoutMeta created by @manager and attached to the
+child of a @container
+Since: 1.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> a #ClutterAlphaFunc
+<parameter name="container">
+<parameter_description> a #ClutterContainer using @manager
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function, or %NULL
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @container
</parameter_description>
</parameter>
-<parameter name="destroy">
-<parameter_description> function to call when removing the alpha function, or %NULL
+<parameter name="first_property">
+<parameter_description> the name of the first property
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and return location for the value pairs
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterAlpha
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_path_add_cairo_path">
@@ -10567,94 +12522,94 @@ Terminates the Clutter mainloop.
<return></return>
</function>
-<function name="clutter_alpha_get_alpha">
+<function name="clutter_stage_manager_peek_stages">
<description>
-Query the current alpha value.
+Lists all currently used stages.
+Since: 1.0
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
+<parameter name="stage_manager">
+<parameter_description> a #ClutterStageManager
</parameter_description>
</parameter>
</parameters>
-<return> The current alpha value for the alpha
+<return> a pointer
+to the internal list of #ClutterStage objects. The returned list
+is owned by the #ClutterStageManager and should never be modified
+or freed
-Since: 0.2
</return>
</function>
-<function name="clutter_clone_get_source">
+<function name="clutter_layout_manager_get_preferred_width">
<description>
-Retrieves the source #ClutterActor being cloned by @clone
+Computes the minimum and natural widths of the @container according
+to @manager.
+See also clutter_actor_get_preferred_width()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="clone">
-<parameter_description> a #ClutterClone
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
-</parameters>
-<return> (transfer none): the actor source for the clone
-
-Since: 1.0
-</return>
-</function>
-
-<function name="json_array_get_string_element">
-<description>
-Conveniently retrieves the string value of the element at @index_
-inside @array
-
-See also: json_array_get_element(), json_node_get_string()
-
-
-</description>
-<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="container">
+<parameter_description> the #ClutterContainer using @manager
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="for_height">
+<parameter_description> the height for which the width should be computed, or -1
+</parameter_description>
+</parameter>
+<parameter name="min_width_p">
+<parameter_description> return location for the minimum width
+of the layout, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="nat_width_p">
+<parameter_description> return location for the natural width
+of the layout, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the string value; the returned string is owned by
-the #JsonArray and should not be modified or freed
-
-Since: 0.8
-</return>
+<return></return>
</function>
-<function name="json_object_get_member">
+<function name="clutter_box_layout_set_easing_mode">
<description>
-Retrieves the #JsonNode containing the value of @member_name inside
-a #JsonObject.
+Sets the easing mode to be used by @layout when animating changes in layout
+properties
+
+Use clutter_box_layout_set_use_animations() to enable and disable the
+animations
+Since: 1.2
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the JSON object member to access
+<parameter name="mode">
+<parameter_description> an easing mode, either from #ClutterAnimationMode or a logical id
+from clutter_alpha_register_func()
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the node for the requested object
-member, or %NULL
-</return>
+<return></return>
</function>
<function name="clutter_text_get_activatable">
<description>
Retrieves whether a #ClutterText is activatable or not.
+Since: 1.0
</description>
<parameters>
@@ -10665,30 +12620,28 @@ Retrieves whether a #ClutterText is activatable or not.
</parameters>
<return> %TRUE if the actor is activatable
-Since: 1.0
</return>
</function>
-<function name="clutter_event_get_related">
+<function name="clutter_animator_get_timeline">
<description>
-Retrieves the related actor of a crossing event.
+Get the timeline hooked up for driving the #ClutterAnimator
+Since: 1.2
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent of type %CLUTTER_ENTER or of
-type %CLUTTER_LEAVE
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the related #ClutterActor, or %NULL
+<return> the #ClutterTimeline that drives the animator
-Since: 1.0
</return>
</function>
-<function name="clutter_units_pt">
+<function name="clutter_units_from_pt">
<description>
Stores a value in typographic points inside @units
@@ -10708,22 +12661,26 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_x11_get_stage_from_window">
+<function name="clutter_box_layout_set_pack_start">
<description>
-Gets the stage for a particular X window.
+Sets whether children of @layout should be layed out by appending
+them or by prepending them
+Since: 1.2
</description>
<parameters>
-<parameter name="win">
-<parameter_description> an X Window ID
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="pack_start">
+<parameter_description> %TRUE if the @layout should pack children at the
+beginning of the layout
</parameter_description>
</parameter>
</parameters>
-<return> The stage or NULL if a stage does not exist for the window.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_path_clear">
@@ -10742,83 +12699,12 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_timeline_has_marker">
-<description>
-Checks whether @timeline has a marker set with the given name.
-
-
-</description>
-<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
-</parameter_description>
-</parameter>
-<parameter name="marker_name">
-<parameter_description> the name of the marker
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the marker was found
-
-Since: 0.8
-</return>
-</function>
-
-<function name="clutter_texture_get_repeat">
-<description>
-Retrieves the horizontal and vertical repeat values set
-using clutter_texture_set_repeat()
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture
-</parameter_description>
-</parameter>
-<parameter name="repeat_x">
-<parameter_description> (out): return location for the horizontal repeat
-</parameter_description>
-</parameter>
-<parameter name="repeat_y">
-<parameter_description> (out): return location for the vertical repeat
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_actor_reparent">
-<description>
-This function resets the parent actor of @self. It is
-logically equivalent to calling clutter_actor_unparent()
-and clutter_actor_set_parent(), but more efficiently
-implemented, ensures the child is not finalized
-when unparented, and emits the parent-set signal only
-one time.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="new_parent">
-<parameter_description> the new #ClutterActor parent
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_scriptable_parse_custom_node">
<description>
Parses the passed JSON node. The implementation must set the type
of the passed #GValue pointer using g_value_init().
+Since: 0.6
</description>
<parameters>
@@ -10845,7 +12731,6 @@ of the passed #GValue pointer using g_value_init().
</parameters>
<return> %TRUE if the node was successfully parsed, %FALSE otherwise.
-Since: 0.6
</return>
</function>
@@ -10868,67 +12753,78 @@ resources.
<return></return>
</function>
-<function name="clutter_model_get_iter_at_row">
+<function name="clutter_media_set_audio_volume">
<description>
-Retrieves a #ClutterModelIter representing the row at the given index.
-
-If a filter function has been set using clutter_model_set_filter()
-then the @model implementation will return the first non filtered
-row.
+Sets the playback volume of @media to @volume.
+Since: 1.0
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
-<parameter name="row">
-<parameter_description> position of the row to retrieve
+<parameter name="volume">
+<parameter_description> the volume as a double between 0.0 and 1.0
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full): A new #ClutterModelIter, or %NULL if @row was
-out of bounds. When done using the iterator object, call g_object_unref()
-to deallocate its resources
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_texture_get_max_tile_waste">
+<function name="clutter_actor_map">
<description>
-Gets the maximum waste that will be used when creating a texture or
--1 if slicing is disabled.
+Sets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly maps
+and realizes its children if they are visible. Does nothing if the
+actor is not visible.
+Calling this is allowed in only one case: you are implementing the
+#ClutterActor::map virtual function in an actor and you need to map
+the children of that actor. It is not necessary to call this
+if you implement #ClutterContainer because the default implementation
+will automatically map children of containers.
+
+When overriding map, it is mandatory to chain up to the parent
+implementation.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> A #ClutterTexture
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> The maximum waste or -1 if the texture waste is
-unlimited.
-
-Since: 0.8
-</return>
+<return></return>
</function>
-<function name="clutter_event_copy">
+<function name="clutter_model_get_iter_at_row">
<description>
-Copies @event.
+Retrieves a #ClutterModelIter representing the row at the given index.
+If a filter function has been set using clutter_model_set_filter()
+then the @model implementation will return the first non filtered
+row.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="event">
-<parameter_description> A #ClutterEvent.
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> position of the row to retrieve
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #ClutterEvent
+<return> A new #ClutterModelIter, or %NULL if @row was
+out of bounds. When done using the iterator object, call g_object_unref()
+to deallocate its resources
+
</return>
</function>
@@ -10949,6 +12845,7 @@ Creates a new #JsonObject, an JSON object type representation.
Retrieves a #ClutterModelIter representing the last non-filtered
row in @model.
+Since: 0.6
</description>
<parameters>
@@ -10957,20 +12854,17 @@ row in @model.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full): A new #ClutterModelIter.
+<return> A new #ClutterModelIter.
Call g_object_unref() when done using it
-Since: 0.6
</return>
</function>
-<function name="clutter_text_get_chars">
+<function name="clutter_text_get_selectable">
<description>
-Retrieves the contents of the #ClutterText actor between
- start_pos and @end_pos.
-
-The positions are specified in characters, not in bytes.
+Retrieves whether a #ClutterText is selectable or not.
+Since: 1.0
</description>
<parameters>
@@ -10978,20 +12872,9 @@ The positions are specified in characters, not in bytes.
<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="start_pos">
-<parameter_description> start of text, in characters
-</parameter_description>
-</parameter>
-<parameter name="end_pos">
-<parameter_description> end of text, in characters
-</parameter_description>
-</parameter>
</parameters>
-<return> a newly allocated string with the contents of
-the text actor between the specified positions. Use g_free()
-to free the resources when done
+<return> %TRUE if the actor is selectable
-Since: 1.0
</return>
</function>
@@ -11018,25 +12901,39 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_shader_set_fragment_source">
+<function name="clutter_flow_layout_set_column_spacing">
<description>
-Sets the GLSL source code to be used by a #ClutterShader for the fragment
-program.
+Sets the space between columns, in pixels
-Since: 0.6
+Since: 1.2
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> GLSL source code.
+<parameter name="spacing">
+<parameter_description> the space between columns
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> length of source buffer (currently ignored)
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_name">
+<description>
+Sets the given name to @self. The name can be used to identify
+a #ClutterActor.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> Textual tag to apply to actor
</parameter_description>
</parameter>
</parameters>
@@ -11047,6 +12944,7 @@ Since: 0.6
<description>
Copies the passed iterator.
+Since: 0.8
</description>
<parameters>
@@ -11057,7 +12955,6 @@ Copies the passed iterator.
</parameters>
<return> a copy of the iterator, or %NULL
-Since: 0.8
</return>
</function>
@@ -11065,61 +12962,51 @@ Since: 0.8
<description>
Gets whether the per-actor motion events are enabled.
+Since: 0.6
</description>
<parameters>
</parameters>
<return> %TRUE if the motion events are enabled
-Since: 0.6
</return>
</function>
-<function name="clutter_binding_pool_install_action">
+<function name="clutter_backend_set_double_click_distance">
<description>
-Installs a new action inside a #ClutterBindingPool. The action
-is bound to @key_val and @modifiers.
-
-The same action name can be used for multiple @key_val, @modifiers
-pairs.
-
-When an action has been activated using clutter_binding_pool_activate()
-the passed @callback will be invoked (with @data).
-
-Actions can be blocked with clutter_binding_pool_block_action()
-and then unblocked using clutter_binding_pool_unblock_action().
+Sets the maximum distance used to verify a double click event.
-Since: 1.0
+Since: 0.4
</description>
<parameters>
-<parameter name="pool">
-<parameter_description> a #ClutterBindingPool
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action
-</parameter_description>
-</parameter>
-<parameter name="key_val">
-<parameter_description> key symbol
-</parameter_description>
-</parameter>
-<parameter name="modifiers">
-<parameter_description> bitmask of modifiers
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> function to be called when the action is activated
+<parameter name="distance">
+<parameter_description> a distance, in pixels
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> data to be passed to @callback
+</parameters>
+<return></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="notify">
-<parameter_description> function to be called when the action is removed
-from the pool
+<parameter name="msecs">
+<parameter_description> duration of the timeline in milliseconds
</parameter_description>
</parameter>
</parameters>
@@ -11138,6 +13025,7 @@ function you will have to connect to the #ClutterBackend::font-changed
and #ClutterBackend::resolution-changed signals, and call
pango_layout_context_changed() in response to them.
+Since: 1.0
</description>
<parameters>
@@ -11146,24 +13034,22 @@ pango_layout_context_changed() in response to them.
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> the text to set on the #PangoLayout, or %NULL
+<parameter_description> (allow-none) the text to set on the #PangoLayout, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> the newly created #PangoLayout. Use g_object_unref()
when done
-Since: 1.0
</return>
</function>
-<function name="clutter_event_get_device">
+<function name="clutter_event_get_source">
<description>
-Retrieves the #ClutterInputDevice for the event.
-
-The #ClutterInputDevice structure is completely opaque and should
-be cast to the platform-specific implementation.
+Retrieves the source #ClutterActor the event originated from, or
+NULL if the event has no source.
+Since: 0.6
</description>
<parameters>
@@ -11172,28 +13058,28 @@ be cast to the platform-specific implementation.
</parameter_description>
</parameter>
</parameters>
-<return> the #ClutterInputDevice or %NULL
+<return> a #ClutterActor
-Since: 1.0
</return>
</function>
-<function name="clutter_event_get_source">
+<function name="clutter_actor_get_z_rotation_gravity">
<description>
-Retrieves the source #ClutterActor the event originated from, or
-NULL if the event has no source.
+Retrieves the center for the rotation around the Z axis as a
+compass direction. If the center was specified in pixels or units
+this will return %CLUTTER_GRAVITY_NONE.
+Since: 1.0
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterActor
+<return> the Z rotation center
-Since: 0.6
</return>
</function>
@@ -11201,6 +13087,7 @@ Since: 0.6
<description>
Retrieves the #CoglPangoRenderer for the passed font map.
+Since: 1.0
</description>
<parameters>
@@ -11211,7 +13098,6 @@ Retrieves the #CoglPangoRenderer for the passed font map.
</parameters>
<return> a #PangoRenderer
-Since: 1.0
</return>
</function>
@@ -11219,13 +13105,13 @@ Since: 1.0
<description>
Retrieves the pointer to the default display.
+Since: 0.6
</description>
<parameters>
</parameters>
<return> the default display
-Since: 0.6
</return>
</function>
@@ -11233,6 +13119,7 @@ Since: 0.6
<description>
The position of the timeline in a [0, 1] interval.
+Since: 0.6
</description>
<parameters>
@@ -11243,7 +13130,6 @@ The position of the timeline in a [0, 1] interval.
</parameters>
<return> the position of the timeline.
-Since: 0.6
</return>
</function>
@@ -11264,168 +13150,66 @@ all the four 8 bit channels used by #ClutterColor.
</return>
</function>
-<function name="json_object_set_object_member">
-<description>
-Convenience function for setting an object @value of
- member_name inside @object.
-
-The @object will take ownership of the passed #JsonArray
-
-See also: json_object_set_member()
-
-Since: 0.8
-
-</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="value">
-<parameter_description> the value of the member
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="_cogl_set_indirect_context">
-<description>
-Advises COGL that the GL context is indirect (commands are sent
-over a socket). COGL uses this information to try to avoid
-round-trips in its use of GL, for example.
-
-This function cannot be called "on the fly," only before COGL
-initializes.
-
-</description>
-<parameters>
-<parameter name="indirect">
-<parameter_description> TRUE if GL context is indirect
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_model_iter_get_model">
+<function name="clutter_backend_get_double_click_distance">
<description>
-Retrieves a pointer to the #ClutterModel that this iter is part of.
+Retrieves the distance used to verify a double click event
+Since: 0.4
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a pointer to a #ClutterModel.
+<return> a distance, in pixels.
-Since: 0.6
</return>
</function>
-<function name="clutter_text_insert_unichar">
+<function name="clutter_event_get_device_type">
<description>
-Inserts @wc at the current cursor position of a
-#ClutterText actor.
+Retrieves the type of the device for @event
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<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:
-<informalexample><programlisting>
-clutter_model_iter_set (iter, 0, "foo", -1);
-</programlisting></informalexample>
-
-Since: 0.6
+<return> the #ClutterInputDeviceType for the device, if
+any is set
-</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>
+</return>
</function>
-<function name="clutter_actor_animate_with_alphav">
+<function name="clutter_texture_get_pixel_format">
<description>
-Animates the given list of properties of @actor between the current
-value for each property and a new final value. The animation has a
-definite behaviour given by the passed @alpha.
-
-See clutter_actor_animate() for further details.
-
-This function is useful if you want to use an existing #ClutterAlpha
-to animate @actor.
+Retrieves the pixel format used by @texture. This is
+equivalent to:
-This is the vector-based variant of clutter_actor_animate_with_alpha(),
-useful for language bindings.
+|[
+handle = clutter_texture_get_pixel_format (texture);
-<warning>Unlike clutter_actor_animate_with_alpha(), this function will
-not allow you to specify "signal::" names and callbacks.</warning>
+if (handle != COGL_INVALID_HANDLE)
+format = cogl_texture_get_format (handle);
+]|
+Since: 1.0
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="n_properties">
-<parameter_description> number of property names and values
-</parameter_description>
-</parameter>
-<parameter name="properties">
-<parameter_description> (array length=n_properties) (element-type utf8): a vector
-containing the property names to set
-</parameter_description>
-</parameter>
-<parameter name="values">
-<parameter_description> (array length=n_properies): a vector containing the
-property values to set
+<parameter name="texture">
+<parameter_description> a #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is owned by the
-#ClutterActor and should not be unreferenced with g_object_unref()
+<return> a #CoglPixelFormat value
-Since: 1.0
</return>
</function>
@@ -11462,13 +13246,13 @@ pairs terminated with NULL.
<description>
Gets the number of the default X Screen object.
+Since: 0.6
</description>
<parameters>
</parameters>
<return> the number of the default screen
-Since: 0.6
</return>
</function>
@@ -11497,18 +13281,36 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_animation_get_alpha">
+<description>
+Retrieves the #ClutterAlpha used by @animation.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+</parameters>
+<return> the alpha object used by the animation
+
+</return>
+</function>
+
<function name="clutter_get_current_event_time">
<description>
Retrieves the timestamp of the last event, if there is an
event or if the event has a timestamp.
+Since: 1.0
</description>
<parameters>
</parameters>
<return> the event timestamp, or %CLUTTER_CURRENT_TIME
-Since: 1.0
</return>
</function>
@@ -11526,6 +13328,24 @@ Stops the #ClutterTimeline and moves to frame 0
<return></return>
</function>
+<function name="clutter_get_current_event">
+<description>
+If an event is currently being processed, return that event.
+This function is intended to be used to access event state
+that might not be exposed by higher-level widgets. For
+example, to get the key modifier state from a Button 'clicked'
+event.
+
+Since: 1.2
+
+</description>
+<parameters>
+</parameters>
+<return> The current ClutterEvent, or %NULL if none
+
+</return>
+</function>
+
<function name="clutter_rectangle_set_color">
<description>
Sets the color of @rectangle.
@@ -11559,28 +13379,24 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_box_get_size">
+<function name="clutter_texture_get_max_tile_waste">
<description>
-Retrieves the size of @box
+Gets the maximum waste that will be used when creating a texture or
+-1 if slicing is disabled.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> (out): return location for the width, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> (out): return location for the height, or %NULL
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The maximum waste or -1 if the texture waste is
+unlimited.
+
+</return>
</function>
<function name="clutter_text_set_markup">
@@ -11591,8 +13407,8 @@ This is a convenience function for setting a string containing
Pango markup, and it is logically equivalent to:
|[
-clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE);
clutter_text_set_text (CLUTTER_TEXT (actor), markup);
+clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE);
]|
Since: 1.0
@@ -11621,6 +13437,7 @@ see clutter_actor_animate().
This method returns the animation primarily to make chained
calls convenient in language bindings.
+Since: 1.0
</description>
<parameters>
@@ -11637,8 +13454,8 @@ calls convenient in language bindings.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The animation itself.
-Since: 1.0
+<return> The animation itself.
+
</return>
</function>
@@ -11664,6 +13481,7 @@ Removes @member_name from @object, freeing its allocated resources.
<description>
Copies @vertex
+Since: 1.0
</description>
<parameters>
@@ -11675,7 +13493,6 @@ Copies @vertex
<return> a newly allocated copy of #ClutterVertex. Use
clutter_vertex_free() to free the allocated resources
-Since: 1.0
</return>
</function>
@@ -11710,85 +13527,39 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> (out): return location for the width, or %NULL
+<parameter_description> return location for the width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> (out): return location for the height, or %NULL
+<parameter_description> return location for the height, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_units_from_string">
+<function name="clutter_behaviour_get_actors">
<description>
-Parses a value and updates @units with it
-
-A #ClutterUnits expressed in string should match:
-
-|[
-number: [0-9]
-unit_value: <numbers>+
-unit_name: px|pt|mm|em
-units: <unit_value> <unit_name>
-]|
-
-For instance, these are valid strings:
-
-|[
-10 px
-5 em
-24 pt
-12.6 mm
-]|
+Retrieves all the actors to which @behave applies. It is not recommended
+for derived classes to use this in there alpha notify method but use
+#clutter_behaviour_actors_foreach as it avoids alot of needless allocations.
+Since: 0.2
</description>
<parameters>
-<parameter name="units">
-<parameter_description> a #ClutterUnits
-</parameter_description>
-</parameter>
-<parameter name="str">
-<parameter_description> the string to convert
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the string was successfully parsed
+<return> a list of
+actors. You should free the returned list with g_slist_free() when
+finished using it.
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_set_z_rotation_from_gravity">
-<description>
-Sets the rotation angle of @self around the Z axis using the center
-point specified as a compass point. For example to rotate such that
-the center of the actor remains static you can use
-%CLUTTER_GRAVITY_CENTER. If the actor changes size the center point
-will move accordingly.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="angle">
-<parameter_description> the angle of rotation
-</parameter_description>
-</parameter>
-<parameter name="gravity">
-<parameter_description> the center point of the rotation
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_threads_set_lock_functions">
<description>
Allows the application to replace the standard method that
@@ -11831,9 +13602,14 @@ Since: 0.4
<function name="clutter_texture_set_cogl_material">
<description>
-Replaces the underlying COGL texture drawn by this actor with
- cogl_tex A reference to the texture is taken so if the handle is
-no longer needed it should be deref'd with cogl_handle_unref.
+Replaces the underlying Cogl material drawn by this actor with
+ cogl_material A reference to the material is taken so if the
+handle is no longer needed it should be deref'd with
+cogl_handle_unref. Texture data is attached to the material so
+calling this function also replaces the Cogl
+texture. #ClutterTexture requires that the material have a texture
+layer so you should set one on the material before calling this
+function.
Since: 0.8
@@ -11855,11 +13631,13 @@ Since: 0.8
<function name="clutter_x11_enable_xinput">
<description>
Enables the use of the XInput extension if present on connected
-XServer and support built into Clutter. XInput allows for multiple
-pointing devices to be used. This must be called before
-clutter_init().
+XServer and support built into Clutter. XInput allows for multiple
+pointing devices to be used.
+
+This function must be called before clutter_init().
-You should use #clutter_x11_has_xinput to see if support was enabled.
+Since XInput might not be supported by the X server, you might
+want to use clutter_x11_has_xinput() to see if support was enabled.
Since: 0.8
@@ -11869,32 +13647,90 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_events_pending">
+<function name="clutter_event_copy">
<description>
-Checks if events are pending in the event queue.
+Copies @event.
</description>
<parameters>
+<parameter name="event">
+<parameter_description> A #ClutterEvent.
+</parameter_description>
+</parameter>
</parameters>
-<return> TRUE if there are pending events, FALSE otherwise.
-
-Since: 0.4
+<return> A newly allocated #ClutterEvent
</return>
</function>
-<function name="clutter_main_level">
+<function name="clutter_actor_is_rotated">
<description>
-Retrieves the depth of the Clutter mainloop.
+Checks whether any rotation is applied to the actor.
+Since: 0.6
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return> The level of the mainloop.
+<return> %TRUE if the actor is rotated.
+
</return>
</function>
+<function name="clutter_actor_get_scale">
+<description>
+Retrieves an actors scale factors.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="scale_x">
+<parameter_description> Location to store horizonal
+scale factor, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="scale_y">
+<parameter_description> Location to store vertical
+scale factor, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_set_request_mode">
+<description>
+Sets the geometry request mode of @self.
+
+The @mode determines the order for invoking
+clutter_actor_get_preferred_width() and
+clutter_actor_get_preferred_height()
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> the request mode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_rectangle_get_color">
<description>
Retrieves the color of @rectangle.
@@ -11917,6 +13753,7 @@ Retrieves the color of @rectangle.
<description>
Creates a copy of @interval.
+Since: 1.0
</description>
<parameters>
@@ -11927,25 +13764,86 @@ Creates a copy of @interval.
</parameters>
<return> the newly created #ClutterInterval
-Since: 1.0
</return>
</function>
-<function name="clutter_behaviour_ellipse_set_angle_start">
+<function name="clutter_box_layout_get_pack_start">
<description>
-Sets the angle at which movement starts; angles >= 360 degress get clamped
-to the canonical interval <0, 360).
+Retrieves the value set using clutter_box_layout_set_pack_start()
-Since: 0.6
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="angle_start">
-<parameter_description> angle at which movement starts in degrees, between 0 and 360.
+</parameters>
+<return> %TRUE if the #ClutterBoxLayout should pack children
+at the beginning of the layout, and %FALSE otherwise
+
+</return>
+</function>
+
+<function name="cogl_pango_render_layout_subpixel">
+<description>
+FIXME
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #PangoLayout
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> FIXME
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the layout
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to the renderer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="cogl_pango_render_layout">
+<description>
+Renders @layout.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #PangoLayout
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate to render the layout at
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate to render the layout at
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> color to use when rendering the layout
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to the renderer
</parameter_description>
</parameter>
</parameters>
@@ -11980,37 +13878,42 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_group_remove_all">
+<function name="clutter_model_iter_get_row">
<description>
-Removes all children actors from the #ClutterGroup.
+Retrieves the position of the row that the @iter points to.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="group">
-<parameter_description> A #ClutterGroup
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the position of the @iter in the model
+
+</return>
</function>
-<function name="clutter_event_get_stage">
+<function name="clutter_value_set_color">
<description>
-Retrieves the source #ClutterStage the event originated for, or
-%NULL if the event has no stage.
+Sets @value to @color.
+Since: 0.8.4
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="value">
+<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> the color to set
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterStage
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_timeline_add_marker_at_time">
@@ -12045,49 +13948,53 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_interval_set_final_value">
+<function name="json_object_dup_member">
<description>
-Sets the final value of @interval to @value. The value is
-copied inside the #ClutterInterval.
+Retrieves a copy of the #JsonNode containing the value of @member_name
+inside a #JsonObject
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="interval">
-<parameter_description> a #ClutterInterval
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a #GValue
+<parameter name="member_name">
+<parameter_description> the name of the JSON object member to access
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a copy of the node for the requested object member
+or %NULL. Use json_node_free() when done.
+
+</return>
</function>
-<function name="clutter_container_child_set_property">
+<function name="clutter_actor_box_interpolate">
<description>
-Sets a container-specific property on a child of @container.
+Interpolates between @initial and @final #ClutterActorBox<!-- -->es
+using @progress
-Since: 0.8
+Since: 1.2
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="initial">
+<parameter_description> the initial #ClutterActorBox
</parameter_description>
</parameter>
-<parameter name="child">
-<parameter_description> a #ClutterActor that is a child of @container.
+<parameter name="final">
+<parameter_description> the final #ClutterActorBox
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the name of the property to set.
+<parameter name="progress">
+<parameter_description> the interpolation progress
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value.
+<parameter name="result">
+<parameter_description> return location for the interpolation
</parameter_description>
</parameter>
</parameters>
@@ -12116,78 +14023,94 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_timeline_pause">
+<function name="clutter_actor_get_anchor_point_gravity">
<description>
-Pauses the #ClutterTimeline on current frame
+Retrieves the anchor position expressed as a #ClutterGravity. If
+the anchor point was specified using pixels or units this will
+return %CLUTTER_GRAVITY_NONE.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> A #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #ClutterGravity used by the anchor point
+
+</return>
</function>
-<function name="clutter_shader_get_cogl_program">
+<function name="clutter_clone_set_source">
<description>
-Retrieves the underlying #CoglHandle for the shader program.
+Sets @source as the source actor to be cloned by @clone.
+Since: 1.0
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<parameter name="clone">
+<parameter_description> a #ClutterClone
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> a #ClutterActor, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A #CoglHandle for the shader program, or %NULL
-
-Since: 1.0
-</return>
+<return></return>
</function>
-<function name="clutter_color_add">
+<function name="clutter_shader_get_cogl_program">
<description>
-Adds @a to @b and saves the resulting color inside @result.
+Retrieves the underlying #CoglHandle for the shader program.
-The alpha channel of @result is set as as the maximum value
-between the alpha channels of @a and @b.
+Since: 1.0
</description>
<parameters>
-<parameter name="a">
-<parameter_description> a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="b">
-<parameter_description> a #ClutterColor
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> (out): return location for the result
+<parameter name="shader">
+<parameter_description> a #ClutterShader
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #CoglHandle for the shader program, or %NULL
+
+</return>
</function>
<function name="clutter_actor_get_height">
<description>
-Retrieves the height of the @box
+Retrieves the height of a #ClutterActor.
+
+If the actor has a valid allocation, this function will return the
+height of the allocated area given to the actor.
+
+If the actor does not have a valid allocation, this function will
+return the actor's natural height, that is the preferred height of
+the actor.
+
+If you care whether you get the preferred height or the height that
+has been assigned to the actor, you should probably call a different
+function like clutter_actor_get_allocation_box() to retrieve the
+allocated size or clutter_actor_get_preferred_height() to retrieve the
+preferred height.
+
+If an actor has a fixed height, for instance a height that has been
+assigned using clutter_actor_set_height(), the height returned will
+be the same value.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the height of the box
-
-Since: 1.0
+<return> the height of the actor, in pixels
</return>
</function>
@@ -12224,6 +14147,7 @@ Since: 0.4
Simple wrapper around clutter_threads_add_idle_full() using the
default priority.
+Since: 0.4
</description>
<parameters>
@@ -12238,10 +14162,39 @@ default priority.
</parameters>
<return> the ID (greater than 0) of the event source.
-Since: 0.4
</return>
</function>
+<function name="clutter_actor_get_position">
+<description>
+This function tries to "do what you mean" and tell you where the
+actor is, prior to any transformations. Retrieves the fixed
+position of an actor in pixels, if one has been set; otherwise, if
+the allocation is valid, returns the actor's allocated position;
+otherwise, returns 0,0.
+
+The returned position is in pixels.
+
+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_threads_init">
<description>
Initialises the Clutter threading mechanism, so that Clutter API can be
@@ -12252,6 +14205,8 @@ You must call g_thread_init() before this function.
This function must be called before clutter_init().
+It is safe to call this function multiple times.
+
Since: 0.4
</description>
@@ -12260,6 +14215,35 @@ Since: 0.4
<return></return>
</function>
+<function name="clutter_actor_get_allocation_box">
+<description>
+Gets the layout box an actor has been assigned. The allocation can
+only be assumed valid inside a paint() method; anywhere else, it
+may be out-of-date.
+
+An allocation does not incorporate the actor's scale or anchor point;
+those transformations do not affect layout, only rendering.
+
+<note>Do not call any of the clutter_actor_get_allocation_*() family
+of functions inside the implementation of the get_preferred_width()
+or get_preferred_height() virtual functions.</note>
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="box">
+<parameter_description> the function fills this in with the actor's allocation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="json_array_foreach_element">
<description>
Iterates over all elements of @array and calls @func on
@@ -12289,22 +14273,22 @@ Since: 0.8
<return></return>
</function>
-<function name="ClutterAlpha">
+<function name="clutter_model_get_sorting_column">
<description>
-The progress function logical id - either a value from the
-#ClutterAnimationMode enumeration or a value returned by
-clutter_alpha_register_func().
-
-If %CLUTTER_CUSTOM_MODE is used then the function set using
-clutter_alpha_set_closure() or clutter_alpha_set_func()
-will be used.
+Retrieves the number of column used for sorting the @model.
-Since: 1.0
+Since: 0.6
</description>
<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> a column number, or -1 if the model is not sorted
+
+</return>
</function>
<function name="clutter_actor_paint">
@@ -12334,6 +14318,7 @@ Replaces all of the nodes in the path with nodes described by
If the string is invalid then %FALSE is returned and the path is
unaltered.
+Since: 1.0
</description>
<parameters>
@@ -12348,7 +14333,6 @@ unaltered.
</parameters>
<return> %TRUE is the path was valid, %FALSE otherwise.
-Since: 1.0
</return>
</function>
@@ -12385,7 +14369,7 @@ color to a #ClutterColor.
</description>
<parameters>
<parameter name="color">
-<parameter_description> (out): return location for a #ClutterColor
+<parameter_description> return location for a #ClutterColor
</parameter_description>
</parameter>
<parameter name="pixel">
@@ -12396,48 +14380,61 @@ color to a #ClutterColor.
<return></return>
</function>
-<function name="clutter_actor_realize">
+<function name="clutter_model_set_sorting_column">
<description>
-Creates any underlying graphics resources needed by the actor to be
-displayed.
-
-Realization means the actor is now tied to a specific rendering context
-(that is, a specific toplevel stage).
-
-This function does nothing if the actor is already realized.
-
-Because a realized actor must have realized parent actors, calling
-clutter_actor_realize() will also realize all parents of the actor.
+Sets the model to sort by @column. If @column is a negative value
+the sorting column will be unset.
-This function does not realize child actors, except in the special
-case that realizing the stage, when the stage is visible, will
-suddenly map (and thus realize) the children of the stage.
+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></return>
</function>
-<function name="clutter_model_set_sorting_column">
+<function name="clutter_box_pack_after">
<description>
-Sets the model to sort by @column. If @column is a negative value
-the sorting column will be unset.
+Adds @actor to @box, placing it after @sibling, and sets layout
+properties at the same time, if the #ClutterLayoutManager used by
+ box supports them
-Since: 0.6
+If @sibling is %NULL then @actor is placed at the end of the
+list of children, to be allocated and painted after every other child
+
+This function is a wrapper around clutter_container_add_actor(),
+clutter_container_raise_child() and clutter_layout_manager_child_set()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="box">
+<parameter_description> a #ClutterBox
</parameter_description>
</parameter>
-<parameter name="column">
-<parameter_description> the column of the @model to sort, or -1
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> a #ClutterActor or %NULL
+</parameter_description>
+</parameter>
+<parameter name="first_property">
+<parameter_description> the name of the first property to set, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and value pairs, terminated by %NULL
</parameter_description>
</parameter>
</parameters>
@@ -12468,45 +14465,40 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_stage_set_color">
+<function name="clutter_backend_get_font_options">
<description>
-Sets the stage color.
+Retrieves the font options for @backend.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> A #ClutterColor
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the font options of the #ClutterBackend.
+The returned #cairo_font_options_t is owned by the backend and should
+not be modified or freed
+
+</return>
</function>
-<function name="json_object_set_boolean_member">
+<function name="clutter_box_layout_set_spacing">
<description>
-Convenience function for setting a boolean @value of
- member_name inside @object.
+Sets the spacing between children of @layout
-See also: json_object_set_member()
-
-Since: 0.8
+Since: 1.2
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
-</parameter_description>
-</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value of the member
+<parameter name="spacing">
+<parameter_description> the spacing between children of the layout, in pixels
</parameter_description>
</parameter>
</parameters>
@@ -12518,6 +14510,7 @@ Since: 0.8
Creates a new #ClutterCairoTexture actor, with a surface of @width by
@height pixels.
+Since: 1.0
</description>
<parameters>
@@ -12532,50 +14525,88 @@ Creates a new #ClutterCairoTexture actor, with a surface of @width by
</parameters>
<return> the newly created #ClutterCairoTexture actor
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_grab_key_focus">
+<function name="clutter_model_iter_get">
<description>
-Sets the key focus of the #ClutterStage including @self
-to this #ClutterActor.
+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.
-Since: 1.0
+For example, to get a value from column 0 with type %G_TYPE_STRING use:
+<informalexample><programlisting>
+clutter_model_iter_get (iter, 0, &place_string_here, -1);
+</programlisting></informalexample>
+
+where place_string_here is a gchar* to be filled with the string. If
+appropriate, the returned values have to be freed or unreferenced.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<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="json_array_get_double_element">
+<function name="clutter_behaviour_ellipse_set_angle_start">
<description>
-Conveniently retrieves the floating point value of the element at
- index_ inside @array
-
-See also: json_array_get_element(), json_node_get_double()
+Sets the angle at which movement starts; angles >= 360 degress get clamped
+to the canonical interval <0, 360).
+Since: 0.6
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="angle_start">
+<parameter_description> angle at which movement starts in degrees, between 0 and 360.
</parameter_description>
</parameter>
</parameters>
-<return> the floating point value
+<return></return>
+</function>
-Since: 0.8
-</return>
+<function name="clutter_model_appendv">
+<description>
+Creates and appends a new row to the #ClutterModel, setting the row
+values for the given @columns upon creation.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> the number of columns and values
+</parameter_description>
+</parameter>
+<parameter name="columns">
+<parameter_description> a vector with the columns to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> a vector with the values
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_actor_move_by">
@@ -12607,46 +14638,48 @@ Since: 0.2
<return></return>
</function>
-<function name="clutter_texture_set_load_async">
+<function name="clutter_text_set_attributes">
<description>
-Sets whether @texture should use a worker thread to load the data
-from disk asynchronously. Setting @load_async to %TRUE will make
-clutter_texture_set_from_file() return immediately.
+Sets the attributes list that are going to be applied to the
+#ClutterText contents.
-See the #ClutterTexture:load-async property documentation, and
-clutter_texture_set_load_data_async().
+The #ClutterText actor will take a reference on the #PangoAttrList
+passed to this function.
Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="load_async">
-<parameter_description> %TRUE if the texture should asynchronously load data
-from a filename
+<parameter name="attrs">
+<parameter_description> a #PangoAttrList or %NULL to unset the attributes
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_media_set_playing">
+<function name="clutter_cairo_texture_set_surface_size">
<description>
-Starts or stops playing of @media.
+Resizes the Cairo surface used by @self to @width and @height.
-Since: 0.2
+Since: 1.0
</description>
<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
+<parameter name="self">
+<parameter_description> a #ClutterCairoTexture
</parameter_description>
</parameter>
-<parameter name="playing">
-<parameter_description> %TRUE to start playing
+<parameter name="width">
+<parameter_description> the new width of the surface
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the new height of the surface
</parameter_description>
</parameter>
</parameters>
@@ -12671,58 +14704,126 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_set_default_frame_rate">
+<function name="clutter_threads_add_frame_source_full">
<description>
-Sets the default frame rate. This frame rate will be used to limit
-the number of frames drawn if Clutter is not able to synchronize
-with the vertical refresh rate of the display. When synchronization
-is possible, this value is ignored.
+Sets a function to be called at regular intervals holding the Clutter
+threads lock, with the given priority. The function is called repeatedly
+until it returns %FALSE, at which point the timeout is automatically
+removed and the function will not be called again. The @notify function
+is called when the timeout is removed.
-Since: 0.6
+This function is similar to clutter_threads_add_timeout_full()
+except that it will try to compensate for delays. For example, if
+ func takes half the interval time to execute then the function
+will be called again half the interval time after it finished. In
+contrast clutter_threads_add_timeout_full() would not fire until a
+full interval after the function completes so the delay between
+calls would be @interval * 1.5. This function does not however try
+to invoke the function multiple times to catch up missing frames if
+ func takes more than @interval ms to execute.
+
+See also clutter_threads_add_idle_full().
+
+Since: 0.8
</description>
<parameters>
-<parameter name="frames_per_sec">
-<parameter_description> the new default frame rate
+<parameter name="priority">
+<parameter_description> the priority of the frame source. Typically this will be in the
+range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
+</parameter_description>
+</parameter>
+<parameter name="fps">
+<parameter_description> the number of times per second to call the function
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to call when the timeout source is removed
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ID (greater than 0) of the event source.
+
+</return>
</function>
-<function name="clutter_actor_get_stage">
+<function name="clutter_behaviour_scale_new">
<description>
-Retrieves the #ClutterStage where @actor is contained.
+Creates a new #ClutterBehaviourScale instance.
+Since: 0.2
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="x_scale_start">
+<parameter_description> initial scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_start">
+<parameter_description> initial scale factor on the Y axis
+</parameter_description>
+</parameter>
+<parameter name="x_scale_end">
+<parameter_description> final scale factor on the X axis
+</parameter_description>
+</parameter>
+<parameter name="y_scale_end">
+<parameter_description> final scale factor on the Y axis
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the stage containing the actor, or %NULL
+<return> the newly created #ClutterBehaviourScale
-Since: 0.8
</return>
</function>
-<function name="clutter_alpha_get_timeline">
+<function name="clutter_animation_set_alpha">
<description>
-Gets the #ClutterTimeline bound to @alpha.
+Sets @alpha as the #ClutterAlpha used by @animation.
+If @alpha is not %NULL, the #ClutterAnimation will take ownership
+of the #ClutterAlpha instance.
+
+Since: 1.0
</description>
<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
<parameter name="alpha">
-<parameter_description> A #ClutterAlpha
+<parameter_description> a #ClutterAlpha, or %NULL to unset the current #ClutterAlpha
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterTimeline instance
+<return></return>
+</function>
+
+<function name="clutter_stage_manager_get_default">
+<description>
+Returns the default #ClutterStageManager.
+
+Since: 0.8
+
+</description>
+<parameters>
+</parameters>
+<return> the default stage manager instance. The returned
+object is owned by Clutter and you should not reference or unreference it.
-Since: 0.2
</return>
</function>
@@ -12754,19 +14855,50 @@ Since: 0.2
<return></return>
</function>
-<function name="json_node_get_object">
+<function name="clutter_alpha_set_mode">
<description>
-Retrieves the #JsonObject stored inside a #JsonNode
+Sets the progress function of @alpha using the symbolic value
+of @mode, as taken by the #ClutterAnimationMode enumeration or
+using the value returned by clutter_alpha_register_func().
+Since: 1.0
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> a #ClutterAnimationMode
</parameter_description>
</parameter>
</parameters>
-<return> the #JsonObject
+<return></return>
+</function>
+
+<function name="json_array_get_array_element">
+<description>
+Conveniently retrieves the array from the element at @index_
+inside @array
+
+See also: json_array_get_element(), json_node_get_array()
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> the array
+
</return>
</function>
@@ -12774,6 +14906,7 @@ Retrieves the #JsonObject stored inside a #JsonNode
<description>
Retrieves the value set with clutter_stage_set_user_resizable().
+Since: 0.4
</description>
<parameters>
@@ -12784,7 +14917,28 @@ Retrieves the value set with clutter_stage_set_user_resizable().
</parameters>
<return> %TRUE if the stage is resizable by the user.
-Since: 0.4
+</return>
+</function>
+
+<function name="clutter_box_layout_get_expand">
+<description>
+Retrieves whether @actor should expand inside @layout
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the #ClutterActor should expand, %FALSE otherwise
+
</return>
</function>
@@ -12800,37 +14954,22 @@ Check if clutter has debugging turned on.
</return>
</function>
-<function name="_clutter_actor_rerealize">
+<function name="clutter_behaviour_rotate_get_direction">
<description>
-If an actor is already unrealized, this just calls the callback.
-
-If it is realized, it unrealizes temporarily, calls the callback,
-and then re-realizes the actor.
+Retrieves the #ClutterRotateDirection used by the rotate behaviour.
-As a side effect, leaves all children of the actor unrealized if
-the actor was realized but not showing. This is because when we
-unrealize the actor temporarily we must unrealize its children
-(e.g. children of a stage can't be realized if stage window is
-gone). And we aren't clever enough to save the realization state of
-all children. In most cases this should not matter, because
-the children will automatically realize when they next become mapped.
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> Function to call while unrealized
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data for callback
+<parameter name="rotate">
+<parameter_description> a #ClutterBehaviourRotate
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the rotation direction
+
+</return>
</function>
<function name="clutter_score_remove_all">
@@ -12891,6 +15030,9 @@ Since: 1.0
<function name="clutter_x11_texture_pixmap_new_with_window">
<description>
+Creates a new #ClutterX11TexturePixmap for @window
+
+Since: 0.8
</description>
<parameters>
@@ -12901,7 +15043,6 @@ Since: 1.0
</parameters>
<return> A new #ClutterX11TexturePixmap bound to the given X window.
-Since 0.8
</return>
</function>
@@ -12917,21 +15058,21 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_get_height">
+<function name="clutter_text_get_single_line_mode">
<description>
-Gets the height of the elliptical path.
+Retrieves whether the #ClutterText actor is in single line mode.
+Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
</parameters>
-<return> the height of the path
+<return> %TRUE if the #ClutterText actor is in single line mode
-Since: 0.4
</return>
</function>
@@ -12976,16 +15117,22 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_ungrab_pointer">
+<function name="clutter_animator_key_get_object">
<description>
-Removes an existing grab of the pointer.
+Retrieves the object a key applies to.
-Since: 0.6
+Since: 1.2
</description>
<parameters>
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the object an animator_key exist for.
+
+</return>
</function>
<function name="clutter_behaviour_rotate_set_bounds">
@@ -13013,40 +15160,6 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_behaviour_scale_new">
-<description>
-Creates a new #ClutterBehaviourScale instance.
-
-
-</description>
-<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="x_scale_start">
-<parameter_description> initial scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_start">
-<parameter_description> initial scale factor on the Y axis
-</parameter_description>
-</parameter>
-<parameter name="x_scale_end">
-<parameter_description> final scale factor on the X axis
-</parameter_description>
-</parameter>
-<parameter name="y_scale_end">
-<parameter_description> final scale factor on the Y axis
-</parameter_description>
-</parameter>
-</parameters>
-<return> the newly created #ClutterBehaviourScale
-
-Since: 0.2
-</return>
-</function>
-
<function name="clutter_cairo_texture_create">
<description>
Creates a new Cairo context for the @cairo texture. It is
@@ -13058,6 +15171,7 @@ and @height equal to the @cairo texture surface height.
function or from a callback to the #ClutterActor::paint
signal.</para></warning>
+Since: 1.0
</description>
<parameters>
@@ -13069,14 +15183,44 @@ signal.</para></warning>
<return> a newly created Cairo context. Use cairo_destroy()
to upload the contents of the context when done drawing
-Since: 1.0
</return>
</function>
+<function name="clutter_animator_property_set_interpolation">
+<description>
+Set the interpolation method to use, %CLUTTER_INTERPOLATION_LINEAR causes
+the values to linearly change between the values, and
+%CLUTTER_INTERPOLATION_CUBIC causes the values to smoothly change between
+the values.
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="animator">
+<parameter_description> a #ClutterAnimatorKey
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the name of a property on object
+</parameter_description>
+</parameter>
+<parameter name="interpolation">
+<parameter_description> the #ClutterInterpolation to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_path_add_close">
<description>
-Adds a #CLUTTER_PATH_CLOSE type node to the path. This creates a
-straight line from the last node to the last #CLUTTER_PATH_MOVE_TO
+Adds a %CLUTTER_PATH_CLOSE type node to the path. This creates a
+straight line from the last node to the last %CLUTTER_PATH_MOVE_TO
type node.
Since: 1.0
@@ -13095,6 +15239,7 @@ Since: 1.0
<description>
Retrieves the playback volume of @media.
+Since: 1.0
</description>
<parameters>
@@ -13105,7 +15250,6 @@ Retrieves the playback volume of @media.
</parameters>
<return> The playback volume between 0.0 and 1.0
-Since: 1.0
</return>
</function>
@@ -13113,6 +15257,7 @@ Since: 1.0
<description>
Gets the angle at which movements starts.
+Since: 0.6
</description>
<parameters>
@@ -13123,7 +15268,6 @@ Gets the angle at which movements starts.
</parameters>
<return> angle in degrees
-Since: 0.6
</return>
</function>
@@ -13168,21 +15312,52 @@ its allocated resources are freed.
<return></return>
</function>
-<function name="clutter_animation_get_timeline">
+<function name="clutter_box_layout_set_fill">
<description>
-Retrieves the #ClutterTimeline used by @animation
+Sets the horizontal and vertical fill policies for @actor
+inside @layout
+Since: 1.2
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
+</parameter_description>
+</parameter>
+<parameter name="x_fill">
+<parameter_description> whether @actor should fill horizontally the allocated space
+</parameter_description>
+</parameter>
+<parameter name="y_fill">
+<parameter_description> whether @actor should fill vertically the allocated space
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the timeline used by the animation
+<return></return>
+</function>
-Since: 1.0
+<function name="clutter_actor_get_opacity">
+<description>
+Retrieves the opacity value of an actor, as set by
+clutter_actor_set_opacity().
+
+For retrieving the absolute opacity of the actor inside a paint
+virtual function, see clutter_actor_get_paint_opacity().
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return> the opacity of the actor
</return>
</function>
@@ -13208,6 +15383,7 @@ Retrieves the line wrap mode used by the #ClutterText actor.
See clutter_text_set_line_wrap_mode ().
+Since: 1.0
</description>
<parameters>
@@ -13218,7 +15394,6 @@ See clutter_text_set_line_wrap_mode ().
</parameters>
<return> the wrap mode used by the #ClutterText
-Since: 1.0
</return>
</function>
@@ -13253,6 +15428,7 @@ Since: 0.6
<description>
Retrieves whether @media is seekable or not.
+Since: 0.2
</description>
<parameters>
@@ -13263,7 +15439,32 @@ Retrieves whether @media is seekable or not.
</parameters>
<return> %TRUE if @media can seek, %FALSE otherwise.
-Since: 0.2
+</return>
+</function>
+
+<function name="json_array_get_string_element">
+<description>
+Conveniently retrieves the string value of the element at @index_
+inside @array
+
+See also: json_array_get_element(), json_node_get_string()
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> the string value; the returned string is owned by
+the #JsonArray and should not be modified or freed
+
</return>
</function>
@@ -13284,28 +15485,45 @@ owned by the actor and should not be modified or freed.
</return>
</function>
-<function name="json_array_get_array_element">
+<function name="json_object_set_null_member">
<description>
-Conveniently retrieves the array from the element at @index_
-inside @array
+Convenience function for setting a null @value of
+ member_name inside @object.
-See also: json_array_get_element(), json_node_get_array()
+See also: json_object_set_member()
+Since: 0.8
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="member_name">
+<parameter_description> the name of the member
</parameter_description>
</parameter>
</parameters>
-<return> the array
+<return></return>
+</function>
+
+<function name="clutter_stage_get_use_alpha">
+<description>
+Retrieves the value set using clutter_stage_set_use_alpha()
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the stage should honour the opacity and the
+alpha channel of the stage color
-Since: 0.8
</return>
</function>
@@ -13325,6 +15543,7 @@ an easy way to animate a #ClutterActor and automatically manage the
lifetime of a #ClutterAnimation instance, so you should consider using
those functions instead of manually creating an animation.
+Since: 1.0
</description>
<parameters>
@@ -13332,24 +15551,52 @@ those functions instead of manually creating an animation.
<return> the newly created #ClutterAnimation. Use g_object_unref()
to release the associated resources
-Since: 1.0
</return>
</function>
-<function name="json_object_get_size">
+<function name="clutter_text_set_password_char">
<description>
-Retrieves the number of members of a #JsonObject.
+Sets the character to use in place of the actual text in a
+password text actor.
+
+If @wc is 0 the text will be displayed as it is entered in the
+#ClutterText actor.
+Since: 1.0
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="wc">
+<parameter_description> a Unicode character, or 0 to unset the password character
</parameter_description>
</parameter>
</parameters>
-<return> the number of members
-</return>
+<return></return>
+</function>
+
+<function name="clutter_animation_set_timeline">
+<description>
+Sets the #ClutterTimeline used by @animation.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline, or %NULL to unset the
+current #ClutterTimeline
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_interval_get_interval">
@@ -13383,72 +15630,60 @@ the interval
<return></return>
</function>
-<function name="clutter_model_set_names">
+<function name="clutter_animator_property_set_ease_in">
<description>
-Assigns a name to the columns of a #ClutterModel.
+Sets whether a property value is to be eased into the animation.
-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
+Since: 1.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="animator">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
-<parameter name="n_columns">
-<parameter_description> the number of column names
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
-<parameter name="names">
-<parameter_description> (array length=n_columns): an array of strings
+<parameter name="property_name">
+<parameter_description> the name of a property on object
+</parameter_description>
+</parameter>
+<parameter name="ease_in">
+<parameter_description> we are going to be easing in this property
</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_shader_get_vertex_source">
+<function name="clutter_actor_get_geometry">
<description>
-Query the current GLSL vertex source set on @shader.
-
+Gets the size and position of an actor relative to its parent
+actor. This is the same as calling clutter_actor_get_position() and
+clutter_actor_get_size(). It tries to "do what you mean" and get the
+requested size and position if the actor's allocation is invalid.
</description>
<parameters>
-<parameter name="shader">
-<parameter_description> a #ClutterShader
+<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> 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>
+<return></return>
</function>
<function name="clutter_child_meta_get_container">
<description>
Retrieves the container using @data
+Since: 0.8
</description>
<parameters>
@@ -13457,9 +15692,8 @@ Retrieves the container using @data
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterContainer
+<return> a #ClutterContainer
-Since: 0.8
</return>
</function>
@@ -13469,6 +15703,7 @@ This function is used to emit an event on the main stage.
You should rarely need to use this function, except for
synthetising events.
+Since: 0.6
</description>
<parameters>
@@ -13489,73 +15724,129 @@ synthetising events.
if the actor handled the event, or %FALSE if the event was
not handled
-Since: 0.6
</return>
</function>
-<function name="clutter_container_remove_valist">
+<function name="clutter_text_set_preedit_string">
<description>
-Alternative va_list version of clutter_container_remove().
+Sets, or unsets, the pre-edit string. This function is useful
+for input methods to display a string (with eventual specific
+Pango attributes) before it is entered inside the #ClutterText
+buffer.
-Since: 0.4
+The preedit string and attributes are ignored if the #ClutterText
+actor is not editable.
+
+This function should not be used by applications
+
+Since: 1.2
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="first_actor">
-<parameter_description> the first #ClutterActor to add
+<parameter name="preedit_str">
+<parameter_description> the pre-edit string, or %NULL to unset it
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> list of actors to remove, followed by %NULL
+<parameter name="preedit_attrs">
+<parameter_description> the pre-edit string attributes
+</parameter_description>
+</parameter>
+<parameter name="cursor_pos">
+<parameter_description> the cursor position for the pre-edit string
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_script_get_objects">
+<function name="clutter_actor_get_allocation_geometry">
<description>
-Retrieves a list of objects for the given names. After @script, object
-names/return location pairs should be listed, with a %NULL pointer
-ending the list, like:
-
-<informalexample><programlisting>
-GObject *my_label, *a_button, *main_timeline;
+Gets the layout box an actor has been assigned. The allocation can
+only be assumed valid inside a paint() method; anywhere else, it
+may be out-of-date.
-clutter_script_get_objects (script,
-"my-label", &my_label,
-"a-button", &a_button,
-"main-timeline", &main_timeline,
-NULL);
-</programlisting></informalexample>
+An allocation does not incorporate the actor's scale or anchor point;
+those transformations do not affect layout, only rendering.
-Note: This function does not increment the reference count of the
-returned objects.
+The returned rectangle is in pixels.
+Since: 0.8
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
-<parameter name="first_name">
-<parameter_description> the name of the first object to retrieve
+<parameter name="geom">
+<parameter_description> allocation geometry in pixels
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> return location for a #GObject, then additional names, ending
-with %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_pop_internal">
+<description>
+Disables the effects of clutter_actor_pop_internal()
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the number of objects returned.
+<return></return>
+</function>
+
+<function name="json_array_dup_element">
+<description>
+Retrieves a copy of the #JsonNode containing the value of the
+element at @index_ inside a #JsonArray
Since: 0.6
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the element to retrieve
+</parameter_description>
+</parameter>
+</parameters>
+<return> a copy of the #JsonNode at the requested index.
+Use json_node_free() when done.
+
+</return>
+</function>
+
+<function name="clutter_text_get_attributes">
+<description>
+Gets the attribute list that was set on the #ClutterText actor
+clutter_text_set_attributes(), if any.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> the attribute list, or %NULL if none was set. The
+returned value is owned by the #ClutterText and should not be unreferenced.
+
</return>
</function>
@@ -13614,6 +15905,22 @@ Since: 0.6
<return></return>
</function>
+<function name="json_array_unref">
+<description>
+Decreases by one the reference count of a #JsonArray. If the
+reference count reaches zero, the array is destroyed and all
+its allocated resources are freed.
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #JsonArray
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_color_shade">
<description>
Shades @color by @factor and saves the modified color into @result.
@@ -13629,27 +15936,32 @@ Shades @color by @factor and saves the modified color into @result.
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> (out): return location for the shaded color
+<parameter_description> return location for the shaded color
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_ungrab_pointer_for_device">
+<function name="clutter_color_hash">
<description>
-Removes an existing grab of the pointer events for device @id.
+Converts a #ClutterColor to a hash value.
-Since: 0.8
+This function can be passed to g_hash_table_new() as the @hash_func
+parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="id">
-<parameter_description> a device id
+<parameter name="v">
+<parameter_description> a #ClutterColor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a hash value corresponding to the color
+
+</return>
</function>
<function name="clutter_value_set_shader_int">
@@ -13677,28 +15989,52 @@ Since: 0.8
<return></return>
</function>
-<function name="CLUTTER_ACTOR_IS_MAPPED">
+<function name="clutter_model_insert_value">
<description>
-Evaluates to %TRUE if the %CLUTTER_ACTOR_MAPPED flag is set.
+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.
-Means "the actor will be painted if the stage is mapped."
+Since: 0.6
-%TRUE if the actor is visible; and all parents with possible exception
-of the stage are visible; and an ancestor of the actor is a toplevel.
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> position of the row to modify
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> column to modify
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> new value for the cell
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-Clutter auto-maintains the mapped flag whenever actors are
-reparented or shown/hidden.
+<function name="clutter_alpha_get_timeline">
+<description>
+Gets the #ClutterTimeline bound to @alpha.
Since: 0.2
</description>
<parameters>
-<parameter name="a">
-<parameter_description> a #ClutterActor
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #ClutterTimeline instance
+
+</return>
</function>
<function name="json_object_set_int_member">
@@ -13752,30 +16088,6 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_behaviour_ellipse_set_center">
-<description>
-Sets the center of the elliptical path to the point represented by knot.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> x coordinace of centre
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> y coordinace of centre
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_animation_unbind_property">
<description>
Removes @property_name from the list of animated properties.
@@ -13796,66 +16108,35 @@ Since: 1.0
<return></return>
</function>
-<function name="ClutterScore">
-<description>
-The ::paused signal is emitted each time a #ClutterScore
-is paused.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="score">
-<parameter_description> the score which received the signal
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_alpha_new_full">
+<function name="clutter_stage_get_minimum_size">
<description>
-Creates a new #ClutterAlpha instance and sets the timeline
-and animation mode.
+Retrieves the minimum size for a stage window as set using
+clutter_stage_set_minimum_size().
-See also clutter_alpha_set_timeline() and clutter_alpha_set_mode().
+The returned size may not correspond to the actual minimum size and
+it is specific to the #ClutterStage implementation inside the
+Clutter backend
+Since: 1.2
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> #ClutterTimeline timeline
+<parameter name="stage">
+<parameter_description> a #ClutterStage
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> animation mode
+<parameter name="width">
+<parameter_description> return location for the minimum width, in pixels,
+or %NULL
</parameter_description>
</parameter>
-</parameters>
-<return> the newly created #ClutterAlpha
-
-Since: 1.0
-</return>
-</function>
-
-<function name="clutter_stage_get_title">
-<description>
-Gets the stage title.
-
-
-</description>
-<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="height">
+<parameter_description> return location for the minimum height, in pixels,
+or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> pointer to the title string for the stage. The
-returned string is owned by the actor and should not
-be modified or freed.
-
-Since: 0.4
-</return>
+<return></return>
</function>
<function name="clutter_model_append">
@@ -13888,25 +16169,28 @@ Since: 0.6
<return></return>
</function>
-<function name="CLUTTER_ACTOR_IS_VISIBLE">
+<function name="clutter_bin_layout_new">
<description>
-Evaluates to %TRUE if the actor has been shown, %FALSE if it's hidden.
-Equivalent to the ClutterActor::visible object property.
-
-Note that an actor is only painted onscreen if it's mapped, which
-means it's visible, and all its parents are visible, and one of the
-parents is a toplevel stage.
+Creates a new #ClutterBinLayout layout manager
-Since: 0.2
+Since: 1.2
</description>
<parameters>
-<parameter name="a">
-<parameter_description> a #ClutterActor
+<parameter name="x_align">
+<parameter_description> the default alignment policy to be used on the
+horizontal axis
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> the default alignment policy to be used on the
+vertical axis
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created layout manager
+
+</return>
</function>
<function name="clutter_grab_pointer_for_device">
@@ -13931,34 +16215,46 @@ Since: 0.8
<return></return>
</function>
-<function name="json_parser_new">
+<function name="clutter_text_set_color">
<description>
-Creates a new #JsonParser instance. You can use the #JsonParser to
-load a JSON stream from either a file or a buffer and then walk the
-hierarchy using the data types API.
+Sets the color of the contents of a #ClutterText actor.
+The overall opacity of the #ClutterText actor will be the
+result of the alpha value of @color and the composited
+opacity of the actor itself on the scenegraph, as returned
+by clutter_actor_get_paint_opacity().
+
+Since: 1.0
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #JsonParser. Use g_object_unref()
-to release all the memory it allocates.
-</return>
+<return></return>
</function>
-<function name="cogl_util_next_p2">
+<function name="clutter_flow_layout_get_orientation">
<description>
-Calculates the next power greater than @a.
+Retrieves the orientation of the @layout
+Since: 1.2
</description>
<parameters>
-<parameter name="a">
-<parameter_description> Value to get the next power
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
</parameters>
-<return> The next power after @a.
+<return> the orientation of the #ClutterFlowLayout
+
</return>
</function>
@@ -13994,7 +16290,7 @@ the actors natural size request will be returned.
If you care whether you get the request vs. the allocation, you
should probably call a different function like
-clutter_actor_get_allocation_coords() or
+clutter_actor_get_allocation_box() or
clutter_actor_get_preferred_width().
Since: 0.2
@@ -14021,6 +16317,7 @@ Since: 0.2
<description>
Creates a #GParamSpec for properties using #ClutterColor.
+Since: 0.8.4
</description>
<parameters>
@@ -14047,342 +16344,170 @@ Creates a #GParamSpec for properties using #ClutterColor.
</parameters>
<return> the newly created #GParamSpec
-Since: 0.8.4
</return>
</function>
-<function name="ClutterBindingPool">
-<description>
-The unique name of the #ClutterBindingPool.
-
-Since: 1.0
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_group_get_nth_child">
+<function name="json_object_get_size">
<description>
-Gets a groups child held at @index_ in stack.
+Retrieves the number of members of a #JsonObject.
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterGroup
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> the position of the requested actor.
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): A Clutter actor, or %NULL if
- index_ is invalid.
-
-Since: 0.2
+<return> the number of members
</return>
</function>
-<function name="json_node_set_int">
+<function name="clutter_stage_set_title">
<description>
-Sets @value as the integer content of the @node, replacing any existing
-content.
+Sets the stage title.
+
+Since: 0.4
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="stage">
+<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> an integer value
+<parameter name="title">
+<parameter_description> A utf8 string for the stage windows title.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_animate">
+<function name="clutter_media_get_subtitle_uri">
<description>
-Animates the given list of properties of @actor between the current
-value for each property and a new final value. The animation has a
-definite duration and a speed given by the @mode.
-
-For example, this:
-
-|[
-clutter_actor_animate (rectangle, CLUTTER_LINEAR, 250,
-"width", 100,
-"height", 100,
-NULL);
-]|
-
-will make width and height properties of the #ClutterActor "rectangle"
-grow linearly between the current value and 100 pixels, in 250 milliseconds.
-
-The animation @mode is a logical id, either from the #ClutterAnimationMode
-enumeration of from clutter_alpha_register_func().
-
-All the properties specified will be animated between the current value
-and the final value. If a property should be set at the beginning of
-the animation but not updated during the animation, it should be prefixed
-by the "fixed::" string, for instance:
-
-|[
-clutter_actor_animate (actor, CLUTTER_EASE_IN, 100,
-"rotation-angle-z", 360,
-"fixed::rotation-center-z", &center,
-NULL);
-]|
-
-Will animate the "rotation-angle-z" property between the current value
-and 360 degrees, and set the "rotation-center-z" property to the fixed
-value of the #ClutterVertex "center".
-
-This function will implicitly create a #ClutterAnimation object which
-will be assigned to the @actor and will be returned to the developer
-to control the animation or to know when the animation has been
-completed.
-
-If a name argument starts with "signal::", "signal-after::" or
-"signal-swapped::" the two following arguments are used as callback
-function and data for a signal handler installed on the
-#ClutterAnimation object for the specified signal name, for
-instance:
-
-|[
-
-static void
-on_animation_completed (ClutterAnimation *animation,
-ClutterActor *actor)
-{
-clutter_actor_hide (actor);
-}
-
-clutter_actor_animate (actor, CLUTTER_EASE_IN, 100,
-"opacity", 0,
-"signal::completed", on_animation_completed, actor,
-NULL);
-]|
-
-The "signal::" modifier is the equivalent of using g_signal_connect();
-the "signal-after::" modifier is the equivalent of using
-g_signal_connect_after(); the "signal-swapped::" modifier is the equivalent
-of using g_signal_connect_swapped(). The clutter_actor_animate() function
-will not keep track of multiple connections to the same signal, so it is
-your responsability to avoid them when calling clutter_actor_animate()
-multiple times on the same actor.
-
-Calling this function on an actor that is already being animated
-will cause the current animation to change with the new final values,
-the new easing mode and the new duration - that is, this code:
-
-|[
-clutter_actor_animate (actor, CLUTTER_LINEAR, 250,
-"width", 100,
-"height", 100,
-NULL);
-clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
-"x", 100,
-"y", 100,
-"width", 200,
-NULL);
-]|
-
-is the equivalent of:
-
-|[
-clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
-"x", 100,
-"y", 100,
-"width", 200,
-"height", 100,
-NULL);
-]|
-
-<note>Unless the animation is looping, the #ClutterAnimation created by
-clutter_actor_animate() will become invalid as soon as it is
-complete.</note>
-
-Since the created #ClutterAnimation instance attached to @actor
-is guaranteed to be valid throughout the #ClutterAnimation::completed
-signal emission chain, you will not be able to create a new animation
-using clutter_actor_animate() on the same @actor from within the
-#ClutterAnimation::completed signal handler unless you use
-g_signal_connect_after() to connect the callback function, for instance:
-
-|[
-static void
-on_animation_completed (ClutterAnimation *animation,
-ClutterActor *actor)
-{
-clutter_actor_animate (actor, CLUTTER_EASE_OUT_CUBIC, 250,
-"x", 500,
-"y", 500,
-NULL);
-}
-
-...
-animation = clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 250,
-"x", 100,
-"y", 100,
-NULL);
-g_signal_connect (animation, "completed",
-G_CALLBACK (on_animation_completed),
-actor);
-...
-]|
+Retrieves the URI of the subtitle file in use.
+Since: 1.2
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="mode">
-<parameter_description> an animation mode logical id
-</parameter_description>
-</parameter>
-<parameter name="duration">
-<parameter_description> duration of the animation, in milliseconds
-</parameter_description>
-</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of a property
-</parameter_description>
-</parameter>
-<parameter name="VarArgs">
-<parameter_description> a %NULL terminated list of property names and
-property values
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation object. The object is
-owned by the #ClutterActor and should not be unreferenced with
-g_object_unref()
+<return> the URI of the subtitle file. Use g_free()
+to free the returned string
-Since: 1.0
</return>
</function>
-<function name="clutter_stage_set_title">
+<function name="clutter_behaviour_ellipse_set_height">
<description>
-Sets the stage title.
+Sets the height of the elliptical path.
Since: 0.4
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="self">
+<parameter_description> a #ClutterBehaviourEllipse
</parameter_description>
</parameter>
-<parameter name="title">
-<parameter_description> A utf8 string for the stage windows title.
+<parameter name="height">
+<parameter_description> height of the ellipse
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_model_iter_get_value">
+<function name="clutter_rectangle_set_border_color">
<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
+Sets the color of the border used by @rectangle using @color
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
-</parameter_description>
-</parameter>
-<parameter name="column">
-<parameter_description> column number to retrieve the value from
+<parameter name="rectangle">
+<parameter_description> a #ClutterRectangle
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> an empty #GValue to set
+<parameter name="color">
+<parameter_description> the color of the border
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_node_type_name">
+<function name="clutter_shader_new">
<description>
-Retrieves the user readable name of the data type contained by @node.
+Create a new #ClutterShader instance.
+Since: 0.6
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
-</parameter_description>
-</parameter>
</parameters>
-<return> a string containing the name of the type. The returned string
-is owned by the node and should never be modified or freed
+<return> a new #ClutterShader.
+
</return>
</function>
-<function name="clutter_rectangle_set_border_color">
+<function name="clutter_feature_get_all">
<description>
-Sets the color of the border used by @rectangle using @color
+Returns all the supported features.
+
+Since: 0.1.1
</description>
<parameters>
-<parameter name="rectangle">
-<parameter_description> a #ClutterRectangle
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> the color of the border
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a logical OR of all the supported features.
+
+</return>
</function>
-<function name="clutter_shader_new">
+<function name="clutter_actor_create_pango_context">
<description>
-Create a new #ClutterShader instance.
+Creates a #PangoContext for the given actor. The #PangoContext
+is already configured using the appropriate font map, resolution
+and font options.
+See also clutter_actor_get_pango_context().
+
+Since: 1.0
</description>
<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #ClutterShader.
+<return> the newly created #PangoContext. Use g_object_unref()
+on the returned value to deallocate its resources
-Since: 0.6
</return>
</function>
-<function name="clutter_alpha_set_mode">
+<function name="clutter_media_get_uri">
<description>
-Sets the progress function of @alpha using the symbolic value
-of @mode, as taken by the #ClutterAnimationMode enumeration or
-using the value returned by clutter_alpha_register_func().
+Retrieves the URI from @media.
-Since: 1.0
+Since: 0.2
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
-</parameter_description>
-</parameter>
-<parameter name="mode">
-<parameter_description> a #ClutterAnimationMode
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the URI of the media stream. Use g_free()
+to free the returned string
+
+</return>
</function>
<function name="clutter_actor_queue_redraw">
@@ -14410,41 +16535,32 @@ Also be aware that painting is a NOP for actors with an opacity of
<return></return>
</function>
-<function name="clutter_container_class_find_child_property">
+<function name="clutter_threads_add_timeout">
<description>
-Looks up the #GParamSpec for a child property of @klass.
+Simple wrapper around clutter_threads_add_timeout_full().
+Since: 0.4
</description>
<parameters>
-<parameter name="klass">
-<parameter_description> a #GObjectClass implementing the #ClutterContainer interface.
+<parameter name="interval">
+<parameter_description> the time between calls to the function, in milliseconds
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> a property name.
+<parameter name="func">
+<parameter_description> function to call
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The #GParamSpec for the property or %NULL
-if no such property exist.
+<return> the ID (greater than 0) of the event source.
-Since: 0.8
</return>
</function>
-<function name="ClutterClone">
-<description>
-This property specifies the source actor being cloned.
-
-Since: 1.0
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_behaviour_path_set_path">
<description>
Change the path that the actors will follow. This will take the
@@ -14471,6 +16587,7 @@ Since: 1.0
<description>
Retrieves the flags set on @self
+Since: 1.0
</description>
<parameters>
@@ -14481,64 +16598,37 @@ Retrieves the flags set on @self
</parameters>
<return> a bitwise or of #ClutterActorFlags or 0
-Since: 1.0
</return>
</function>
-<function name="clutter_frame_source_add_full">
+<function name="clutter_text_set_selection_bound">
<description>
-Sets a function to be called at regular intervals with the given
-priority. The function is called repeatedly until it returns
-%FALSE, at which point the timeout is automatically destroyed and
-the function will not be called again. The @notify function is
-called when the timeout is destroyed. The first call to the
-function will be at the end of the first @interval.
+Sets the other end of the selection, starting from the current
+cursor position.
-This function is similar to g_timeout_add_full() except that it
-will try to compensate for delays. For example, if @func takes half
-the interval time to execute then the function will be called again
-half the interval time after it finished. In contrast
-g_timeout_add_full() would not fire until a full interval after the
-function completes so the delay between calls would be 1.0 / @fps *
-1.5. This function does not however try to invoke the function
-multiple times to catch up missing frames if @func takes more than
- interval ms to execute.
+If @selection_bound is -1, the selection unset.
+Since: 1.0
</description>
<parameters>
-<parameter name="priority">
-<parameter_description> the priority of the frame source. Typically this will be in the
-range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
-</parameter_description>
-</parameter>
-<parameter name="fps">
-<parameter_description> the number of times per second to call the function
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> function to call
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to the function
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> function to call when the timeout source is removed
+<parameter name="selection_bound">
+<parameter_description> the position of the end of the selection, in characters
</parameter_description>
</parameter>
</parameters>
-<return> the ID (greater than 0) of the event source.
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_texture_set_from_rgb_data">
<description>
Sets #ClutterTexture image data.
+Since: 0.4.
</description>
<parameters>
@@ -14582,55 +16672,34 @@ depending on @has_alpha)
</parameters>
<return> %TRUE on success, %FALSE on failure.
-Since: 0.4.
</return>
</function>
-<function name="clutter_container_add">
+<function name="clutter_text_set_line_alignment">
<description>
-Adds a list of #ClutterActor<!-- -->s to @container. Each time and
-actor is added, the "actor-added" signal is emitted. Each actor should
-be parented to @container, which takes a reference on the actor. You
-cannot add a #ClutterActor to more than one #ClutterContainer.
+Sets the way that the lines of a wrapped label are aligned with
+respect to each other. This does not affect the overall alignment
+of the label within its allocated or specified width.
-Since: 0.4
+To align a #ClutterText actor you should add it to a container
+that supports alignment, or use the anchor point.
+
+Since: 1.0
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
-</parameter_description>
-</parameter>
-<parameter name="first_actor">
-<parameter_description> the first #ClutterActor to add
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> %NULL terminated list of actors to add
+<parameter name="alignment">
+<parameter_description> A #PangoAlignment
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_event_get_state">
-<description>
-Retrieves the modifier state of the event.
-
-
-</description>
-<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
-</parameter_description>
-</parameter>
-</parameters>
-<return> the modifier state parameter, or 0
-
-Since: 0.4
-</return>
-</function>
-
<function name="clutter_stage_set_use_fog">
<description>
Sets whether the depth cueing effect on the stage should be enabled
@@ -14658,26 +16727,78 @@ Since: 0.6
<return></return>
</function>
-<function name="json_node_dup_object">
+<function name="clutter_animator_property_get_interpolation">
<description>
-Retrieves the #JsonObject inside @node. The reference count of
-the returned object is increased.
+Get the interpolation used by animator for a property on a particular
+object.
+Since: 1.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="animator">
+<parameter_description> a #ClutterAnimatorKey
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> the name of a property on object
</parameter_description>
</parameter>
</parameters>
-<return> the #JsonObject
+<return> a ClutterInterpolation value.
+</return>
+</function>
+
+<function name="clutter_shader_set_fragment_source">
+<description>
+Sets the GLSL source code to be used by a #ClutterShader for the fragment
+program.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="shader">
+<parameter_description> a #ClutterShader
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> GLSL source code.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of source buffer (currently ignored)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_box_layout_get_easing_mode">
+<description>
+Retrieves the easing mode set using clutter_box_layout_set_easing_mode()
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+</parameters>
+<return> an easing mode
+
</return>
</function>
<function name="clutter_actor_unmap">
<description>
-Unsets the #CLUTTER_ACTOR_MAPPED flag on the actor and possibly
+Unsets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly
unmaps its children if they were mapped.
Calling this is allowed in only one case: you are implementing the
@@ -14717,27 +16838,6 @@ Creates a new #ClutterEvent of the specified type.
</return>
</function>
-<function name="ClutterStageManager">
-<description>
-The ::stage-removed signal is emitted each time a #ClutterStage
-has been removed from the stage manager.
-
-Since: 0.8
-
-</description>
-<parameters>
-<parameter name="stage_manager">
-<parameter_description> the object which received the signal
-</parameter_description>
-</parameter>
-<parameter name="stage">
-<parameter_description> the removed stage
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="json_object_set_array_member">
<description>
Convenience function for setting an array @value of
@@ -14767,35 +16867,6 @@ Since: 0.8
<return></return>
</function>
-<function name="ClutterActor">
-<description>
-The ::allocation-changed signal is emitted when the
-#ClutterActor:allocation property changes. Usually, application
-code should just use the notifications for the :allocation property
-but if you want to track the allocation flags as well, for instance
-to know whether the absolute origin of @actor changed, then you might
-want use this signal instead.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="actor">
-<parameter_description> the #ClutterActor that emitted the signal
-</parameter_description>
-</parameter>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox with the new allocation
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #ClutterAllocationFlags for the allocation
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_path_add_string">
<description>
Adds new nodes to the end of the path as described in @str. The
@@ -14838,6 +16909,7 @@ M 250,350 l 0 -100 L 350,250 l 0 100 z
If the path description isn't valid %FALSE will be returned and no
nodes will be added.
+Since: 1.0
</description>
<parameters>
@@ -14853,7 +16925,40 @@ nodes will be added.
<return> %TRUE is the path description was valid or %FALSE
otherwise.
-Since: 1.0
+</return>
+</function>
+
+<function name="clutter_script_load_from_data">
+<description>
+Loads the definitions from @data into @script and merges with
+the currently loaded ones, if any.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a #ClutterScript
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a buffer containing the definitions
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the buffer, or -1 if @data is a NUL-terminated
+buffer
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> on error, zero is returned and @error is set
+accordingly. On success, the merge id for the UI definitions is
+returned. You can use the merge id with clutter_script_unmerge().
+
</return>
</function>
@@ -14864,6 +16969,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -14878,12 +16984,14 @@ See also: json_object_get_member()
</parameters>
<return> the integer value of the object's member
-Since: 0.8
</return>
</function>
<function name="clutter_x11_texture_pixmap_new_with_pixmap">
<description>
+Creates a new #ClutterX11TexturePixmap for @pixmap
+
+Since: 0.8
</description>
<parameters>
@@ -14894,7 +17002,6 @@ Since: 0.8
</parameters>
<return> A new #ClutterX11TexturePixmap bound to the given X Pixmap
-Since 0.8
</return>
</function>
@@ -14902,6 +17009,7 @@ Since 0.8
<description>
Gets the tilt of the ellipse around the center in the given axis.
+Since: 0.4
</description>
<parameters>
@@ -14916,7 +17024,6 @@ Gets the tilt of the ellipse around the center in the given axis.
</parameters>
<return> angle in degrees.
-Since: 0.4
</return>
</function>
@@ -14926,6 +17033,8 @@ Sets @stage as the default stage.
Since: 0.8
+Deprecated: 1.2: Calling this function has no effect
+
</description>
<parameters>
<parameter name="stage_manager">
@@ -14940,140 +17049,95 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_timeline_set_delay">
+<function name="clutter_interval_set_final_value">
<description>
-Sets the delay, in milliseconds, before @timeline should start.
+Sets the final value of @interval to @value. The value is
+copied inside the #ClutterInterval.
-Since: 0.4
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="msecs">
-<parameter_description> delay in milliseconds
+<parameter name="value">
+<parameter_description> a #GValue
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_actor_get_anchor_point_gravity">
+<function name="clutter_timeline_set_delay">
<description>
-Retrieves the anchor position expressed as a #ClutterGravity. If
-the anchor point was specified using pixels or units this will
-return %CLUTTER_GRAVITY_NONE.
+Sets the delay, in milliseconds, before @timeline should start.
+Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
+</parameter_description>
+</parameter>
+<parameter name="msecs">
+<parameter_description> delay in milliseconds
</parameter_description>
</parameter>
</parameters>
-<return> the #ClutterGravity used by the anchor point
-
-Since: 1.0
-</return>
+<return></return>
</function>
-<function name="clutter_model_iter_prev">
+<function name="clutter_timeline_pause">
<description>
-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.
-
+Pauses the #ClutterTimeline on current frame
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): The passed iterator, updated to point at the previous
-row in the model.
-
-Since: 0.6
-</return>
+<return></return>
</function>
-<function name="clutter_actor_box_get_origin">
+<function name="clutter_actor_set_position">
<description>
-Retrieves the origin of @box
+Sets the actor's fixed position in pixels relative to any parent
+actor.
-Since: 1.0
+If a layout manager is in use, this position will override the
+layout manager and force a fixed position.
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="self">
+<parameter_description> A #ClutterActor
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> (out): return location for the X coordinate, or %NULL
+<parameter_description> New left position of actor in pixels.
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> (out): return location for the Y coordinate, or %NULL
+<parameter_description> New top position of actor in pixels.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_path_get_length">
-<description>
-Retrieves an approximation of the total length of the path.
-
-
-</description>
-<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-</parameters>
-<return> the length of the path.
-
-Since: 1.0
-</return>
-</function>
-
-<function name="clutter_texture_get_pixel_format">
-<description>
-Retrieves the pixel format used by @texture. This is
-equivalent to:
-
-|[
-handle = clutter_texture_get_pixel_format (texture);
-
-if (handle != COGL_INVALID_HANDLE)
-format = cogl_texture_get_format (handle);
-]|
-
-
-</description>
-<parameters>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #CoglPixelFormat value
-
-Since: 1.0
-</return>
-</function>
-
<function name="clutter_actor_set_height">
<description>
Forces a height on an actor, causing the actor's preferred width
and height (if any) to be ignored.
+If @height is -1 the actor will use its preferred height instead of
+overriding it, i.e. you can "unset" the height with -1.
+
This function sets both the minimum and natural size of the actor.
since: 0.2
@@ -15085,47 +17149,30 @@ since: 0.2
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> Requested new height for the actor, in pixels
+<parameter_description> Requested new height for the actor, in pixels, or -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="json_array_add_array_element">
+<function name="clutter_texture_get_cogl_material">
<description>
-Conveniently adds an array into @array. The @array takes ownership
-of the newly added #JsonArray
+Returns a handle to the underlying COGL material used for drawing
+the actor. No extra reference is taken so if you need to keep the
+handle then you should call cogl_handle_ref() on it.
-See also: json_array_add_element(), json_node_take_array()
+Since: 1.0
-Since: 0.8
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #JsonArray
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="clutter_stage_manager_get_default">
-<description>
-Return value: (transfer none): the default stage manager instance. The returned
-
-</description>
-<parameters>
-</parameters>
-<return> (transfer none): the default stage manager instance. The returned
-object is owned by Clutter and you should not reference or unreference it.
-
-Since: 0.8
+<return> COGL material handle
</return>
</function>
@@ -15145,108 +17192,75 @@ Retrieves the line currently parsed, starting from 1.
</return>
</function>
-<function name="clutter_texture_new_from_actor">
+<function name="clutter_behaviour_is_applied">
<description>
-Creates a new #ClutterTexture object with its source a prexisting
-actor (and associated children). The textures content will contain
-'live' redirected output of the actors scene.
-
-Note this function is intented as a utility call for uniformly applying
-shaders to groups and other potential visual effects. It requires that
-the %CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend
-and the target system.
-
-Some tips on usage:
-
-<itemizedlist>
-<listitem>
-<para>The source actor must be made visible (i.e by calling
-#clutter_actor_show).</para>
-</listitem>
-<listitem>
-<para>The source actor must have a parent in order for it to be
-allocated a size from the layouting mechanism. If the source
-actor does not have a parent when this function is called then
-the ClutterTexture will adopt it and allocate it at its
-preferred size. Using this you can clone an actor that is
-otherwise not displayed. Because of this feature if you do
-intend to display the source actor then you must make sure that
-the actor is parented before calling
-clutter_texture_new_from_actor() or that you unparent it before
-adding it to a container.</para>
-</listitem>
-<listitem>
-<para>When getting the image for the clone texture, Clutter
-will attempt to render the source actor exactly as it would
-appear if it was rendered on screen. The source actor's parent
-transformations are taken into account. Therefore if your
-source actor is rotated along the X or Y axes so that it has
-some depth, the texture will appear differently depending on
-the on-screen location of the source actor. While painting the
-source actor, Clutter will set up a temporary asymmetric
-perspective matrix as the projection matrix so that the source
-actor will be projected as if a small section of the screen was
-being viewed. Before version 0.8.2, an orthogonal identity
-projection was used which meant that the source actor would be
-clipped if any part of it was not on the zero Z-plane.</para>
-</listitem>
-<listitem>
-<para>Avoid reparenting the source with the created texture.</para>
-</listitem>
-<listitem>
-<para>A group can be padded with a transparent rectangle as to
-provide a border to contents for shader output (blurring text
-for example).</para>
-</listitem>
-<listitem>
-<para>The texture will automatically resize to contain a further
-transformed source. However, this involves overhead and can be
-avoided by placing the source actor in a bounding group
-sized large enough to contain any child tranformations.</para>
-</listitem>
-<listitem>
-<para>Uploading pixel data to the texture (e.g by using
-clutter_actor_set_from_file()) will destroy the offscreen texture data
-and end redirection.</para>
-</listitem>
-<listitem>
-<para>cogl_texture_get_data() with the handle returned by
-clutter_texture_get_cogl_texture() can be used to read the
-offscreen texture pixels into a pixbuf.</para>
-</listitem>
-</itemizedlist>
+Check if @behave applied to @actor.
+Since: 0.4
</description>
<parameters>
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
+</parameter_description>
+</parameter>
<parameter name="actor">
-<parameter_description> A source #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #ClutterTexture object, or %NULL on failure.
+<return> TRUE if actor has behaviour. FALSE otherwise.
-Since: 0.6
</return>
</function>
-<function name="json_object_set_null_member">
+<function name="json_generator_to_file">
<description>
-Convenience function for setting a null @value of
- member_name inside @object.
+Creates a JSON data stream and puts it inside @filename, overwriting the
+current file contents. This operation is atomic.
-See also: json_object_set_member()
+
+</description>
+<parameters>
+<parameter name="generator">
+<parameter_description> a #JsonGenerator
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> path to the target file
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if saving was successful.
+</return>
+</function>
+
+<function name="clutter_container_child_set_property">
+<description>
+Sets a container-specific property on a child of @container.
Since: 0.8
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the member
+<parameter name="child">
+<parameter_description> a #ClutterActor that is a child of @container.
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the name of the property to set.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value.
</parameter_description>
</parameter>
</parameters>
@@ -15278,6 +17292,7 @@ Since: 0.6
Gets whether the current iterator is at the beginning of the model
to which it belongs.
+Since: 0.6
</description>
<parameters>
@@ -15288,77 +17303,62 @@ to which it belongs.
</parameters>
<return> #TRUE if @iter is the first iter in the filtered model
-Since: 0.6
</return>
</function>
-<function name="clutter_actor_get_preferred_size">
+<function name="clutter_animator_set_duration">
<description>
-Computes the preferred minimum and natural size of an actor, taking into
-account the actor's geometry management (either height-for-width
-or width-for-height).
-
-The width and height used to compute the preferred height and preferred
-width are the actor's natural ones.
+Runs the timeline of the #ClutterAnimator with a duration in msecs
+as specified.
-If you need to control the height for the preferred width, or the width for
-the preferred height, you should use clutter_actor_get_preferred_width()
-and clutter_actor_get_preferred_height(), and check the actor's preferred
-geometry management using the #ClutterActor:request-mode property.
-
-Since: 0.8
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="min_width_p">
-<parameter_description> (out) (allow-none): return location for the minimum width, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="min_height_p">
-<parameter_description> (out) (allow-none): return location for the minimum height, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_width_p">
-<parameter_description> (out) (allow-none): return location for the natural width, or %NULL
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
-<parameter name="natural_height_p">
-<parameter_description> (out) (allow-none): return location for the natural height, or %NULL
+<parameter name="duration">
+<parameter_description> milliseconds a run of the animator should last.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_event_free">
+<function name="clutter_input_device_get_device_name">
<description>
-Frees all resources used by @event.
+Retrieves the name of the @device
+
+Since: 1.2
</description>
<parameters>
-<parameter name="event">
-<parameter_description> A #ClutterEvent.
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the name of the device, or %NULL. The returned string
+is owned by the #ClutterInputDevice and should never be modified
+or freed
+
+</return>
</function>
-<function name="clutter_feature_get_all">
+<function name="clutter_event_free">
<description>
-Return value: a logical OR of all the supported features.
+Frees all resources used by @event.
</description>
<parameters>
+<parameter name="event">
+<parameter_description> A #ClutterEvent.
+</parameter_description>
+</parameter>
</parameters>
-<return> a logical OR of all the supported features.
-
-Since: 0.1.1
-</return>
+<return></return>
</function>
<function name="clutter_text_set_cursor_position">
@@ -15395,98 +17395,47 @@ Retrieves the top level node from the parsed JSON stream.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the root #JsonNode . The returned node
+<return> the root #JsonNode . The returned node
is owned by the #JsonParser and should never be modified or freed.
</return>
</function>
-<function name="clutter_backend_set_double_click_time">
-<description>
-Sets the maximum time between two button press events, used to
-verify whether it's a double click event or not.
-
-Since: 0.4
-
-</description>
-<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
-</parameter_description>
-</parameter>
-<parameter name="msec">
-<parameter_description> milliseconds between two button press events
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_script_load_from_data">
+<function name="clutter_event_get_related">
<description>
-Loads the definitions from @data into @script and merges with
-the currently loaded ones, if any.
+Retrieves the related actor of a crossing event.
+Since: 1.0
</description>
<parameters>
-<parameter name="script">
-<parameter_description> a #ClutterScript
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a buffer containing the definitions
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of the buffer, or -1 if @data is a NUL-terminated
-buffer
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="event">
+<parameter_description> a #ClutterEvent of type %CLUTTER_ENTER or of
+type %CLUTTER_LEAVE
</parameter_description>
</parameter>
</parameters>
-<return> on error, zero is returned and @error is set
-accordingly. On success, the merge id for the UI definitions is
-returned. You can use the merge id with clutter_script_unmerge().
+<return> the related #ClutterActor, or %NULL
-Since: 0.6
</return>
</function>
-<function name="clutter_actor_set_clip">
+<function name="clutter_actor_box_copy">
<description>
-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.
+Copies @box
-Since: 0.6
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="xoff">
-<parameter_description> X offset of the clip rectangle
-</parameter_description>
-</parameter>
-<parameter name="yoff">
-<parameter_description> Y offset of the clip rectangle
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> Width of the clip rectangle
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> Height of the clip rectangle
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a newly allocated copy of #ClutterActorBox. Use
+clutter_actor_box_free() to free the allocated resources
+
+</return>
</function>
<function name="clutter_script_connect_signals">
@@ -15538,22 +17487,6 @@ effect.
<return></return>
</function>
-<function name="clutter_actor_get_parent">
-<description>
-Retrieves the parent of @self.
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-</parameters>
-<return> (transfer none): The #ClutterActor parent, or %NULL if no parent is set
-</return>
-</function>
-
<function name="clutter_stage_get_fog">
<description>
Retrieves the current depth cueing settings from the stage.
@@ -15574,60 +17507,98 @@ Since: 0.6
<return></return>
</function>
-<function name="ClutterTexture">
+<function name="clutter_flow_layout_new">
<description>
-The ::load-finished signal is emitted when a texture load has
-completed. If there was an error during loading, @error will
-be set, otherwise it will be %NULL
+Creates a new #ClutterFlowLayout with the given @orientation
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="orientation">
+<parameter_description> the orientation of the flow layout
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #ClutterFlowLayout
+
+</return>
+</function>
+
+<function name="clutter_interval_compute_value">
+<description>
+Computes the value between the @interval boundaries given the
+progress @factor and puts it into @value.
Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> the texture which received the signal
+<parameter name="interval">
+<parameter_description> a #ClutterInterval
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> A set error, or %NULL
+<parameter name="factor">
+<parameter_description> the progress factor, between 0 and 1
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> return location for an initialized #GValue
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the operation was successful
+
+</return>
</function>
-<function name="clutter_timeline_set_loop">
+<function name="clutter_actor_get_rotation">
<description>
-Sets whether @timeline should loop.
+Retrieves the angle and center of rotation on the given axis,
+set using clutter_actor_set_rotation().
+
+Since: 0.8
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
-<parameter name="loop">
-<parameter_description> %TRUE for enable looping
+<parameter name="axis">
+<parameter_description> the axis of rotation
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> return value for the X coordinate of the center of rotation
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> return value for the Y coordinate of the center of rotation
+</parameter_description>
+</parameter>
+<parameter name="z">
+<parameter_description> return value for the Z coordinate of the center of rotation
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the angle of rotation
+
+</return>
</function>
-<function name="cogl_pango_font_map_set_resolution">
+<function name="clutter_timeline_set_loop">
<description>
-Sets the resolution to be used by @font_map at @dpi.
-
-Since: 1.0
+Sets whether @timeline should loop.
</description>
<parameters>
-<parameter name="font_map">
-<parameter_description> a #CoglPangoFontMap
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
-<parameter name="dpi">
-<parameter_description> DPI to set
+<parameter name="loop">
+<parameter_description> %TRUE for enable looping
</parameter_description>
</parameter>
</parameters>
@@ -15638,6 +17609,7 @@ Since: 1.0
<description>
Checks @box_a and @box_b for equality
+Since: 1.0
</description>
<parameters>
@@ -15652,7 +17624,6 @@ Checks @box_a and @box_b for equality
</parameters>
<return> %TRUE if the passed #ClutterActorBox are equal
-Since: 1.0
</return>
</function>
@@ -15660,6 +17631,7 @@ Since: 1.0
<description>
Gets whether Clutter has XInput support.
+Since: 0.8
</description>
<parameters>
@@ -15667,30 +17639,9 @@ Gets whether Clutter has XInput support.
<return> %TRUE if Clutter was compiled with XInput support
and XInput support is available at run time.
-Since: 0.8
</return>
</function>
-<function name="clutter_media_set_uri">
-<description>
-Sets the URI of @media to @uri.
-
-Since: 0.2
-
-</description>
-<parameters>
-<parameter name="media">
-<parameter_description> a #ClutterMedia
-</parameter_description>
-</parameter>
-<parameter name="uri">
-<parameter_description> the URI of the media stream
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_model_iter_set_value">
<description>
Sets the data in the cell specified by @iter and @column. The type of
@@ -15720,6 +17671,7 @@ Since: 0.6
<description>
Creates a new #ClutterTimeline with a duration of @msecs.
+Since: 0.6
</description>
<parameters>
@@ -15731,31 +17683,66 @@ Creates a new #ClutterTimeline with a duration of @msecs.
<return> the newly created #ClutterTimeline instance. Use
g_object_unref() when done using it
-Since: 0.6
</return>
</function>
-<function name="clutter_actor_is_rotated">
+<function name="cogl_pango_font_map_set_resolution">
<description>
-Checks whether any rotation is applied to the actor.
+Sets the resolution to be used by @font_map at @dpi.
+Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="font_map">
+<parameter_description> a #CoglPangoFontMap
+</parameter_description>
+</parameter>
+<parameter name="dpi">
+<parameter_description> DPI to set
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor is rotated.
+<return></return>
+</function>
-Since: 0.6
-</return>
+<function name="clutter_text_set_use_markup">
+<description>
+Sets whether the contents of the #ClutterText actor contains markup
+in <link linkend="PangoMarkupFormat">Pango's text markup language</link>.
+
+Setting #ClutterText:use-markup on an editable #ClutterText will
+make the actor discard any markup.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE if the text should be parsed for markup.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="clutter_x11_get_stage_visual">
<description>
-Return value: The XVisualInfo for the stage.
+Returns an XVisualInfo suitable for creating a foreign window for the given
+stage. NOTE: It doesn't do as the name may suggest, which is return the
+XVisualInfo that was used to create an existing window for the given stage.
+
+XXX: It might be best to deprecate this function and replace with something
+along the lines of clutter_backend_x11_get_foreign_visual () or perhaps
+clutter_stage_x11_get_foreign_visual ()
+
+Deprecated: 1.2: Use clutter_x11_get_visual_info() instead
+
+Since: 0.4
</description>
<parameters>
@@ -15764,9 +17751,9 @@ Return value: The XVisualInfo for the stage.
</parameter_description>
</parameter>
</parameters>
-<return> The XVisualInfo for the stage.
+<return> An XVisualInfo suitable for creating a foreign stage. Use
+XFree() to free the returned value instead
-Since: 0.4
</return>
</function>
@@ -15795,19 +17782,53 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_glx_texture_pixmap_new_with_pixmap">
+<function name="clutter_box_layout_get_fill">
<description>
+Retrieves the horizontal and vertical fill policies for @actor
+as set using clutter_box_layout_pack() or clutter_box_layout_set_fill()
+
+Since: 1.2
</description>
<parameters>
-<parameter name="pixmap">
-<parameter_description> the X Pixmap to which this texture should be bound
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
+</parameter_description>
+</parameter>
+<parameter name="x_fill">
+<parameter_description> return location for the horizontal fill policy
+</parameter_description>
+</parameter>
+<parameter name="y_fill">
+<parameter_description> return location for the vertical fill policy
</parameter_description>
</parameter>
</parameters>
-<return> A new #ClutterGLXTexturePixmap bound to the given X Pixmap
+<return></return>
+</function>
+
+<function name="clutter_model_iter_prev">
+<description>
+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.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #ClutterModelIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> The passed iterator, updated to point at the previous
+row in the model.
-Since: 0.8
</return>
</function>
@@ -15815,32 +17836,42 @@ Since: 0.8
<description>
Gets the current EGLDisplay.
+Since: 0.4
</description>
<parameters>
</parameters>
<return> an EGLDisplay
-Since: 0.4
</return>
</function>
-<function name="clutter_model_iter_get_row">
+<function name="clutter_actor_set_z_rotation_from_gravity">
<description>
-Retrieves the position of the row that the @iter points to.
+Sets the rotation angle of @self around the Z axis using the center
+point specified as a compass point. For example to rotate such that
+the center of the actor remains static you can use
+%CLUTTER_GRAVITY_CENTER. If the actor changes size the center point
+will move accordingly.
+Since: 1.0
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> a #ClutterModelIter
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> the angle of rotation
+</parameter_description>
+</parameter>
+<parameter name="gravity">
+<parameter_description> the center point of the rotation
</parameter_description>
</parameter>
</parameters>
-<return> the position of the @iter in the model
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="cogl_sqrti">
@@ -15849,10 +17880,11 @@ Very fast fixed point implementation of square root for integers.
This function is at least 6x faster than clib sqrt() on x86, and (this is
not a typo!) about 500x faster on ARM without FPU. It's error is < 5%
-for arguments < #COGL_SQRTI_ARG_5_PERCENT and < 10% for arguments <
-#COGL_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
+for arguments < %COGL_SQRTI_ARG_5_PERCENT and < 10% for arguments <
+%COGL_SQRTI_ARG_10_PERCENT. The maximum argument that can be passed to
this function is COGL_SQRTI_ARG_MAX.
+Since: 0.2
</description>
<parameters>
@@ -15864,7 +17896,6 @@ this function is COGL_SQRTI_ARG_MAX.
<return> integer square root.
-Since: 0.2
</return>
</function>
@@ -15891,7 +17922,9 @@ and clutter_actor_set_size().
<function name="clutter_get_timestamp">
<description>
-Return value: Number of microseconds since clutter_init() was called.
+Returns the approximate number of microseconds passed since clutter was
+intialised.
+
</description>
<parameters>
@@ -15900,95 +17933,119 @@ Return value: Number of microseconds since clutter_init() was called.
</return>
</function>
-<function name="clutter_actor_get_allocation_coords">
+<function name="clutter_x11_set_stage_foreign">
<description>
-Gets the layout box an actor has been assigned. The allocation can
-only be assumed valid inside a paint() method; anywhere else, it
-may be out-of-date.
+Target the #ClutterStage to use an existing external X Window
-An allocation does not incorporate the actor's scale or anchor point;
-those transformations do not affect layout, only rendering.
+Since: 0.4
+
+</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
+
+</return>
+</function>
+
+<function name="clutter_animator_key_get_property_type">
+<description>
+Retrieves the #GType of the property a key applies to
-The returned coordinates are in pixels.
+You can use this type to initialize the #GValue to pass to
+clutter_animator_key_get_value()
-Since: 0.8
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
+</parameters>
+<return> the #GType of the property
+
+</return>
+</function>
+
+<function name="clutter_actor_box_new">
+<description>
+Allocates a new #ClutterActorBox using the passed coordinates
+for the top left and bottom right points
+
+Since: 1.0
+
+</description>
+<parameters>
<parameter name="x_1">
-<parameter_description> (out): x1 coordinate
+<parameter_description> X coordinate of the top left point
</parameter_description>
</parameter>
<parameter name="y_1">
-<parameter_description> (out): y1 coordinate
+<parameter_description> Y coordinate of the top left point
</parameter_description>
</parameter>
<parameter name="x_2">
-<parameter_description> (out): x2 coordinate
+<parameter_description> X coordinate of the bottom right point
</parameter_description>
</parameter>
<parameter name="y_2">
-<parameter_description> (out): y2 coordinate
+<parameter_description> Y coordinate of the bottom right point
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly allocated #ClutterActorBox. Use
+clutter_actor_box_free() to free the resources
+
+</return>
</function>
-<function name="clutter_text_activate">
+<function name="clutter_flow_layout_get_row_height">
<description>
-Emits the #ClutterText::activate signal, if @self has been set
-as activatable using clutter_text_set_activatable().
-
-This function can be used to emit the ::activate signal inside
-a #ClutterActor::captured-event or #ClutterActor::key-press-event
-signal handlers before the default signal handler for the
-#ClutterText is invoked.
+Retrieves the minimum and maximum row heights
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
+</parameter_description>
+</parameter>
+<parameter name="min_height">
+<parameter_description> return location for the minimum row height, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="max_height">
+<parameter_description> return location for the maximum row height, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the ::activate signal has been emitted,
-and %FALSE otherwise
-
-Since: 1.0
-</return>
+<return></return>
</function>
-<function name="clutter_behaviour_opacity_new">
+<function name="clutter_event_get_device_id">
<description>
-Creates a new #ClutterBehaviourOpacity object, driven by @alpha
-which controls the opacity property of every actor, making it
-change in the interval between @opacity_start and @opacity_end.
+Retrieves the events device id if set.
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha instance, or %NULL
-</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 name="event">
+<parameter_description> a clutter event
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterBehaviourOpacity
-
-Since: 0.2
+<return> A unique identifier for the device or -1 if the event has
+no specific device set.
</return>
</function>
@@ -16033,89 +18090,77 @@ Since: 0.8
<return></return>
</function>
-<function name="json_node_dup_array">
+<function name="clutter_get_default_text_direction">
<description>
-Retrieves the #JsonArray stored inside a #JsonNode and returns it
-with its reference count increased by one.
-
-
-</description>
-<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
-</parameter_description>
-</parameter>
-</parameters>
-<return> the #JsonArray with its reference count increased.
-</return>
-</function>
+Retrieves the default direction for the text. The text direction is
+determined by the locale and/or by the %CLUTTER_TEXT_DIRECTION environment
+variable
-<function name="clutter_text_get_password_char">
-<description>
-Retrieves the character to use in place of the actual text
-as set by clutter_text_set_password_char().
+The default text direction can be overridden on a per-actor basis by using
+clutter_actor_set_text_direction()
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
</parameters>
-<return> a Unicode character or 0 if the password
-character is not set
+<return> the default text direction
-Since: 1.0
</return>
</function>
-<function name="clutter_text_set_password_char">
+<function name="clutter_animator_set_timeline">
<description>
-Sets the character to use in place of the actual text in a
-password text actor.
+Sets an external timeline that will be used for driving the animation
-If @wc is 0 the text will be displayed as it is entered in the
-#ClutterText actor.
-
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
-<parameter name="wc">
-<parameter_description> a Unicode character, or 0 to unset the password character
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_container_lower_child">
+<function name="clutter_texture_set_from_file">
<description>
-Lowers @actor to @sibling level, in the depth ordering.
+Sets the #ClutterTexture image data from an image file. In case of
+failure, %FALSE is returned and @error is set.
-Since: 0.6
+If #ClutterTexture:load-async is set to %TRUE, this function
+will return as soon as possible, and the actual image loading
+from disk will be performed asynchronously. #ClutterTexture::size-change
+will be emitten when the size of the texture is available and
+#ClutterTexture::load-finished will be emitted when the image has been
+loaded or if an error occurred.
+
+Since: 0.8
</description>
<parameters>
-<parameter name="container">
-<parameter_description> a #ClutterContainer
+<parameter name="texture">
+<parameter_description> A #ClutterTexture
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> the actor to raise
+<parameter name="filename">
+<parameter_description> The filename of the image in GLib file name encoding
</parameter_description>
</parameter>
-<parameter name="sibling">
-<parameter_description> the sibling to lower to, or %NULL to lower to the bottom
+<parameter name="error">
+<parameter_description> Return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the image was successfully loaded and set
+
+</return>
</function>
<function name="clutter_texture_new">
@@ -16130,34 +18175,11 @@ Creates a new empty #ClutterTexture object.
</return>
</function>
-<function name="clutter_text_set_use_markup">
-<description>
-Sets whether the contents of the #ClutterText actor contains markup
-in <link linkend="PangoMarkupFormat">Pango's text markup language</link>.
-
-Setting #ClutterText:use-markup on an editable #ClutterText will
-make the actor discard any markup.
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="setting">
-<parameter_description> %TRUE if the text should be parsed for markup.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_texture_get_load_data_async">
<description>
Retrieves the value set by clutter_texture_set_load_data_async()
+Since: 1.0
</description>
<parameters>
@@ -16169,33 +18191,30 @@ Retrieves the value set by clutter_texture_set_load_data_async()
<return> %TRUE if the #ClutterTexture should load the image
data from a file asynchronously
-Since: 1.0
</return>
</function>
-<function name="json_generator_to_file">
+<function name="clutter_text_set_max_length">
<description>
-Creates a JSON data stream and puts it inside @filename, overwriting the
-current file contents. This operation is atomic.
+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: 1.0
</description>
<parameters>
-<parameter name="generator">
-<parameter_description> a #JsonGenerator
-</parameter_description>
-</parameter>
-<parameter name="filename">
-<parameter_description> path to the target file
+<parameter name="self">
+<parameter_description> a #ClutterText
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="max">
+<parameter_description> the maximum number of characters allowed in the text actor; 0
+to disable or -1 to set the length of the current string
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if saving was successful.
-</return>
+<return></return>
</function>
<function name="clutter_model_iter_set_valist">
@@ -16219,11 +18238,190 @@ Since: 0.6
<return></return>
</function>
+<function name="clutter_actor_animate">
+<description>
+Animates the given list of properties of @actor between the current
+value for each property and a new final value. The animation has a
+definite duration and a speed given by the @mode.
+
+For example, this:
+
+|[
+clutter_actor_animate (rectangle, CLUTTER_LINEAR, 250,
+"width", 100.0,
+"height", 100.0,
+NULL);
+]|
+
+will make width and height properties of the #ClutterActor "rectangle"
+grow linearly between the current value and 100 pixels, in 250 milliseconds.
+
+The animation @mode is a logical id, either from the #ClutterAnimationMode
+enumeration of from clutter_alpha_register_func().
+
+All the properties specified will be animated between the current value
+and the final value. If a property should be set at the beginning of
+the animation but not updated during the animation, it should be prefixed
+by the "fixed::" string, for instance:
+
+|[
+clutter_actor_animate (actor, CLUTTER_EASE_IN_SINE, 100,
+"rotation-angle-z", 360.0,
+"fixed::rotation-center-z", &center,
+NULL);
+]|
+
+Will animate the "rotation-angle-z" property between the current value
+and 360 degrees, and set the "rotation-center-z" property to the fixed
+value of the #ClutterVertex "center".
+
+This function will implicitly create a #ClutterAnimation object which
+will be assigned to the @actor and will be returned to the developer
+to control the animation or to know when the animation has been
+completed.
+
+If a name argument starts with "signal::", "signal-after::",
+"signal-swapped::" or "signal-swapped-after::" the two following arguments
+are used as callback function and data for a signal handler installed on
+the #ClutterAnimation object for the specified signal name, for instance:
+
+|[
+
+static void
+on_animation_completed (ClutterAnimation *animation,
+ClutterActor *actor)
+{
+clutter_actor_hide (actor);
+}
+
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 100,
+"opacity", 0,
+"signal::completed", on_animation_completed, actor,
+NULL);
+]|
+
+or, to automatically destroy an actor at the end of the animation:
+
+|[
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 100,
+"opacity", 0,
+"signal-swapped-after::completed",
+clutter_actor_destroy,
+actor,
+NULL);
+]|
+
+The "signal::" modifier is the equivalent of using g_signal_connect();
+the "signal-after::" modifier is the equivalent of using
+g_signal_connect_after() or g_signal_connect_data() with the
+%G_CONNECT_AFTER; the "signal-swapped::" modifier is the equivalent
+of using g_signal_connect_swapped() or g_signal_connect_data() with the
+%G_CONNECT_SWAPPED flah; finally, the "signal-swapped-after::" modifier
+is the equivalent of using g_signal_connect_data() with both the
+%G_CONNECT_AFTER and %G_CONNECT_SWAPPED flags. The clutter_actor_animate()
+function will not keep track of multiple connections to the same signal,
+so it is your responsability to avoid them when calling
+clutter_actor_animate() multiple times on the same actor.
+
+Calling this function on an actor that is already being animated
+will cause the current animation to change with the new final values,
+the new easing mode and the new duration - that is, this code:
+
+|[
+clutter_actor_animate (actor, CLUTTER_LINEAR, 250,
+"width", 100.0,
+"height", 100.0,
+NULL);
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
+"x", 100.0,
+"y", 100.0,
+"width", 200.0,
+NULL);
+]|
+
+is the equivalent of:
+
+|[
+clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500,
+"x", 100.0,
+"y", 100.0,
+"width", 200.0,
+"height", 100.0,
+NULL);
+]|
+
+<note>Unless the animation is looping, the #ClutterAnimation created by
+clutter_actor_animate() will become invalid as soon as it is
+complete.</note>
+
+Since the created #ClutterAnimation instance attached to @actor
+is guaranteed to be valid throughout the #ClutterAnimation::completed
+signal emission chain, you will not be able to create a new animation
+using clutter_actor_animate() on the same @actor from within the
+#ClutterAnimation::completed signal handler unless you use
+g_signal_connect_after() to connect the callback function, for instance:
+
+|[
+static void
+on_animation_completed (ClutterAnimation *animation,
+ClutterActor *actor)
+{
+clutter_actor_animate (actor, CLUTTER_EASE_OUT_CUBIC, 250,
+"x", 500.0,
+"y", 500.0,
+NULL);
+}
+
+...
+animation = clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 250,
+"x", 100.0,
+"y", 100.0,
+NULL);
+g_signal_connect (animation, "completed",
+G_CALLBACK (on_animation_completed),
+actor);
+...
+]|
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> duration of the animation, in milliseconds
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of a property
+</parameter_description>
+</parameter>
+<parameter name="VarArgs">
+<parameter_description> a %NULL terminated list of property names and
+property values
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterAnimation object. The object is
+owned by the #ClutterActor and should not be unreferenced with
+g_object_unref()
+
+</return>
+</function>
+
<function name="clutter_texture_set_from_yuv_data">
<description>
Sets a #ClutterTexture from YUV image data. If an error occurred,
%FALSE is returned and @error is set.
+Since: 0.4
</description>
<parameters>
@@ -16254,7 +18452,6 @@ Sets a #ClutterTexture from YUV image data. If an error occurred,
</parameters>
<return> %TRUE if the texture was successfully updated
-Since: 0.4
</return>
</function>
@@ -16276,6 +18473,29 @@ Sets the stage perspective.
<return></return>
</function>
+<function name="clutter_alpha_register_closure">
+<description>
+#GClosure variant of clutter_alpha_register_func().
+
+Registers a global alpha function and returns its logical id
+to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
+
+The logical id is always greater than %CLUTTER_ANIMATION_LAST.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="closure">
+<parameter_description> a #GClosure
+</parameter_description>
+</parameter>
+</parameters>
+<return> the logical id of the alpha function
+
+</return>
+</function>
+
<function name="clutter_actor_apply_relative_transform_to_point">
<description>
Transforms @point in coordinates relative to the actor into
@@ -16330,6 +18550,7 @@ used by #ClutterTimeline.
See also clutter_threads_add_idle_full().
+Since: 0.4
</description>
<parameters>
@@ -16357,18 +18578,68 @@ range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
</parameters>
<return> the ID (greater than 0) of the event source.
-Since: 0.4
</return>
</function>
-<function name="json_node_free">
+<function name="clutter_actor_set_width">
<description>
-Frees the resources allocated by @node.
+Forces a width on an actor, causing the actor's preferred width
+and height (if any) to be ignored.
+
+If @width is -1 the actor will use its preferred width request
+instead of overriding it, i.e. you can "unset" the width with -1.
+
+This function sets both the minimum and natural size of the actor.
+
+since: 0.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Requested new width for the actor, in pixels, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_text_get_ellipsize">
+<description>
+Returns the ellipsizing position of a #ClutterText actor, as
+set by clutter_text_set_ellipsize().
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterText
+</parameter_description>
+</parameter>
+</parameters>
+<return> #PangoEllipsizeMode
+
+</return>
+</function>
+
+<function name="clutter_alpha_set_timeline">
+<description>
+Binds @alpha to @timeline.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="timeline">
+<parameter_description> A #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
@@ -16403,20 +18674,22 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_model_get_filter_set">
+<function name="clutter_timeline_get_duration">
<description>
-Return value: %TRUE if a filter is set
+Retrieves the duration of a #ClutterTimeline in milliseconds.
+See clutter_timeline_set_duration().
+
+Since: 0.6
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a filter is set
+<return> the duration of the timeline, in milliseconds.
-Since: 1.0
</return>
</function>
@@ -16426,50 +18699,32 @@ Retrieves the #PangoFontMap instance used by Clutter.
You can use the global font map object with the COGL
Pango API.
-
-</description>
-<parameters>
-</parameters>
-<return> (transfer none): the #PangoFontMap instance. The returned
-value is owned by Clutter and it should never be unreferenced.
-
Since: 1.0
-</return>
-</function>
-
-<function name="clutter_actor_has_clip">
-<description>
-Determines whether the actor has a clip area set or not.
-
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if the actor has a clip area set.
+<return> the #PangoFontMap instance. The returned
+value is owned by Clutter and it should never be unreferenced.
-Since: 0.1.1
</return>
</function>
-<function name="clutter_value_get_color">
+<function name="clutter_behaviour_path_get_path">
<description>
-Gets the #ClutterColor contained in @value.
+Get the current path of the behaviour
+Since: 1.0
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
+<parameter name="pathb">
+<parameter_description> a #ClutterBehaviourPath instance
</parameter_description>
</parameter>
</parameters>
-<return> the colors inside the passed #GValue
+<return> the path
-Since: 0.8.4
</return>
</function>
@@ -16506,6 +18761,7 @@ Since: 0.8
Checks whether a point with @x, @y coordinates is contained
withing @box
+Since: 1.0
</description>
<parameters>
@@ -16524,56 +18780,56 @@ withing @box
</parameters>
<return> %TRUE if the point is contained by the #ClutterActorBox
-Since: 1.0
</return>
</function>
-<function name="clutter_score_pause">
+<function name="clutter_timeline_get_delay">
<description>
-Pauses a playing score @score.
+Retrieves the delay set using clutter_timeline_set_delay().
-Since: 0.6
+Since: 0.4
</description>
<parameters>
-<parameter name="score">
-<parameter_description> a #ClutterScore
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the delay in milliseconds.
+
+</return>
</function>
-<function name="json_parser_load_from_file">
+<function name="clutter_container_lower_child">
<description>
-Loads a JSON stream from the content of @filename and parses it. See
-json_parser_load_from_data().
+Lowers @actor to @sibling level, in the depth ordering.
+Since: 0.6
</description>
<parameters>
-<parameter name="parser">
-<parameter_description> a #JsonParser
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="filename">
-<parameter_description> the path for the file to parse
+<parameter name="actor">
+<parameter_description> the actor to raise
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="sibling">
+<parameter_description> the sibling to lower to, or %NULL to lower to the bottom
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file was successfully loaded and parsed.
-In case of error, @error is set accordingly and %FALSE is returned
-</return>
+<return></return>
</function>
<function name="clutter_score_is_playing">
<description>
Query state of a #ClutterScore instance.
+Since: 0.6
</description>
<parameters>
@@ -16584,26 +18840,41 @@ Query state of a #ClutterScore instance.
</parameters>
<return> %TRUE if score is currently playing
-Since: 0.6
</return>
</function>
-<function name="json_node_get_node_type">
+<function name="clutter_bin_layout_get_alignment">
<description>
-Retrieves the #JsonNodeType of @node
+Retrieves the horizontal and vertical alignment policies for
+a child of @self
+If @child is %NULL the default alignment policies will be returned
+instead
+
+Since: 1.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="self">
+<parameter_description> a #ClutterBinLayout
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a child of @container
+</parameter_description>
+</parameter>
+<parameter name="x_align">
+<parameter_description> return location for the horizontal
+alignment policy
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> return location for the vertical
+alignment policy
</parameter_description>
</parameter>
</parameters>
-<return> the type of the node
-
-Since: 0.8
-</return>
+<return></return>
</function>
<function name="clutter_rectangle_set_border_width">
@@ -16627,6 +18898,33 @@ Since: 0.2
<return></return>
</function>
+<function name="clutter_actor_realize">
+<description>
+Creates any underlying graphics resources needed by the actor to be
+displayed.
+
+Realization means the actor is now tied to a specific rendering context
+(that is, a specific toplevel stage).
+
+This function does nothing if the actor is already realized.
+
+Because a realized actor must have realized parent actors, calling
+clutter_actor_realize() will also realize all parents of the actor.
+
+This function does not realize child actors, except in the special
+case that realizing the stage, when the stage is visible, will
+suddenly map (and thus realize) the children of the stage.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_stage_show_cursor">
<description>
Shows the cursor on the stage window
@@ -16641,25 +18939,20 @@ Shows the cursor on the stage window
<return></return>
</function>
-<function name="clutter_actor_should_pick_paint">
+<function name="clutter_actor_hide_all">
<description>
-Should be called inside the implementation of the
-#ClutterActor::pick virtual function in order to check whether
-the actor should paint itself in pick mode or not.
-
-This function should never be called directly by applications.
+Calls clutter_actor_hide() on all child actors (if any).
+Since: 0.2
</description>
<parameters>
<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor should paint its silhouette,
-%FALSE otherwise
-</return>
+<return></return>
</function>
<function name="clutter_timeline_skip">
@@ -16703,6 +18996,7 @@ If the action bound to the @key_val, @modifiers pair has been
blocked using clutter_binding_pool_block_action(), the callback
will not be invoked, and this function will return %FALSE.
+Since: 1.0
</description>
<parameters>
@@ -16725,41 +19019,115 @@ will not be invoked, and this function will return %FALSE.
</parameters>
<return> %TRUE if an action was found and was activated
+</return>
+</function>
+
+<function name="clutter_behaviour_get_n_actors">
+<description>
+Gets the number of actors this behaviour is applied too.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
+</parameter_description>
+</parameter>
+</parameters>
+<return> The number of applied actors
+
+</return>
+</function>
+
+<function name="clutter_animation_set_mode">
+<description>
+Sets the animation @mode of @animation. The animation @mode is
+a logical id, either coming from the #ClutterAnimationMode enumeration
+or the return value of clutter_alpha_register_func().
+
+This function will also set #ClutterAnimation:alpha if needed.
+
Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> an animation mode logical id
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_animation_get_interval">
+<description>
+Retrieves the #ClutterInterval associated to @property_name
+inside @animation.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #ClutterAnimation
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> name of the property
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterInterval or %NULL if no
+property with the same name was found. The returned interval is
+owned by the #ClutterAnimation and should not be unreferenced
+
</return>
</function>
-<function name="clutter_behaviour_ellipse_get_direction">
+<function name="clutter_animator_get_duration">
<description>
-Retrieves the #ClutterRotateDirection used by the ellipse behaviour.
+Retrieves the current duration of an animator
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterBehaviourEllipse
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
</parameters>
-<return> the rotation direction
+<return> the duration of the animation, in milliseconds
-Since: 0.4
</return>
</function>
-<function name="clutter_actor_set_opacity">
+<function name="json_object_set_double_member">
<description>
-Sets the actor's opacity, with zero being completely transparent and
-255 (0xff) being fully opaque.
+Convenience function for setting a floating point @value
+of @member_name inside @object.
+
+See also: json_object_set_member()
+
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="object">
+<parameter_description> a #JsonObject
</parameter_description>
</parameter>
-<parameter name="opacity">
-<parameter_description> New opacity value for the actor.
+<parameter name="member_name">
+<parameter_description> the name of the member
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the member
</parameter_description>
</parameter>
</parameters>
@@ -16805,6 +19173,7 @@ the filtering function set on @model.
This function should be used only by subclasses of #ClutterModel.
+Since: 0.6
</description>
<parameters>
@@ -16820,7 +19189,6 @@ This function should be used only by subclasses of #ClutterModel.
<return> %TRUE if the row should be displayed,
%FALSE otherwise
-Since: 0.6
</return>
</function>
@@ -16840,12 +19208,29 @@ Retrieves the unicode value for the key that caused @keyev.
</return>
</function>
-<function name="JsonGenerator">
+<function name="clutter_container_destroy_child_meta">
<description>
-Number of spaces to be used to indent when pretty printing.
+Destroys the #ClutterChildMeta wrapping @actor inside the
+ container, if any.
+
+This function is only useful when removing a #ClutterActor to
+a #ClutterContainer implementation outside of the
+#ClutterContainer::add() virtual function implementation.
+
+Applications should not call this function.
+
+Since: 1.2
</description>
<parameters>
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -16863,11 +19248,11 @@ Since: 0.8
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> (out): return location for the X coordinate, or %NULL
+<parameter_description> return location for the X coordinate, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> (out): return location for the Y coordinate, or %NULL
+<parameter_description> return location for the Y coordinate, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -16903,25 +19288,7 @@ clutter_timeline_advance() will be emit the skipped markers.
Retrieves whether the contents of the #ClutterText actor should be
parsed for the Pango text markup.
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the contents will be parsed for markup
-
Since: 1.0
-</return>
-</function>
-
-<function name="clutter_text_get_attributes">
-<description>
-Gets the attribute list that was set on the #ClutterText actor
-clutter_text_set_attributes(), if any.
-
</description>
<parameters>
@@ -16930,35 +19297,29 @@ clutter_text_set_attributes(), if any.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the attribute list, or %NULL if none was set. The
-returned value is owned by the #ClutterText and should not be unreferenced.
+<return> %TRUE if the contents will be parsed for markup
-Since: 1.0
</return>
</function>
-<function name="cogl_pango_render_layout_line">
+<function name="clutter_model_foreach">
<description>
-Renders @line at the given coordinates using the given color.
+Calls @func for each row in the model.
-Since: 1.0
+Since: 0.6
</description>
<parameters>
-<parameter name="line">
-<parameter_description> a #PangoLayoutLine
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> X coordinate to render the line at
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate to render the line at
+<parameter name="func">
+<parameter_description> a #ClutterModelForeachFunc
</parameter_description>
</parameter>
-<parameter name="color">
-<parameter_description> color to use when rendering the line
+<parameter name="user_data">
+<parameter_description> user data to pass to @func
</parameter_description>
</parameter>
</parameters>
@@ -16969,6 +19330,7 @@ Since: 1.0
<description>
Retrieves the currently selected text.
+Since: 1.0
</description>
<parameters>
@@ -16981,7 +19343,6 @@ Retrieves the currently selected text.
selected text, or %NULL. Use g_free() to free the returned
string.
-Since: 1.0
</return>
</function>
@@ -17007,65 +19368,72 @@ g_free() to free the allocated resources.
</return>
</function>
-<function name="clutter_actor_set_shader">
+<function name="clutter_glx_texture_pixmap_new_with_pixmap">
<description>
-Sets the #ClutterShader to be used when rendering @self.
-
-If @shader is %NULL it will unset any currently set shader
-for the actor.
+Creates a new #ClutterGLXTexturePixmap for @pixmap
+Since: 0.8
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="shader">
-<parameter_description> a #ClutterShader or %NULL to unset the shader.
+<parameter name="pixmap">
+<parameter_description> the X Pixmap to which this texture should be bound
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the shader was successfully applied
+<return> A new #ClutterGLXTexturePixmap bound to the given X Pixmap
-Since: 0.6
</return>
</function>
-<function name="clutter_actor_set_depth">
+<function name="clutter_get_option_group">
<description>
-Sets the Z coordinate of @self to @depth.
+Returns a #GOptionGroup for the command line arguments recognized
+by Clutter. You should add this group to your #GOptionContext with
+g_option_context_add_group(), if you are using g_option_context_parse()
+to parse your commandline arguments.
-The unit used by @depth is dependant on the perspective setup. See
-also clutter_stage_set_perspective().
+Calling g_option_context_parse() with Clutter's #GOptionGroup will result
+in Clutter's initialization. That is, the following code:
+
+|[
+g_option_context_set_main_group (context, clutter_get_option_group ());
+res = g_option_context_parse (context, &argc, &argc, NULL);
+]|
+
+is functionally equivalent to:
+
+|[
+clutter_init (&argc, &argv);
+]|
+
+After g_option_context_parse() on a #GOptionContext containing the
+Clutter #GOptionGroup has returned %TRUE, Clutter is guaranteed to be
+initialized.
+
+Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="depth">
-<parameter_description> Z co-ord
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a #GOptionGroup for the commandline arguments
+recognized by Clutter
+
+</return>
</function>
-<function name="clutter_color_darken">
+<function name="clutter_stage_set_color">
<description>
-Darkens @color by a fixed amount, and saves the changed color
-in @result.
+Sets the stage color.
</description>
<parameters>
-<parameter name="color">
-<parameter_description> a #ClutterColor
+<parameter name="stage">
+<parameter_description> A #ClutterStage
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> (out): return location for the darker color
+<parameter name="color">
+<parameter_description> A #ClutterColor
</parameter_description>
</parameter>
</parameters>
@@ -17094,102 +19462,126 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_actor_box_get_area">
+<function name="clutter_input_device_get_pointer_stage">
<description>
-Retrieves the area of @box
+Retrieves the #ClutterStage underneath the pointer of @device
+Since: 1.2
</description>
<parameters>
-<parameter name="box">
-<parameter_description> a #ClutterActorBox
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice of type %CLUTTER_POINTER_DEVICE
</parameter_description>
</parameter>
</parameters>
-<return> the area of a #ClutterActorBox, in pixels
+<return> a pointer to the #ClutterStage or %NULL
-Since: 1.0
</return>
</function>
-<function name="clutter_media_get_playing">
+<function name="json_object_set_boolean_member">
<description>
-Retrieves the playing status of @media.
+Convenience function for setting a boolean @value of
+ member_name inside @object.
+
+See also: json_object_set_member()
+Since: 0.8
</description>
<parameters>
-<parameter name="media">
-<parameter_description> A #ClutterMedia object
+<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="value">
+<parameter_description> the value of the member
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if playing, %FALSE if stopped.
-
-Since: 0.2
-</return>
+<return></return>
</function>
-<function name="clutter_value_get_shader_int">
+<function name="clutter_init">
<description>
-Retrieves the list of integer values stored inside the passed
-#GValue. @value must have been initialized with
-%CLUTTER_TYPE_SHADER_INT.
+It will initialise everything needed to operate with Clutter and
+parses some standard command line options. @argc and @argv are
+adjusted accordingly so your own code will never see those standard
+arguments.
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue
+<parameter name="argc">
+<parameter_description> The number of arguments in @argv
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> return location for the number of returned integer
-values, or %NULL
+<parameter name="argv">
+<parameter_description> A pointer to an array
+of arguments.
</parameter_description>
</parameter>
</parameters>
-<return> the pointer to a list of integer values.
-The returned value is owned by the #GValue and should never
-be modified or freed.
-
-Since: 0.8
+<return> 1 on success, < 0 on failure.
</return>
</function>
-<function name="CoglMatrixStack">
+<function name="clutter_media_get_playing">
<description>
-Stores a cogl-side matrix stack, which we use as a cache
-so we can get the matrix efficiently when using indirect
-rendering.
+Retrieves the playing status of @media.
+
+Since: 0.2
</description>
<parameters>
+<parameter name="media">
+<parameter_description> A #ClutterMedia object
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> %TRUE if playing, %FALSE if stopped.
+
+</return>
</function>
-<function name="clutter_actor_create_pango_context">
+<function name="clutter_box_packv">
<description>
-Creates a #PangoContext for the given actor. The #PangoContext
-is already configured using the appropriate font map, resolution
-and font options.
-
-See also clutter_actor_get_pango_context().
+Vector-based variant of clutter_box_pack(), intended for language
+bindings to use
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
+<parameter name="box">
+<parameter_description> a #ClutterBox
+</parameter_description>
+</parameter>
+<parameter name="actor">
<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
+<parameter name="n_properties">
+<parameter_description> the number of properties to set
+</parameter_description>
+</parameter>
+<parameter name="properties">
+<parameter_description> a vector
+containing the property names to set
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> a vector containing the property
+values to set
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly created #PangoContext. Use g_object_unref()
-on the returned value to deallocate its resources
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_binding_pool_new">
@@ -17199,6 +19591,7 @@ key bindings for an actor. The @name must be a unique identifier
for the binding pool, so that clutter_binding_pool_find() will
be able to return the correct binding pool.
+Since: 1.0
</description>
<parameters>
@@ -17210,22 +19603,9 @@ be able to return the correct binding pool.
<return> the newly created binding pool with the given
name. Use g_object_unref() when done.
-Since: 1.0
</return>
</function>
-<function name="ClutterBehaviourEllipse">
-<description>
-The direction of the rotation.
-
-Since: 0.4
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_texture_set_repeat">
<description>
Sets whether the @texture should repeat horizontally or
@@ -17274,6 +19654,53 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_backend_set_font_name">
+<description>
+Sets the default font to be used by Clutter. The @font_name string
+must either be %NULL, which means that the font name from the
+default #ClutterBackend will be used; or be something that can
+be parsed by the pango_font_description_from_string() function.
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
+</parameter_description>
+</parameter>
+<parameter name="font_name">
+<parameter_description> the name of the font
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_actors_foreach">
+<description>
+Calls @func for every actor driven by @behave.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a function called for each actor
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> optional data to be passed to the function, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_behaviour_rotate_set_center">
<description>
Sets the center of rotation. The coordinates are relative to the plane
@@ -17303,116 +19730,70 @@ Since: 0.4
<return></return>
</function>
-<function name="clutter_text_set_cursor_color">
+<function name="clutter_actor_grab_key_focus">
<description>
-Sets the color of the cursor of a #ClutterText actor.
-
-If @color is %NULL, the cursor color will be the same as the
-text color.
+Sets the key focus of the #ClutterStage including @self
+to this #ClutterActor.
Since: 1.0
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #ClutterText
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> the color of the cursor, or %NULL to unset it
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="ClutterShader">
+<function name="clutter_x11_get_input_devices">
<description>
-Whether the shader is currently used in the GL rendering pipeline.
-
-Since: 0.6
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="clutter_interval_register_progress_func">
-<description>
-Sets the progress function for a given @value_type, like:
-
-|[
-clutter_interval_register_progress_func (MY_TYPE_FOO,
-my_foo_progress);
-]|
-
-Whenever a #ClutterInterval instance using the default
-#ClutterInterval::compute_value implementation is set as an
-interval between two #GValue of type @value_type, it will call
- func to establish the value depending on the given progress,
-for instance:
+Retrieves a pointer to the list of input devices
-|[
-static gboolean
-my_int_progress (const GValue *a,
-const GValue *b,
-gdouble progress,
-GValue *retval)
-{
-gint ia = g_value_get_int (a);
-gint ib = g_value_get_int (b);
-gint res = factor * (ib - ia) + ia;
-
-g_value_set_int (retval, res);
-
-return TRUE;
-}
+Deprecated: 1.2: Use clutter_device_manager_peek_devices() instead
-clutter_interval_register_progress_func (G_TYPE_INT, my_int_progress);
-]|
-
-To unset a previously set progress function of a #GType, pass %NULL
-for @func.
+Since: 0.8
-Since: 1.0
</description>
<parameters>
-<parameter name="value_type">
-<parameter_description> a #GType
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #ClutterProgressFunc, or %NULL to unset a previously
-set progress function
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a pointer to the internal list of input devices; the
+returned list is owned by Clutter and should not be modified or
+freed
+</return>
</function>
-<function name="clutter_alpha_get_mode">
+<function name="json_node_is_null">
<description>
-Retrieves the #ClutterAnimationMode used by @alpha.
+Checks whether @node is a %JSON_NODE_NULL
+<note>A null node is not the same as a %NULL #JsonNode</note>
+
+Since: 0.8
</description>
<parameters>
-<parameter name="alpha">
-<parameter_description> a #ClutterAlpha
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return> the animation mode
+<return> %TRUE if the node is null
-Since: 1.0
</return>
</function>
<function name="clutter_color_to_string">
<description>
-Return value: a newly-allocated text string
+Returns a textual specification of @color in the hexadecimal form
+<literal>rrggbbaa</literal>, where <literal>r</literal>,
+<literal>g</literal>, <literal>b</literal> and <literal>a</literal> are
+hex digits representing the red, green, blue and alpha components
+respectively.
+
+Since: 0.2
</description>
<parameters>
@@ -17423,7 +19804,6 @@ Return value: a newly-allocated text string
</parameters>
<return> a newly-allocated text string
-Since: 0.2
</return>
</function>
@@ -17447,6 +19827,7 @@ Since: 0.2
<description>
Retrieves the underlying #CoglHandle for the vertex shader.
+Since: 1.0
</description>
<parameters>
@@ -17457,30 +19838,9 @@ Retrieves the underlying #CoglHandle for the vertex shader.
</parameters>
<return> A #CoglHandle for the vertex shader, or %NULL
-Since: 1.0
</return>
</function>
-<function name="clutter_units_mm">
-<description>
-Stores a value in millimiters inside @units
-
-Since: 1.0
-
-</description>
-<parameters>
-<parameter name="units">
-<parameter_description> a #ClutterUnits
-</parameter_description>
-</parameter>
-<parameter name="mm">
-<parameter_description> millimeters
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_stage_new">
<description>
Creates a new, non-default stage. A non-default stage is a new
@@ -17494,6 +19854,7 @@ backend. Use clutter_feature_available() and
%CLUTTER_FEATURE_STAGE_MULTIPLE to check at runtime whether a
backend supports multiple stages.
+Since: 0.8
</description>
<parameters>
@@ -17502,27 +19863,31 @@ backend supports multiple stages.
not support multiple stages. Use clutter_actor_destroy() to
programmatically close the returned stage.
-Since: 0.8
</return>
</function>
-<function name="clutter_texture_get_load_async">
+<function name="clutter_units_from_em_for_font">
<description>
-Retrieves the value set using clutter_texture_get_load_async()
+Stores a value in em inside @units using @font_name
+Since: 1.0
</description>
<parameters>
-<parameter name="texture">
-<parameter_description> a #ClutterTexture
+<parameter name="units">
+<parameter_description> a #ClutterUnits
+</parameter_description>
+</parameter>
+<parameter name="font_name">
+<parameter_description> the font name and size
+</parameter_description>
+</parameter>
+<parameter name="em">
+<parameter_description> em
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #ClutterTexture should load the data from
-disk asynchronously
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_text_set_selection">
@@ -17552,84 +19917,85 @@ Since: 1.0
<return></return>
</function>
-<function name="ClutterRectangle">
+<function name="clutter_device_manager_get_device">
<description>
-Whether the #ClutterRectangle should be displayed with a border.
+Retrieves the #ClutterInputDevice with the given @device_id
-Since: 0.2
+Since: 1.2
</description>
<parameters>
+<parameter name="device_manager">
+<parameter_description> a #ClutterDeviceManager
+</parameter_description>
+</parameter>
+<parameter name="device_id">
+<parameter_description> the integer id of a device
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> a #ClutterInputDevice or %NULL. The
+returned device is owned by the #ClutterDeviceManager and should
+never be modified or freed
+
+</return>
</function>
-<function name="clutter_rectangle_get_border_color">
+<function name="clutter_actor_get_reactive">
<description>
-Gets the color of the border used by @rectangle and places
-it into @color.
+Checks whether @actor is marked as reactive.
-Since: 0.2
+Since: 0.6
</description>
<parameters>
-<parameter name="rectangle">
-<parameter_description> a #ClutterRectangle
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> return location for a #ClutterColor
+<parameter name="actor">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the actor is reactive
+
+</return>
</function>
-<function name="clutter_actor_set_rotation">
+<function name="clutter_animator_compute_value">
<description>
-Sets the rotation angle of @self around the given axis.
+Compute the value for a managed property at a given progress.
-The rotation center coordinates used depend on the value of @axis:
-<itemizedlist>
-<listitem><para>%CLUTTER_X_AXIS requires @y and @z</para></listitem>
-<listitem><para>%CLUTTER_Y_AXIS requires @x and @z</para></listitem>
-<listitem><para>%CLUTTER_Z_AXIS requires @x and @y</para></listitem>
-</itemizedlist>
+If the property is an ease-in property, the current value of the property
+on the object will be used as the starting point for computation.
-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.8
+Since: 1.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="axis">
-<parameter_description> the axis of rotation
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
-<parameter name="angle">
-<parameter_description> the angle of rotation
+<parameter name="object">
+<parameter_description> a #GObject
</parameter_description>
</parameter>
-<parameter name="x">
-<parameter_description> X coordinate of the rotation center
+<parameter name="property_name">
+<parameter_description> the name of the property on object to check
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> Y coordinate of the rotation center
+<parameter name="progress">
+<parameter_description> a value between 0.0 and 1.0
</parameter_description>
</parameter>
-<parameter name="z">
-<parameter_description> Z coordinate of the rotation center
+<parameter name="value">
+<parameter_description> an initialized value to store the computed result
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the computation yields has a value, otherwise (when
+an error occurs or the progress is before any of the keys) %FALSE is
+returned and the #GValue is left untouched
+
+</return>
</function>
<function name="clutter_actor_allocate_available_size">
@@ -17713,28 +20079,81 @@ actor's natural height
<return></return>
</function>
-<function name="clutter_script_get_type_from_name">
+<function name="clutter_model_prependv">
<description>
-Looks up a type by name, using the virtual function that
-#ClutterScript has for that purpose. This function should
-rarely be used.
+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="script">
-<parameter_description> a #ClutterScript
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
-<parameter name="type_name">
-<parameter_description> name of the type to look up
+<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> the type for the requested type name, or
-%G_TYPE_INVALID if not corresponding type was found.
+<return></return>
+</function>
+
+<function name="clutter_event_get_coords">
+<description>
+Retrieves the coordinates of @event and puts them into @x and @y.
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #ClutterEvent
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> return location for the X coordinate
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> return location for the Y coordinate
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_container_get_child_meta">
+<description>
+Retrieves the #ClutterChildMeta which contains the data about the
+ container specific state for @actor.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> a #ClutterContainer
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor that is a child of @container.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #ClutterChildMeta for the @actor child
+of @container or %NULL if the specifiec actor does not exist or the
+container is not configured to provide #ClutterChildMeta<!-- -->s
-Since: 0.6
</return>
</function>
@@ -17745,6 +20164,7 @@ and @final.
This function is useful for language bindings.
+Since: 1.0
</description>
<parameters>
@@ -17763,77 +20183,65 @@ This function is useful for language bindings.
</parameters>
<return> the newly created #ClutterInterval
-Since: 1.0
</return>
</function>
-<function name="clutter_text_set_attributes">
+<function name="clutter_text_new_full">
<description>
-Sets the attributes list that are going to be applied to the
-#ClutterText contents.
+Creates a new #ClutterText actor, using @font_name as the font
+description; @text will be used to set the contents of the actor;
+and @color will be used as the color to render @text.
-The #ClutterText actor will take a reference on the #PangoAttrList
-passed to this function.
+This function is equivalent to calling clutter_text_new(),
+clutter_text_set_font_name(), clutter_text_set_text() and
+clutter_text_set_color().
Since: 1.0
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="font_name">
+<parameter_description> a string with a font description
</parameter_description>
</parameter>
-<parameter name="attrs">
-<parameter_description> a #PangoAttrList or %NULL to unset the attributes
+<parameter name="text">
+<parameter_description> the contents of the actor
+</parameter_description>
+</parameter>
+<parameter name="color">
+<parameter_description> the color to be used to render @text
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterText actor
+
+</return>
</function>
-<function name="ClutterTimeline">
+<function name="clutter_units_to_string">
<description>
-The ::marker-reached signal is emitted each time a timeline
-reaches a marker set with
-clutter_timeline_add_marker_at_time(). This signal is detailed
-with the name of the marker as well, so it is possible to connect
-a callback to the ::marker-reached signal for a specific marker
-with:
+Converts @units into a string
-<informalexample><programlisting>
-clutter_timeline_add_marker_at_time (timeline, "foo", 500);
-clutter_timeline_add_marker_at_time (timeline, "bar", 750);
-
-g_signal_connect (timeline, "marker-reached",
-G_CALLBACK (each_marker_reached), NULL);
-g_signal_connect (timeline, "marker-reached::foo",
-G_CALLBACK (foo_marker_reached), NULL);
-g_signal_connect (timeline, "marker-reached::bar",
-G_CALLBACK (bar_marker_reached), NULL);
-</programlisting></informalexample>
+See clutter_units_from_string() for the units syntax and for
+examples of output
-In the example, the first callback will be invoked for both
-the "foo" and "bar" marker, while the second and third callbacks
-will be invoked for the "foo" or "bar" markers, respectively.
+<note>Fractional values are truncated to the second decimal
+position for em, mm and cm, and to the first decimal position for
+typographic points. Pixels are integers.</note>
-Since: 0.8
+Since: 1.0
</description>
<parameters>
-<parameter name="timeline">
-<parameter_description> the #ClutterTimeline which received the signal
-</parameter_description>
-</parameter>
-<parameter name="marker_name">
-<parameter_description> the name of the marker reached
-</parameter_description>
-</parameter>
-<parameter name="msecs">
-<parameter_description> the elapsed time
+<parameter name="units">
+<parameter_description> a #ClutterUnits
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a newly allocated string containing the encoded
+#ClutterUnits value. Use g_free() to free the string
+
+</return>
</function>
<function name="clutter_actor_set_x">
@@ -17882,29 +20290,81 @@ Since: 0.6
<return></return>
</function>
-<function name="clutter_animation_get_interval">
+<function name="clutter_input_device_update_from_event">
<description>
-Retrieves the #ClutterInterval associated to @property_name
-inside @animation.
+Forcibly updates the state of the @device using a #ClutterEvent
+
+This function should never be used by applications: it is meant
+for integration with embedding toolkits, like clutter-gtk
+
+Embedding toolkits that disable the event collection inside Clutter
+need to use this function to update the state of input devices depending
+on a #ClutterEvent that they are going to submit to the event handling code
+in Clutter though clutter_do_event(). Since the input devices hold the state
+that is going to be used to fill in fields like the #ClutterButtonEvent
+click count, or to emit synthesized events like %CLUTTER_ENTER and
+%CLUTTER_LEAVE, it is necessary for embedding toolkits to also be
+responsible of updating the input device state.
+
+For instance, this might be the code to translate an embedding toolkit
+native motion notification into a Clutter #ClutterMotionEvent and ask
+Clutter to process it:
+
+|[
+ClutterEvent c_event;
+
+translate_native_event_to_clutter (native_event, &c_event);
+
+clutter_do_event (&c_event);
+]|
+
+Before letting clutter_do_event() process the event, it is necessary to call
+clutter_input_device_update_from_event():
+
+|[
+ClutterEvent c_event;
+ClutterDeviceManager *manager;
+ClutterInputDevice *device;
+
+translate_native_event_to_clutter (native_event, &c_event);
+/ * get the device manager * /
+manager = clutter_device_manager_get_default ();
+
+/ * use the default Core Pointer that Clutter
+* backends register by default
+* /
+device = clutter_device_manager_get_core_device (manager, %CLUTTER_POINTER_DEVICE);
+
+/ * update the state of the input device * /
+clutter_input_device_update_from_event (device, &c_event, FALSE);
+
+clutter_do_event (&c_event);
+]|
+
+The @update_stage boolean argument should be used when the input device
+enters and leaves a #ClutterStage; it will use the #ClutterStage field
+of the passed @event to update the stage associated to the input device.
+
+Since: 1.2
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="device">
+<parameter_description> a #ClutterInputDevice
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> name of the property
+<parameter name="event">
+<parameter_description> a #ClutterEvent
+</parameter_description>
+</parameter>
+<parameter name="update_stage">
+<parameter_description> whether to update the #ClutterStage of the @device
+using the stage of the event
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterInterval or %NULL if no
-property with the same name was found. The returned interval is
-owned by the #ClutterAnimation and should not be unreferenced
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_behaviour_depth_new">
@@ -17912,6 +20372,7 @@ Since: 1.0
Creates a new #ClutterBehaviourDepth which can be used to control
the ClutterActor:depth property of a set of #ClutterActor<!-- -->s.
+Since: 0.4
</description>
<parameters>
@@ -17930,83 +20391,120 @@ the ClutterActor:depth property of a set of #ClutterActor<!-- -->s.
</parameters>
<return> the newly created behaviour
-Since: 0.4
</return>
</function>
-<function name="clutter_alpha_register_closure">
+<function name="clutter_binding_pool_find">
<description>
-#GClosure variant of clutter_alpha_register_func().
+Finds the #ClutterBindingPool with @name.
-Registers a global alpha function and returns its logical id
-to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
+Since: 1.0
-The logical id is always greater than %CLUTTER_ANIMATION_LAST.
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name of the binding pool to find
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the #ClutterBindingPool, or %NULL
+</return>
+</function>
+
+<function name="clutter_model_get_n_columns">
+<description>
+Retrieves the number of columns inside @model.
+
+Since: 0.6
</description>
<parameters>
-<parameter name="closure">
-<parameter_description> a #GClosure
+<parameter name="model">
+<parameter_description> a #ClutterModel
</parameter_description>
</parameter>
</parameters>
-<return> the logical id of the alpha function
+<return> the number of columns
-Since: 1.0
</return>
</function>
-<function name="clutter_binding_pool_find">
+<function name="clutter_scriptable_set_custom_property">
<description>
-Finds the #ClutterBindingPool with @name.
+Overrides the common properties setting. The underlying virtual
+function should be used when implementing custom properties.
+Since: 0.6
</description>
<parameters>
+<parameter name="scriptable">
+<parameter_description> a #ClutterScriptable
+</parameter_description>
+</parameter>
+<parameter name="script">
+<parameter_description> the #ClutterScript creating the scriptable instance
+</parameter_description>
+</parameter>
<parameter name="name">
-<parameter_description> the name of the binding pool to find
+<parameter_description> the name of the property
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the property
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a pointer to the #ClutterBindingPool, or %NULL
-
-Since: 1.0
-</return>
+<return></return>
</function>
-<function name="clutter_model_get_n_columns">
+<function name="clutter_animator_start">
<description>
-Retrieves the number of columns inside @model.
+Start the ClutterAnimator, this is a thin wrapper that rewinds
+and starts the animators current timeline.
+Since: 1.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="animator">
+<parameter_description> a #ClutterAnimator
</parameter_description>
</parameter>
</parameters>
-<return> the number of columns
+<return> the #ClutterTimeline that drives the animator.
-Since: 0.6
</return>
</function>
-<function name="json_node_get_array">
+<function name="clutter_box_layout_get_alignment">
<description>
-Retrieves the #JsonArray stored inside a #JsonNode
+Retrieves the horizontal and vertical alignment policies for @actor
+as set using clutter_box_layout_pack() or clutter_box_layout_set_alignment()
+Since: 1.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
+</parameter_description>
+</parameter>
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
+</parameter_description>
+</parameter>
+<parameter name="x_align">
+<parameter_description> return location for the horizontal alignment policy
+</parameter_description>
+</parameter>
+<parameter name="y_align">
+<parameter_description> return location for the vertical alignment policy
</parameter_description>
</parameter>
</parameters>
-<return> the #JsonArray
-</return>
+<return></return>
</function>
<function name="clutter_model_iter_is_last">
@@ -18014,6 +20512,7 @@ Retrieves the #JsonArray stored inside a #JsonNode
Gets whether the iterator is at the end of the model to which it
belongs.
+Since: 0.6
</description>
<parameters>
@@ -18024,7 +20523,6 @@ belongs.
</parameters>
<return> #TRUE if @iter is the last iter in the filtered model.
-Since: 0.6
</return>
</function>
@@ -18044,25 +20542,87 @@ Since: 0.6
<return></return>
</function>
-<function name="json_node_set_string">
+<function name="clutter_media_set_playing">
<description>
-Sets @value as the string content of the @node, replacing any existing
-content.
+Starts or stops playing of @media.
+
+Since: 0.2
</description>
<parameters>
-<parameter name="node">
-<parameter_description> a #JsonNode of type %JSON_NODE_VALUE
+<parameter name="media">
+<parameter_description> a #ClutterMedia
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a string value
+<parameter name="playing">
+<parameter_description> %TRUE to start playing
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_alpha_set_closure">
+<description>
+Sets the #GClosure used to compute the alpha value at each
+frame of the #ClutterTimeline bound to @alpha.
+
+Since: 0.8
+
+</description>
+<parameters>
+<parameter name="alpha">
+<parameter_description> A #ClutterAlpha
+</parameter_description>
+</parameter>
+<parameter name="closure">
+<parameter_description> A #GClosure
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="clutter_stage_read_pixels">
+<description>
+Makes a screenshot of the stage in RGBA 8bit data, returns a
+linear buffer with @width * 4 as rowstride.
+
+The alpha data contained in the returned buffer is driver-dependent,
+and not guaranteed to hold any sensible value.
+
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> A #ClutterStage
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> x coordinate of the first pixel that is read from stage
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y coordinate of the first pixel that is read from stage
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width dimention of pixels to be read, or -1 for the
+entire stage width
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height dimention of pixels to be read, or -1 for the
+entire stage height
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to newly allocated memory with the buffer
+or %NULL if the read failed. Use g_free() on the returned data
+to release the resources it has allocated.
+</return>
+</function>
+
<function name="clutter_value_set_shader_float">
<description>
Sets @floats as the contents of @value. The passed #GValue
@@ -18088,20 +20648,29 @@ Since: 0.8
<return></return>
</function>
-<function name="_clutter_stage_needs_update">
+<function name="clutter_color_add">
<description>
-Determines if _clutter_stage_do_update() needs to be called.
+Adds @a to @b and saves the resulting color inside @result.
+The alpha channel of @result is set as as the maximum value
+between the alpha channels of @a and @b.
</description>
<parameters>
-<parameter name="stage">
-<parameter_description> A #ClutterStage
+<parameter name="a">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> a #ClutterColor
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> return location for the result
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stage need layout or painting
-</return>
+<return></return>
</function>
<function name="clutter_actor_set_reactive">
@@ -18124,6 +20693,22 @@ Since: 0.6
<return></return>
</function>
+<function name="clutter_actor_box_clamp_to_pixel">
+<description>
+Clamps the components of @box to the nearest integer
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #ClutterActorBox to clamp
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="clutter_x11_set_display">
<description>
Sets the display connection Clutter should use; must be called
@@ -18147,52 +20732,39 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_path_add_curve_to">
+<function name="clutter_alpha_new_full">
<description>
-Adds a #CLUTTER_PATH_CURVE_TO type node to the path. This causes
-the actor to follow a bezier from the last node to (@x_3, @y_3) using
-(@x_1, @y_1) and (@x_2,@y_2) as control points.
+Creates a new #ClutterAlpha instance and sets the timeline
+and animation mode.
+
+See also clutter_alpha_set_timeline() and clutter_alpha_set_mode().
Since: 1.0
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-<parameter name="x_1">
-<parameter_description> the x coordinate of the first control point
-</parameter_description>
-</parameter>
-<parameter name="y_1">
-<parameter_description> the y coordinate of the first control point
-</parameter_description>
-</parameter>
-<parameter name="x_2">
-<parameter_description> the x coordinate of the second control point
-</parameter_description>
-</parameter>
-<parameter name="y_2">
-<parameter_description> the y coordinate of the second control point
-</parameter_description>
-</parameter>
-<parameter name="x_3">
-<parameter_description> the x coordinate of the third control point
+<parameter name="timeline">
+<parameter_description> #ClutterTimeline timeline
</parameter_description>
</parameter>
-<parameter name="y_3">
-<parameter_description> the y coordinate of the third control point
+<parameter name="mode">
+<parameter_description> animation mode
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #ClutterAlpha
+
+</return>
</function>
-<function name="clutter_text_get_selectable">
+<function name="clutter_text_get_chars">
<description>
-Retrieves whether a #ClutterText is selectable or not.
+Retrieves the contents of the #ClutterText actor between
+ start_pos and @end_pos.
+The positions are specified in characters, not in bytes.
+
+Since: 1.0
</description>
<parameters>
@@ -18200,27 +20772,35 @@ Retrieves whether a #ClutterText is selectable or not.
<parameter_description> a #ClutterText
</parameter_description>
</parameter>
+<parameter name="start_pos">
+<parameter_description> start of text, in characters
+</parameter_description>
+</parameter>
+<parameter name="end_pos">
+<parameter_description> end of text, in characters
+</parameter_description>
+</parameter>
</parameters>
-<return> %TRUE if the actor is selectable
+<return> a newly allocated string with the contents of
+the text actor between the specified positions. Use g_free()
+to free the resources when done
-Since: 1.0
</return>
</function>
-<function name="clutter_backend_set_double_click_distance">
+<function name="clutter_set_default_frame_rate">
<description>
-Sets the maximum distance used to verify a double click event.
+Sets the default frame rate. This frame rate will be used to limit
+the number of frames drawn if Clutter is not able to synchronize
+with the vertical refresh rate of the display. When synchronization
+is possible, this value is ignored.
-Since: 0.4
+Since: 0.6
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #ClutterBackend
-</parameter_description>
-</parameter>
-<parameter name="distance">
-<parameter_description> a distance, in pixels
+<parameter name="frames_per_sec">
+<parameter_description> the new default frame rate
</parameter_description>
</parameter>
</parameters>
@@ -18246,23 +20826,29 @@ content.
<return></return>
</function>
-<function name="clutter_event_get_device_type">
+<function name="clutter_texture_get_repeat">
<description>
-Retrieves the type of the device for @event
+Retrieves the horizontal and vertical repeat values set
+using clutter_texture_set_repeat()
+Since: 1.0
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a #ClutterEvent
+<parameter name="texture">
+<parameter_description> a #ClutterTexture
+</parameter_description>
+</parameter>
+<parameter name="repeat_x">
+<parameter_description> return location for the horizontal repeat
+</parameter_description>
+</parameter>
+<parameter name="repeat_y">
+<parameter_description> return location for the vertical repeat
</parameter_description>
</parameter>
</parameters>
-<return> the #ClutterInputDeviceType for the device, if
-any is set
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="clutter_main">
@@ -18275,12 +20861,86 @@ Starts the Clutter mainloop.
<return></return>
</function>
-<function name="clutter_behaviour_get_actors">
+<function name="clutter_units_from_string">
<description>
-Retrieves all the actors to which @behave applies. It is not recommended
-for derived classes to use this in there alpha notify method but use
-#clutter_behaviour_actors_foreach as it avoids alot of needless allocations.
+Parses a value and updates @units with it
+
+A #ClutterUnits expressed in string should match:
+
+|[
+units: wsp* unit-value wsp* unit-name? wsp*
+unit-value: number
+unit-name: 'px' | 'pt' | 'mm' | 'em' | 'cm'
+number: digit+
+| digit* sep digit+
+sep: '.' | ','
+digit: '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'
+wsp: (#0x20 | #0x9 | #0xA | #0xB | #0xC | #0xD)+
+]|
+
+For instance, these are valid strings:
+
+|[
+10 px
+5.1 em
+24 pt
+12.6 mm
+.3 cm
+]|
+
+While these are not:
+
+|[
+42 cats
+omg!1!ponies
+]|
+
+<note>If no unit is specified, pixels are assumed.</note>
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="units">
+<parameter_description> a #ClutterUnits
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> the string to convert
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the string was successfully parsed,
+and %FALSE otherwise
+
+</return>
+</function>
+
+<function name="clutter_device_manager_list_devices">
+<description>
+Lists all currently registered input devices
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="device_manager">
+<parameter_description> a #ClutterDeviceManager
+</parameter_description>
+</parameter>
+</parameters>
+<return>
+a newly allocated list of #ClutterInputDevice objects. Use
+g_slist_free() to deallocate it when done
+
+</return>
+</function>
+
+<function name="clutter_behaviour_get_alpha">
+<description>
+Retrieves the #ClutterAlpha object bound to @behave.
+
+Since: 0.2
</description>
<parameters>
@@ -18289,28 +20949,25 @@ for derived classes to use this in there alpha notify method but use
</parameter_description>
</parameter>
</parameters>
-<return> (transfer container) (element-type ClutterActor): a list of actors.
-You should free the returned list with g_slist_free() when finished using it.
+<return> a #ClutterAlpha object, or %NULL if no alpha
+object has been bound to this behaviour.
-Since: 0.2
</return>
</function>
-<function name="clutter_actor_get_reactive">
+<function name="cogl_util_next_p2">
<description>
-Checks whether @actor is marked as reactive.
+Calculates the next power greater than @a.
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="a">
+<parameter_description> Value to get the next power
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the actor is reactive
-
-Since: 0.6
+<return> The next power after @a.
</return>
</function>
@@ -18318,6 +20975,7 @@ Since: 0.6
<description>
Retrieves the size of the cursor of a #ClutterText actor.
+Since: 1.0
</description>
<parameters>
@@ -18328,7 +20986,6 @@ Retrieves the size of the cursor of a #ClutterText actor.
</parameters>
<return> the size of the cursor, in pixels
-Since: 1.0
</return>
</function>
@@ -18344,7 +21001,7 @@ in @result.
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> (out): return location for the lighter color
+<parameter_description> return location for the lighter color
</parameter_description>
</parameter>
</parameters>
@@ -18394,6 +21051,7 @@ Gets the double value stored inside a #JsonNode
<description>
Retrieves the direction of the scrolling of @event
+Since: 1.0
</description>
<parameters>
@@ -18404,7 +21062,6 @@ Retrieves the direction of the scrolling of @event
</parameters>
<return> the scrolling direction
-Since: 1.0
</return>
</function>
@@ -18412,6 +21069,7 @@ Since: 1.0
<description>
Retrieves the time of the event.
+Since: 0.4
</description>
<parameters>
@@ -18422,7 +21080,6 @@ Retrieves the time of the event.
</parameters>
<return> the time of the event, or %CLUTTER_CURRENT_TIME
-Since: 0.4
</return>
</function>
@@ -18488,6 +21145,7 @@ Create a new #ClutterGroup.
<description>
Retrieves whether the cursor of a #ClutterText actor is visible.
+Since: 1.0
</description>
<parameters>
@@ -18498,27 +21156,9 @@ Retrieves whether the cursor of a #ClutterText actor is visible.
</parameters>
<return> %TRUE if the cursor is visible
-Since: 1.0
</return>
</function>
-<function name="ClutterX11TexturePixmap">
-<description>
-The ::hide signal is emitted to ask the texture to update its
-content from its source pixmap.
-
-Since: 0.8
-
-</description>
-<parameters>
-<parameter name="texture">
-<parameter_description> the object which received the signal
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="json_node_dup_string">
<description>
Gets a copy of the string value stored inside a #JsonNode
@@ -18540,6 +21180,7 @@ the #JsonNode contents
<description>
Gets the width of the elliptical path.
+Since: 0.4
</description>
<parameters>
@@ -18550,7 +21191,6 @@ Gets the width of the elliptical path.
</parameters>
<return> the width of the path
-Since: 0.4
</return>
</function>
@@ -18558,6 +21198,7 @@ Since: 0.4
<description>
Retrieves the value stored inside @units
+Since: 1.0
</description>
<parameters>
@@ -18568,42 +21209,43 @@ Retrieves the value stored inside @units
</parameters>
<return> the value stored inside a #ClutterUnits
-Since: 1.0
</return>
</function>
<function name="clutter_get_show_fps">
<description>
-Return value: %TRUE if Clutter should show the FPS.
+Returns whether Clutter should print out the frames per second on the
+console. You can enable this setting either using the
+<literal>CLUTTER_SHOW_FPS</literal> environment variable or passing
+the <literal>--clutter-show-fps</literal> command line argument. *
+
+Since: 0.4
</description>
<parameters>
</parameters>
<return> %TRUE if Clutter should show the FPS.
-Since: 0.4
</return>
</function>
-<function name="clutter_behaviour_opacity_get_bounds">
+<function name="clutter_box_set_layout_manager">
<description>
-Gets the initial and final levels of the opacity applied by @behaviour
-on each actor it controls.
+Sets the #ClutterLayoutManager for @box
-Since: 0.6
+A #ClutterLayoutManager is a delegate object that controls the
+layout of the children of @box
+
+Since: 1.2
</description>
<parameters>
-<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 name="box">
+<parameter_description> a #ClutterBox
</parameter_description>
</parameter>
-<parameter name="opacity_end">
-<parameter_description> return location for the maximum level of opacity, or %NULL
+<parameter name="manager">
+<parameter_description> a #ClutterLayoutManager
</parameter_description>
</parameter>
</parameters>
@@ -18617,6 +21259,7 @@ stored in @member_name of @object
See also: json_object_get_member()
+Since: 0.8
</description>
<parameters>
@@ -18631,7 +21274,6 @@ See also: json_object_get_member()
</parameters>
<return> the string value of the object's member
-Since: 0.8
</return>
</function>
@@ -18684,28 +21326,39 @@ Since: 0.4
<return></return>
</function>
-<function name="json_object_dup_member">
+<function name="clutter_box_pack">
<description>
-Retrieves a copy of the #JsonNode containing the value of @member_name
-inside a #JsonObject
+Adds @actor to @box and sets layout properties at the same time,
+if the #ClutterLayoutManager used by @box has them
+
+This function is a wrapper around clutter_container_add_actor()
+and clutter_layout_manager_child_set()
+Language bindings should use the vector-based clutter_box_addv()
+variant instead
+
+Since: 1.2
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #JsonObject
+<parameter name="box">
+<parameter_description> a #ClutterBox
</parameter_description>
</parameter>
-<parameter name="member_name">
-<parameter_description> the name of the JSON object member to access
+<parameter name="actor">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="first_property">
+<parameter_description> the name of the first property to set, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of property name and value pairs, terminated by %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a copy of the node for the requested object member
-or %NULL. Use json_node_free() when done.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_binding_pool_remove_action">
@@ -18733,28 +21386,28 @@ Since: 1.0
<return></return>
</function>
-<function name="json_array_dup_element">
+<function name="clutter_container_remove_valist">
<description>
-Retrieves a copy of the #JsonNode containing the value of the
-element at @index_ inside a #JsonArray
+Alternative va_list version of clutter_container_remove().
+Since: 0.4
</description>
<parameters>
-<parameter name="array">
-<parameter_description> a #JsonArray
+<parameter name="container">
+<parameter_description> a #ClutterContainer
</parameter_description>
</parameter>
-<parameter name="index_">
-<parameter_description> the index of the element to retrieve
+<parameter name="first_actor">
+<parameter_description> the first #ClutterActor to add
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> list of actors to remove, followed by %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a copy of the #JsonNode at the requested index.
-Use json_node_free() when done.
-
-Since: 0.6
-</return>
+<return></return>
</function>
<function name="clutter_actor_set_size">
@@ -18788,50 +21441,77 @@ This function sets or unsets both the minimum and natural size.
<return></return>
</function>
-<function name="clutter_model_insert_value">
+<function name="clutter_box_layout_set_expand">
<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. If the row does
-not exist then it is created.
+Sets whether @actor should expand inside @layout
-Since: 0.6
+Since: 1.2
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
+<parameter name="layout">
+<parameter_description> a #ClutterBoxLayout
</parameter_description>
</parameter>
-<parameter name="row">
-<parameter_description> position of the row to modify
+<parameter name="actor">
+<parameter_description> a #ClutterActor child of @layout
</parameter_description>
</parameter>
-<parameter name="column">
-<parameter_description> column to modify
+<parameter name="expand">
+<parameter_description> whether @actor should expand
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> new value for the cell
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_behaviour_get_nth_actor">
+<description>
+Gets an actor the behaviour was applied to referenced by index num.
+
+Since: 0.2
+
+</description>
+<parameters>
+<parameter name="behave">
+<parameter_description> a #ClutterBehaviour
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of an actor this behaviour is applied too.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A Clutter actor or NULL if @index_ is invalid.
+
+</return>
</function>
-<function name="clutter_event_get_device_id">
+<function name="clutter_behaviour_opacity_new">
<description>
-Retrieves the events device id if set.
+Creates a new #ClutterBehaviourOpacity object, driven by @alpha
+which controls the opacity property of every actor, making it
+change in the interval between @opacity_start and @opacity_end.
+Since: 0.2
</description>
<parameters>
-<parameter name="event">
-<parameter_description> a clutter event
+<parameter name="alpha">
+<parameter_description> a #ClutterAlpha instance, or %NULL
+</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> A unique identifier for the device or -1 if the event has
-no specific device set.
+<return> the newly created #ClutterBehaviourOpacity
+
</return>
</function>
@@ -18839,6 +21519,7 @@ no specific device set.
<description>
Checks whether @shader is enabled.
+Since: 0.6
</description>
<parameters>
@@ -18849,26 +21530,36 @@ Checks whether @shader is enabled.
</parameters>
<return> %TRUE if the shader is enabled.
-Since: 0.6
</return>
</function>
-<function name="clutter_animation_get_object">
+<function name="clutter_actor_get_abs_allocation_vertices">
<description>
-Retrieves the #GObject attached to @animation.
+Calculates the transformed screen coordinates of the four corners of
+the actor; the returned vertices relate to the #ClutterActorBox
+coordinates as follows:
+<itemizedlist>
+<listitem><para>v[0] contains (x1, y1)</para></listitem>
+<listitem><para>v[1] contains (x2, y1)</para></listitem>
+<listitem><para>v[2] contains (x1, y2)</para></listitem>
+<listitem><para>v[3] contains (x2, y2)</para></listitem>
+</itemizedlist>
+Since: 0.4
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="self">
+<parameter_description> A #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="verts">
+<parameter_description> Pointer to a location of an array
+of 4 #ClutterVertex where to store the result.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #GObject
-
-Since: 1.0
-</return>
+<return></return>
</function>
<function name="json_node_copy">
@@ -18892,6 +21583,7 @@ count of the objects is increased.
<description>
Retrieves the button number of @event
+Since: 1.0
</description>
<parameters>
@@ -18903,7 +21595,40 @@ of type %CLUTTER_BUTTON_RELEASE
</parameters>
<return> the button number
+</return>
+</function>
+
+<function name="clutter_stage_hide_cursor">
+<description>
+Makes the cursor invisible on the stage window
+
+Since: 0.4
+
+</description>
+<parameters>
+<parameter name="stage">
+<parameter_description> a #ClutterStage
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_box_get_y">
+<description>
+Retrieves the Y coordinate of the origin of @box
+
Since: 1.0
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #ClutterActorBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the Y coordinate of the origin
+
</return>
</function>
@@ -18927,70 +21652,160 @@ Since: 0.8
<return></return>
</function>
-<function name="clutter_animation_set_timeline">
+<function name="clutter_value_get_shader_int">
<description>
-Sets the #ClutterTimeline used by @animation.
+Retrieves the list of integer values stored inside the passed
+#GValue. @value must have been initialized with
+%CLUTTER_TYPE_SHADER_INT.
-Since: 1.0
+Since: 0.8
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #ClutterAnimation
+<parameter name="value">
+<parameter_description> a #GValue
</parameter_description>
</parameter>
-<parameter name="timeline">
-<parameter_description> a #ClutterTimeline, or %NULL to unset the
-current #ClutterTimeline
+<parameter name="length">
+<parameter_description> return location for the number of returned integer
+values, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the pointer to a list of integer values.
+The returned value is owned by the #GValue and should never
+be modified or freed.
+
+</return>
</function>
-<function name="clutter_actor_get_opacity">
+<function name="clutter_texture_new_from_actor">
<description>
-Retrieves the opacity value of an actor, as set by
-clutter_actor_set_opacity().
+Creates a new #ClutterTexture object with its source a prexisting
+actor (and associated children). The textures content will contain
+'live' redirected output of the actors scene.
-For retrieving the absolute opacity of the actor inside a paint
-virtual function, see clutter_actor_get_paint_opacity().
+Note this function is intented as a utility call for uniformly applying
+shaders to groups and other potential visual effects. It requires that
+the %CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend
+and the target system.
+Some tips on usage:
+
+<itemizedlist>
+<listitem>
+<para>The source actor must be made visible (i.e by calling
+#clutter_actor_show).</para>
+</listitem>
+<listitem>
+<para>The source actor must have a parent in order for it to be
+allocated a size from the layouting mechanism. If the source
+actor does not have a parent when this function is called then
+the ClutterTexture will adopt it and allocate it at its
+preferred size. Using this you can clone an actor that is
+otherwise not displayed. Because of this feature if you do
+intend to display the source actor then you must make sure that
+the actor is parented before calling
+clutter_texture_new_from_actor() or that you unparent it before
+adding it to a container.</para>
+</listitem>
+<listitem>
+<para>When getting the image for the clone texture, Clutter
+will attempt to render the source actor exactly as it would
+appear if it was rendered on screen. The source actor's parent
+transformations are taken into account. Therefore if your
+source actor is rotated along the X or Y axes so that it has
+some depth, the texture will appear differently depending on
+the on-screen location of the source actor. While painting the
+source actor, Clutter will set up a temporary asymmetric
+perspective matrix as the projection matrix so that the source
+actor will be projected as if a small section of the screen was
+being viewed. Before version 0.8.2, an orthogonal identity
+projection was used which meant that the source actor would be
+clipped if any part of it was not on the zero Z-plane.</para>
+</listitem>
+<listitem>
+<para>Avoid reparenting the source with the created texture.</para>
+</listitem>
+<listitem>
+<para>A group can be padded with a transparent rectangle as to
+provide a border to contents for shader output (blurring text
+for example).</para>
+</listitem>
+<listitem>
+<para>The texture will automatically resize to contain a further
+transformed source. However, this involves overhead and can be
+avoided by placing the source actor in a bounding group
+sized large enough to contain any child tranformations.</para>
+</listitem>
+<listitem>
+<para>Uploading pixel data to the texture (e.g by using
+clutter_actor_set_from_file()) will destroy the offscreen texture data
+and end redirection.</para>
+</listitem>
+<listitem>
+<para>cogl_texture_get_data() with the handle returned by
+clutter_texture_get_cogl_texture() can be used to read the
+offscreen texture pixels into a pixbuf.</para>
+</listitem>
+</itemizedlist>
+
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="actor">
+<parameter_description> A source #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return> the opacity of the actor
+<return> A newly created #ClutterTexture object, or %NULL on failure.
+
</return>
</function>
-<function name="clutter_actor_get_abs_allocation_vertices">
+<function name="clutter_device_manager_get_core_device">
<description>
-Calculates the transformed screen coordinates of the four corners of
-the actor; the returned vertices relate to the #ClutterActorBox
-coordinates as follows:
-<itemizedlist>
-<listitem><para>v[0] contains (x1, y1)</para></listitem>
-<listitem><para>v[1] contains (x2, y1)</para></listitem>
-<listitem><para>v[2] contains (x1, y2)</para></listitem>
-<listitem><para>v[3] contains (x2, y2)</para></listitem>
-</itemizedlist>
+Retrieves the core #ClutterInputDevice of type @device_type
+
+Core devices are devices created automatically by the default
+Clutter backend
+
+Since: 1.2
+
+</description>
+<parameters>
+<parameter name="device_manager">
+<parameter_description> a #ClutterDeviceManager
+</parameter_description>
+</parameter>
+<parameter name="device_type">
+<parameter_description> the type of the core device
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #ClutterInputDevice or %NULL. The
+returned device is owned by the #ClutterDeviceManager and should
+not be modified or freed
+
+</return>
+</function>
+
+<function name="clutter_backend_set_double_click_time">
+<description>
+Sets the maximum time between two button press events, used to
+verify whether it's a double click event or not.
Since: 0.4
</description>
<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
+<parameter name="backend">
+<parameter_description> a #ClutterBackend
</parameter_description>
</parameter>
-<parameter name="verts">
-<parameter_description> (out) (array fixed-size=4): Pointer to a location of an array
-of 4 #ClutterVertex where to store the result.
+<parameter name="msec">
+<parameter_description> milliseconds between two button press events
</parameter_description>
</parameter>
</parameters>
@@ -19001,6 +21816,7 @@ of 4 #ClutterVertex where to store the result.
<description>
Retrieves whether the stage is full screen or not
+Since: 1.0
</description>
<parameters>
@@ -19011,24 +21827,54 @@ Retrieves whether the stage is full screen or not
</parameters>
<return> %TRUE if the stage is full screen
-Since: 1.0
</return>
</function>
-<function name="clutter_knot_free">
+<function name="clutter_actor_get_text_direction">
<description>
-Frees the memory of an allocated knot.
+Retrieves the value set using clutter_actor_set_text_direction()
-Since: 0.2
+If no text direction has been previously set, the default text
+direction, as returned by clutter_get_default_text_direction(), will
+be returned instead
+
+Since: 1.2
</description>
<parameters>
-<parameter name="knot">
-<parameter_description> a #ClutterKnot
+<parameter name="self">
+<parameter_description> a #ClutterActor
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #ClutterTextDirection for the actor
+
+</return>
+</function>
+
+<function name="clutter_actor_set_shader">
+<description>
+Sets the #ClutterShader to be used when rendering @self.
+
+If @shader is %NULL it will unset any currently set shader
+for the actor.
+
+Since: 0.6
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="shader">
+<parameter_description> a #ClutterShader or %NULL to unset the shader.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the shader was successfully applied
+
+</return>
</function>
<function name="clutter_behaviour_ellipse_set_angle_tilt">
@@ -19060,6 +21906,7 @@ degrees.
<description>
Retrieves the amount of the stream that is buffered.
+Since: 1.0
</description>
<parameters>
@@ -19070,25 +21917,24 @@ Retrieves the amount of the stream that is buffered.
</parameters>
<return> the fill level, between 0.0 and 1.0
-Since: 1.0
</return>
</function>
-<function name="clutter_behaviour_path_get_path">
+<function name="clutter_animator_key_get_progress">
<description>
-Get the current path of the behaviour
+Retrieves the progress of an clutter_animator_key
+Since: 1.2
</description>
<parameters>
-<parameter name="pathb">
-<parameter_description> a #ClutterBehaviourPath instance
+<parameter name="key">
+<parameter_description> a #ClutterAnimatorKey
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the path
+<return> the progress defined for a #ClutterAnimator key.
-Since: 1.0
</return>
</function>
@@ -19097,6 +21943,7 @@ Since: 1.0
Retrieves the animation mode of @animation, as set by
clutter_animation_set_mode().
+Since: 1.0
</description>
<parameters>
@@ -19107,46 +21954,41 @@ clutter_animation_set_mode().
</parameters>
<return> the mode for the animation
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_hide_all">
+<function name="json_node_dup_array">
<description>
-Calls clutter_actor_hide() on all child actors (if any).
+Retrieves the #JsonArray stored inside a #JsonNode and returns it
+with its reference count increased by one.
-Since: 0.2
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterActor
+<parameter name="node">
+<parameter_description> a #JsonNode
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #JsonArray with its reference count increased.
+</return>
</function>
-<function name="clutter_path_new_with_description">
+<function name="clutter_event_get_state">
<description>
-Creates a new #ClutterPath instance with the nodes described in
- desc See clutter_path_add_string() for details of the format of
-the string.
-
-The object has a floating reference so if you add it to a
-#ClutterBehaviourPath then you do not need to unref it.
+Retrieves the modifier state of the event.
+Since: 0.4
</description>
<parameters>
-<parameter name="desc">
-<parameter_description> a string describing the path
+<parameter name="event">
+<parameter_description> a #ClutterEvent
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #ClutterPath
+<return> the modifier state parameter, or 0
-Since: 1.0
</return>
</function>
@@ -19175,22 +22017,26 @@ Since: 1.0
<return></return>
</function>
-<function name="clutter_text_get_line_wrap">
+<function name="clutter_model_get_column_name">
<description>
-Retrieves the value set using clutter_text_set_line_wrap().
+Retrieves the name of the @column
+Since: 0.6
</description>
<parameters>
-<parameter name="self">
-<parameter_description> a #ClutterText
+<parameter name="model">
+<parameter_description> #ClutterModel
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column number
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #ClutterText actor should wrap
-its contents
+<return> the name of the column. The model holds the returned
+string, and it should not be modified or freed
-Since: 1.0
</return>
</function>
@@ -19198,6 +22044,11 @@ Since: 1.0
<description>
Sets the contents of a #ClutterText actor.
+If the #ClutterText:use-markup property was set to %TRUE it
+will be reset to %FALSE as a side effect. If you want to
+maintain the #ClutterText:use-markup you should use the
+clutter_text_set_markup() function instead
+
Since: 1.0
</description>
@@ -19219,6 +22070,7 @@ empty string)
<description>
Retrieves the #GType of the values inside @interval.
+Since: 1.0
</description>
<parameters>
@@ -19229,7 +22081,6 @@ Retrieves the #GType of the values inside @interval.
</parameters>
<return> the type of the value, or G_TYPE_INVALID
-Since: 1.0
</return>
</function>
@@ -19242,6 +22093,7 @@ by @x_offset, @y_offset, @width and @height.
function or from a callback to the #ClutterActor::paint
signal.</para></warning>
+Since: 1.0
</description>
<parameters>
@@ -19269,7 +22121,6 @@ signal.</para></warning>
<return> a newly created Cairo context. Use cairo_destroy()
to upload the contents of the context when done drawing
-Since: 1.0
</return>
</function>
@@ -19294,7 +22145,7 @@ between the alpha channels of @a and @b.
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> (out): return location for the result
+<parameter_description> return location for the result
</parameter_description>
</parameter>
</parameters>
@@ -19305,6 +22156,7 @@ between the alpha channels of @a and @b.
<description>
Creates a new #ClutterColor with the given values.
+Since: 0.8.4
</description>
<parameters>
@@ -19328,7 +22180,6 @@ Creates a new #ClutterColor with the given values.
<return> the newly allocated color. Use clutter_color_free()
when done
-Since: 0.8.4
</return>
</function>
@@ -19405,6 +22256,7 @@ Conveniently retrieves whether the element at @index_ is set to null
See also: json_array_get_element(), JSON_NODE_TYPE(), %JSON_NODE_NULL
+Since: 0.8
</description>
<parameters>
@@ -19419,7 +22271,6 @@ See also: json_array_get_element(), JSON_NODE_TYPE(), %JSON_NODE_NULL
</parameters>
<return> %TRUE if the element is null
-Since: 0.8
</return>
</function>
@@ -19452,11 +22303,46 @@ Since: 1.0
<return></return>
</function>
+<function name="clutter_group_remove_all">
+<description>
+Removes all children actors from the #ClutterGroup.
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> A #ClutterGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="clutter_actor_get_transformation_matrix">
+<description>
+Retrieves the transformations applied to @self
+
+Since: 1.0
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #ClutterActor
+</parameter_description>
+</parameter>
+<parameter name="matrix">
+<parameter_description> the return location for a #CoglMatrix
+</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.
+Since: 0.6
</description>
<parameters>
@@ -19472,7 +22358,6 @@ the reference count of the returned object.
<return> : (transfer none): the named object, or %NULL if no object
with the given name was available
-Since: 0.6
</return>
</function>
@@ -19495,91 +22380,30 @@ using it, call g_value_unset() on the #GValue.
<return></return>
</function>
-<function name="clutter_model_appendv">
+<function name="clutter_timeline_get_delta">
<description>
-Creates and appends a new row to the #ClutterModel, setting the row
-values for the given @columns upon creation.
-
-Since: 0.6
-
-</description>
-<parameters>
-<parameter name="model">
-<parameter_description> a #ClutterModel
-</parameter_description>
-</parameter>
-<parameter name="n_columns">
-<parameter_description> the number of columns and values
-</parameter_description>
-</parameter>
-<parameter name="columns">
-<parameter_description> (array length=n_columns): a vector with the columns to set
-</parameter_description>
-</parameter>
-<parameter name="values">
-<parameter_description> (array length=n_columns): a vector with the values
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Retrieves the amount of time elapsed since the last
+ClutterTimeline::new-frame signal.
-<function name="clutter_actor_get_animation">
-<description>
-Retrieves the #ClutterAnimation used by @actor, if clutter_actor_animate()
-has been called on @actor.
+This function is only useful inside handlers for the ::new-frame
+signal, and its behaviour is undefined if the timeline is not
+playing.
+Since: 0.6
</description>
<parameters>
-<parameter name="actor">
-<parameter_description> a #ClutterActor
+<parameter name="timeline">
+<parameter_description> a #ClutterTimeline
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAnimation, or %NULL
+<return> the amount of time in milliseconds elapsed since the
+last frame
-Since: 1.0
</return>
</function>
-<function name="clutter_actor_get_preferred_width">
-<description>
-Computes the requested minimum and natural widths for an actor,
-optionally depending on the specified height, or if they are
-already computed, returns the cached values.
-
-An actor may not get its request - depending on the layout
-manager that's in effect.
-
-A request should not incorporate the actor's scale or anchor point;
-those transformations do not affect layout, only rendering.
-
-Since: 0.8
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> A #ClutterActor
-</parameter_description>
-</parameter>
-<parameter name="for_height">
-<parameter_description> available height when computing the preferred width,
-or a negative value to indicate that no height is defined
-</parameter_description>
-</parameter>
-<parameter name="min_width_p">
-<parameter_description> (out): return location for minimum width, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_width_p">
-<parameter_description> (out): return location for the natural width, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="clutter_stage_ensure_current">
<description>
This function essentially makes sure the right GL context is
@@ -19598,45 +22422,45 @@ Since: 0.8
<return></return>
</function>
-<function name="ClutterBehaviour">
+<function name="clutter_path_insert_node">
<description>
-The ::removed signal is emitted each time a behaviour is not applied
-to an actor anymore.
+Inserts @node into the path before the node at the given offset. If
+ index_ is negative it will append the node to the end of the path.
+Since: 1.0
</description>
<parameters>
-<parameter name="behaviour">
-<parameter_description> the #ClutterBehaviour that received the signal
+<parameter name="path">
+<parameter_description> a #ClutterPath
</parameter_description>
</parameter>
-<parameter name="actor">
-<parameter_description> the removed actor
+<parameter name="index_">
+<parameter_description> offset of where to insert the node
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> the node to insert
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_path_insert_node">
+<function name="clutter_flow_layout_set_row_spacing">
<description>
-Inserts @node into the path before the node at the given offset. If
- index_ is negative it will append the node to the end of the path.
+Sets the spacing between rows, in pixels
-Since: 1.0
+Since: 1.2
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a #ClutterPath
-</parameter_description>
-</parameter>
-<parameter name="index_">
-<parameter_description> offset of where to insert the node
+<parameter name="layout">
+<parameter_description> a #ClutterFlowLayout
</parameter_description>
</parameter>
-<parameter name="node">
-<parameter_description> the node to insert
+<parameter name="spacing">
+<parameter_description> the space between rows
</parameter_description>
</parameter>
</parameters>
@@ -19669,6 +22493,7 @@ You can use the returned #PangoContext to create a #PangoLayout
and render text using cogl_pango_render_layout() to reuse the
glyphs cache also used by Clutter.
+Since: 1.0
</description>
<parameters>
@@ -19677,51 +22502,54 @@ glyphs cache also used by Clutter.
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): the #PangoContext for a #ClutterActor.
+<return> the #PangoContext for a #ClutterActor.
The returned #PangoContext is owned by the actor and should not be
unreferenced by the application code
-Since: 1.0
</return>
</function>
-<function name="clutter_value_set_color">
+<function name="clutter_score_rewind">
<description>
-Sets @value to @color.
+Rewinds a #ClutterScore to its initial state.
-Since: 0.8.4
+Since: 0.6
</description>
<parameters>
-<parameter name="value">
-<parameter_description> a #GValue initialized to #CLUTTER_TYPE_COLOR
-</parameter_description>
-</parameter>
-<parameter name="color">
-<parameter_description> the color to set
+<parameter name="score">
+<parameter_description> A #ClutterScore
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="clutter_behaviour_get_alpha">
+<function name="clutter_media_set_subtitle_font_name">
<description>
-Retrieves the #ClutterAlpha object bound to @behave.
+Sets the font used by the subtitle renderer. The @font_name string must be
+either %NULL, which means that the default font name of the underlying
+implementation will be used; or must follow the grammar recognized by
+pango_font_description_from_string() like:
+|[
+clutter_media_set_subtitle_font_name (media, "Sans 24pt");
+]|
+
+Since: 1.2
</description>
<parameters>
-<parameter name="behave">
-<parameter_description> a #ClutterBehaviour
+<parameter name="media">
+<parameter_description> a #ClutterMedia
+</parameter_description>
+</parameter>
+<parameter name="font_name">
+<parameter_description> a font name, or %NULL to set the default font name
</parameter_description>
</parameter>
</parameters>
-<return> (transfer none): a #ClutterAlpha object, or %NULL if no alpha
-object has been bound to this behaviour.
-
-Since: 0.2
-</return>
+<return></return>
</function>
</root>
diff --git a/clutter/src/clutter_methods.defs b/clutter/src/clutter_methods.defs
index 3872352..0013ae5 100644
--- a/clutter/src/clutter_methods.defs
+++ b/clutter/src/clutter_methods.defs
@@ -27,6 +27,13 @@
(gtype-id "CLUTTER_TYPE_ANIMATION")
)
+(define-object Animator
+ (in-module "Clutter")
+ (parent "GObject")
+ (c-name "ClutterAnimator")
+ (gtype-id "CLUTTER_TYPE_ANIMATOR")
+)
+
(define-object Backend
(in-module "Clutter")
(parent "GObject")
@@ -83,6 +90,13 @@
(gtype-id "CLUTTER_TYPE_BEHAVIOUR_SCALE")
)
+(define-object Box
+ (in-module "Clutter")
+ (parent "ClutterActor")
+ (c-name "ClutterBox")
+ (gtype-id "CLUTTER_TYPE_BOX")
+)
+
(define-object ChildMeta
(in-module "Clutter")
(parent "GObject")
@@ -103,6 +117,13 @@
(gtype-id "CLUTTER_TYPE_CONTAINER")
)
+(define-object DeviceManager
+ (in-module "Clutter")
+ (parent "GObject")
+ (c-name "ClutterDeviceManager")
+ (gtype-id "CLUTTER_TYPE_DEVICE_MANAGER")
+)
+
(define-object Group
(in-module "Clutter")
(parent "ClutterActor")
@@ -117,6 +138,48 @@
(gtype-id "CLUTTER_TYPE_INTERVAL")
)
+(define-object LayoutManager
+ (in-module "Clutter")
+ (parent "GInitiallyUnowned")
+ (c-name "ClutterLayoutManager")
+ (gtype-id "CLUTTER_TYPE_LAYOUT_MANAGER")
+)
+
+(define-object FlowLayout
+ (in-module "Clutter")
+ (parent "ClutterLayoutManager")
+ (c-name "ClutterFlowLayout")
+ (gtype-id "CLUTTER_TYPE_FLOW_LAYOUT")
+)
+
+(define-object FixedLayout
+ (in-module "Clutter")
+ (parent "ClutterLayoutManager")
+ (c-name "ClutterFixedLayout")
+ (gtype-id "CLUTTER_TYPE_FIXED_LAYOUT")
+)
+
+(define-object BoxLayout
+ (in-module "Clutter")
+ (parent "ClutterLayoutManager")
+ (c-name "ClutterBoxLayout")
+ (gtype-id "CLUTTER_TYPE_BOX_LAYOUT")
+)
+
+(define-object BinLayout
+ (in-module "Clutter")
+ (parent "ClutterLayoutManager")
+ (c-name "ClutterBinLayout")
+ (gtype-id "CLUTTER_TYPE_BIN_LAYOUT")
+)
+
+(define-object LayoutMeta
+ (in-module "Clutter")
+ (parent "ClutterChildMeta")
+ (c-name "ClutterLayoutMeta")
+ (gtype-id "CLUTTER_TYPE_LAYOUT_META")
+)
+
(define-object Media
(in-module "Clutter")
(c-name "ClutterMedia")
@@ -237,6 +300,7 @@
'("realized" "CLUTTER_ACTOR_REALIZED")
'("reactive" "CLUTTER_ACTOR_REACTIVE")
'("visible" "CLUTTER_ACTOR_VISIBLE")
+ '("no-layout" "CLUTTER_ACTOR_NO_LAYOUT")
)
)
@@ -250,6 +314,50 @@
)
)
+(define-flags RedrawFlags
+ (in-module "Clutter")
+ (c-name "ClutterRedrawFlags")
+ (gtype-id "CLUTTER_TYPE_REDRAW_FLAGS")
+ (values
+ '("box" "CLUTTER_REDRAW_CLIPPED_TO_BOX")
+ '("allocation" "CLUTTER_REDRAW_CLIPPED_TO_ALLOCATION")
+ )
+)
+
+(define-enum Interpolation
+ (in-module "Clutter")
+ (c-name "ClutterInterpolation")
+ (gtype-id "CLUTTER_TYPE_INTERPOLATION")
+ (values
+ '("linear" "CLUTTER_INTERPOLATION_LINEAR")
+ '("cubic" "CLUTTER_INTERPOLATION_CUBIC")
+ )
+)
+
+(define-enum BinAlignment
+ (in-module "Clutter")
+ (c-name "ClutterBinAlignment")
+ (gtype-id "CLUTTER_TYPE_BIN_ALIGNMENT")
+ (values
+ '("fixed" "CLUTTER_BIN_ALIGNMENT_FIXED")
+ '("fill" "CLUTTER_BIN_ALIGNMENT_FILL")
+ '("start" "CLUTTER_BIN_ALIGNMENT_START")
+ '("end" "CLUTTER_BIN_ALIGNMENT_END")
+ '("center" "CLUTTER_BIN_ALIGNMENT_CENTER")
+ )
+)
+
+(define-enum BoxAlignment
+ (in-module "Clutter")
+ (c-name "ClutterBoxAlignment")
+ (gtype-id "CLUTTER_TYPE_BOX_ALIGNMENT")
+ (values
+ '("start" "CLUTTER_BOX_ALIGNMENT_START")
+ '("end" "CLUTTER_BOX_ALIGNMENT_END")
+ '("center" "CLUTTER_BOX_ALIGNMENT_CENTER")
+ )
+)
+
(define-flags DebugFlag
(in-module "Clutter")
(c-name "ClutterDebugFlag")
@@ -271,7 +379,27 @@
'("multistage" "CLUTTER_DEBUG_MULTISTAGE")
'("animation" "CLUTTER_DEBUG_ANIMATION")
'("layout" "CLUTTER_DEBUG_LAYOUT")
+ )
+)
+
+(define-flags PickDebugFlag
+ (in-module "Clutter")
+ (c-name "ClutterPickDebugFlag")
+ (gtype-id "CLUTTER_TYPE_PICK_DEBUG_FLAG")
+ (values
'("nop-picking" "CLUTTER_DEBUG_NOP_PICKING")
+ '("dump-pick-buffers" "CLUTTER_DEBUG_DUMP_PICK_BUFFERS")
+ )
+)
+
+(define-flags DrawDebugFlag
+ (in-module "Clutter")
+ (c-name "ClutterDrawDebugFlag")
+ (gtype-id "CLUTTER_TYPE_DRAW_DEBUG_FLAG")
+ (values
+ '("disable-swap-events" "CLUTTER_DEBUG_DISABLE_SWAP_EVENTS")
+ '("disable-clipped-redraws" "CLUTTER_DEBUG_DISABLE_CLIPPED_REDRAWS")
+ '("redraws" "CLUTTER_DEBUG_REDRAWS")
)
)
@@ -355,18 +483,6 @@
)
)
-(define-enum InputDeviceType
- (in-module "Clutter")
- (c-name "ClutterInputDeviceType")
- (gtype-id "CLUTTER_TYPE_INPUT_DEVICE_TYPE")
- (values
- '("pointer-device" "CLUTTER_POINTER_DEVICE")
- '("keyboard-device" "CLUTTER_KEYBOARD_DEVICE")
- '("extension-device" "CLUTTER_EXTENSION_DEVICE")
- '("n-device-types" "CLUTTER_N_DEVICE_TYPES")
- )
-)
-
(define-flags FeatureFlags
(in-module "Clutter")
(c-name "ClutterFeatureFlags")
@@ -382,6 +498,29 @@
'("shaders-glsl" "CLUTTER_FEATURE_SHADERS_GLSL")
'("offscreen" "CLUTTER_FEATURE_OFFSCREEN")
'("stage-multiple" "CLUTTER_FEATURE_STAGE_MULTIPLE")
+ '("swap-events" "CLUTTER_FEATURE_SWAP_EVENTS")
+ )
+)
+
+(define-enum FlowOrientation
+ (in-module "Clutter")
+ (c-name "ClutterFlowOrientation")
+ (gtype-id "CLUTTER_TYPE_FLOW_ORIENTATION")
+ (values
+ '("horizontal" "CLUTTER_FLOW_HORIZONTAL")
+ '("vertical" "CLUTTER_FLOW_VERTICAL")
+ )
+)
+
+(define-enum InputDeviceType
+ (in-module "Clutter")
+ (c-name "ClutterInputDeviceType")
+ (gtype-id "CLUTTER_TYPE_INPUT_DEVICE_TYPE")
+ (values
+ '("pointer-device" "CLUTTER_POINTER_DEVICE")
+ '("keyboard-device" "CLUTTER_KEYBOARD_DEVICE")
+ '("extension-device" "CLUTTER_EXTENSION_DEVICE")
+ '("n-device-types" "CLUTTER_N_DEVICE_TYPES")
)
)
@@ -426,6 +565,17 @@
'("actor-in-paint" "CLUTTER_ACTOR_IN_PAINT")
'("actor-in-relayout" "CLUTTER_ACTOR_IN_RELAYOUT")
'("stage-in-resize" "CLUTTER_STAGE_IN_RESIZE")
+ '("actor-internal-child" "CLUTTER_ACTOR_INTERNAL_CHILD")
+ )
+)
+
+(define-flags ProfileFlag
+ (in-module "Clutter")
+ (c-name "ClutterProfileFlag")
+ (gtype-id "CLUTTER_TYPE_PROFILE_FLAG")
+ (values
+ '("picking-only" "CLUTTER_PROFILE_PICKING_ONLY")
+ '("disable-report" "CLUTTER_PROFILE_DISABLE_REPORT")
)
)
@@ -606,6 +756,17 @@
)
)
+(define-enum TextDirection
+ (in-module "Clutter")
+ (c-name "ClutterTextDirection")
+ (gtype-id "CLUTTER_TYPE_TEXT_DIRECTION")
+ (values
+ '("default" "CLUTTER_TEXT_DIRECTION_DEFAULT")
+ '("ltr" "CLUTTER_TEXT_DIRECTION_LTR")
+ '("rtl" "CLUTTER_TEXT_DIRECTION_RTL")
+ )
+)
+
(define-enum UnitType
(in-module "Clutter")
(c-name "ClutterUnitType")
@@ -615,6 +776,7 @@
'("em" "CLUTTER_UNIT_EM")
'("mm" "CLUTTER_UNIT_MM")
'("point" "CLUTTER_UNIT_POINT")
+ '("cm" "CLUTTER_UNIT_CM")
)
)
@@ -722,6 +884,21 @@
(return-type "none")
)
+(define-method set_request_mode
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_set_request_mode")
+ (return-type "none")
+ (parameters
+ '("ClutterRequestMode" "mode")
+ )
+)
+
+(define-method get_request_mode
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_get_request_mode")
+ (return-type "ClutterRequestMode")
+)
+
(define-method get_preferred_width
(of-object "ClutterActor")
(c-name "clutter_actor_get_preferred_width")
@@ -1478,6 +1655,39 @@
(return-type "gboolean")
)
+(define-method has_pointer
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_has_pointer")
+ (return-type "gboolean")
+)
+
+(define-method set_text_direction
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_set_text_direction")
+ (return-type "none")
+ (parameters
+ '("ClutterTextDirection" "text_dir")
+ )
+)
+
+(define-method get_text_direction
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_get_text_direction")
+ (return-type "ClutterTextDirection")
+)
+
+(define-method push_internal
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_push_internal")
+ (return-type "none")
+)
+
+(define-method pop_internal
+ (of-object "ClutterActor")
+ (c-name "clutter_actor_pop_internal")
+ (return-type "none")
+)
+
;; From clutter-alpha.h
@@ -1743,6 +1953,16 @@
)
)
+(define-method update
+ (of-object "ClutterAnimation")
+ (c-name "clutter_animation_update")
+ (return-type "ClutterAnimation*")
+ (parameters
+ '("const-gchar*" "property_name")
+ '("const-GValue*" "final")
+ )
+)
+
(define-method update_interval
(of-object "ClutterAnimation")
(c-name "clutter_animation_update_interval")
@@ -1858,6 +2078,203 @@
+;; From clutter-animator.h
+
+(define-function clutter_animator_get_type
+ (c-name "clutter_animator_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_animator_new
+ (c-name "clutter_animator_new")
+ (is-constructor-of "ClutterAnimator")
+ (return-type "ClutterAnimator*")
+)
+
+(define-method set_key
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_set_key")
+ (return-type "ClutterAnimator*")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("guint" "mode")
+ '("gdouble" "progress")
+ '("const-GValue*" "value")
+ )
+)
+
+(define-method set
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_set")
+ (return-type "none")
+ (parameters
+ '("gpointer" "first_object")
+ '("const-gchar*" "first_property_name")
+ '("guint" "first_mode")
+ '("gdouble" "first_progress")
+ )
+ (varargs #t)
+)
+
+(define-method get_keys
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_get_keys")
+ (return-type "GList*")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("gdouble" "progress")
+ )
+)
+
+(define-method remove_key
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_remove_key")
+ (return-type "none")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("gdouble" "progress")
+ )
+)
+
+(define-method start
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_start")
+ (return-type "ClutterTimeline*")
+)
+
+(define-method compute_value
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_compute_value")
+ (return-type "gboolean")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("gdouble" "progress")
+ '("GValue*" "value")
+ )
+)
+
+(define-method get_timeline
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_get_timeline")
+ (return-type "ClutterTimeline*")
+)
+
+(define-method set_timeline
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_set_timeline")
+ (return-type "none")
+ (parameters
+ '("ClutterTimeline*" "timeline")
+ )
+)
+
+(define-method get_duration
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_get_duration")
+ (return-type "guint")
+)
+
+(define-method set_duration
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_set_duration")
+ (return-type "none")
+ (parameters
+ '("guint" "duration")
+ )
+)
+
+(define-method property_get_ease_in
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_property_get_ease_in")
+ (return-type "gboolean")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ )
+)
+
+(define-method property_set_ease_in
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_property_set_ease_in")
+ (return-type "none")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("gboolean" "ease_in")
+ )
+)
+
+(define-method property_get_interpolation
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_property_get_interpolation")
+ (return-type "ClutterInterpolation")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ )
+)
+
+(define-method property_set_interpolation
+ (of-object "ClutterAnimator")
+ (c-name "clutter_animator_property_set_interpolation")
+ (return-type "none")
+ (parameters
+ '("GObject*" "object")
+ '("const-gchar*" "property_name")
+ '("ClutterInterpolation" "interpolation")
+ )
+)
+
+(define-function clutter_animator_key_get_type
+ (c-name "clutter_animator_key_get_type")
+ (return-type "GType")
+)
+
+(define-method get_object
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_object")
+ (return-type "GObject*")
+)
+
+(define-method get_property_name
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_property_name")
+ (return-type "const-gchar*")
+)
+
+(define-method get_property_type
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_property_type")
+ (return-type "GType")
+)
+
+(define-method get_mode
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_mode")
+ (return-type "gulong")
+)
+
+(define-method get_progress
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_progress")
+ (return-type "gdouble")
+)
+
+(define-method get_value
+ (of-object "ClutterAnimatorKey")
+ (c-name "clutter_animator_key_get_value")
+ (return-type "gboolean")
+ (parameters
+ '("GValue*" "value")
+ )
+)
+
+
+
;; From clutter-backend.h
(define-function clutter_backend_get_type
@@ -2606,6 +3023,350 @@
+;; From clutter-bin-layout.h
+
+(define-function clutter_bin_layout_get_type
+ (c-name "clutter_bin_layout_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_bin_layout_new
+ (c-name "clutter_bin_layout_new")
+ (is-constructor-of "ClutterBinLayout")
+ (return-type "ClutterLayoutManager*")
+ (parameters
+ '("ClutterBinAlignment" "x_align")
+ '("ClutterBinAlignment" "y_align")
+ )
+)
+
+(define-method set_alignment
+ (of-object "ClutterBinLayout")
+ (c-name "clutter_bin_layout_set_alignment")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "child")
+ '("ClutterBinAlignment" "x_align")
+ '("ClutterBinAlignment" "y_align")
+ )
+)
+
+(define-method get_alignment
+ (of-object "ClutterBinLayout")
+ (c-name "clutter_bin_layout_get_alignment")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "child")
+ '("ClutterBinAlignment*" "x_align")
+ '("ClutterBinAlignment*" "y_align")
+ )
+)
+
+(define-method add
+ (of-object "ClutterBinLayout")
+ (c-name "clutter_bin_layout_add")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "child")
+ '("ClutterBinAlignment" "x_align")
+ '("ClutterBinAlignment" "y_align")
+ )
+)
+
+
+
+;; From clutter-box.h
+
+(define-function clutter_box_get_type
+ (c-name "clutter_box_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_box_new
+ (c-name "clutter_box_new")
+ (is-constructor-of "ClutterBox")
+ (return-type "ClutterActor*")
+ (parameters
+ '("ClutterLayoutManager*" "manager")
+ )
+)
+
+(define-method set_layout_manager
+ (of-object "ClutterBox")
+ (c-name "clutter_box_set_layout_manager")
+ (return-type "none")
+ (parameters
+ '("ClutterLayoutManager*" "manager")
+ )
+)
+
+(define-method get_layout_manager
+ (of-object "ClutterBox")
+ (c-name "clutter_box_get_layout_manager")
+ (return-type "ClutterLayoutManager*")
+)
+
+(define-method set_color
+ (of-object "ClutterBox")
+ (c-name "clutter_box_set_color")
+ (return-type "none")
+ (parameters
+ '("const-ClutterColor*" "color")
+ )
+)
+
+(define-method get_color
+ (of-object "ClutterBox")
+ (c-name "clutter_box_get_color")
+ (return-type "none")
+ (parameters
+ '("ClutterColor*" "color")
+ )
+)
+
+(define-method pack
+ (of-object "ClutterBox")
+ (c-name "clutter_box_pack")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+(define-method packv
+ (of-object "ClutterBox")
+ (c-name "clutter_box_packv")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("guint" "n_properties")
+ '("const-gchar*-const[]" "properties")
+ '("const-GValue*" "values")
+ )
+)
+
+(define-method pack_after
+ (of-object "ClutterBox")
+ (c-name "clutter_box_pack_after")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("ClutterActor*" "sibling")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+(define-method pack_before
+ (of-object "ClutterBox")
+ (c-name "clutter_box_pack_before")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("ClutterActor*" "sibling")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+(define-method pack_at
+ (of-object "ClutterBox")
+ (c-name "clutter_box_pack_at")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("gint" "position")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+
+
+;; From clutter-box-layout.h
+
+(define-function clutter_box_layout_get_type
+ (c-name "clutter_box_layout_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_box_layout_new
+ (c-name "clutter_box_layout_new")
+ (is-constructor-of "ClutterBoxLayout")
+ (return-type "ClutterLayoutManager*")
+)
+
+(define-method set_spacing
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_spacing")
+ (return-type "none")
+ (parameters
+ '("guint" "spacing")
+ )
+)
+
+(define-method get_spacing
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_spacing")
+ (return-type "guint")
+)
+
+(define-method set_vertical
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_vertical")
+ (return-type "none")
+ (parameters
+ '("gboolean" "vertical")
+ )
+)
+
+(define-method get_vertical
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_vertical")
+ (return-type "gboolean")
+)
+
+(define-method set_pack_start
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_pack_start")
+ (return-type "none")
+ (parameters
+ '("gboolean" "pack_start")
+ )
+)
+
+(define-method get_pack_start
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_pack_start")
+ (return-type "gboolean")
+)
+
+(define-method pack
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_pack")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("gboolean" "expand")
+ '("gboolean" "x_fill")
+ '("gboolean" "y_fill")
+ '("ClutterBoxAlignment" "x_align")
+ '("ClutterBoxAlignment" "y_align")
+ )
+)
+
+(define-method set_alignment
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_alignment")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("ClutterBoxAlignment" "x_align")
+ '("ClutterBoxAlignment" "y_align")
+ )
+)
+
+(define-method get_alignment
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_alignment")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("ClutterBoxAlignment*" "x_align")
+ '("ClutterBoxAlignment*" "y_align")
+ )
+)
+
+(define-method set_fill
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_fill")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("gboolean" "x_fill")
+ '("gboolean" "y_fill")
+ )
+)
+
+(define-method get_fill
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_fill")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("gboolean*" "x_fill")
+ '("gboolean*" "y_fill")
+ )
+)
+
+(define-method set_expand
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_expand")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ '("gboolean" "expand")
+ )
+)
+
+(define-method get_expand
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_expand")
+ (return-type "gboolean")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
+(define-method set_use_animations
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_use_animations")
+ (return-type "none")
+ (parameters
+ '("gboolean" "animate")
+ )
+)
+
+(define-method get_use_animations
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_use_animations")
+ (return-type "gboolean")
+)
+
+(define-method set_easing_mode
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_easing_mode")
+ (return-type "none")
+ (parameters
+ '("gulong" "mode")
+ )
+)
+
+(define-method get_easing_mode
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_easing_mode")
+ (return-type "gulong")
+)
+
+(define-method set_easing_duration
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_set_easing_duration")
+ (return-type "none")
+ (parameters
+ '("guint" "msecs")
+ )
+)
+
+(define-method get_easing_duration
+ (of-object "ClutterBoxLayout")
+ (c-name "clutter_box_layout_get_easing_duration")
+ (return-type "guint")
+)
+
+
+
;; From clutter-cairo-texture.h
(define-function clutter_cairo_texture_get_type
@@ -3060,6 +3821,24 @@
)
)
+(define-method create_child_meta
+ (of-object "ClutterContainer")
+ (c-name "clutter_container_create_child_meta")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
+(define-method destroy_child_meta
+ (of-object "ClutterContainer")
+ (c-name "clutter_container_destroy_child_meta")
+ (return-type "none")
+ (parameters
+ '("ClutterActor*" "actor")
+ )
+)
+
(define-method get_child_meta
(of-object "ClutterContainer")
(c-name "clutter_container_get_child_meta")
@@ -3123,6 +3902,50 @@
+;; From clutter-device-manager.h
+
+(define-function clutter_device_manager_get_type
+ (c-name "clutter_device_manager_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_device_manager_get_default
+ (c-name "clutter_device_manager_get_default")
+ (return-type "ClutterDeviceManager*")
+)
+
+(define-method list_devices
+ (of-object "ClutterDeviceManager")
+ (c-name "clutter_device_manager_list_devices")
+ (return-type "GSList*")
+)
+
+(define-method peek_devices
+ (of-object "ClutterDeviceManager")
+ (c-name "clutter_device_manager_peek_devices")
+ (return-type "const-GSList*")
+)
+
+(define-method get_device
+ (of-object "ClutterDeviceManager")
+ (c-name "clutter_device_manager_get_device")
+ (return-type "ClutterInputDevice*")
+ (parameters
+ '("gint" "device_id")
+ )
+)
+
+(define-method get_core_device
+ (of-object "ClutterDeviceManager")
+ (c-name "clutter_device_manager_get_core_device")
+ (return-type "ClutterInputDevice*")
+ (parameters
+ '("ClutterInputDeviceType" "device_type")
+ )
+)
+
+
+
;; From clutter-enum-types.h
(define-function clutter_actor_flags_get_type
@@ -3135,6 +3958,26 @@
(return-type "GType")
)
+(define-function clutter_redraw_flags_get_type
+ (c-name "clutter_redraw_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_interpolation_get_type
+ (c-name "clutter_interpolation_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_bin_alignment_get_type
+ (c-name "clutter_bin_alignment_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_box_alignment_get_type
+ (c-name "clutter_box_alignment_get_type")
+ (return-type "GType")
+)
+
(define-function clutter_modifier_type_get_type
(c-name "clutter_modifier_type_get_type")
(return-type "GType")
@@ -3160,13 +4003,18 @@
(return-type "GType")
)
-(define-function clutter_input_device_type_get_type
- (c-name "clutter_input_device_type_get_type")
+(define-function clutter_feature_flags_get_type
+ (c-name "clutter_feature_flags_get_type")
(return-type "GType")
)
-(define-function clutter_feature_flags_get_type
- (c-name "clutter_feature_flags_get_type")
+(define-function clutter_flow_orientation_get_type
+ (c-name "clutter_flow_orientation_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_input_device_type_get_type
+ (c-name "clutter_input_device_type_get_type")
(return-type "GType")
)
@@ -3245,6 +4093,11 @@
(return-type "GType")
)
+(define-function clutter_text_direction_get_type
+ (c-name "clutter_text_direction_get_type")
+ (return-type "GType")
+)
+
(define-function clutter_unit_type_get_type
(c-name "clutter_unit_type_get_type")
(return-type "GType")
@@ -3420,16 +4273,9 @@
(return-type "guint32")
)
-(define-method get_device_type
- (of-object "ClutterInputDevice")
- (c-name "clutter_input_device_get_device_type")
- (return-type "ClutterInputDeviceType")
-)
-
-(define-method get_device_id
- (of-object "ClutterInputDevice")
- (c-name "clutter_input_device_get_device_id")
- (return-type "gint")
+(define-function clutter_get_current_event
+ (c-name "clutter_get_current_event")
+ (return-type "const-ClutterEvent*")
)
@@ -3491,6 +4337,139 @@
+;; From clutter-fixed-layout.h
+
+(define-function clutter_fixed_layout_get_type
+ (c-name "clutter_fixed_layout_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_fixed_layout_new
+ (c-name "clutter_fixed_layout_new")
+ (is-constructor-of "ClutterFixedLayout")
+ (return-type "ClutterLayoutManager*")
+)
+
+
+
+;; From clutter-flow-layout.h
+
+(define-function clutter_flow_layout_get_type
+ (c-name "clutter_flow_layout_get_type")
+ (return-type "GType")
+)
+
+(define-function clutter_flow_layout_new
+ (c-name "clutter_flow_layout_new")
+ (is-constructor-of "ClutterFlowLayout")
+ (return-type "ClutterLayoutManager*")
+ (parameters
+ '("ClutterFlowOrientation" "orientation")
+ )
+)
+
+(define-method set_orientation
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_orientation")
+ (return-type "none")
+ (parameters
+ '("ClutterFlowOrientation" "orientation")
+ )
+)
+
+(define-method get_orientation
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_orientation")
+ (return-type "ClutterFlowOrientation")
+)
+
+(define-method set_homogeneous
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_homogeneous")
+ (return-type "none")
+ (parameters
+ '("gboolean" "homogeneous")
+ )
+)
+
+(define-method get_homogeneous
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_homogeneous")
+ (return-type "gboolean")
+)
+
+(define-method set_column_spacing
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_column_spacing")
+ (return-type "none")
+ (parameters
+ '("gfloat" "spacing")
+ )
+)
+
+(define-method get_column_spacing
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_column_spacing")
+ (return-type "gfloat")
+)
+
+(define-method set_row_spacing
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_row_spacing")
+ (return-type "none")
+ (parameters
+ '("gfloat" "spacing")
+ )
+)
+
+(define-method get_row_spacing
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_row_spacing")
+ (return-type "gfloat")
+)
+
+(define-method set_column_width
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_column_width")
+ (return-type "none")
+ (parameters
+ '("gfloat" "min_width")
+ '("gfloat" "max_width")
+ )
+)
+
+(define-method get_column_width
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_column_width")
+ (return-type "none")
+ (parameters
+ '("gfloat*" "min_width")
+ '("gfloat*" "max_width")
+ )
+)
+
+(define-method set_row_height
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_set_row_height")
+ (return-type "none")
+ (parameters
+ '("gfloat" "min_height")
+ '("gfloat" "max_height")
+ )
+)
+
+(define-method get_row_height
+ (of-object "ClutterFlowLayout")
+ (c-name "clutter_flow_layout_get_row_height")
+ (return-type "none")
+ (parameters
+ '("gfloat*" "min_height")
+ '("gfloat*" "max_height")
+ )
+)
+
+
+
;; From clutter-frame-source.h
(define-function clutter_frame_source_add
@@ -3603,6 +4582,65 @@
+;; From clutter-input-device.h
+
+(define-function clutter_input_device_get_type
+ (c-name "clutter_input_device_get_type")
+ (return-type "GType")
+)
+
+(define-method get_device_type
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_device_type")
+ (return-type "ClutterInputDeviceType")
+)
+
+(define-method get_device_id
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_device_id")
+ (return-type "gint")
+)
+
+(define-method get_device_coords
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_device_coords")
+ (return-type "none")
+ (parameters
+ '("gint*" "x")
+ '("gint*" "y")
+ )
+)
+
+(define-method get_pointer_actor
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_pointer_actor")
+ (return-type "ClutterActor*")
+)
+
+(define-method get_pointer_stage
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_pointer_stage")
+ (return-type "ClutterStage*")
+)
+
+(define-method get_device_name
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_get_device_name")
+ (return-type "const-gchar*")
+)
+
+(define-method update_from_event
+ (of-object "ClutterInputDevice")
+ (c-name "clutter_input_device_update_from_event")
+ (return-type "none")
+ (parameters
+ '("ClutterEvent*" "event")
+ '("gboolean" "update_stage")
+ )
+)
+
+
+
;; From clutter-interval.h
(define-function clutter_interval_get_type
@@ -3750,6 +4788,178 @@
+;; From clutter-layout-manager.h
+
+(define-function clutter_layout_manager_get_type
+ (c-name "clutter_layout_manager_get_type")
+ (return-type "GType")
+)
+
+(define-method get_preferred_width
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_get_preferred_width")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("gfloat" "for_height")
+ '("gfloat*" "min_width_p")
+ '("gfloat*" "nat_width_p")
+ )
+)
+
+(define-method get_preferred_height
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_get_preferred_height")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("gfloat" "for_width")
+ '("gfloat*" "min_height_p")
+ '("gfloat*" "nat_height_p")
+ )
+)
+
+(define-method allocate
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_allocate")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("const-ClutterActorBox*" "allocation")
+ '("ClutterAllocationFlags" "flags")
+ )
+)
+
+(define-method set_container
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_set_container")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ )
+)
+
+(define-method layout_changed
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_layout_changed")
+ (return-type "none")
+)
+
+(define-method find_child_property
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_find_child_property")
+ (return-type "GParamSpec*")
+ (parameters
+ '("const-gchar*" "name")
+ )
+)
+
+(define-method list_child_properties
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_list_child_properties")
+ (return-type "GParamSpec**")
+ (parameters
+ '("guint*" "n_pspecs")
+ )
+)
+
+(define-method get_child_meta
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_get_child_meta")
+ (return-type "ClutterLayoutMeta*")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("ClutterActor*" "actor")
+ )
+)
+
+(define-method child_set
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_child_set")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("ClutterActor*" "actor")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+(define-method child_get
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_child_get")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("ClutterActor*" "actor")
+ '("const-gchar*" "first_property")
+ )
+ (varargs #t)
+)
+
+(define-method child_set_property
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_child_set_property")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("ClutterActor*" "actor")
+ '("const-gchar*" "property_name")
+ '("const-GValue*" "value")
+ )
+)
+
+(define-method child_get_property
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_child_get_property")
+ (return-type "none")
+ (parameters
+ '("ClutterContainer*" "container")
+ '("ClutterActor*" "actor")
+ '("const-gchar*" "property_name")
+ '("GValue*" "value")
+ )
+)
+
+(define-method begin_animation
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_begin_animation")
+ (return-type "ClutterAlpha*")
+ (parameters
+ '("guint" "duration")
+ '("gulong" "mode")
+ )
+)
+
+(define-method end_animation
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_end_animation")
+ (return-type "none")
+)
+
+(define-method get_animation_progress
+ (of-object "ClutterLayoutManager")
+ (c-name "clutter_layout_manager_get_animation_progress")
+ (return-type "gdouble")
+)
+
+
+
+;; From clutter-layout-meta.h
+
+(define-function clutter_layout_meta_get_type
+ (c-name "clutter_layout_meta_get_type")
+ (return-type "GType")
+)
+
+(define-method get_manager
+ (of-object "ClutterLayoutMeta")
+ (c-name "clutter_layout_meta_get_manager")
+ (return-type "ClutterLayoutManager*")
+)
+
+
+
;; From clutter-list-model.h
(define-function clutter_list_model_get_type
@@ -4085,6 +5295,11 @@
(return-type "PangoFontMap*")
)
+(define-function clutter_get_default_text_direction
+ (c-name "clutter_get_default_text_direction")
+ (return-type "ClutterTextDirection")
+)
+
;; From clutter-marshal.h
@@ -4161,6 +5376,36 @@
(return-type "gdouble")
)
+(define-method set_subtitle_uri
+ (of-object "ClutterMedia")
+ (c-name "clutter_media_set_subtitle_uri")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "uri")
+ )
+)
+
+(define-method get_subtitle_uri
+ (of-object "ClutterMedia")
+ (c-name "clutter_media_get_subtitle_uri")
+ (return-type "gchar*")
+)
+
+(define-method set_subtitle_font_name
+ (of-object "ClutterMedia")
+ (c-name "clutter_media_set_subtitle_font_name")
+ (return-type "none")
+ (parameters
+ '("const-char*" "font_name")
+ )
+)
+
+(define-method get_subtitle_font_name
+ (of-object "ClutterMedia")
+ (c-name "clutter_media_get_subtitle_font_name")
+ (return-type "gchar*")
+)
+
(define-method set_audio_volume
(of-object "ClutterMedia")
(c-name "clutter_media_set_audio_volume")
@@ -4852,6 +6097,10 @@
+;; From clutter-profile.h
+
+
+
;; From clutter-rectangle.h
(define-function clutter_rectangle_get_type
@@ -5238,6 +6487,11 @@
)
)
+(define-function clutter_script_parser_get_type
+ (c-name "clutter_script_parser_get_type")
+ (return-type "GType")
+)
+
(define-method parse_node
(of-object "ClutterScript")
(c-name "clutter_script_parse_node")
@@ -5266,12 +6520,11 @@
)
)
-(define-method construct_object
- (of-object "ClutterScript")
- (c-name "clutter_script_construct_object")
- (return-type "GObject*")
+(define-function clutter_script_resolve_animation_mode
+ (c-name "clutter_script_resolve_animation_mode")
+ (return-type "gulong")
(parameters
- '("ObjectInfo*" "info")
+ '("JsonNode*" "node")
)
)
@@ -5325,15 +6578,6 @@
)
)
-(define-method parse_alpha
- (of-object "ClutterScript")
- (c-name "clutter_script_parse_alpha")
- (return-type "GObject*")
- (parameters
- '("JsonNode*" "node")
- )
-)
-
;; From clutter-shader.h
@@ -5774,6 +7018,41 @@
(return-type "gboolean")
)
+(define-method set_use_alpha
+ (of-object "ClutterStage")
+ (c-name "clutter_stage_set_use_alpha")
+ (return-type "none")
+ (parameters
+ '("gboolean" "use_alpha")
+ )
+)
+
+(define-method get_use_alpha
+ (of-object "ClutterStage")
+ (c-name "clutter_stage_get_use_alpha")
+ (return-type "gboolean")
+)
+
+(define-method set_minimum_size
+ (of-object "ClutterStage")
+ (c-name "clutter_stage_set_minimum_size")
+ (return-type "none")
+ (parameters
+ '("guint" "width")
+ '("guint" "height")
+ )
+)
+
+(define-method get_minimum_size
+ (of-object "ClutterStage")
+ (c-name "clutter_stage_get_minimum_size")
+ (return-type "none")
+ (parameters
+ '("guint*" "width")
+ '("guint*" "height")
+ )
+)
+
;; From clutter-stage-manager.h
@@ -5788,15 +7067,6 @@
(return-type "ClutterStageManager*")
)
-(define-method set_default_stage
- (of-object "ClutterStageManager")
- (c-name "clutter_stage_manager_set_default_stage")
- (return-type "none")
- (parameters
- '("ClutterStage*" "stage")
- )
-)
-
(define-method get_default_stage
(of-object "ClutterStageManager")
(c-name "clutter_stage_manager_get_default_stage")
@@ -5815,6 +7085,15 @@
(return-type "const-GSList*")
)
+(define-method set_default_stage
+ (of-object "ClutterStageManager")
+ (c-name "clutter_stage_manager_set_default_stage")
+ (return-type "none")
+ (parameters
+ '("ClutterStage*" "stage")
+ )
+)
+
;; From clutter-stage-window.h
@@ -5915,6 +7194,21 @@
(return-type "const-gchar*")
)
+(define-method set_font_description
+ (of-object "ClutterText")
+ (c-name "clutter_text_set_font_description")
+ (return-type "none")
+ (parameters
+ '("PangoFontDescription*" "font_desc")
+ )
+)
+
+(define-method get_font_description
+ (of-object "ClutterText")
+ (c-name "clutter_text_get_font_description")
+ (return-type "PangoFontDescription*")
+)
+
(define-method set_ellipsize
(of-object "ClutterText")
(c-name "clutter_text_set_ellipsize")
@@ -6300,6 +7594,17 @@
)
)
+(define-method set_preedit_string
+ (of-object "ClutterText")
+ (c-name "clutter_text_set_preedit_string")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "preedit_str")
+ '("PangoAttrList*" "preedit_attrs")
+ '("guint" "cursor_pos")
+ )
+)
+
;; From clutter-texture.h
@@ -6933,6 +8238,23 @@
)
)
+(define-method interpolate
+ (of-object "ClutterActorBox")
+ (c-name "clutter_actor_box_interpolate")
+ (return-type "none")
+ (parameters
+ '("const-ClutterActorBox*" "final")
+ '("gdouble" "progress")
+ '("ClutterActorBox*" "result")
+ )
+)
+
+(define-method clamp_to_pixel
+ (of-object "ClutterActorBox")
+ (c-name "clutter_actor_box_clamp_to_pixel")
+ (return-type "none")
+)
+
(define-function clutter_geometry_get_type
(c-name "clutter_geometry_get_type")
(return-type "GType")
@@ -7034,6 +8356,15 @@
)
)
+(define-method from_cm
+ (of-object "ClutterUnits")
+ (c-name "clutter_units_from_cm")
+ (return-type "none")
+ (parameters
+ '("gfloat" "cm")
+ )
+)
+
(define-method from_pt
(of-object "ClutterUnits")
(c-name "clutter_units_from_pt")
@@ -7107,9 +8438,9 @@
(define-function clutter_util_next_p2
(c-name "clutter_util_next_p2")
- (return-type "int")
+ (return-type "gint")
(parameters
- '("int" "a")
+ '("gint" "a")
)
)
@@ -7117,4 +8448,14 @@
;; From clutter-version.h
+(define-function clutter_check_version
+ (c-name "clutter_check_version")
+ (return-type "gboolean")
+ (parameters
+ '("guint" "major")
+ '("guint" "minor")
+ '("guint" "micro")
+ )
+)
+
diff --git a/clutter/src/clutter_signals.defs b/clutter/src/clutter_signals.defs
index fc1a75d..51c584c 100644
--- a/clutter/src/clutter_signals.defs
+++ b/clutter/src/clutter_signals.defs
@@ -36,6 +36,12 @@
)
)
+(define-signal queue-relayout
+ (of-object "ClutterActor")
+ (return-type "void")
+ (when "last")
+)
+
(define-signal event
(of-object "ClutterActor")
(return-type "gboolean")
@@ -105,13 +111,13 @@
)
)
-(define-signal focus-in
+(define-signal key-focus-in
(of-object "ClutterActor")
(return-type "void")
(when "last")
)
-(define-signal focus-out
+(define-signal key-focus-out
(of-object "ClutterActor")
(return-type "void")
(when "last")
@@ -173,6 +179,16 @@
)
)
+(define-signal allocation-changed
+ (of-object "ClutterActor")
+ (return-type "void")
+ (when "last")
+ (parameters
+ '("ClutterActorBox*" "p0")
+ '("ClutterAllocationFlags" "p1")
+ )
+)
+
(define-property name
(of-object "ClutterActor")
(prop-type "GParamString")
@@ -184,7 +200,7 @@
(define-property x
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -193,7 +209,7 @@
(define-property y
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -202,7 +218,7 @@
(define-property width
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -211,7 +227,7 @@
(define-property height
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -220,7 +236,7 @@
(define-property fixed-x
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -229,7 +245,7 @@
(define-property fixed-y
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -247,7 +263,7 @@
(define-property min-width
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -265,7 +281,7 @@
(define-property min-height
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -283,7 +299,7 @@
(define-property natural-width
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -301,7 +317,7 @@
(define-property natural-height
(of-object "ClutterActor")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -337,8 +353,8 @@
(define-property depth
(of-object "ClutterActor")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -356,7 +372,7 @@
(define-property has-clip
(of-object "ClutterActor")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -373,8 +389,8 @@
(define-property opacity
(of-object "ClutterActor")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -383,16 +399,34 @@
(define-property visible
(of-object "ClutterActor")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterActor")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterActor")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterActor")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -418,7 +452,7 @@
(define-property scale-center-x
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -427,7 +461,7 @@
(define-property scale-center-y
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -508,7 +542,7 @@
(define-property anchor-x
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -517,7 +551,7 @@
(define-property anchor-y
(of-object "ClutterActor")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -542,6 +576,25 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterActor")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterActor")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+
;; From ClutterAlpha
(define-property timeline
@@ -995,7 +1048,7 @@
(define-property x
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -1004,7 +1057,7 @@
(define-property y
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -1013,7 +1066,7 @@
(define-property width
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -1022,7 +1075,7 @@
(define-property height
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -1031,7 +1084,7 @@
(define-property fixed-x
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -1040,7 +1093,7 @@
(define-property fixed-y
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -1058,7 +1111,7 @@
(define-property min-width
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -1076,7 +1129,7 @@
(define-property min-height
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -1094,7 +1147,7 @@
(define-property natural-width
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -1112,7 +1165,7 @@
(define-property natural-height
(of-object "ClutterCairoTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -1148,8 +1201,8 @@
(define-property depth
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1167,7 +1220,7 @@
(define-property has-clip
(of-object "ClutterCairoTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -1184,8 +1237,8 @@
(define-property opacity
(of-object "ClutterCairoTexture")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1194,16 +1247,35 @@
(define-property visible
(of-object "ClutterCairoTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+
(define-property reactive
(of-object "ClutterCairoTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1229,7 +1301,7 @@
(define-property scale-center-x
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -1238,7 +1310,7 @@
(define-property scale-center-y
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -1319,7 +1391,7 @@
(define-property anchor-x
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -1328,7 +1400,7 @@
(define-property anchor-y
(of-object "ClutterCairoTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -1353,6 +1425,24 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterCairoTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property disable-slicing
(of-object "ClutterCairoTexture")
(prop-type "GParamBoolean")
@@ -1365,10 +1455,10 @@
(define-property tile-waste
(of-object "ClutterCairoTexture")
(prop-type "GParamInt")
- (docs "Max wastage dimension of a texture when using sliced textures or -1 to disable slicing. Bigger values use less textures, smaller values less texture memory.")
+ (docs "Maximum waste area of a sliced texture")
(readable #t)
- (writable #t)
- (construct-only #t)
+ (writable #f)
+ (construct-only #f)
)
(define-property pixel-format
@@ -1521,7 +1611,7 @@
(define-property x
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -1530,7 +1620,7 @@
(define-property y
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -1539,7 +1629,7 @@
(define-property width
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -1548,7 +1638,7 @@
(define-property height
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -1557,7 +1647,7 @@
(define-property fixed-x
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -1566,7 +1656,7 @@
(define-property fixed-y
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -1584,7 +1674,7 @@
(define-property min-width
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -1602,7 +1692,7 @@
(define-property min-height
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -1620,7 +1710,7 @@
(define-property natural-width
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -1638,7 +1728,7 @@
(define-property natural-height
(of-object "ClutterClone")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -1674,8 +1764,8 @@
(define-property depth
(of-object "ClutterClone")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1693,7 +1783,7 @@
(define-property has-clip
(of-object "ClutterClone")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -1710,8 +1800,8 @@
(define-property opacity
(of-object "ClutterClone")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1720,16 +1810,34 @@
(define-property visible
(of-object "ClutterClone")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterClone")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterClone")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterClone")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -1755,7 +1863,7 @@
(define-property scale-center-x
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -1764,7 +1872,7 @@
(define-property scale-center-y
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -1845,7 +1953,7 @@
(define-property anchor-x
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -1854,7 +1962,7 @@
(define-property anchor-y
(of-object "ClutterClone")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -1879,13 +1987,32 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterClone")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterClone")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+
(define-property source
(of-object "ClutterClone")
(prop-type "GParamObject")
(docs "Specifies the actor to be cloned")
(readable #t)
(writable #t)
- (construct-only #t)
+ (construct-only #f)
)
;; From ClutterColor
@@ -1935,7 +2062,7 @@
(define-property x
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -1944,7 +2071,7 @@
(define-property y
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -1953,7 +2080,7 @@
(define-property width
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -1962,7 +2089,7 @@
(define-property height
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -1971,7 +2098,7 @@
(define-property fixed-x
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -1980,7 +2107,7 @@
(define-property fixed-y
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -1998,7 +2125,7 @@
(define-property min-width
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -2016,7 +2143,7 @@
(define-property min-height
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -2034,7 +2161,7 @@
(define-property natural-width
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -2052,7 +2179,7 @@
(define-property natural-height
(of-object "ClutterGroup")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -2088,8 +2215,8 @@
(define-property depth
(of-object "ClutterGroup")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2107,7 +2234,7 @@
(define-property has-clip
(of-object "ClutterGroup")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -2124,8 +2251,8 @@
(define-property opacity
(of-object "ClutterGroup")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2134,16 +2261,34 @@
(define-property visible
(of-object "ClutterGroup")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterGroup")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterGroup")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterGroup")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2169,7 +2314,7 @@
(define-property scale-center-x
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -2178,7 +2323,7 @@
(define-property scale-center-y
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -2259,7 +2404,7 @@
(define-property anchor-x
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -2268,7 +2413,7 @@
(define-property anchor-y
(of-object "ClutterGroup")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -2293,6 +2438,25 @@
(construct-only #f)
)
+
+(define-property text-direction
+ (of-object "ClutterGroup")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterGroup")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
;; From ClutterInterval
(define-property value-type
@@ -2321,66 +2485,85 @@
)
)
-(define-property playing
+
+(define-property duration
+ (of-object "ClutterMedia")
+ (prop-type "GParamDouble")
+ (docs "The duration of the stream, in seconds")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property can-seek
(of-object "ClutterMedia")
(prop-type "GParamBoolean")
- (docs "Wheter the actor is playing")
+ (docs "Whether the current stream is seekable")
(readable #t)
- (writable #t)
+ (writable #f)
(construct-only #f)
)
-(define-property audio-volume
+(define-property buffer-fill
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "The volume of the audio")
+ (docs "The fill level of the buffer")
(readable #t)
- (writable #t)
+ (writable #f)
(construct-only #f)
)
-(define-property can-seek
+(define-property playing
(of-object "ClutterMedia")
(prop-type "GParamBoolean")
- (docs "Whether the current stream is seekable")
+ (docs "Wheter the actor is playing")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
-(define-property progress
+(define-property subtitle-font-name
+ (of-object "ClutterMedia")
+ (prop-type "GParamString")
+ (docs "The font used to display subtitles")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property audio-volume
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "Current progress of the playback")
+ (docs "The volume of the audio")
(readable #t)
(writable #t)
(construct-only #f)
)
-(define-property duration
+(define-property progress
(of-object "ClutterMedia")
(prop-type "GParamDouble")
- (docs "The duration of the stream, in seconds")
+ (docs "Current progress of the playback")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
-(define-property uri
+(define-property subtitle-uri
(of-object "ClutterMedia")
(prop-type "GParamString")
- (docs "URI of a media file")
+ (docs "URI of a subtitle file")
(readable #t)
(writable #t)
(construct-only #f)
)
-(define-property buffer-fill
+(define-property uri
(of-object "ClutterMedia")
- (prop-type "GParamDouble")
- (docs "The fill level of the buffer")
+ (prop-type "GParamString")
+ (docs "URI of a media file")
(readable #t)
- (writable #f)
+ (writable #t)
(construct-only #f)
)
@@ -2417,7 +2600,7 @@
(define-property x
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -2426,7 +2609,7 @@
(define-property y
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -2435,7 +2618,7 @@
(define-property width
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -2444,7 +2627,7 @@
(define-property height
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -2453,7 +2636,7 @@
(define-property fixed-x
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -2462,7 +2645,7 @@
(define-property fixed-y
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -2480,7 +2663,7 @@
(define-property min-width
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -2498,7 +2681,7 @@
(define-property min-height
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -2516,7 +2699,7 @@
(define-property natural-width
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -2534,7 +2717,7 @@
(define-property natural-height
(of-object "ClutterRectangle")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -2570,8 +2753,8 @@
(define-property depth
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2589,7 +2772,7 @@
(define-property has-clip
(of-object "ClutterRectangle")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -2606,8 +2789,8 @@
(define-property opacity
(of-object "ClutterRectangle")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2616,16 +2799,34 @@
(define-property visible
(of-object "ClutterRectangle")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterRectangle")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterRectangle")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterRectangle")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -2651,7 +2852,7 @@
(define-property scale-center-x
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -2660,7 +2861,7 @@
(define-property scale-center-y
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -2741,7 +2942,7 @@
(define-property anchor-x
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -2750,7 +2951,7 @@
(define-property anchor-y
(of-object "ClutterRectangle")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -2775,6 +2976,24 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterRectangle")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterRectangle")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property color
(of-object "ClutterRectangle")
(prop-type "ClutterParamSpecColor")
@@ -2880,6 +3099,13 @@
;; From ClutterStage
+
+(define-signal activate
+ (of-object "ClutterStage")
+ (return-type "void")
+ (when "last")
+)
+
(define-signal fullscreen
(of-object "ClutterStage")
(return-type "void")
@@ -2892,16 +3118,19 @@
(when "last")
)
-(define-signal activate
+(define-signal deactivate
(of-object "ClutterStage")
(return-type "void")
(when "last")
)
-(define-signal deactivate
+(define-signal delete-event
(of-object "ClutterStage")
- (return-type "void")
+ (return-type "gboolean")
(when "last")
+ (parameters
+ '("ClutterEvent*" "p0")
+ )
)
(define-property name
@@ -2915,7 +3144,7 @@
(define-property x
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -2924,7 +3153,7 @@
(define-property y
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -2933,7 +3162,7 @@
(define-property width
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -2942,7 +3171,7 @@
(define-property height
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -2951,7 +3180,7 @@
(define-property fixed-x
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -2960,7 +3189,7 @@
(define-property fixed-y
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -2978,7 +3207,7 @@
(define-property min-width
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -2996,7 +3225,7 @@
(define-property min-height
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -3014,7 +3243,7 @@
(define-property natural-width
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -3032,7 +3261,7 @@
(define-property natural-height
(of-object "ClutterStage")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -3068,8 +3297,8 @@
(define-property depth
(of-object "ClutterStage")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3087,7 +3316,7 @@
(define-property has-clip
(of-object "ClutterStage")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -3104,8 +3333,8 @@
(define-property opacity
(of-object "ClutterStage")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3114,16 +3343,34 @@
(define-property visible
(of-object "ClutterStage")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterStage")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterStage")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterStage")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3149,7 +3396,7 @@
(define-property scale-center-x
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -3158,7 +3405,7 @@
(define-property scale-center-y
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -3239,7 +3486,7 @@
(define-property anchor-x
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -3248,7 +3495,7 @@
(define-property anchor-y
(of-object "ClutterStage")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -3273,6 +3520,24 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterStage")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterStage")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property color
(of-object "ClutterStage")
(prop-type "ClutterParamSpecColor")
@@ -3282,19 +3547,19 @@
(construct-only #f)
)
-(define-property fullscreen
+(define-property fullscreen-set
(of-object "ClutterStage")
(prop-type "GParamBoolean")
(docs "Whether the main stage is fullscreen")
(readable #t)
- (writable #t)
+ (writable #f)
(construct-only #f)
)
(define-property offscreen
(of-object "ClutterStage")
(prop-type "GParamBoolean")
- (docs "Whether the main stage is renderer offscreen")
+ (docs "Whether the main stage should be rendered offscreen")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3303,7 +3568,7 @@
(define-property cursor-visible
(of-object "ClutterStage")
(prop-type "GParamBoolean")
- (docs "Whether the mouse pointer is visible on the main stage ")
+ (docs "Whether the mouse pointer is visible on the main stage")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3354,18 +3619,51 @@
(construct-only #f)
)
+(define-property use-alpha
+ (of-object "ClutterStage")
+ (prop-type "GParamBoolean")
+ (docs "Whether to honour the alpha component of the stage color")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property key-focus
+ (of-object "ClutterStage")
+ (prop-type "GParamObject")
+ (docs "The currently key focused actor")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
;; From ClutterText
-(define-signal activate
+(define-signal text-changed
(of-object "ClutterText")
(return-type "void")
(when "last")
)
-(define-signal text-changed
+(define-signal insert-text
+ (of-object "ClutterText")
+ (return-type "void")
+ (when "last")
+ (parameters
+ '("const-gchar*" "p0")
+ '("gint" "p1")
+ '("gpointer" "p2")
+ )
+)
+
+(define-signal delete-text
(of-object "ClutterText")
(return-type "void")
(when "last")
+ (parameters
+ '("gint" "p0")
+ '("gint" "p1")
+ )
)
;; Hand-edited to add constness
@@ -3378,6 +3676,12 @@
)
)
+(define-signal activate
+ (of-object "ClutterText")
+ (return-type "void")
+ (when "last")
+)
+
(define-property name
(of-object "ClutterText")
(prop-type "GParamString")
@@ -3389,7 +3693,7 @@
(define-property x
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -3398,7 +3702,7 @@
(define-property y
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -3407,7 +3711,7 @@
(define-property width
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -3416,7 +3720,7 @@
(define-property height
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -3425,7 +3729,7 @@
(define-property fixed-x
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -3434,7 +3738,7 @@
(define-property fixed-y
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -3452,7 +3756,7 @@
(define-property min-width
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -3470,7 +3774,7 @@
(define-property min-height
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -3488,7 +3792,7 @@
(define-property natural-width
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -3506,7 +3810,7 @@
(define-property natural-height
(of-object "ClutterText")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -3542,8 +3846,8 @@
(define-property depth
(of-object "ClutterText")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3561,7 +3865,7 @@
(define-property has-clip
(of-object "ClutterText")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -3578,8 +3882,8 @@
(define-property opacity
(of-object "ClutterText")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3588,16 +3892,34 @@
(define-property visible
(of-object "ClutterText")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterText")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterText")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterText")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3623,7 +3945,7 @@
(define-property scale-center-x
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -3632,7 +3954,7 @@
(define-property scale-center-y
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -3713,7 +4035,7 @@
(define-property anchor-x
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -3722,7 +4044,7 @@
(define-property anchor-y
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -3747,6 +4069,24 @@
(construct-only #f)
)
+(define-property text-direction
+ (of-object "ClutterText")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterText")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property font-name
(of-object "ClutterText")
(prop-type "GParamString")
@@ -3756,6 +4096,15 @@
(construct-only #f)
)
+(define-property font-description
+ (of-object "ClutterText")
+ (prop-type "GParamBoxed")
+ (docs "The font description to be used")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
(define-property text
(of-object "ClutterText")
(prop-type "GParamString")
@@ -3947,7 +4296,7 @@
(define-property max-length
(of-object "ClutterText")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Maximum length of the text inside the actor")
(readable #t)
(writable #t)
@@ -4001,7 +4350,7 @@
(define-property x
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the actor")
(readable #t)
(writable #t)
@@ -4010,7 +4359,7 @@
(define-property y
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the actor")
(readable #t)
(writable #t)
@@ -4019,7 +4368,7 @@
(define-property width
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Width of the actor")
(readable #t)
(writable #t)
@@ -4028,7 +4377,7 @@
(define-property height
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Height of the actor")
(readable #t)
(writable #t)
@@ -4037,7 +4386,7 @@
(define-property fixed-x
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced X position of the actor")
(readable #t)
(writable #t)
@@ -4046,7 +4395,7 @@
(define-property fixed-y
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced Y position of the actor")
(readable #t)
(writable #t)
@@ -4064,7 +4413,7 @@
(define-property min-width
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum width request for the actor")
(readable #t)
(writable #t)
@@ -4082,7 +4431,7 @@
(define-property min-height
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced minimum height request for the actor")
(readable #t)
(writable #t)
@@ -4100,7 +4449,7 @@
(define-property natural-width
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural width request for the actor")
(readable #t)
(writable #t)
@@ -4118,7 +4467,7 @@
(define-property natural-height
(of-object "ClutterTexture")
- (prop-type "ClutterParamSpecUnit")
+ (prop-type "GParamFloat")
(docs "Forced natural height request for the actor")
(readable #t)
(writable #t)
@@ -4154,8 +4503,8 @@
(define-property depth
(of-object "ClutterTexture")
- (prop-type "GParamInt")
- (docs "Depth of actor")
+ (prop-type "GParamFloat")
+ (docs "Position on the Z axis")
(readable #t)
(writable #t)
(construct-only #f)
@@ -4173,7 +4522,7 @@
(define-property has-clip
(of-object "ClutterTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor has a clip set or not")
+ (docs "Whether the actor has a clip set")
(readable #t)
(writable #f)
(construct-only #f)
@@ -4190,8 +4539,8 @@
(define-property opacity
(of-object "ClutterTexture")
- (prop-type "GParamUChar")
- (docs "Opacity of actor")
+ (prop-type "GParamUInt")
+ (docs "Opacity of an actor")
(readable #t)
(writable #t)
(construct-only #f)
@@ -4200,16 +4549,34 @@
(define-property visible
(of-object "ClutterTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor is visible or not")
+ (docs "Whether the actor is visible")
(readable #t)
(writable #t)
(construct-only #f)
)
+(define-property mapped
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor will be painted")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
+(define-property realized
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor has been realized")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property reactive
(of-object "ClutterTexture")
(prop-type "GParamBoolean")
- (docs "Whether the actor is reactive to events or not")
+ (docs "Whether the actor is reactive to events")
(readable #t)
(writable #t)
(construct-only #f)
@@ -4235,7 +4602,7 @@
(define-property scale-center-x
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Horizontal scale center")
(readable #t)
(writable #t)
@@ -4244,7 +4611,7 @@
(define-property scale-center-y
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Vertical scale center")
(readable #t)
(writable #t)
@@ -4325,7 +4692,7 @@
(define-property anchor-x
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "X coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -4334,7 +4701,7 @@
(define-property anchor-y
(of-object "ClutterTexture")
- (prop-type "GParamInt")
+ (prop-type "GParamFloat")
(docs "Y coordinate of the anchor point")
(readable #t)
(writable #t)
@@ -4359,6 +4726,25 @@
(construct-only #f)
)
+
+(define-property text-direction
+ (of-object "ClutterTexture")
+ (prop-type "GParamEnum")
+ (docs "Direction of the text")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property has-pointer
+ (of-object "ClutterTexture")
+ (prop-type "GParamBoolean")
+ (docs "Whether the actor contains the pointer of an input device")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
(define-property disable-slicing
(of-object "ClutterTexture")
(prop-type "GParamBoolean")
@@ -4371,10 +4757,10 @@
(define-property tile-waste
(of-object "ClutterTexture")
(prop-type "GParamInt")
- (docs "Max wastage dimension of a texture when using sliced textures or -1 to disable slicing. Bigger values use less textures, smaller values less texture memory.")
+ (docs "Maximum waste area of a sliced texture")
(readable #t)
- (writable #t)
- (construct-only #t)
+ (writable #f)
+ (construct-only #f)
)
(define-property pixel-format
@@ -4515,24 +4901,6 @@
)
)
-(define-property fps
- (of-object "ClutterTimeline")
- (prop-type "GParamUInt")
- (docs "Frames per second")
- (readable #t)
- (writable #t)
- (construct-only #f)
-)
-
-(define-property num-frames
- (of-object "ClutterTimeline")
- (prop-type "GParamUInt")
- (docs "Total number of frames")
- (readable #t)
- (writable #t)
- (construct-only #f)
-)
-
(define-property loop
(of-object "ClutterTimeline")
(prop-type "GParamBoolean")
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
